Command · Save Version As
history.export
Writes a saved version as a project file of its own ("restore as a new project").
- v1
- Capability EditProject
- Tool
history_export
Request
{
"command": "history.export",
"params": {
"path": "C:/Projects/Film (client cut v2).wabcut",
"revision": 12
}
}Parameters
overwriteboolean- Replace an existing file (default false).
pathstringRequired- The new project file (UTF-8 path).
revisioninteger (1..)Required- The version's id (history.list).
sequenceinteger (1..)- Sequence id; only needed when the project has several.
Discussion
Writes a saved version as a project file of its own ("restore as a new project"). Refuses to replace a file unless "overwrite".
Run it with wabcut-cli cmd <project> --json, from an MCP client as history_export, or from an extension. See Edit commands for requests, references and results.
See also
history.*
- history.checkpoint
Save Version. Records the project as it is now in the version history (unchanged since the last version: nothing is added).
- history.diff
Compare Versions. What changed from one version to another ("current" is the project as it is): per sequence the clips added, removed, moved, trimmed or retimed, effects and keyframes changed, settings, tracks, markers and captions; media and review notes.
- history.list
Version History. The project's saved versions, oldest first, as arrays: id, createdAt (UTC), kind (save, auto, agent, manual, restore), label (named versions are kept), sequences, clips, the bytes the version added.
- history.name
Name Version. Names a saved version (an empty label unnames it).
- history.restore
Restore Version. Goes back to a saved version: the whole project (one undo step; the project as it was is saved as a version first), or, with "sequence", that sequence of the version as a new sequence next to the current ones (the media it plays is the project's own where the project still has it).