idempotency_key_required
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.
| Code | Type | HTTP | Category |
|---|---|---|---|
idempotency_key_required | invalid_request_error | 422 | Idempotency |
Cause
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.
What to do
Generate one unique identifier per operation you fire (a UUID works) and send it in the Idempotency-Key header; if the connection drops and you retry, repeat exactly the same key so the operation never runs twice.
Related
All Idempotency error codes
Causes and actions for errors in this category.
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.