IDEMPOTENCY_KEY_REUSED

HTTP status: 409

What it means

An Idempotency-Key was reused with a different request body.

Why it happens

• You sent an Idempotency-Key that was already used within 24 hours with a DIFFERENT request body.

How to fix it

• Use a fresh key for a new request, or resend the exact original body to replay the original response.
• Replays of the same key + same body return the original render with HTTP 200.

Example

Every non-2xx response uses the same envelope; path (when present) is the exact JSON path of the offending field, and requestId identifies the request in support conversations:

{
  "error": {
    "code": "IDEMPOTENCY_KEY_REUSED",
    "message": "This Idempotency-Key was already used with a different request body. Use a new key for new requests.",
    "docsUrl": "https://automotion.dev/docs/errors/idempotency_key_reused"
  },
  "requestId": "req_0123456789abcdef0123456789abcdef"
}

See the error index for the full catalog and the API overview for envelope semantics.