Skip to content
deedglassdocs

idempotency_key_invalid

Idempotency-Key is empty, longer than 255 characters, holds characters outside printable ASCII, or was sent more than once.

HTTP 400 · invalid_request_error · not retryable

What happened

Section titled “What happened”

Idempotency-Key is empty, longer than 255 characters, holds characters outside printable ASCII, or was sent more than once. On an endpoint that requires a key, a request without one gets this code with “This endpoint needs an Idempotency-Key header. Send a new unique value, such as a UUID, with each new request.” param is Idempotency-Key.

What to do

Section titled “What to do”

Send one key of 1 to 255 printable ASCII characters. A UUID works.

Example

Section titled “Example”
HTTP 400 · idempotency_key_invalid
{
  "error": {
    "type": "invalid_request_error",
    "code": "idempotency_key_invalid",
    "message": "Idempotency-Key must be 1 to 255 printable ASCII characters.",
    "param": "Idempotency-Key",
    "request_id": "req_01j9zr3m5k8q2w7x4t6v0b1c9d",
    "doc_url": "https://docs.deedglass.com/errors/idempotency_key_invalid"
  }
}

The message is for a person and can get more exact over time: branch on type and code, never on the message.

In the SDKs

Section titled “In the SDKs”
SDK Raised as
TypeScript (@deedglass/sdk) InvalidRequestError with code === "idempotency_key_invalid"
Python (deedglass) deedglass.InvalidRequestError with .code == "idempotency_key_invalid"
Section titled “Related”