run.failed

Event triggered whenever an extraction run fails due to an error or produces results that do not pass schema validation.

Payload Parameters

Webhook payloads are flat camelCase objects — every field sits at the top level.

event: string

The event type that triggered the webhook (`run.failed`).

runId: string

Unique identifier for the extraction run.

documentId: string

ID of the document that was processed.

environmentId: string

Id of the environment the run belongs to (not the environment slug).

status: string

Always the literal `failed` — even when the run's terminal status in the API is `validation_failed`. Route on `event` and fetch the run via the API if you need to distinguish the two failure modes.

timestamp: string

ISO 8601 timestamp when the event was dispatched.

errorMessage: string

Description of what went wrong.

200 Response

{
  "event": "run.failed",
  "runId": "run_xyz789",
  "documentId": "doc_abc123",
  "environmentId": "env_prod123",
  "status": "failed",
  "timestamp": "2026-03-15T10:30:12.000Z",
  "errorMessage": "Unable to parse document content"
}