Delete layer
delete_layerPermanently delete one or more named layers from a committed project scene; optionally close timeline gaps for a single layer. Selector-based and empty-project deletions are refused.
Instructions
Deterministic edit: permanently delete one or more named layers of a project, committed immediately. close_gap: true ripples the timeline closed and works with a single layer_id only. Selectors such as "all" or "@…" are refused, and so is a delete that would leave the project empty. To hide a layer temporarily use update_layer with {"visible": false} instead.
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>"
},
"name": "delete_layer"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| layer_id | No | One layer to delete. | |
| close_gap | No | Ripple later layers left to close the gap (single layer_id only). | |
| layer_ids | No | Several layers to delete (alternative to layer_id). | |
| project_id | Yes | Project whose committed scene is edited. |