Errors / idempotency_key_reused

Idempotency key already used

HTTP 409invalid_requestidempotency_key_reused

That Idempotency-Key was already used for a different request: another recipient, body or mode.

What to do

An Idempotency-Key identifies one request. Retrying the SAME request with the same key is safe and returns the original message; a different request needs a new key.

What it looks like

{
  "error": {
    "type": "invalid_request",
    "code": "idempotency_key_reused",
    "message": "…",
    "doc_url": "https://docs.textmast.com/errors/idempotency_key_reused",
    "request_id": "req_01j8xk2p7n4qc3m9v0wz5bt6ay"
  }
}

Quote the request_id if you get in touch. It is on every response, including this one, and it turns a support email into a single log query rather than an archaeology exercise.