Webhooks

An agent run paused at an approval gate

Fires when a run reaches an approval step and checkpoints — the run resumes automatically once approved (in-app or via the emailed approval link). data.step is the 1-indexed paused step.

postWebhookagent.approval_pending

Payload

api_versionstring

createdinteger required

Unix seconds.

idstring uuid required

type'agent.approval_pending' required

Example payload

{
  "api_version": "1.0",
  "id": "evt_a1b2c3..."
}

Response

Acknowledged.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.