inference_hook.failing
⚠️
Preview — this feature is being built; the design below is the spec.
Sent when: The organization’s inference policy hook has been timing out or erroring for 5 minutes.
| Property | Value |
|---|---|
| Scope | The whole organization. Register with an Admin key at /v1/organizations/webhooks. |
| Area | Security |
| Subscribe with | "events": ["inference_hook.failing"], or a prefix such as "inference_hook.*" |
Payload
{
"id": "evt_01JCA5D7F9H1K3M5P7R9",
"type": "inference_hook.failing",
"created_at": "2026-11-05T10:00:00Z",
"organization_id": "org_01J9X8Z6B4D2F0H8K6M4",
"data": {
"object": {
"type": "inference_hook",
"failure_mode": "closed",
"since": "2026-11-05T09:55:00Z",
"last_error": "timeout after 1500 ms"
}
}
}data.object matches what the corresponding GET endpoint returned when the event happened. Prompt and output text are never included.
What to do
- With
failure_mode: closed, requests are being refused right now; restore the hook service first. - Use Test the hook to confirm recovery.
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?