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

# Webhooks

> Manage event delivery endpoints and inspect delivery history.

Webhook endpoints are scoped to the organization associated with the API key. Use `X-Idempotency-Key` on creation, secret rotation, and retry requests when a client may retry after a network failure.

<Warning>The endpoint secret is returned only when the endpoint is created or its secret is rotated. Store it securely; it is not returned by list or get.</Warning>

## Operations

| Method   | Path                                                    | Purpose                                       |
| -------- | ------------------------------------------------------- | --------------------------------------------- |
| `POST`   | `/webhooks`                                             | Create an endpoint                            |
| `GET`    | `/webhooks`                                             | List endpoints                                |
| `GET`    | `/webhooks/{webhook_id}`                                | Retrieve an endpoint                          |
| `PATCH`  | `/webhooks/{webhook_id}`                                | Update URL, events, filters, or enabled state |
| `DELETE` | `/webhooks/{webhook_id}`                                | Delete an endpoint                            |
| `GET`    | `/webhooks/{webhook_id}/deliveries`                     | List delivery attempts                        |
| `POST`   | `/webhooks/{webhook_id}/deliveries/{delivery_id}/retry` | Retry a failed delivery                       |
| `POST`   | `/webhooks/{webhook_id}/rotate-secret`                  | Rotate the signing secret                     |

Delivery records include status, attempt number, response code, timestamps, and the stored event payload when available. Retry is allowed only for failed or exhausted deliveries.