Errors

idempotency_conflict

409 Idempotency key reused. The Idempotency-Key was used in the last 24 hours with a different request.

Open in Claude Open in ChatGPT .md

Status	Code	Retry?
409 Idempotency key reused	`idempotency_conflict`	After fixing it

What it means

The Idempotency-Key was used in the last 24 hours with a different request. A key stands for one request.

Common causes

The same key was sent with a different body or to a different path.

What to do

This Idempotency-Key was used in the last 24 hours with a different request. Use a new key for a new request.

Can I retry it?

Only after you fix what the message names. Until then the same request gets the same answer.

What the answer looks like

Response409

{
  "error": {
    "code": "idempotency_conflict",
    "message": "This Idempotency-Key was used with a different request.",
    "hint": "This Idempotency-Key was used in the last 24 hours with a different request. Use a new key for a new request.",
    "doc_url": "https://usebluebot.com/docs/errors/idempotency_conflict",
    "request_id": "req_1Hq2LxW9cVbN3mKpRtYs0a"
  }
}

Branch on code, which never changes. message and hint are written for people and may be reworded. Quote request_id when you write to support.

Errors: the envelope and every code
Idempotency: retrying without sending twice
Limits: every cap and what happens when you reach it