API reference

invalid_request — HTTP 400

Body failed validation - see error.issues.

Example response

{
  "ok": false,
  "request_id": "req_...",
  "error": {
    "code": "invalid_request",
    "message": "Body failed validation - see error.issues."
  }
}

Why it happens

  • The JSON body is malformed or missing a required field (e.g. `video`, `url`, `query`).
  • A field has the wrong type — `limit` as a string, `videoIds` not an array.
  • `limit` is out of range, or `videoIds` has more than 50 entries.

How to fix it

  • Read the `error.issues` array in the response — it names the exact field and constraint that failed.
  • Compare your body against the request example in the endpoint's docs page.
  • Send `Content-Type: application/json` and valid JSON (no trailing commas).
Retryable? Only after correcting the body — the same body will fail the same way. Every error response carries a request_id — include it when contacting support.
Next →All error codes
invalid_request (HTTP 400) · TranscriptFetch API error