> ## Documentation Index
> Fetch the complete documentation index at: https://docs-agentic-id.icustomer.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Feedback

> Report what happened after you used a value: bounced, replied, wrong person, confirmed.

`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.

```bash curl theme={null}
curl -X POST https://YOUR_AGENTIC_ID_HOST/v1/feedback \
  -H "Authorization: Bearer $AGENTIC_ID_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 7e3b9d15-0a4c-4f2e-8d6b-5a1c3e7f9b20" \
  -d '{
    "id": "ic-4Hn8sPq1VxC6yTb3Ku9MwR",
    "field": "work_email",
    "outcome": "bounced"
  }'
```

```typescript TypeScript theme={null}
const res = await fetch('https://YOUR_AGENTIC_ID_HOST/v1/feedback', {
  method: 'POST',
  headers: {
    authorization: `Bearer ${process.env.AGENTIC_ID_API_KEY}`,
    'content-type': 'application/json',
    'idempotency-key': crypto.randomUUID(),
  },
  body: JSON.stringify({
    id: 'ic-4Hn8sPq1VxC6yTb3Ku9MwR',
    field: 'work_email',
    outcome: 'bounced',
  }),
});
const reply = await res.json();
console.log(reply.recorded, reply.summary);
```

```json 200 theme={null}
{
  "request_id": "req_d2f4a6c8-0b1e-4d3f-9a5c-7e9b1d3f5a79",
  "recorded": true,
  "summary": "This value is no longer served to your workspace, and it counts against source-a's trust. Other brands are unaffected."
}
```

## Request

**id** `string` *required*

The Agentic ID the value belongs to. Your workspace must hold it.

**field** `string` *required*

Which value you used. One of `work_email`, `personal_email`, `mobile_phone`, `phone`, `title`, `company_domain`.

**outcome** `string` *required*

What happened.

| Value | Meaning |
| - | - |
| `bounced` | The email bounced. |
| `replied` | The person replied. |
| `wrong_person` | It reached the wrong person. |
| `confirmed` | Your CRM confirms the value. |

## Response

**request\_id** `string` *required*

The ID of this call. The same value as the `X-Request-Id` header.

**recorded** `boolean` *required*

`true` when the outcome was recorded.

**summary** `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

| Status | Code | Meaning | Retry |
| - | - | - | - |
| 400 | `request.invalid` | The body does not match the schema. `issues` lists each problem. | No. Fix the body. |
| 400 | `idempotency.key_invalid` | The `Idempotency-Key` is not 8 to 200 printable characters. | No. Fix the key. |
| 401 | `auth.invalid_key` | No valid credential was sent. | No. |
| 401 | `auth.token_expired` | Your sign-in has expired. | After you refresh the token. |
| 404 | `feedback.not_held` | Your workspace does not hold this ID. | No. Report only on IDs delivered to you. |
| 409 | `idempotency.in_progress` | The first request with this key is still running. | Yes, after `Retry-After`, same key. |
| 422 | `idempotency.key_reused` | The key was already used with a different body. | No. Use a new key. |
| 429 | `rate_limited` | Too many requests. | Yes, after `Retry-After`. |
| 502 | `service.error` | A fault on our side. | Yes, with the same `Idempotency-Key`. |
| 503 | `service.unavailable` | Temporarily unavailable. | Yes, after `Retry-After`, same key. |
| 504 | `service.timeout` | The call took too long. It may still have completed. | Yes, with the same `Idempotency-Key`. |

See [Errors](https://docs-agentic-id.icustomer.ai/errors.md) 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](https://docs-agentic-id.icustomer.ai/idempotency.md).
* **API only.** The SDK and CLI do not have a feedback call today. Use the HTTP endpoint.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.