Solia Direct DocsControl Plane
⌘K

API ReferenceReference

Idempotency

Safe retries on writes and at-least-once events.

Machine-readable OpenAPI description

Writes

  • POST /v1/orders requires an Idempotency-Key request header of up to 190 characters.
  • A repeat with the same key and the same body returns the same order rather than creating a duplicate.
  • Reusing the same key with a different body is refused with 409 conflict.
  • Retry a network failure or a 500 with the same key; never mint a new key for the same logical order.

Deliveries

Webhook delivery and the event stream are at-least-once and may arrive out of order. Deduplicate on event_id, ignore a delivery identifier already processed, and keep handlers idempotent.