Save and Restore Pipeline Versions
Browse saved Pipeline states, create named checkpoints, preview earlier versions, and restore a snapshot safely.
Use Pipeline history to inspect an earlier saved graph without changing your current Pipeline. You can create named checkpoints for important graph configurations and restore a snapshot as a new protected version.
Prerequisites
- Open a Pipeline in Pipeline Builder.
- You need owner or editor access to create checkpoints or restore snapshots. Viewers can browse and preview Pipeline history.
Browse Pipeline history
Open Pipeline history
Select the clock and chevron control beside the Pipeline title.
The Pipeline history menu opens with saved snapshots listed from newest to oldest. The current version has a Current badge.
Filter the snapshots
Select All snapshots to include autosaves, or select Checkpoints & edits to hide autosaves.
The list and snapshot count update for the selected filter. If the filter has no results, the menu shows No snapshots match this filter.
Load older snapshots
Select Load more when it appears below the list.
Older snapshots appear below the snapshots already loaded.
Create a named checkpoint
Named checkpoints mark graph configurations you want to find again. Checkpoint names appear as row titles. Historical checkpoints have a Protected badge, while the current checkpoint has Current.
You can create a checkpoint only from the current Pipeline. If a historical snapshot is open, select Back to current first.
Open Pipeline history
Open Pipeline history.
The menu shows New checkpoint above the snapshot filters.
Start a checkpoint
Select New checkpoint.
The Checkpoint name field and Save and Cancel buttons appear.
Name the checkpoint
Enter a name in the Checkpoint name field.
The Save button becomes available when the field contains a name.
Save the checkpoint
Select Save.
Salt saves the current graph configuration as a protected checkpoint and shows it in Pipeline history under the name you entered.
If the menu shows Checkpoint could not be created., select Save again.
Preview an earlier snapshot
Open a snapshot
Select a snapshot that does not have the Current badge.
The snapshot opens on the canvas, and the banner shows Viewing snapshot from followed by its date and Read-only. Previewing does not change the current Pipeline.
Inspect the saved state
Review the nodes, Edges, and settings on the read-only canvas.
Editing, running, and autosaving remain unavailable while the historical snapshot is open.
Return to the current Pipeline
Select Back to current in the banner.
The canvas reloads the current saved Pipeline state.
Restore a snapshot
Preview the snapshot
Open the snapshot you want to restore.
The read-only banner appears with Restore snapshot for owners and editors. Viewers do not see this button.
Open the restore confirmation
Select Restore snapshot.
The Restore this snapshot? dialog explains that Salt first saves the current Pipeline as a protected checkpoint, then saves the selected snapshot as a new protected version.
Confirm the restore
Select Restore as new version.
The selected graph configuration becomes the current Pipeline, and Salt shows Pipeline snapshot restored as a new protected version. The previous current graph remains available as a protected checkpoint.
Restoring a snapshot does not update published Agentic Tools, APIs, or Web Forms. Existing runs always keep their original Pipeline version.
Published surfaces continue serving their published snapshots. To publish the restored graph, run the Pipeline successfully, then publish the update from the corresponding surface.
If the Pipeline changed after you opened the preview, Salt stops the restore and shows The pipeline changed after this preview opened. Return to current and try again. The current Pipeline remains unchanged. Select Back to current, reopen the snapshot, and restore again.
If the menu shows Pipeline history could not be loaded., select Try again.
If a snapshot cannot be opened, Salt shows Failed to open this pipeline snapshot. The current Pipeline remains unchanged.
If a snapshot becomes unavailable after you preview it, Salt stops the restore and shows This snapshot is no longer available. The current pipeline was not changed. No restore occurs.
If Salt cannot return to the current Pipeline, it shows Failed to load the current pipeline. Try Back to current again before making further changes.
If another error prevents Salt from completing a restore, it shows Failed to restore this snapshot. The current pipeline was not changed. Reopen the snapshot before trying again.
Pipeline history and Run History
| History | Contains | Entry point |
|---|---|---|
| Pipeline history | Saved editor snapshots, including autosaves and named checkpoints | Clock and chevron control beside the Pipeline title |
| Run History | Pipeline executions, including their status, outputs, and logs | History control in the right-side header group, or R; its tooltip reads Open runs |