Skip to main content

idempotency.missing

HTTP Status: 400 Category: Idempotency

When you see this​

Mutating request without X-Idempotency-Key header.

How to fix it​

Add X-Idempotency-Key: <UUIDv4 or ULID> to every POST and PATCH. Keys are scoped per-agency for 24 hours.

Example response​

{
  "error": {
    "code": "idempotency.missing",
    "message": "Mutating request without X-Idempotency-Key header.",
    "hint": null,
    "doc_url": "https://docs.valara.cloud/api-reference/errors/idempotency.missing",
    "request_id": "req_01H...",
    "details": {
      "errors": [],
      "field_count": 0
    }
  }
}