Idempotent Requests

Safely retry requests without creating duplicates. Include an Idempotency-Key header with a unique UUID.

Example Header

Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000

Behavior Reference

ScenarioResponse
Same key + same body
200Cached original response
Same key + different body
422idempotency_key_mismatch
Same key + different operation
409idempotency_key_conflict
Same key + different account
409idempotency_key_conflict

Idempotency records expire after 24 hours. Generate a new key for every distinct operation.