API reference/Error codes

Error codes

Two separate things fail: the HTTP call, and the job. They have different codes.

HTTP statuses

Code

When

400Malformed body, or a schema that cannot be turned into a template.

401Missing or unknown API key.

402No credits left in the workspace, or its hard cap has been reached.

404No such job, or it belongs to another workspace. The two are deliberately indistinguishable.

409An Idempotency-Key was reused with a different body.

429Over the plan’s rate limit. Honour Retry-After.

5xxOurs. Retry with backoff; nothing was charged.

The body carries a machine-readable shape: { "error": { "code", "message" } }.

These arrive on a job that reached failed, in its error field. None of them are charged.

Code

Meaning

Retry

no_captionsNo caption track we can read. There is no fallback.No

video_unavailablePrivate, deleted or region-blocked.No

schema_invalidColumns could not be validated against what came back.No

captions_fetch_failedUpstream caption fetch failed or timed out.Yes

internal_errorOurs. Worth retrying once.Yes