ws_edit
Edit the project by editing its files — exact old→new replacement, like editing code. job/<job_id>/transcript.txt, transcript/<clip_id>.txt, words/<clip_id>.txt: delete words, phrase lines or pause lines to CUT them from the edit. job/<job_id>/timeline.txt: delete a clip line (remove clip), change its start (move), move the line under another track header (change track), change its src range (trim) or x. project/<project_id>/scenes/<scene_id>/document.html: any edit. Applied as ONE undoable, all-or-nothing batch. dry_run=true returns the operations without applying. keep_tracks_in_sync=true (transcript cuts only): in the same edit, overlays, cutouts, captions, sound effects and music after the cut move with the footage they sat over. old must be copied exactly from a fresh ws_read.
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": {
"path": "<path>",
"old": "<old>",
"new": "<new>"
},
"name": "ws_edit"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| new | Yes | ||
| old | Yes | ||
| path | Yes | ||
| confirm | No | ||
| dry_run | No | ||
| replace_all | No | ||
| keep_tracks_in_sync | No |