Skip to main content

​
Overview

The Version History viewer lets you explore every change ever made to a workflow. It lists published versions — the definitions that power automated and manual executions — alongside your current draft, the auto-saved working copy that has not yet been published. From the viewer you can:
  • See when each version and draft was created, and who saved it.
  • Switch between versions to inspect their full YAML definitions.
  • Compare any two versions (or the draft) using the Compare toggles — Previous vs. Selected, Latest vs. Selected, or Draft vs. Selected.
  • Restore a previous version into your working copy.
  • Publish the draft when you are ready, or discard it if the changes are no longer needed.

​
Viewing drafts and versions

  1. Open the workflow in Workflow Builder.
  2. Click View Version History in the action bar.
  3. The list shows:
    • Draft — your auto-saved, unpublished edits. Appears at the top with a “Draft” badge and a relative timestamp so you can confirm when the last auto-save occurred.
    • Published versions — ordered chronologically with the most recent at the top. Each entry displays the commit message, author, and timestamp.
Selecting any row opens its metadata panel and preview on the right, so you always know which version the diff viewer is referencing before you compare or restore.
Drafts remain local to the workflow until you publish. They do not impact scheduled or trigger-based runs.

​
Comparing versions with diff

The viewer supports interactive diffs so you can see exactly what changed between any two versions.
1

Choose versions to compare

Use the Compare dropdown to pick Previous vs. Selected, Latest vs. Selected, or Draft vs. Selected. The default highlights changes between the selected version and its immediate predecessor so you can step through history quickly.
2

Review the side-by-side YAML diff

The diff viewer uses synchronized scrolling so both panes stay aligned. Added lines appear highlighted in green; removed lines appear in red, making it easy to spot prompt tweaks, parameter changes, or connector updates.
The diff viewer is read-only. To make additional edits, close Version History and continue working in the builder; your changes will update the Draft entry automatically.

​
Restoring previous versions

If a recently published change introduces issues — or if you simply prefer an older definition — you can restore it into the working copy.
1

Select the desired version

Click the version in the list to load its details.
2

Click Restore to Draft

Confirm the action in the modal. The chosen version becomes the new Draft while leaving the original published entry intact for future reference and audit trails.
3

Review and publish or adjust further

After restoration, return to the builder to validate, tweak if necessary, and Publish to make it the active version.
Restoring does not automatically publish the version. Automated executions will continue using the last published version until you publish the new draft.

​
Best practices

  • Review before you run. Always verify the draft’s diff against the latest published version to confirm expected changes.
  • Publish intentionally. Provide clear commit messages when publishing so teammates understand why a change was made.
  • Discard stale drafts. If a draft lingers and is no longer relevant, discard it to avoid confusion.
  • Use restore for quick rollbacks. Instead of re-editing, restore a known-good version and publish it to roll back fast.