Error codes

idempotency_key_too_long

Idempotency-Key too long

HTTP 400

The Idempotency-Key header is at most 255 characters (251 on a bulk enrollment call, which appends each row's index). Longer keys are refused rather than cut, so two keys can never collide.

The problem body

Sent as application/problem+json, with the request id in request_id and the X-Request-Id header. Branch on code: the error and detail sentences can change, and some operations add members of their own.

Example problem
{
  "error": "Idempotency-Key too long",
  "code": "idempotency_key_too_long",
  "type": "https://secondappraisal.com/developers/errors/idempotency_key_too_long",
  "title": "Idempotency-Key too long",
  "status": 400,
  "detail": "Idempotency-Key too long",
  "instance": "/api/gap/v1/referrals",
  "request_id": "req_4f9a2c7e1b8d4a6f9c3e2b1a7d5f8e0c"
}

Operations that can send it