delete_session_object
Delete a specific track, return, scene, or session clip in Ableton Live with explicit confirmation, handling dependent group and send lane content.
Instructions
Delete an exact track/Group, Return, scene or whole Session clip. Binds native identity and exposed content, including Group descendants or affected Return send lanes. Requires explicit content authority; retains partial outcomes. Clip removal includes envelopes and note expression.
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": {
"expectedStateVersion": "<expectedStateVersion>",
"targetType": "<targetType>",
"targetId": "<targetId>"
},
"name": "delete_session_object"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dryRun | No | False executes with token and hash. | |
| trackId | No | ID from list_tracks. | |
| planHash | No | Plan hash. | |
| targetId | Yes | Stable target ID. | |
| targetType | Yes | ||
| allowContent | No | Allow deletion of contained material or a Return Track and its send lane. | |
| confirmationToken | No | Single-use plan token. | |
| expectedStateVersion | Yes | Observed stateVersion. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||