internal

Something broke on our side; it is logged.

Response

Every failure uses this envelope. credits_charged is 0. The message below is the default text for this code. Live messages can change, so branch on error.code.

HTTP 500Sample
{
  "ok": false,
  "error": {
    "code": "internal",
    "message": "Something broke on our side; it is logged.",
    "retryable": true
  },
  "credits_charged": 0,
  "request_id": "req_0123456789abcdef01234567"
}

Retry when error.retryable is true. If a retry-after header is present, wait that many seconds. Otherwise back off. Only rate_limited and overloaded always set that header.

What to do

  • Retry. If it keeps happening, write to [email protected] with request_id. The attempt is free.

The response header x-request-id matches request_id. The full list is on errors.