read_envelope
Retrieve automation points for a Session clip parameter, including beat times, displayed and raw values, and curve bends; returns exists=false when no envelope is defined.
Instructions
The automation points of one parameter in a Session clip: time in beats, value as Live shows it, raw value, and curve bends. exists=false when the clip has no envelope for it.
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": "read_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 | |
| parameter | Yes | volume, pan, send A, or a device parameter on the same track as t0/d0:Release (device address, colon, parameter name) |