Errors

Errors share one envelope and never leak internal details, SQL, or stack traces.

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Collection not found"
  }
}

Status	Code	Meaning
400	INVALID_REQUEST	Malformed parameter, cursor or filter
401	UNAUTHORIZED	Missing, malformed, expired or revoked key
403	FORBIDDEN	Key lacks the required scope, or origin not allowed
404	NOT_FOUND	No such collection, token or owner
429	RATE_LIMITED	Rate limit exceeded
503	UNAVAILABLE	Dependency unavailable; retry with backoff

Retry guidance

• Retry 429 and 503 with exponential backoff and jitter.
• Never retry 400, 401, 403 or 404 unchanged.