FlashData API V2

Webhooks

Receive signed job events, verify the raw request body, and use delivery IDs to investigate retries.

Delivery contract

FlashData signs the timestamp and raw body. Verify before parsing JSON, enforce a short timestamp tolerance, and deduplicate effects by event ID.

Request headers
X-FlashData-Event-Id: owe_...
X-FlashData-Event-Type: job.completed
X-FlashData-Delivery-Id: whd_...
X-FlashData-Timestamp: 1787808000
X-FlashData-Signature: v1=...

Events and retries

Job events are job.completed, job.failed, and job.cancelled. Return a 2xx only after durable acceptance. Delivery attempts keep immutable IDs and a visible timeline.