W W.A.L.T.Developers Main site
API error · HTTP 409

idempotency_conflict

Idempotency key reused with a different request

HTTP status409 Conflict
codeidempotency_conflict
titleIdempotency key reused with a different request
Retry?No (handle)

What it means

This Idempotency-Key was already used for a different request. The request includes the body, its media type, the acting user (WALT-Acting-User) and the credential's scopes (§5).

What to do

This is a bug in the caller. Reuse a key only to retry the same operation; generate a new key only if the operation is genuinely new (§12.4).

Example response

Branch on code, never on title or detail. detail varies; quote request_id to support.

HTTP
HTTP/1.1 409 Conflict
Content-Type: application/problem+json

{
  "type": "https://www.underwritinguk.ai/developers/errors/idempotency_conflict",
  "title": "Idempotency key reused with a different request",
  "status": 409,
  "code": "idempotency_conflict",
  "detail": "Idempotency key reused with a different request.",
  "request_id": "7b0b1e5c-2f7e-4a52-9a43-5b0d0f0e9d11"
}

All error codes · Error catalogue in the integration guide (§15) · Error handling and retries (§12.4)