ErrorResponse

The JSON body returned for every non-2xx response.

errorstringrequired

Stable machine-readable code — for example RATE_LIMIT_EXCEEDED. Branch on this, not on message.

Example: RATE_LIMIT_EXCEEDED

messagestringrequired

Human-readable explanation. Safe to log, not safe to parse.

Example: Client ingestion rate limit exceeded

purpose object

oneOf

• null
• RateLimitPurpose

null

retry_after_seconds(integer | null)<int64>nullable

Integer mirror of the Retry-After header, for clients that only surface the payload. The header stays authoritative.

Possible values: >= 0

status_codeinteger<int32>required

The HTTP status, repeated in the body for clients that only surface the payload.

Possible values: >= 0

Example: 429

ErrorResponse

{
  "error": "RATE_LIMIT_EXCEEDED",
  "message": "Client ingestion rate limit exceeded",
  "purpose": "null",
  "retry_after_seconds": 0,
  "status_code": 429
}