NowgateDocs

idempotency_key_reused

The Idempotency-Key was already used for a different request.

On this page

HTTP status: 422 Unprocessable Entity. Retrying the same request unchanged fails the same way.

Why it happens

  • The same key was sent with a different body, method or path.
  • Keys are remembered for at least 24 hours (currently 7 days).

What to do

Use a new key for a new request. Reuse a key only to retry exactly the same request.

Example

The response is application/problem+json. Branch on code, never on title or detail. See errors for the format.

{
  "type": "https://docs.nowgate.io/errors/idempotency_key_reused",
  "title": "Unprocessable Entity",
  "status": 422,
  "detail": "What exactly was wrong, in a sentence.",
  "instance": "/v1/payments",
  "code": "idempotency_key_reused",
  "request_id": "req_01jc3xb1n6f0q2w8e4r7t5y9v3"
}