Update layer
update_layerSet layer properties such as position, scale, opacity, visibility, or timeline window on an existing project layer to commit changes immediately without a planner or export.
Instructions
Deterministic edit: set registry properties on one existing layer of a project, committed immediately (no planner, no export). E.g. {"x": 540, "y": 960}, {"scale": 1.2}, {"opacity": 0.5}, {"volume": 0.3}, {"visible": false}, {"z_index": 4}, or its timeline window {"start_time": 2, "end_time": 8}. Unknown keys are ignored, and an update that changes nothing is an error (NO_CHANGE). Not for keyframed animation (use autonomous_edit), and not "text" on a caption group (refused: it would overwrite every caption). Get layer ids from get_project (project.scene.layers[].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": {
"project_id": "<project_id>",
"layer_id": "<layer_id>",
"properties": "<properties>"
},
"name": "update_layer"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| layer_id | Yes | Id of the layer to change. | |
| project_id | Yes | Project whose committed scene is edited. | |
| properties | Yes | Layer property keys to values (non-empty). |