API reference

internal_error, HTTP 500

Unexpected server error.

Example response

{
  "ok": false,
  "request_id": "req_...",
  "error": {
    "code": "internal_error",
    "message": "Unexpected server error."
  }
}

Failures on the transcript endpoints additionally carry a top-level reason field and an ai_fallback hint block alongside this envelope. See the transcript failure reasons table.

Why it happens

An unexpected server-side failure while processing the request.

How to fix it

Retry once with backoff, most are transient.
If it persists, contact [email protected] with the `request_id` from the response so we can trace it.

Retryable? Yes, with backoff. Include the request_id when reporting. Every error response carries a request_id, include it when contacting support.

Related errors

upstream_unavailable , if the fault is the video platform's, it is reported as 503
rate_limited , platform blocks and throttles are 429, never 500

Next →All error codes