missing_idempotency_key

HTTP status: 400

Every POST, PUT, PATCH, and DELETE request must include an Idempotency-Key header. The key was absent from this request.

Why this happens

• You are calling the API directly with curl or a raw HTTP client and forgot to include the header.
• A custom HTTP middleware in your stack strips or skips the header.
• You are using an older SDK version that predates idempotency-key enforcement.

What to do

1. Add Idempotency-Key: <uuid-v4> to every mutating request. Generate a new UUID v4 per logical operation.
2. If using an SDK, upgrade to the latest version — the SDK auto-mints a key per call.
3. For raw curl calls, add -H "Idempotency-Key: $(uuidgen)".
4. For queued jobs, mint the key at enqueue time and attach it to the job payload so retries reuse the same key.

Example response

{
  "type": "https://zyins.isaapi.com/errors/missing-idempotency-key",
  "title": "Missing idempotency key",
  "status": 400,
  "detail": "Mutating requests require an Idempotency-Key header containing a UUID v4. Add the header and retry.",
  "code": "missing_idempotency_key",
  "advice_code": "add_idempotency_key",
  "param": null,
  "request_id": "req_01HZK2N5GQR9T8X4B6FJW3Y1AS"
}

SDK exceptions

See also

• Error catalog
• Idempotency guide