Idempotency error codes
Every public API error code emitted by Idempotency, with its HTTP status, its type and a page per code.
Error codes emitted by Idempotency. Each code links to its own page with the cause and the action to take.
| Code | Type | HTTP | Description |
|---|---|---|---|
idempotency_key_in_use | idempotency_error | 409 | Another request with the same Idempotency-Key is still in flight, and the result is not known yet. |
idempotency_key_invalid | invalid_request_error | 400 | The Idempotency-Key does not fit the accepted format: it must be 1 to 255 printable ASCII characters. |
idempotency_key_required | invalid_request_error | 422 | The request arrived without an Idempotency-Key header, and this operation delivers an effect that cannot be taken back — an email sent, a file generated, a charge — so its transition window has already closed for this credential's environment. |
idempotency_key_reused | idempotency_error | 409 | That Idempotency-Key was already used with a different payload. The key identifies one specific operation, so reusing it for another would make replay meaningless. |
Related
Error codes by category
Find an error by the category that emits it.
Full reference table
All codes, HTTP statuses, types and descriptions in one reference.
Error model
Interpret the error envelope and handle errors by code.