write_envelope
Replaces or clears automation for one mixer or device parameter in a Session clip using time-ordered points; values ramp between points unless a jump is set.
Instructions
Replace one parameter's automation in a Session clip with these points, or clear it with no points. Values ramp from point to point unless a point has jump=true. Works for the mixer (volume, pan, sends) and device parameters, including rack macros; MIDI CC is not reachable (use CC Control's Custom A, CC 64 Sustain, for the pedal). Copy the clip to the Arrangement to keep the automation there. One undo step.
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": "<track>",
"slot": "<slot>",
"parameter": "<parameter>"
},
"name": "write_envelope"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slot | Yes | Clip slot: the scene row, from 0. Example: 0 for the first scene. | |
| track | Yes | Track address: t0 for the first track (numbers from 0), rA for return track A, m for the master. Example: t2 | |
| points | No | Points in time order. Example: [{"time": 0, "value": "200 ms"}, {"time": 8, "value": "800 ms"}]. Empty: clear the envelope. | |
| parameter | Yes | volume, pan, send A, or a device parameter on the same track as t0/d0:Release (device address, colon, parameter name) |