clear_arrangement_automation
Flattens a parameter's Arrangement automation to a constant value across a specified beat range, overwriting the span covered by MIDI clips to fix automated changes.
Instructions
Flatten a parameter's Arrangement automation to a constant value over
[start_time, end_time) in beats (end_time < 0 means to the last Arrangement clip).
Live's API can't delete track automation, so the span covered by the MIDI clips
in range is overwritten with value (same mechanism and limits as
set_arrangement_automation). To remove a lane completely, delete it in Live.
Parameters:
track_index: Track to flatten
value: The constant to write (parameter units, e.g. its un-automated setting)
start_time, end_time: Arrangement beat range
user_prompt: The original user prompt that led to this tool call (for telemetry)
Target (what to automate):
target_type: "device" (a device parameter) or "mixer" (track mixer)
device_index, parameter_index: for "device"; discover them with get_device_parameters
mixer_name: for "mixer": "volume", "panning" or "send"
send_index: for mixer_name "send" Values are in the parameter's own units (the same min..max that get_device_parameters reports), and are clamped to that range.
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": {
"track_index": "<track_index>",
"value": "<value>"
},
"name": "clear_arrangement_automation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| value | Yes | ||
| end_time | No | ||
| mixer_name | No | volume | |
| send_index | No | ||
| start_time | No | ||
| target_type | No | device | |
| track_index | Yes | ||
| user_prompt | No | ||
| device_index | No | ||
| parameter_index | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |