idempotency_key_invalid

Idempotency key not valid

Code: idempotency_key_invalid · HTTP status: usually 422

The Idempotency-Key header is empty, longer than 255 characters or has characters other than visible ASCII.

How to fix

Send 1 to 255 visible ASCII characters, such as a UUID, and a new key for each new request.

Example response

{
  "code": "idempotency_key_invalid",
  "type": "https://docs.stoqapp.com/v2/docs/api-v2/errors/idempotency-key-invalid/",
  "title": "Idempotency key not valid",
  "status": 422,
  "detail": "Idempotency-Key is not valid. Send 1 to 255 visible ASCII characters, such as a UUID, and a new key for each new request.",
  "errors": [
    "Idempotency-Key is not valid"
  ],
  "details": [
    {
      "code": "idempotency_key_invalid",
      "message": "Idempotency-Key is not valid",
      "path": null,
      "value": null,
      "expected": null
    }
  ]
}

Every API v2 and MCP failure carries code and a type link to its page here. See Errors & Responses for the full envelope.