set_clip_automation
Draws automation envelopes inside a Session clip for a device parameter or mixer control, so the parameter changes play whenever that clip plays.
Instructions
Draw an automation envelope inside a Session clip; it plays whenever the clip plays. (Live's API does not allow writing envelopes in Arrangement clips or the Arrangement's automation lanes.) Target a device parameter (device_index + parameter_index, see get_device_parameters) or a mixer control (mixer_parameter).
Parameters:
track_index: The track holding the clip and the parameter
clip_index: The Session slot
points: [{"time": 0, "value": 0.2}, {"time": 16, "value": 0.9}] — time in beats from the clip start, value in the parameter's own range (clamped); the last value holds to the clip end. [] with clear_first removes the envelope.
location: "session" (the only place Live accepts)
device_index: Device in the chain (ignored with mixer_parameter)
parameter_index: Parameter of that device
mixer_parameter: "volume", "panning" or "send:N" (N = return index)
interpolation: "linear" (ramps drawn in steps of
resolution) or "step"resolution: Ramp step in beats (0.25 = a sixteenth)
clear_first: Erase this parameter's envelope in the clip first
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 | ||
| location | No | session | |
| clip_index | Yes | ||
| resolution | No | ||
| clear_first | No | ||
| track_index | Yes | ||
| device_index | No | ||
| interpolation | No | linear | |
| mixer_parameter | No | ||
| parameter_index | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |