add_audio_track
Add an existing workspace audio media item to the edit timeline with precise placement, trim, fades, volume automation, channel, and optional shot pinning.
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": {
"workspaceId": "<workspaceId>",
"editId": "<editId>",
"mediaId": "<mediaId>"
},
"name": "add_audio_track"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| editId | Yes | The edit ID | |
| volume | No | Base volume from 0 to 1 | |
| channel | No | Audio lane/channel index | |
| mediaId | Yes | Audio MediaDocV2 ID to place on the timeline | |
| trimEnd | No | Source trim end in seconds | |
| duration | No | Timeline clip duration in seconds | |
| startTime | No | Timeline start time in seconds | |
| trimStart | No | Source trim start in seconds | |
| fadeInTime | No | Fade-in length in seconds | |
| autoChannel | No | Pick the first non-overlapping channel automatically | |
| fadeOutTime | No | Fade-out length in seconds | |
| workspaceId | Yes | The workspace ID | |
| pinnedToShotId | No | Shot ID to pin this audio to, or null to unpin | |
| volumeKeyframes | No | Volume automation curve | |
| relativeStartTime | No | Offset in seconds from the pinned shot start |