deployment.run.failed
⚠️
Preview — this feature is being built; the design below is the spec.
Sent when: A scheduled or triggered deployment run ended in failure.
| Property | Value |
|---|---|
| Scope | One workspace. Register with an inference key at /v1/webhooks. |
| Area | Agents |
| Subscribe with | "events": ["deployment.run.failed"], or a prefix such as "deployment.*" |
Payload
{
"id": "evt_01JCA5D7F9H1K3M5P7R9",
"type": "deployment.run.failed",
"created_at": "2026-11-05T10:00:00Z",
"workspace_id": "wrkspc_01JC0A2C4E6G8J0L2N4Q",
"data": {
"object": {
"id": "drn_01JC9F1H3K5M7P9R1T3V",
"type": "deployment_run",
"deployment_id": "dep_01JC6C8E0G2J4L6N8Q0S",
"status": "failed",
"session_id": "sesn_01JC9F2J4L6N8Q0S2U4W",
"error": {
"code": "tool_failed",
"message": "crm.lookup returned 503 three times."
}
}
}
}data.object matches what the corresponding GET endpoint returned when the event happened. Prompt and output text are never included.
What to do
- Open the run’s session to see which step failed.
- Three failures in a row pause the deployment; see
deployment.paused.
Delivery
Deliveries are signed, retried with back-off for up to 3 days, and may arrive more than once or out of order. De-duplicate on the syntic-event-id header and compare timestamps before acting. See Webhooks.
Was this page helpful?