Debugging / Status reference

Common Errors

Pick the status code you received to see what it means, whether retrying helps, and the first thing to check.

Lookup

Look up a status code

Meaning: The request was rejected before any work happened — a required field or header is missing or malformed.
Retry?: No. Fix the request.
Check first: Read the code in the error body. A missing end-user header is the most common cause for API-key callers.

Response shape

The shape of an error response

Errors carry their explanation in a detail field. Structured errors nest a stable code your client can branch on, which is safer than matching on the message text.

HTTP 400
{
  "detail": {
    "error": {
      "code": "MISSING_END_USER_ID",
      "message": "API-key and OAuth client-credentials callers MUST identify the end user …",
      "header": "X-End-User-ID"
    }
  }
}

Log the status, the code, and the request id. Do not log the request body, because it usually contains user content.

Was this page helpful?

← Previous

Debug Toolkit

Authentication Issues