move_device_to_chain
Plan or move an exact device into a rack chain on ordinary, Return, or Main tracks, including nested destinations, then use the returned device ID and actual position.
Instructions
Plan or move an exact device into a rack chain across ordinary, Return, or Main tracks, including nested destinations. Live may choose the nearest valid position; use the returned device ID and actualPosition.
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": {
"expectedStateVersion": "<expectedStateVersion>",
"trackId": "<trackId>",
"deviceId": "<deviceId>",
"targetTrackId": "<targetTrackId>",
"targetChainId": "<targetChainId>",
"targetPosition": "<targetPosition>"
},
"name": "move_device_to_chain"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dryRun | No | False executes with token and hash. | |
| trackId | Yes | track-N from list_tracks, return-N from get_set_mixer, or master. | |
| deviceId | Yes | ID from list_devices. | |
| planHash | No | Plan hash. | |
| targetChainId | Yes | Exact chain ID from device hierarchy. | |
| targetTrackId | Yes | track-N from list_tracks, return-N from get_set_mixer, or master. | |
| targetPosition | Yes | ||
| confirmationToken | No | Single-use plan token. | |
| expectedStateVersion | Yes | Observed stateVersion. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||