set_audio_clip_state
Update an Ableton Live audio clip's gain, pitch, warp, and start/end marker bounds with state-version checks and confirmation guards.
Instructions
Guard audio settings and bounds: warped beats or unwarped seconds. Change warp separately. Verify independent readback.
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": "set_audio_clip_state"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gain | No | Clip gain. | |
| 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. | |
| warping | No | Warp enabled. | |
| planHash | No | Plan hash. | |
| warpMode | No | Warp mode value or name. | |
| pitchFine | No | Fine pitch offset in cents. | |
| pitchCoarse | No | Coarse pitch offset in semitones. | |
| endMarkerBeats | No | Warped end marker in beats. | |
| endMarkerSeconds | No | Unwarped end marker in seconds. | |
| startMarkerBeats | No | Warped start marker in beats. | |
| confirmationToken | No | Single-use plan token. | |
| startMarkerSeconds | No | Unwarped start marker in seconds. | |
| expectedStateVersion | Yes | Observed stateVersion. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||