set_clip_automation
Write automation curves into one clip's envelope to control device or mixer parameters over time, replacing existing data when needed.
Instructions
Write an automation curve into one clip's envelope.
points: [{"time": beats, "value": v, "step": false}, ...] with times in clip-local
beats (0 = clip start, same timeline as note start_time). Between points the value
ramps linearly; "step": true holds the point's value until the next point (a jump).
Before the first / after the last point the end values are held, so one point
writes a flat line. Ramps are written as steps resolution beats wide.
Parameters:
track_index, clip_index, clip_view: which clip (see get_clip_automation)
points: The curve (see above)
resolution: Step width for ramps in beats (default 1/32 note = 0.125)
clear_existing: Replace the parameter's existing envelope in this clip (default True)
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>",
"clip_index": "<clip_index>",
"points": "<points>"
},
"name": "set_clip_automation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| points | Yes | ||
| clip_view | No | session | |
| clip_index | Yes | ||
| mixer_name | No | volume | |
| resolution | No | ||
| send_index | No | ||
| target_type | No | device | |
| track_index | Yes | ||
| user_prompt | No | ||
| device_index | No | ||
| clear_existing | No | ||
| parameter_index | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |