Command · Restore Version
history.restore
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).
- v1
- Capability EditProject
- Tool
history_restore
Request
{
"command": "history.restore",
"params": {
"revision": 12
}
}Parameters
frominteger (1..)- Restore only this sequence of the version, as a new sequence.
namestring- The new sequence's name (default: " (version )").
revisioninteger (1..)Required- The version's id (history.list).
sequenceinteger (1..)- Sequence id; only needed when the project has several.
Discussion
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). The no-cloud lock stays on.
Run it with wabcut-cli cmd <project> --json, from an MCP client as history_restore, 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.export
Save Version As. Writes a saved version as a project file of its own ("restore as a new project").
- 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).