Most recurring content is the same edit with different footage — a fixed intro, a fixed music bed, captions in a fixed style, and a middle section that changes. Versely's cloud editor stores that structure as an EDL: the full project state, with timeline clips, trims, texts, music and captions. save_editor_project persists it, and get_editor_project loads one back with the complete edl field the agent can read and modify.
The create-versus-update rule is simple and worth knowing: omit the id and you create a new draft; pass an id and you update that one. list_editor_projects gives you the drafts you already have — metadata only (id, title, duration_sec, clip_count, thumbnail_url, updated_at), newest first, with no full EDL — which is the cheap way to find the one you want before loading it.
Powered by
Create or update a cloud editor draft. Omit id to create (POST /editor-projects); pass id to update (PUT /editor-projects/:id). Body fields: title, edl (required — full editor project state JSON object), duration_sec, clip_count, optional thumbnail_url. Use after the agent modifies a draft EDL, or to snapshot a composition before rendering with edit_video.
What to tell the agent
Versely's agent maps this plain-English request directly onto save_editor_project. You don't need to know the parameter names — just describe what you want.
“Load my 'Weekly product reel' editor draft, swap the middle clip for this week's footage, save it, and render the result.”
How it works
1. Find the draft
list_editor_projects returns your saved drafts newest first — id, title, duration and clip count — without pulling the full timeline for each one.
2. Load the full timeline
get_editor_project takes an id and returns the complete edl: the clips, trims, texts, music and captions that make up the project state.
3. Change what changes
Swap the clip URLs for this week's footage and leave the structure — the intro, the caption style, the music bed — exactly as it was.
4. Save, then render
save_editor_project with the same id updates the draft in place (omit the id to fork a new one instead). Then pass the clips into edit_video to actually render, previewing at 480p for free before the charged export.
What it costs
Saving, listing and loading drafts are project-state operations rather than renders — the credits are spent when edit_video produces the final video, which supports a free 480p preview (preview:true, per-user cooldown) before the charged export. Snapshotting a composition before you render is the cheap half of this workflow.
The formula behind that number: What does editing a video cost if I keep changing it? — charges per finished export, so iteration is free and the count is the whole bill.
Limits & things to know
- A draft is project state, not a rendered video — nothing is watchable until you run edit_video on it.
- Omitting the id creates a NEW draft rather than updating the one you loaded, which is either the fork you wanted or a duplicate you didn't. Pass the id to update in place.
- list_editor_projects deliberately returns metadata only, so you can't inspect a timeline without a get_editor_project call for that specific draft.
- The edl is the editor's own project format. It's a structure to reuse and adapt, not a general-purpose interchange file for other editing software.
Who uses this
- A weekly or daily series that keeps the same intro, captions and music bed
- Agencies running the same edit structure across several clients' footage
- Snapshotting a composition before an experimental change, so there's a version to go back to
- Handing a half-finished edit to the agent to continue rather than re-describing it
Frequently asked questions
What's actually stored in a draft?+
The edl — the editor's full project state, including timeline clips, trims, texts, music and captions. get_editor_project returns it in full; list_editor_projects returns only metadata.
How do I update a draft instead of creating a new one?+
Pass its id to save_editor_project. Omitting the id creates a new draft, which is how you fork a variant deliberately.
Does saving a draft render the video?+
No — a draft is project state only. Pass the clips into edit_video when you want an actual file, with a free 480p preview available before the charged final export.
Can I reuse one edit structure across different footage?+
That's the main reason to save one. Load the draft, swap the clip URLs, keep the intro, captions and music as they were, then save and render.
Related Versely tools
Related editing jobs
Save a Video Edit as a Reusable Draft inside Versely
The all-in-one AI studio for creators. 60+ models for video, image, voice, music and lipsync in a single app.