Errors
The error envelope and status codes.
Errors return a stable JSON envelope:
{ "error": { "code": "invalid_request", "message": "Provide exactly one of `storagePath` or `url`." } }Codes
| HTTP | code | When |
|---|---|---|
| 401 | unauthorized | Missing, malformed, invalid, or revoked API key. |
| 402 | payment_required | Not enough minutes to start the job. |
| 403 | forbidden | Not permitted. |
| 404 | not_found | No such transcription (or not yours). |
| 409 | conflict | Conflicting state. |
| 422 | invalid_request | Invalid body, bad URL, or both/neither ingest modes given. |
| 429 | rate_limited | Rate limit or concurrency limit exceeded. |
| 500 | internal_error | Something went wrong on our side. |
Always branch on the code field rather than the human-readable message, which may
change.