Execute canonical editor action
execute_actionRun any canonical editor action or inspection tool directly on a project scene, and bootstrap a new project by passing a video URL or assets on the first call.
Instructions
Execute any single canonical editor action (all 189+ actions) or read/inspection tool (list_layers, inspect_layer, query_transcript, list_sources, search_shots, shot_timeline, read_source_transcript, measure_audio, measure_picture, measure_color) directly on a project scene without autonomous_edit. Pass video_url or assets on the first call to bootstrap a new project.
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": {
"action": "<action>"
},
"name": "execute_action"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scene | No | Optional inline scene. | |
| action | Yes | Canonical action name (e.g. REGISTER_REMOTE_ASSET, SET_SOURCE_RANGE, TRIM_LAYER, REMOVE_SILENCES, CONFIGURE_CANVAS, VERTICAL_REFRAME, COLOR_GRADE, APPLY_VFX, TITLE_CARD, PLAN_MOTION_GRAPHICS, GENERATE_CAPTIONS, STYLE_CAPTIONS, CLEAN_AUDIO, GENERATE_VOICEOVER, GENERATE_MUSIC, ADD_SFX, AUTO_DUCK, RENDER_PREVIEW, EXPORT_VIDEO) or read tool name (e.g. list_layers, query_transcript). | |
| assets | No | Optional media assets to seed a new project. | |
| video_url | No | Optional source video URL to seed a new project. | |
| project_id | No | Project id for state persistence across calls. | |
| action_params | No | Parameters for the canonical action (see get_action_schema). | |
| include_scene | No | If true, include the full raw scene JSON in the response (omitted by default in favor of liveLayers). |