Start Today

← Documentation

Process versioning

A business process has a single working copy called the Draft and any number of numbered versions (v1, v2, …). Numbered versions are saved snapshots: you can open, export, play and compare them, but their text is locked.

Switching versions

When at least one version exists, a Version dropdown appears in the process header next to Create version and Compare. Pick Draft to keep editing, or pick a numbered version to view that snapshot.

  • Draft — edit the full spec and operations, run AI enhance, generate artifacts and run plugin actions on the live content.
  • Numbered version — text is read-only. A banner at the top offers a one-click jump back to Draft when you need to make changes. Exports and the player use whichever version you are looking at.

Create a version

Click Create version to freeze the current Draft as the next numbered version. Add an optional comment (e.g. “before rewrite”) to remember why you snapshotted. The app then opens the new version. Before bulk AI generation from Draft, you may be offered to create a version first so generated artifacts stay tied to a stable snapshot.

Compare versions

Compare opens a side-by-side diff page. Pick any two versions in the From and To dropdowns (Draft is included). The page highlights line-level changes in the main specification and, for each operation, shows separate diffs for the title and the body. Use Swap to flip sides.

Work on a live Draft and freeze numbered snapshots you can compare.

Read more