Errors

All errors share the same envelope:

{
  "error": {
    "code": "invalid_input",
    "message": "source_url must be an HTTPS URL",
    "request_id": "req_a1b2c3d4e5f6"
  }
}

Include the request_id (also returned in the x-request-id response header) when contacting support.

Status codes

Status	When you’ll see it
`400 invalid_input`	Body validation failed.
`401 missing_credentials`	No `Authorization` header.
`401 invalid_credentials`	Key is malformed, unknown, or revoked.
`403 insufficient_scope`	Key doesn’t have the required scope.
`404 not_found`	Video doesn’t exist or belongs to another organization.
`429 rate_limited`	RPM exceeded. Wait `retry-after` seconds.
`429 daily_ingest_limit`	Daily ingest budget exhausted.
`500 internal_error`	Eden-side problem. Retry with backoff.

404 vs 403: we return 404 when a video belongs to a different organization so we don’t reveal the existence of other partners’ content.

Code	Retry?
4xx	No — fix the request first.
429	Yes — after `retry-after` seconds.
5xx	Yes — exponential backoff with jitter, ~5 attempts.

Reasonable backoff: 1s, 2s, 4s, 8s, 16s (each with ±25% jitter).