studio.move_clips_to_track
Move 1 to 200 timeline clips onto another track of the same kind (a b-roll clip to a video-broll track, a title to a text track, music to an audio-music track, a voice clip to an audio-voice track), keeping their spacing; delta_ms also moves them in time (default 0). Stacking follows the track: get_composition lists tracks in stacking order, and a clip on a later video-broll or text track draws over the earlier ones. All or nothing. Refuses, naming the first offender and moving nothing: an unknown clip id or track_id (get_composition lists the ids), a locked source or target track (unlock it with lock_track), a target of another kind (pick a track of the clip's kind, or add one with add_track), a target that would pass its clip cap (move fewer clips, or add a track with add_track), listed clips that overlap each other (move them one at a time), a clip pushed before 0 or past the timeline cap (keep delta_ms within the range the refusal gives), or a landing that overlaps a clip already on the target (use another delta_ms; the refusal gives the nearest one that fits).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| clip_ids | Yes | Timeline clip ids (vcl_) from get_composition's tracks; duplicates count once. | |
| delta_ms | No | Milliseconds to move the clips in time as they change track; negative moves them earlier. 0 when left out. | |
| track_id | Yes | The target track (vtr_) from get_composition's tracks, of the same role as every listed clip's track. | |
| project_id | Yes | The studio project (vp_…) this tool acts on. |