Skip to content

invalid_idempotency_key

Description

The request idempotency key is invalid.

HTTP Status

400 Bad Request

doc_url Format

The doc_url value is an absolute URL and changes by environment:

<docs-base-url>/errors/invalid_idempotency_key

Typical Causes

  • The X-Quarzo-Life-Idempotency-Key header is blank after trimming.
  • The key exceeds the endpoint's maximum length.

Example

Response:

json
{
  "errors": [
    {
      "code": "invalid_idempotency_key",
      "message": "Provided idempotency key is invalid.",
      "doc_url": "https://docs.example.com/errors/invalid_idempotency_key"
    }
  ]
}

How To Fix

Send a stable, non-empty key within the endpoint's documented length limit.