move_arrangement_clip
Move an exact Arrangement MIDI or audio clip to a new beat position on its current track, verifying staging before removal and refusing collisions except self-overlap.
Instructions
Move one exact Arrangement MIDI or audio clip on its current track. Binds native identity, exposed source content and prior layout; verifies staging before source removal and destination before staging removal. Self-overlap is supported; other collisions refuse. Reports partial work without rollback or replay. Same position skips writes. Updated bridge required; hidden state and clip envelopes are not verified.
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>",
"clipId": "<clipId>",
"startBeats": "<startBeats>"
},
"name": "move_arrangement_clip"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| clipId | Yes | Exact timeline clip ID from list_arrangement_clips. | |
| dryRun | No | False executes with token and hash. | |
| trackId | Yes | ID from list_tracks. | |
| planHash | No | Plan hash. | |
| startBeats | Yes | New nonnegative timeline position in beats. | |
| confirmationToken | No | Single-use plan token. | |
| expectedStateVersion | Yes | Observed stateVersion. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||