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
409as a signal that the key was reused for a conflicting request.
The SDK accepts an idempotencyKey option on write methods.