For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
GuidesAPI ReferenceChangelog
GuidesAPI ReferenceChangelog
  • API Reference
  • Event Reference
      • POSTDocument Insights extraction completed
      • POSTDocument Insights extraction failed
      • POSTDocument Insights extraction rejected
Event ReferenceDocument Insights

Document Insights extraction failed

Payload
1{
2  "eventId": "evt_01JY7MFAILED000000000001",
3  "eventType": "document-insights.extraction.failed",
4  "occurredAt": "2026-04-07T10:18:00Z",
5  "apiVersion": "v1",
6  "data": {
7    "extractionId": "69654f0bc073ef404baec649",
8    "status": "FAILED",
9    "outputAvailable": false,
10    "createdAt": "2026-04-07T10:05:00Z",
11    "updatedAt": "2026-04-07T10:18:00Z",
12    "completedAt": "2026-04-07T10:18:00Z",
13    "document": {
14      "fileId": "file_01JY7M4ZVX5R1P3M3Q0TA1S7ZM",
15      "fileName": "lab-result.pdf",
16      "mimeType": "application/pdf",
17      "sizeBytes": 63877
18    },
19    "error": {
20      "code": "PROCESSING_FAILED",
21      "message": "The document could not be processed."
22    }
23  }
24}

Delivered when a Document Insights extraction reaches FAILED.

Was this page helpful?
Previous

Document Insights extraction rejected

Next
Built with

Headers

X-Plextera-Delivery-IdstringRequired

Unique identifier for this delivery attempt. Changes on each retry; use X-Plextera-Event-Id for deduplication.

X-Plextera-Event-IdstringRequired
Stable event identifier. Identical across retry attempts for the same event. Use this to deduplicate deliveries on the receiver side.
X-Plextera-Event-TypestringRequired

Event type string, e.g. document-insights.extraction.completed. Mirrors the eventType field in the body.

X-Plextera-Event-Occurred-AtdatetimeRequired

ISO 8601 timestamp when the terminal state was reached. Mirrors the occurredAt field in the body.

X-Plextera-Api-VersionstringRequired

API version used to format this payload, e.g. v1. Mirrors the apiVersion field in the body.

X-Plextera-SignaturestringRequired

HMAC-SHA256 signature for verifying that the delivery originated from Plextera. Format: t=<unix timestamp>,v1=<hex signature>. The signed string is <t>.<raw request body>. See the Events guide for full verification steps.

Payload

The payload of this webhook request is an object.
eventIdstringRequired

Unique identifier for this event. Stable across retry attempts — use it to deduplicate deliveries on the receiver side.

eventType"document-insights.extraction.failed"Required

String identifying the event type, e.g. document-insights.extraction.completed.

occurredAtdatetimeRequired
ISO 8601 timestamp at which the terminal state was reached.
apiVersionstringRequired
API version used to format this payload.
dataobjectRequired

Event-specific payload. The shape varies by eventType; see the individual event schemas below.

Response

200
Event accepted
202
Event accepted for asynchronous processing