Skip to main content
POST /v1/feedback records what you saw after using a value Agentic ID gave you. An email bounced, the person replied, it reached the wrong person, or your CRM confirms it. Use it after every send and every CRM sync. It changes what your workspace is served and how much the value’s source is trusted. It is never shown to another workspace.
200

Request

string
required
The Agentic ID the value belongs to. Your workspace must hold it.
string
required
Which value you used. One of work_email, personal_email, mobile_phone, phone, title, company_domain.
string
required
What happened.

Response

string
required
The ID of this call. The same value as the X-Request-Id header.
boolean
required
true when the outcome was recorded.
string
required
One plain sentence saying what the report changed.

What it costs

No credits are charged. The call takes no max_credits and returns no cost.

Errors

See Errors for the full list.

Behaviour

  • One value per call. Each call reports one outcome for one field of one ID.
  • bounced and wrong_person. The value is no longer served to your workspace, and the report counts against the trust of the source that supplied it. Other workspaces are not affected.
  • replied and confirmed. The report counts toward the trust of the source that supplied the value. It can also be kept as your workspace’s own evidence that the person or company is real.
  • Private to your workspace. What you saw is recorded as your workspace’s own evidence. It never becomes a shared fact and is never shown to another workspace.
  • No value served yet. If no value was ever served to you for that field on that ID, the report is still recorded, and the summary says there is nothing to credit or stop serving.
  • Send an Idempotency-Key. A repeated report is recorded again. The key makes a retry safe. See Idempotency.
  • API only. The SDK and CLI do not have a feedback call today. Use the HTTP endpoint.