Idempotency

Idempotency-Key

Public API write endpoints require an Idempotency-Key header.

Example:

Idempotency-Key: 6a8d5f5a-7d6b-4b26-9b30-9a6b0b2b9d2b

How To Use It

1. Generate a new UUID for the operation.
2. Reuse the same key when retrying the same request (timeouts, 5xx, network issues).
3. Do not reuse the same key with a different request body.

Conflict Behavior

If the same idempotency key is reused with a different payload, the API returns:

• 409 Conflict with error.code = "conflict"