Idempotency

Public write endpoints require Idempotency-Key. Reuse the same key when retrying the same logical operation after a timeout or transport failure.

Rules

• Generate a unique key per logical write.
• Reuse the key only for exact retries of that write.
• Do not reuse a key across different payloads.
• Treat 409 as a signal that the key was reused for a conflicting request.

The SDK accepts an idempotencyKey option on write methods.