delete_clip
Delete one exact Session clip from Ableton Live using track and clip IDs with state-version checks and confirmation. Removes clip envelopes and note expression.
Instructions
Plan or delete one exact whole Session clip with native identity, exposed content and layout confirmation. Includes clip envelopes and note expression; the snapshot is not a restorable backup.
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>",
"trackId": "<trackId>",
"clipId": "<clipId>"
},
"name": "delete_clip"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| clipId | Yes | list_clips Session ID or supported list_arrangement_clips ID. | |
| dryRun | No | False executes with token and hash. | |
| trackId | Yes | ID from list_tracks. | |
| planHash | No | Plan hash. | |
| confirmationToken | No | Single-use plan token. | |
| expectedStateVersion | Yes | Observed stateVersion. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||