Idempotency

Every non-idempotent write (POST, PATCH, certain DELETEs) accepts an Idempotency-Key header. Pass any unique string per logical operation; the platform de-duplicates retries within a 24-hour window.

Example

POST /v1/orders/orders
Idempotency-Key: 9a7e1c4b-...

If the same key arrives twice, the second call returns the original response — including the original status code. Use a UUID per operation and persist it on your side so retries from your retry loop reuse the same key.

SDK helpers

The official SDKs generate idempotency keys automatically for write methods. Override by passing idempotencyKey (TS) / idempotency_key (Python) / IdempotencyKey (.NET) on the request.

Errors

If a key was used previously with a different request body, the platform returns 409 Conflict with error: "idempotency_key_reused". Generate fresh keys for fresh writes.