# Error codes

Every error.code with its meaning, status and endpoints.

| Status | error.code | Meaning | What to do | Retry as is | Charged |
| --- | --- | --- | --- | --- | --- |
| 400, 404 | `asset_not_found` | Asset is unknown, deleted or outside your team (from Check an asset, Create a video task) | Check that the asset ID belongs to your team and still exists. | No | No |
| 400 | `asset_unusable` | Asset failed, has an unsuitable media type or lacks review approval for this request (from Create a video task) | Use another asset, or one whose media type fits its role. | No | No |
| 400 | `callback_target_not_verified` | The address does not exactly match a verified, unrevoked and unexpired callback target owned by your team (from Create a video task) | Register and verify the callback address in the console, or drop `callback_url`. | No | No |
| 400 | `input_video_duration_exceeded` | Combined video input exceeds the model's duration limit (from Create a video task) | Shorten the reference videos to the model's total limit. | No | No |
| 400 | `invalid_request` | Invalid request, including too many references for the model (from Register an asset, Check an asset, Create a video task, List team tasks, Read a video task, Cancel a video task, Read task billing) | Fix the request as `error.message` describes, then send it again. | No | No |
| 400 | `source_url_not_allowed` | The source address does not meet the fetch policy (from Register an asset) | Use a public HTTPS address that the fetch policy accepts. | No | No |
| 400 | `unsupported_capability` | The available choices cannot satisfy the required capabilities together (from Create a video task) | Adjust the parameters named in `error.details`. | No | No |
| 401 | `authentication_failed` | The request could not be authenticated (from Register an asset, Check an asset, Create a video task, List team tasks, Read a video task, Cancel a video task, Read task billing) | Check the API key after `Authorization: Bearer`. | No | No |
| 403 | `permission_denied` | Required permission is missing (from Register an asset, Check an asset) | Use an API key that has `service.use` permission. | No | No |
| 404 | `task_not_found` | The task is unknown or not visible to your team (from Read a video task, Cancel a video task, Read task billing) | Check that the task ID belongs to your team. | No | No |
| 409 | `asset_not_ready` | A referenced asset is still processing (from Create a video task) | Wait until the asset is `active`, then retry with the same key and body. | After the cause is fixed | No |
| 409 | `idempotency_conflict` | The same idempotency value was used for a different request (from Register an asset, Create a video task, Cancel a video task) | Retry the original body with the same key; send a new request with a new key. | No | No |
| 409, 410 | `idempotency_replay_expired` | The saved response can no longer be replayed exactly (from Register an asset, Create a video task, Cancel a video task) | The original request was accepted: read it by ID instead of sending it again with a new key. | No | No |
| 409 | `key_provisioning_incomplete` | API key setup is incomplete; delete the key and create another (from Create a video task) | Delete this API key and create a new one. | No | No |
| 409 | `task_not_cancellable` | This finished task has no cancellation operation to refer to (from Cancel a video task) | The task has already finished; there is nothing to cancel. | No | No |
| 429 | `asset_intake_rate_limit_exceeded` | Asset intake capacity is limited (from Register an asset) | Retry later with the same key. | After the cause is fixed | No |
| 429 | `asset_storage_quota_exceeded` | Asset storage allowance is insufficient (from Register an asset, Create a video task) | The storage allowance is used up; free space or contact us before registering more. | No | No |
| 429 | `insufficient_balance` | Balance is insufficient to accept the request (from Create a video task) | Top up, then retry with the same key; `error.details` gives the reservation needed. | After the cause is fixed | No |
| 429 | `rate_limited` | The request rate is limited (from Create a video task, List team tasks, Read a video task, Cancel a video task, Read task billing) | Wait `Retry-After` seconds, then retry with the same key. | After the cause is fixed | No |
| 500 | `internal_error` | The service could not complete the request (from Create a video task, List team tasks, Read a video task, Cancel a video task, Read task billing) | Retry with the same `Idempotency-Key` and body. | Yes, same key | No; a retry is never charged twice |
| 503 | `dependency_unavailable` | The service is temporarily unavailable and the outcome is unknown (from Register an asset, Check an asset, Create a video task, List team tasks, Read a video task, Cancel a video task, Read task billing) | The outcome is unknown: retry with the same key and body. | Yes, same key | No; a retry is never charged twice |
| 503 | `funding_intake_closed` | New intake is closed (from Create a video task) | New intake is closed for now; try later. Exact replays of accepted requests still return their response. | After the cause is fixed | No |