Statxt API
All error codes
All error codes

idempotency_key_reused

HTTP 409Not retryable

The same `Idempotency-Key` was reused with a different request body. Use a fresh key for distinct requests.

How to resolve

  • Generate a fresh idempotency key (e.g. a UUID) for each distinct request.
  • Do not reuse a key from a previous request with a different body.

Example response

JSON

{
  "object": "error",
  "code": "idempotency_key_reused",
  "message": "The same `Idempotency-Key` was reused with a different request body. Use a fresh key for distinct requests.",
  "request_id": "req_example123",
  "docs_url": "https://docs.statxt.com/api/errors/idempotency_key_reused"
}

SDK handling

TypeScript

import { StatxtClient, StatxtApiError } from "@statxt/sdk"

const client = new StatxtClient({ apiKey: process.env.STATXT_API_KEY! })

try {
  await client.messages.send({ ... })
} catch (err) {
  if (err instanceof StatxtApiError && err.code === "idempotency_key_reused") {
    // The same `Idempotency-Key` was reused with a different request body. Use a fresh key for distinct requests.
    console.error(err.requestId) // include in support tickets
  }
}

Public reference: /docs/errors/idempotency_key_reused