studio.delete_elements
Delete several scenes, timeline clips, stickers and captions in one edit: pass 1 to 200 ids in element_ids. All or nothing: an unknown id, a clip on a locked track, or a locked track a scene's cut would move refuses the whole call, names the first offender, and deletes nothing (unlock it with lock_track, or pass ripple_secondary "none"). Scenes follow ripple_secondary as in delete_element: "shift" (default) removes each deleted scene's time from every lane, keeping later clips in sync; "none" closes the main track alone. The receipt's clips_removed and clips_trimmed count each unlisted clip once, however many deleted scenes it spanned. Listed clips leave gaps (ripple_delete closes one); captions hide reversibly (restore_fillers brings them back).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | The studio project (vp_…) this tool acts on. | |
| element_ids | Yes | Scene (vs_), clip (vcl_), sticker (vov_) or caption (vc_) ids; duplicates count once. | |
| ripple_secondary | No | For deleted scenes: "shift" (default) removes their time from every lane; "none" closes the main track alone. Clips, stickers and captions ignore it. |