Idempotency on Requests

Idempotent requests provide a reliable mechanism to handle network interruptions and prevent duplicate operations during API interactions. This feature is essential for maintaining data integrity when building robust applications.

Include an Idempotency-Key header with a unique identifier (UUID recommended) to make any request idempotent. Once used, the key remains valid for 24 hours and will return the same response for identical requests. This allows your application to safely retry operations without creating unintended duplicates.

Important considerations: Reusing an idempotency key with different request parameters will result in an HTTP 409 Conflict error. Concurrent requests using the same key will return HTTP 429 Too Many Requests for all but the first request, ensuring consistent processing.