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.