Automette docs

List webhook subscriptions

GET
/api/v1/webhooks

Authorization

ApiKeyAuth
AuthorizationBearer <token>

API key from API Keys in the dashboard menu.

In: header

Response Body

application/json

application/json

curl -X GET "https://example.com/api/v1/webhooks"
[  {    "id": "string",    "url": "http://example.com",    "events": [      "render.completed"    ],    "enabled": true,    "failure_count": 0,    "template_id": "string",    "created_at": "2019-08-24T14:15:22Z",    "updated_at": "2019-08-24T14:15:22Z"  }]

Read a task's thread GET

Everything the task did, in order (messages, tool calls and results, questions, answers, corrections), after event `after`.

Create a webhook subscription POST

Subscribes to events for your team. When an event fires, Automette POSTs a JSON payload to your URL. The response includes a `secret`: use it to verify the `webhook-signature` header on incoming requests. **The secret is shown only once**: store it immediately. See [Webhook payloads](/docs/api-reference/webhook-payloads) for signature verification. By default a subscription is **team-wide** and fires for every matching event in your team, regardless of source. Pass `template_id` to scope it to a single template: it then receives render events for that template only. Delivery is additive: a render notifies your team-wide subscriptions **and** any subscription scoped to that template. For a one-off callback tied to a single render, use the `webhook_url` field on `POST /api/v1/renders` instead. **Available events:** - `render.completed`: a single render finished successfully (API, form, Dynamic URL, template set). Bulk/CSV rows do **not** fire this: see `job.completed`. - `render.failed`: a single render failed or errored - `form.submitted`: a submission landed on a hosted form - `job.completed`: a bulk/CSV job finished (one event per job, with row counts), instead of a delivery per row - `task.completed`: an agent finished a task - `task.failed`: an agent's task stopped on an error - `task.waiting`: a task is waiting on a person (a question or an approval); `waiting_on` says what for