Execute canonical action batch
execute_batchExecutes ordered scene actions and read operations in one atomic round-trip, applying safety checks, timeline reconciliation, and layout fixes before committing updates to a project.
Instructions
Execute an ordered array of canonical actions (and/or read tools) in a single atomic round-trip without autonomous_edit. Automatically runs safe-zone checks, timeline reconciliation, layout de-stacking, async asset completion, and commits the updated scene to project_id.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"actions": "<actions>"
},
"name": "execute_batch"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scene | No | Optional inline scene. | |
| assets | No | Optional media assets to seed a new project. | |
| actions | Yes | Ordered list of { action, params } steps to execute. | |
| video_url | No | Optional source video URL to seed a new project. | |
| project_id | No | Project id for state persistence across calls. | |
| include_scene | No | If true, include the full raw scene JSON in the response (omitted by default in favor of liveLayers). |