Delete one element by id
delete_elementRemove an element by ID from a composition, even if nested inside a group or mask. Keeps at least one top-level element in the project.
Instructions
Delete the element with the given id, anywhere in the tree (including one nested inside a group or its mask) — a tweak to an existing composition. (The project must keep at least one top-level element.)
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": {
"id": "<id>"
},
"name": "delete_element"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The id of the element to delete. | |
| project_id | No | Which project to act on — the id returned by create_project / set_project / create_promo / load_project. Omit when working on a single local project. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| deleted_element_id | Yes | ||
| top_level_element_count | Yes |