Reference
Error reference
Generated from the server’s error catalogue. A failed tool call returns isError: true and structuredContent.error with the code, message, field_path, owner, retry_policy and next_action. Always follow next_action from the reply; this table is for planning.
retry_policy values
never- Do not retry. Tell the person and stop.
after_fix- Fix the input named in field_path, then call again.
refresh_then_retry- Read the current state, then call again with fresh values.
backoff- Wait, then try again with growing pauses.
reconcile- Do not retry. Read the state first: the write may have happened.
Error codes
Not every code is listed. Codes whose text names a price, a route or a feature these pages do not cover are left out, and a newer release can add codes that are not here yet. Whatever the code, follow next_action in the reply.
| Code | Message | Who acts | What to do |
|---|---|---|---|
ADMIN_REASON_REQUIRED | Provide a reason for this admin action. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
AGENT_CONTEXT_CAP | This turn's content is too long. Shorten the request. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
AGENT_MODEL_UNAVAILABLE | The default model is not in the verified catalog. | Workspace admin |
A workspace admin must fix this in Settings. Tell the human what is missing and stop; retrying will not help. |
AGENT_NOT_CONFIGURED | An admin must pick a Gemini or OpenAI-compatible connection for planning. | Workspace admin |
A workspace admin must fix this in Settings. Tell the human what is missing and stop; retrying will not help. |
AGENT_TURN_UNCERTAIN | The previous assistant turn is still running or its result is unconfirmed; do not send a new turn yet. | Our side |
Outcome unknown. Do NOT retry or re-submit. Read the resource state with the matching read tool and decide from that. |
AGENT_TURN_UNKNOWN | The model response could not be confirmed. The turn is held as unknown to avoid a duplicate send. | Our side |
Outcome unknown. Do NOT retry or re-submit. Read the resource state with the matching read tool and decide from that. |
ANALYSIS_UNCONFIRMED | The source analysis outcome was not confirmed; it counts as spent at its reserved price. Analyze again if needed. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
APPROVAL_CONFLICT | The approval does not match this run. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
ASSET_ABANDONED | The upload was cancelled. | The agent |
The id was not found in this workspace. List resources with the matching list_* tool and use an id it returns. |
ASSET_ENTITY_CORRUPT | The asset entity is missing its type or revision. | Our side |
Not allowed for this token or resource. Do not retry; report it to the human. |
ASSET_IN_USE | The image is still used by the project. Remove it from the project and save before cancelling the upload. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
ASSET_NOT_APPROVED | The asset revision must be approved (rights confirmed) before it can be used. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
ASSET_NOT_READY | The image upload has not finished. | The agent |
Transient. Retry the SAME call with the SAME request_key after a short delay (>= 5 s, at most 3 attempts). |
ASSET_REVISION_ARCHIVED | Archived assets cannot be mapped. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
ASSET_REVISION_NOT_FOUND | The asset revision does not belong to this workspace. | The agent |
The id was not found in this workspace. List resources with the matching list_* tool and use an id it returns. |
ASSET_RIGHTS_REQUIRED | Usage rights must be confirmed (rights.confirmed or status owned/licensed). | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
ASSET_TYPE_EXISTS | This asset type key already exists in the workspace. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
ASSET_TYPE_IMMUTABLE | An entity's type cannot change. Create a new entity instead. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
ASSET_TYPE_IN_USE | Active entities still use this type. Archive them first. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
AUDIO_TTS_UNAVAILABLE | Add narration to the plan before enabling TTS. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
BATCH_CONFLICT | The batch was already issued with a different file. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
BATCH_LIMIT | The batch exceeds 250 MB; split it into smaller batches. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
BATCH_NOT_FOUND | Not all takes were found in the project. | The agent |
The id was not found in this workspace. List resources with the matching list_* tool and use an id it returns. |
BIBLE_NAME_CONFLICT | That entity name already exists in this kind. Rename it or edit the existing entity. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
BIBLE_NOT_APPROVED | Choose an approved story-bible version. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
BIBLE_NOT_AVAILABLE | Choose a non-archived story bible in the workspace. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
BIBLE_VERSION_CONFLICT | Pick exactly one approved version per entity. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
BOUNDARY_EVIDENCE_REQUIRED | Record the timestamp and evidence for identity, position, lighting and voice continuity. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
BOUNDARY_REVIEW_REQUIRED | Review and confirm the bridge frame and continuity points. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
BOUNDARY_UNAVAILABLE | The last scene has no finished source clip to take a bridge frame from. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
BRANCH_ARCHIVED | Restore the branch before selecting it. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
BRANCH_PRIMARY | Choose another primary branch first. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
BUDGET_NOT_RESERVED | There is no sufficient durable reservation yet. | Our side |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
CANDIDATE_CONFLICT | The candidate does not belong to this content/model/config or has not passed QC. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
CHAPTER_NOT_FOUND | That chapter is not in the plan; re-read the chapter list. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
CLAIMS_SOURCE_REQUIRED | Facts/claims need a source or verification document before approval. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
COMPOSITION_NOT_FOUND | The composition does not belong to this project. | The agent |
The id was not found in this workspace. List resources with the matching list_* tool and use an id it returns. |
CONFIGURATION_ERROR | The studio is being configured. Try again later. | Our side |
Transient. Retry the SAME call with the SAME request_key after a short delay (>= 5 s, at most 3 attempts). |
CONFIRMATION_EXPIRED | The preview expired. Create a new preview. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
CONFIRMATION_INVALID | The confirmation is invalid or belongs to another session. Create a new preview. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
CONFIRMATION_REQUIRED | This step (archive, review, delivery) needs confirmed=true after the human has approved it. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
CONNECTION_CHANGED | The connection changed. Create a new quote before approving. | The agent |
Call create_quote for a fresh quote, then approve_production with its quote_id and expected_content_hash (no price approval step). |
CONNECTION_DISABLED | Enable the connection before testing it. | Workspace admin |
A workspace admin must fix this in Settings. Tell the human what is missing and stop; retrying will not help. |
CONNECTION_NOT_READY | Choose a tested connection with the right capability in this workspace. | Workspace admin |
A workspace admin must fix this in Settings. Tell the human what is missing and stop; retrying will not help. |
CONTENT_BLOCKED | The request text breaks the acceptable use policy, so it did not start and nothing was charged. Edit the text and try again. | The person |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
COVERAGE_UNAVAILABLE | Split the scene or pick a model/quality with enough coverage before quoting. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
CREDENTIAL_REFERENCE_REJECTED | The credential reference does not match the intent. | Our side |
Not allowed for this token or resource. Do not retry; report it to the human. |
CSRF_REJECTED | The session changed. Reload the page. | The person |
Not allowed for this token or resource. Do not retry; report it to the human. |
CURRENT_PASSWORD_WRONG | The current password is wrong. | The person |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
DELIVERY_BLOCKED | Delivery is blocked by an open review/QC issue. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
DELIVERY_CONFLICT | The delivery was already issued with a different file. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
DELIVERY_EXPIRED | Delivery access has expired. | The person |
Not allowed for this token or resource. Do not retry; report it to the human. |
DELIVERY_MEDIA_MISMATCH | An issued package entry failed its checksum. | Our side |
Not allowed for this token or resource. Do not retry; report it to the human. |
DELIVERY_NOT_READY | The run has no QC-passed render yet. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
DELIVERY_REVOKED | Delivery access has been revoked. | The person |
Not allowed for this token or resource. Do not retry; report it to the human. |
DISPATCH_PENDING | The write is saved but the worker dispatch failed; it will be retried. Poll the read tool instead of re-submitting. | Our side |
Do NOT call the write tool again. Poll get_run_progress / get_production_state until the work starts. |
DUPLICATE_SCENE_ROLE | A scene may have only one asset per role. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
EDIT_JOB_NOT_CLAIMED | This edit job is not claimed by this executor or its state changed; read the job again. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
EDIT_NO_AUDIO | The source video has no audio track for this edit. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
EDIT_RANGE_INVALID | The time range is outside the source video. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
EDIT_RENDER_FAILED | The video edit did not render; change the parameters or try again later. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
EDIT_RESULT_INVALID | The edit result is invalid (needs a new ready MP4 asset in the same project). | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
EDIT_SOURCE_INVALID | The source video cannot be edited (needs a ready MP4 up to 10 minutes). | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
EDIT_TOOL_UNKNOWN | Unknown edit tool; see get_edit_options. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
ELEMENT_NAME_TAKEN | The element name is already used in this workspace. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
EMAIL_DELIVERY_UNAVAILABLE | Email cannot be sent yet. Try again later. | Our side |
Not allowed for this token or resource. Do not retry; report it to the human. |
EMAIL_REQUIRED | The account has no email yet. Add one first. | The person |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
EMAIL_TAKEN | This email is already used by another account. | The person |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
EMAIL_TOKEN_INVALID | The link is invalid, already used or expired. | The person |
Not allowed for this token or resource. Do not retry; report it to the human. |
EMAIL_UNCHANGED | This is already the account email. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
EMPTY_EXCEL | The Excel file has no request rows. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
EXECUTOR_UNAVAILABLE | No Local Studio hub is online for this tool; run it on the web or open the app. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
EXPAND_BUSY | Some of these scenes are already being expanded. Wait for them to finish, then send again. | The agent |
Transient. Retry the SAME call with the SAME request_key after a short delay (>= 5 s, at most 3 attempts). |
EXPLORE_NOT_READY | The project has no finished render to show how it was made. | The agent |
The id was not found in this workspace. List resources with the matching list_* tool and use an id it returns. |
EXPORT_TOO_LARGE | The export is over the size limit. Select fewer videos and export again. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
EXTENSION_CREATED | This request already created a branch; open the existing one. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
EXTENSION_DURATION | The extension duration exceeds the model limit. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
EXTENSION_ROUTE_UNSUPPORTED | Choose a first-frame route that is ready in the source's pool. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
FOLDER_ARCHIVED | The folder is archived. Restore it first. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
FOLDER_EXISTS | A folder with this name already exists in the workspace. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
FORBIDDEN | This token/mode/scope does not allow that. Ask an admin for a wider capability. | Workspace admin |
Not allowed for this token or resource. Do not retry; report it to the human. |
FRAME_CHANGED | The bridge frame is already saved and immutable. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
FRAME_NOT_READY | The bridge frame is not extracted yet. Reconfirm the request. | The agent |
Transient. Retry the SAME call with the SAME request_key after a short delay (>= 5 s, at most 3 attempts). |
GRAPH_STALE | The shot graph does not match the current plan revision. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
IDEMPOTENCY_CONFLICT | This request_key was already used with different input. Use a new request_key for a different request. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
IDEMPOTENCY_REQUIRED | A request_key (UUID) is required for this write. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
IMAGE_CONFIG_UNAVAILABLE | Image size or reference count does not fit the image model. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
IMAGE_EDIT_INVALID | The image edit parameters are invalid. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
IMAGE_EDIT_SOURCE_INVALID | The source image cannot be edited. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
IMAGE_EDIT_TOO_LARGE | The edited image would exceed 50 MB. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
IMAGE_FETCH_FAILED | The image URL could not be fetched. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
IMPORT_LIMIT | Excel is limited to 4 MB and 100 rows. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
INTENT_NOT_SUBMITTED | The intent is not allowed to submit. | Our side |
Outcome unknown. Do NOT retry or re-submit. Read the resource state with the matching read tool and decide from that. |
INVALID_ACCOUNT | Choose an AI account in this workspace. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
INVALID_ANALYSIS | The video has no style analysis yet. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
INVALID_ANCHOR | The comment anchor scene is not in the snapshot. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
INVALID_ASSET | The image path is invalid. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
INVALID_ASSETS | Library images must belong to the workspace and be fully uploaded. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
INVALID_ASSET_MEDIA | Media assets must belong to this workspace and be ready. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
INVALID_ASSET_TYPE | The type key must be a stable lowercase key. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
INVALID_BASE_RUN | The base run must be READY and belong to this project/workspace. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
INVALID_BATCH | Do not select the same delivery twice. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
INVALID_BIBLE | Scene entities must belong to the story bible approved in the plan. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
INVALID_CAPABILITY | The requested capability is not supported. | Workspace admin |
Not allowed for this token or resource. Do not retry; report it to the human. |
INVALID_COMMENTS | Duplicate comments were selected. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
INVALID_CREDENTIAL | The credential format is wrong. Check the copied key. | Workspace admin |
A workspace admin must fix this in Settings. Tell the human what is missing and stop; retrying will not help. |
INVALID_CREDENTIALS | Wrong username or password. | The person |
Session or credentials are invalid. Run initialize again with a valid API token; do not retry the call. |
INVALID_EDITS | Edit each shot only once. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
INVALID_ELEMENT_NAME | The element name is invalid (max 20 characters, used as @name). | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
INVALID_ENDPOINT | Use a public HTTPS endpoint ending in /v1. | Workspace admin |
A workspace admin must fix this in Settings. Tell the human what is missing and stop; retrying will not help. |
INVALID_EXCEL | Invalid Excel. Use the .xlsx template, max 100 rows. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
INVALID_FACT | The selected fact is invalid. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
INVALID_FOLDER | The folder name must not be empty. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
INVALID_FRAME | The frame does not belong to this bridge request. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
INVALID_GRANT | The OAuth grant is no longer available. | The person |
Session or credentials are invalid. Run initialize again with a valid API token; do not retry the call. |
INVALID_IMAGE | The image is invalid or over 20 megapixels. Use JPG, PNG or WebP. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
INVALID_INPUT | An argument is missing or invalid; see field_path. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
INVALID_MAPPING | Each mapping must be an object. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
INVALID_MODEL | Choose a text model from the catalog. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
INVALID_NODE | The scene/task changed; pick a candidate of the current revision. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
INVALID_PACKAGE | The file list does not match the approved manifest. | Our side |
Not allowed for this token or resource. Do not retry; report it to the human. |
INVALID_PARENT | The parent branch is unavailable. | The agent |
The id was not found in this workspace. List resources with the matching list_* tool and use an id it returns. |
INVALID_PATCH | The patch is not valid; check the fields and values, then call again. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
INVALID_REFERENCES | The proposal contains images outside the project snapshot. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
INVALID_REFERENCE_ROLES | Reference roles must map to the exact scene images without duplicates. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
INVALID_RENDITIONS | Pick each extra ratio once, different from the main ratio. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
INVALID_RESULT | The operation reference is invalid. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
INVALID_SHOT | The scene is not part of the current plan. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
INVALID_SOURCE | The approved source asset is no longer available. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
INVALID_SPEAKER | The speaker must belong to the scene's characters or voices. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
INVALID_STATE | The intent does not accept a new result in its current state. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
INVALID_STYLE | The source has no video style to apply. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
INVALID_UPLOAD | The image does not match the registered upload. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
INVALID_VIDEO | Only MP4 video is accepted. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
INVALID_YOUTUBE_URL | Use a public YouTube or Shorts link. | The agent |
Provide the content another way: get_source_upload_info then upload an authorized MP4, or create_source with kind=text and pasted content. |
INVITATION_INVALID | The invitation is invalid or expired. | The person |
Not allowed for this token or resource. Do not retry; report it to the human. |
INVITATION_WRONG_ACCOUNT | Sign in with the invited account. | The person |
Not allowed for this token or resource. Do not retry; report it to the human. |
KEYFRAMES_NOT_PLANNED | No shot needs an opening still made first (no images attached, or the attached image is used as is). Quote phase full, or attach reference images or keyframes to an ai_video shot. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
KEYFRAME_CHAIN_UNAVAILABLE | A chained first frame needs an ai_video shot immediately before it; change the frame source or shot order. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
KEYFRAME_QC_FAILED | The keyframe failed automatic checks (ratio, size or blank image), so its clip was not started; regenerate the still (keyframes phase, or quote the run again on the reference-to-video route). | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
KEYFRAME_RATIO_MISMATCH | The first-frame image does not match the video ratio; crop to the exact ratio or regenerate the image. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
KEYFRAME_REFERENCE_UNSUPPORTED | Keyframes accept image references only and cannot be combined with V2V video references. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
KEYFRAME_ROLE_UNSUPPORTED | The selected video model does not support mid/last keyframes; use only the first frame or pick a multi-frame model. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
KEYFRAME_TOO_SMALL | The first-frame image is too small; the short side must be at least 480 px. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
LANGUAGE_CONFLICT | The AI did not keep the chosen narration language. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
LEASE_REJECTED | The worker does not hold the intent lease. | Our side |
Not allowed for this token or resource. Do not retry; report it to the human. |
LEGAL_ACCEPTANCE_REQUIRED | Accept the Terms of Service and the Privacy Policy to continue. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
LEGAL_DOC_UNKNOWN | Unknown legal document. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
LIBRARY_KIND_CONFLICT | Each project picks one brand, one product and one character. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
LIBRARY_NOT_APPROVED | Choose an approved, non-archived version in the workspace. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
LIBRARY_REFERENCES_REMOVED | The library version's images were removed from the project. Re-apply before planning. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
LOCALE_COVERAGE | Each scene needs exactly one translation and subtitle. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
LOCALE_NATIVE_AUDIO | A translation uses new narration; source audio with untranslated speech must be handled. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
LOCALE_TRANSCRIPT_MISSING | Keep silent scenes and fill the translation for every narrated scene. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
LOCALE_VOICE_UNSUPPORTED | Choose a Gemini voice for translations; VieNeu has Vietnamese presets only. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
LOCKED_TAKE_CONFLICT | The take is locked in the plan. Save the edit before changing takes. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
MANUAL_PROMPT_SEGMENTED | A manual prompt is one text for the whole shot and cannot be split into segments; shorten the shot to the route duration cap or use the structured prompt. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
MARKET_NOT_AVAILABLE | The Studio does not sell in that country yet. Pick a country from the list. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
MCP_DEFAULT_MODEL_NOT_READY | The default MCP video model is not ready and no fallback was selected. | Workspace admin |
A workspace admin must fix this in Settings. Tell the human what is missing and stop; retrying will not help. |
MCP_VIDEO_MODEL_NOT_READY | The requested video model is not selectable or its production canary is not verified. Call list_video_models and pick a selectable model. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
MCP_VIDEO_MODEL_RATIO_UNSUPPORTED | The selected video model does not support that ratio. Call list_video_models for its ratios. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
MEDIA_BATCH_EMPTY | The table has no rows to turn into clips. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
MEDIA_BATCH_LIMIT | The workspace already has the maximum number of running batches. Wait for one to finish or cancel one, then start again. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
MEDIA_BATCH_NOT_FOUND | This clip batch was not found in this workspace. | The agent |
The id was not found in this workspace. List resources with the matching list_* tool and use an id it returns. |
MEDIA_BATCH_ROW_INVALID | Some rows are invalid; see details.rows, fix the file and send it again. Nothing was created or charged. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
MEDIA_BATCH_STATE | The batch or item is in a state that does not allow this action. Read the batch state again. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
MEDIA_BATCH_TOO_LARGE | The table is too large: at most 100 rows per batch. Split the file and send it again. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
MEDIA_NOT_READY | The media task is not finished yet. | The agent |
Transient. Retry the SAME call with the SAME request_key after a short delay (>= 5 s, at most 3 attempts). |
MEDIA_QUOTE_USED | This quote was already used. Read the task state instead of generating again. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
MEDIA_RESULT_INVALID | The worker result does not match the task. Read the state again; do not resubmit. | Our side |
Outcome unknown. Do NOT retry or re-submit. Read the resource state with the matching read tool and decide from that. |
MODEL_UNAVAILABLE | The model is disabled or no longer in the pool. Edit the plan before quoting. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
MODE_FORBIDS_TOOL | This token's mode does not permit that tool (plan_only < interactive < execute). Ask the human for a token with a higher mode. | Workspace admin |
Your token mode does not permit this tool. Tell the human which mode is needed (plan_only < interactive < execute) and stop. |
NATIVE_AUDIO_UNSUPPORTED | Native audio needs a scene generated by a model that supports audio. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
NOTHING_TO_EXPAND | No scene in this scope is waiting to be expanded. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
NOTHING_TO_OUTLINE | No chapter in this scope is waiting for its scene lines. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
NOT_FOUND | The resource was not found in this workspace. | The agent |
The id was not found in this workspace. List resources with the matching list_* tool and use an id it returns. |
NOT_PAUSED | The run is not waiting for credit/connection. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
NOT_READY | The batch has not been issued yet. | The agent |
Transient. Retry the SAME call with the SAME request_key after a short delay (>= 5 s, at most 3 attempts). |
NO_CHANGES | Edit the approved plan before proposing a branch. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
NO_PROVIDER_REQUIRED | Reuse tasks must not read the provider key. | The agent |
Not allowed for this token or resource. Do not retry; report it to the human. |
NO_SAFE_RETRY | There is no stopped task to resume. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
ORIGIN_REJECTED | The request must come from the Studio. | The person |
Not allowed for this token or resource. Do not retry; report it to the human. |
OUTLINE_INVALID | The outline cannot be assembled, or the scene count does not fit the fixed duration. Change scene_count or the duration, then plan a new outline. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
OUTLINE_NOT_READY | The outline is not ready to approve yet. Wait for the AI to finish or ask for a new outline. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
OVERRIDE_CONFLICT | The AI proposed changing a duration you chose. The proposal is held for review. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
PATCH_OUT_OF_SCOPE | The proposal edits a scene outside the Canvas selection. Patch only scenes in scope. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
PLANNING_BUSY | The AI is still processing the previous request. | The agent |
Transient. Retry the SAME call with the SAME request_key after a short delay (>= 5 s, at most 3 attempts). |
PLANNING_NOT_CONFIGURED | Ask an admin to choose the planning connection in Settings. | Workspace admin |
A workspace admin must fix this in Settings. Tell the human what is missing and stop; retrying will not help. |
PLAN_REQUIRED | Propose a storyboard from the project brief before opening the document set. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
PLATFORM_FORBIDDEN | Only platform staff may do this. | Workspace admin |
Not allowed for this token or resource. Do not retry; report it to the human. |
PROJECT_ARCHIVED | Restore the root project before editing branches. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
PROJECT_MISMATCH | The source does not belong to the selected project. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
PROMPT_AUDIO_UNSUPPORTED | This model does not generate native audio. Use separate TTS/music or choose another model. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
PROMPT_IMPORT_EMPTY | Paste the manual prompt before reading it into structure. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
PROMPT_MODE_CHANGED | The input mode differs from the approved route. | The agent |
Call create_quote for a fresh quote, then approve_production with its quote_id and expected_content_hash (no price approval step). |
PROMPT_MODE_UNSUPPORTED | Video conditioning is not verified for this model revision. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
PROMPT_REFERENCES_UNSUPPORTED | A video route needs one image, video conditioning, or no image. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
PROMPT_ROUTE_CHANGED | The compiled prompt does not match the approved route. | The agent |
Call create_quote for a fresh quote, then approve_production with its quote_id and expected_content_hash (no price approval step). |
PROMPT_ROUTE_UNSUPPORTED | No approved compiler exists for this model or input mode. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
PROMPT_SNAPSHOT_CHANGED | The compiled prompt does not match the approved snapshot. | The agent |
Call create_quote for a fresh quote, then approve_production with its quote_id and expected_content_hash (no price approval step). |
PROMPT_TOO_LONG | The director prompt exceeds the route character limit (8000; about 3600 for LTX); shorten it before quoting. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
PROVIDER_JOB_TIMEOUT | The provider did not return a result before the deadline; this attempt counts as spent at its reserved price. Resume under the same approval (max 3 attempts) or edit the plan. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
PROVIDER_POLL_FAILED | The job status could not be read after repeated attempts; this attempt counts as spent at its reserved price. Resume under the same approval (max 3 attempts) or edit the plan. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
PROVIDER_REJECTED | The provider rejected the task; the reservation was released. Change the input and create a new quote. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
PROVIDER_REPLY_UNKNOWN | The provider did not reply; this attempt counts as spent at its reserved price. Send the request again if needed. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
QC_BLOCKING | A blocking QC issue must be resolved first. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
QC_REQUIRED | Complete all 8 QC groups before approving. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
QC_UNRESOLVED | Blocking issues need a recorded resolution before approval. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
QUEUE_DEADLINE_EXPIRED | The job waited in queue past its deadline and was not submitted. Create a new quote to try again. | Our side |
Call create_quote for a fresh quote, then approve_production with its quote_id and expected_content_hash (no price approval step). |
QUOTE_EXPIRED | The quote is no longer valid. Create a new quote before approving. | The agent |
Call create_quote for a fresh quote, then approve_production with its quote_id and expected_content_hash (no price approval step). |
RATE_LIMITED | Too many attempts. Try again later. | Our side |
Transient. Retry the SAME call with the SAME request_key after a short delay (>= 5 s, at most 3 attempts). |
RATIONALE_REQUIRED | Provide a rationale of at most 1,000 characters. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
REASON_REQUIRED | Provide the reason for creating these takes. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
REFERENCE_REQUIRED | A product needs an original image with the product role. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
REFERENCE_ROLE_CONFLICT | Each reference may have only one role in a scene. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
REFERENCE_ROLE_UNSUPPORTED | The binding does not pass media to the model; drop use_media or attach the image directly. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
REFERENCE_SHEET_REQUIRED | A character needs front, left, right, back and full-body images. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
REGENERATE_REASON_REQUIRED | Provide a regeneration reason before quoting. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
RETRY_LIMIT_REACHED | The 3-attempt limit was reached. Edit the plan or change the model, then run again. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
REUSE_CHANGED | The visual master or source stem changed; create a new quote. | The agent |
Call create_quote for a fresh quote, then approve_production with its quote_id and expected_content_hash (no price approval step). |
REVERSE_NOT_READY | The source video is not analyzed yet. Analysis is paid and runs immediately (no price approval): call analyze_source. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
REVIEW_NOT_ALLOWED | The result is already reviewed or not submitted. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
REVIEW_NOT_OPEN | No review round is open for this run. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
REVIEW_NOT_READY | The render has not passed technical QC yet. | The agent |
Transient. Retry the SAME call with the SAME request_key after a short delay (>= 5 s, at most 3 attempts). |
REVISION_CONFLICT | The composition changed since the preview. Create a new preview. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
RIGHTS_REQUIRED | Confirm usage rights; characters need consent to use their likeness. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
RIGHTS_REVOKED | Delivery rights are unavailable. | The person |
Not allowed for this token or resource. Do not retry; report it to the human. |
RIGHTS_SOURCE_REQUIRED | Record the rights source or consent document before approval. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
SAFETY_PATTERN_UNSAFE | The pattern cannot be used: it is too long, empty or could run very slowly. Write a simpler pattern. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
SAFETY_TERM_EXISTS | This pattern is already in the list. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
SCENE_LAST | A plan needs at least one scene; the last scene cannot be deleted. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
SCENE_LIMIT | The plan reached the maximum number of scenes. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
SCENE_LINT_FAILED | The Nexus or manual scene prompt has a blocking lint error (over the character budget, face-covering word, stale tag, unbound @img/@vid reference or banned element); run compile_scene_prompt. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
SCENE_NOT_FOUND | The scene or position is not in the current plan; re-read the scene count. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
SEGMENT_PLAN_UNAVAILABLE | The route length limit is too short to split the shot into segments. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
SEGMENT_SPEECH_UNSPLITTABLE | The long shot cannot be split without cutting its native dialogue; shorten the dialogue or choose a longer route. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
SEGMENT_TAKE_UNSUPPORTED | This shot is split into segments; pick takes per segment (video:shot:sN), not for the whole shot. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
SELFHOST_JOB_FAILED | The GPU server could not make the clip; the reservation was released. Quote again and retry. | Our side |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
SELFHOST_LICENSE_DISCLOSURE_REQUIRED | Complete the legal-entity, serving-region and brand-relationship disclosure first. | Workspace admin |
A workspace admin must fix this in Settings. Tell the human what is missing and stop; retrying will not help. |
SELFHOST_NOT_READY | The self-hosted model is not ready (readiness tier below requirement). | Workspace admin |
A workspace admin must fix this in Settings. Tell the human what is missing and stop; retrying will not help. |
SELFHOST_V2V_TOO_LONG | The V2V clip exceeds this route limit (LTX 2.5 Turbo allows at most 20 s). Shorten the shot or pick another route. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
SHARE_LINK_EXPIRED | This share link has expired, was revoked or the video is gone. Ask for a new link. | The person |
Not allowed for this token or resource. Do not retry; report it to the human. |
SHOT_COVERAGE_CONFLICT | Split scenes by model coverage; the total duration is kept. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
SHOT_VOICE_MODEL_MISMATCH | The scene voice does not belong to the quote's voice_model. Call list_voices. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
SOURCE_CONTENT_TYPE | The source file type is not supported. | The agent |
Provide the content another way: get_source_upload_info then upload an authorized MP4, or create_source with kind=text and pasted content. |
SOURCE_FETCH_FAILED | The source could not be fetched; check the URL or paste the content. | The agent |
Provide the content another way: get_source_upload_info then upload an authorized MP4, or create_source with kind=text and pasted content. |
SOURCE_IMMUTABLE | The source was already analyzed; create a new source before replacing the video. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
SOURCE_LIMIT | Reference videos are limited to 200 MB. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
SOURCE_NEEDS_UPLOAD | The source blocks access; paste the content or upload an authorized file. | The agent |
Provide the content another way: get_source_upload_info then upload an authorized MP4, or create_source with kind=text and pasted content. |
SOURCE_NOT_READY | Wait for the source to be fetched or uploaded before analyzing. | The agent |
Transient. Retry the SAME call with the SAME request_key after a short delay (>= 5 s, at most 3 attempts). |
SOURCE_PROVENANCE_REQUIRED | Scenes using source facts/style must record provenance. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
SOURCE_REDIRECT_LIMIT | The source redirected more than 3 times. | The agent |
Provide the content another way: get_source_upload_info then upload an authorized MP4, or create_source with kind=text and pasted content. |
SOURCE_REQUIRED | Paste the content to analyze. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
SOURCE_UPLOAD_STATE | Upload video only for sources that are not analyzed yet. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
SPEAKER_VOICE_UNSUPPORTED | The character's voice is not in the deployed voice list. Call list_voices. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
STALE_BATCH | The batch quote changed. Reload before approving. | The agent |
Call create_quote for a fresh quote, then approve_production with its quote_id and expected_content_hash (no price approval step). |
STALE_BOUNDARY | The source content does not match. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
STALE_CONTENT | The project brief changed. Update the plan before proposing. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
STALE_LOCALE | The source content changed. Reload the transcript before creating a locale. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
STALE_REVISION | Context or composition changed. Call read_external_context and resubmit against the new revisions. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
STALE_SOURCE | The source snapshot changed. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
STALE_TAKE | The plan changed. Pick the take again. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
STORAGE_UNAVAILABLE | Storage could not be confirmed. Retry the same request_key. | Our side |
Transient. Retry the SAME call with the SAME request_key after a short delay (>= 5 s, at most 3 attempts). |
SUBMISSION_UNKNOWN | The provider did not confirm the request; this attempt counts as spent at its reserved price. Resume under the same approval (max 3 attempts) or edit the plan. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
SUBTITLE_TRANSLATION_REQUIRED | The plan needs subtitle text in the chosen language. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
SUPPORT_RATE_LIMITED | You are sending too quickly. Wait a few minutes and try again. | The person |
Transient. Retry the SAME call with the SAME request_key after a short delay (>= 5 s, at most 3 attempts). |
SUPPORT_TICKET_CLOSED | This support ticket is closed. Open a new ticket if you need more help. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
TAKES_UNSUPPORTED | A scene that keeps the original image has no model takes to compare. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
TAKE_SEGMENTED | This is only one segment of a split shot; segments cannot be locked individually. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
TAKE_UNAVAILABLE | A take must be finished and belong to the project or a verified source branch. | The agent |
Re-read current state (read_external_context, get_studio_state or get_production_state), then redo the step against the fresh revision with a NEW request_key. |
TASK_MODEL_UNAVAILABLE | Choose a connection with the right provider for image/TTS/music in Settings. | Workspace admin |
A workspace admin must fix this in Settings. Tell the human what is missing and stop; retrying will not help. |
TEMPLATE_FIELDS_INVALID | A template field value is missing or invalid; see field_path. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
TEMPLATE_INVALID | The template is not valid: check its fields, prompt and field placeholders. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
TEMPLATE_NOT_FOUND | The template was not found or is not published. | The agent |
The id was not found in this workspace. List resources with the matching list_* tool and use an id it returns. |
TEMPLATE_SLUG_TAKEN | This template slug is already taken; choose another. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
TOKEN_CONCURRENCY_LIMIT | This API token already runs its maximum number of concurrent paid jobs. Wait for one to finish, then retry. | The agent |
Transient. Retry the SAME call with the SAME request_key after a short delay (>= 5 s, at most 3 attempts). |
TOKEN_LIMIT | The narration exceeds the approved token ceiling. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
TOKEN_NOT_ROTATABLE | This API token is revoked or expired, so its secret cannot be rotated. Create a new token. | Workspace admin |
A workspace admin must fix this in Settings. Tell the human what is missing and stop; retrying will not help. |
TOKEN_RATE_LIMITED | This API token made too many calls this minute. Wait for Retry-After, then retry. | The agent |
Transient. Retry the SAME call with the SAME request_key after a short delay (>= 5 s, at most 3 attempts). |
TOKEN_SPEND_CAP_REACHED | This API token reached its spend cap for the period. Running jobs continue; an admin can raise the cap on the Developers page. | Workspace admin |
A workspace admin must fix this in Settings. Tell the human what is missing and stop; retrying will not help. |
TOOL_NOT_ALLOWED | That tool is not available. Call tools/list for the tools your token may use. | The agent |
Not allowed for this token or resource. Do not retry; report it to the human. |
TRANSCRIPT_REQUIRED | Approve the translation and subtitles before creating a locale. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
TRANSITION_COVERAGE_UNAVAILABLE | Shot plus transition handle exceeds model coverage; shorten the shot or handle. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
TRIAL_ALREADY_USED | This email has already received a trial. Each email gets one trial. | The person |
Not allowed for this token or resource. Do not retry; report it to the human. |
TRIAL_EXHAUSTED | The trial credit is used up. Add funds or choose a plan to keep creating videos. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
TRIAL_EXPIRED | The trial has ended. Add funds or choose a plan to keep creating videos. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
TTS_UNAVAILABLE | An admin must verify a connection with Gemini 3.8 Flash TTS. | Workspace admin |
A workspace admin must fix this in Settings. Tell the human what is missing and stop; retrying will not help. |
UNAUTHENTICATED | Please sign in to continue. For MCP, run initialize again with a valid API token. | The person |
Session or credentials are invalid. Run initialize again with a valid API token; do not retry the call. |
UNKNOWN_OPERATION | The operation is not supported. | The agent |
Not allowed for this token or resource. Do not retry; report it to the human. |
UNSAFE_IMAGE_URL | Image URLs must be public HTTPS without credentials. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
UNSAFE_SOURCE_URL | Only public HTTP/HTTPS URLs on ports 80/443 without login. | The agent |
Provide the content another way: get_source_upload_info then upload an authorized MP4, or create_source with kind=text and pasted content. |
UPLOAD_LIMIT | Each image is limited to 50 MB. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
UPLOAD_MISMATCH | The video size or checksum does not match. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
USAGE_RANGE_INVALID | Choose a valid date range: from and to as YYYY-MM-DD, from not after to, at most 400 days. | The person |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
USERNAME_TAKEN | This username is already taken. | The person |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
V1_CURSOR_INVALID | The cursor is not valid. Send next_cursor from the previous page unchanged, or omit it. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
V1_IDEMPOTENCY_KEY_REQUIRED | Idempotency-Key is missing: send 8 to 200 printable characters, one key per request. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
VAULT_UNAVAILABLE | The assistant connection is not ready. | Our side |
Transient. Retry the SAME call with the SAME request_key after a short delay (>= 5 s, at most 3 attempts). |
VIDEO_CLIP_REFERENCE_INVALID | The reference image cannot be used for a clip. Pick another image in this workspace. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
VIDEO_CLIP_ROUTE_UNAVAILABLE | No clip route is ready for this choice. Pick another route or ask an admin to enable one. | Workspace admin |
A workspace admin must fix this in Settings. Tell the human what is missing and stop; retrying will not help. |
VIDEO_DELETED | This video is in the Deleted list; restore it on the Videos page before using it again. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
VIDEO_IN_USE | This video is still in use (a delivery, a locked take, a review, a timeline, an unfinished run, a saved library version or another project), so nothing was deleted. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
VIDEO_REFERENCES_UNSUPPORTED | Each V2V scene accepts one source video. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
VIDEO_RESTORE_EXPIRED | The restore window has ended for at least one selected video, so nothing was restored. | The person |
Not allowed for this token or resource. Do not retry; report it to the human. |
VIENEU_INPUT_UNSUPPORTED | VieNeu preset: max 5000 characters per scene; remove pronunciation/style/pace. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
VIENEU_LANGUAGE_UNSUPPORTED | VieNeu currently supports Vietnamese narration only. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
VIENEU_ROUTE_CHANGED | The VieNeu contract changed; create a quote and approve again. | The agent |
Call create_quote for a fresh quote, then approve_production with its quote_id and expected_content_hash (no price approval step). |
VOICE_SEGMENT_REQUIRED | Split narration into scenes under 160 seconds to keep the token cap; keep the total duration. | The agent |
Edit the storyboard/composition to satisfy the message, resubmit it with submit_external_composition, then create a new quote. |
WEBHOOK_ENDPOINT_DISABLED | This webhook endpoint is turned off. Turn it on before sending a test or a replay. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
WEBHOOK_EVENT_UNKNOWN | The event type is not in the supported list. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
WEBHOOK_LIMIT_REACHED | This workspace has reached its webhook endpoint limit. Delete one and try again. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
WEBHOOK_NOT_FOUND | This webhook was not found in the workspace. | The agent |
Not allowed for this token or resource. Do not retry; report it to the human. |
WEBHOOK_RATE_LIMITED | This endpoint already has too many test or replay sends waiting. Wait a few seconds and try again. | The person |
Transient. Retry the SAME call with the SAME request_key after a short delay (>= 5 s, at most 3 attempts). |
WEBHOOK_URL_REFUSED | The webhook URL is refused: only https to a public address is accepted, and redirects are not followed. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
WORKER_LOST_AFTER_SUBMIT | The worker stopped after submitting the job; this attempt counts as spent at its reserved price. Resume under the same approval (max 3 attempts) or edit the plan. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
WORKER_REPLY_UNKNOWN | The worker did not return a result; this attempt counts as spent at its reserved price. Send the request again if needed. | The person |
Stop and ask the human to confirm or decide. Never set confirmed=true on their behalf. |
WORKSPACE_FORBIDDEN | The folder does not belong to the project's workspace. | The agent |
Not allowed for this token or resource. Do not retry; report it to the human. |
WORKSPACE_REQUIRED | workspace_id or project_id is required. | The agent |
Fix the argument(s) named in field_path/message, then call the same tool again (with a NEW request_key if the tool takes one). |
WORKSPACE_SUSPENDED | This workspace is suspended, so new paid work cannot start. Sign-in, reads and downloads still work; contact support. | Workspace admin |
Not allowed for this token or resource. Do not retry; report it to the human. |
WRITE_OUTCOME_UNKNOWN | The server could not confirm whether the write was saved. Do not retry; read the current state first. | Our side |
Outcome unknown. Do NOT retry or re-submit. Read the resource state with the matching read tool and decide from that. |