---
url: /errors/invalid_idempotency_key.md
---
# `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.