Version flows with snapshots

Snapshots enable you to save, view, and restore versions of your flows. With snapshots, you can create and manage reliable versions of your flows to share with others. You can also experiment with design ideas without fear of breaking a functioning flow.

Create a snapshot

To create a snapshot of a flow, do the following:

1. In Postman, create a flow or select a flow from the sidebar.

2. In the right sidebar, select Snapshots.

3. Select Create Snapshot.

4. Enter a message that describes this version of your flow.

5. Select Create Snapshot. The first snapshot is automatically titled Snapshot 1. The newest snapshot's title includes the label LATEST. Additional snapshots are automatically numbered in sequence like Snapshot 2 and Snapshot 3.

6. To create more snapshots, select Add snapshot, enter a message, and select Create Snapshot.

   If there are no significant changes in the flow, a warning message displays and no snapshot is created.

View a snapshot

When you view a snapshot, Postman loads that version of your flow on the canvas. While viewing a snapshot, you can run the flow but you can't edit it. To edit a snapshot's flow, you must restore the snapshot. Viewing a snapshot doesn't override the current state of your flow.

To view a snapshot, do the following:

1. Select a flow from the sidebar.

2. In the right sidebar, select Snapshots.

3. Select the snapshot you want to view. That version of the flow appears on the canvas, along with a message that lets you know you are viewing a snapshot.

4. To run the flow, select Run.

5. To stop viewing the selected snapshot and return to the latest version of the flow, select Exit.

Restore a snapshot

When you restore a snapshot, you can run and edit that version of your flow. Restoring a snapshot will override the current state of your flow.

To restore a snapshot, do the following:

1. Select a flow from the sidebar.

2. In the right sidebar, select Snapshots.

3. Next to the snapshot you want to restore, select More actions.

4. Select Restore. A warning appears to let you know that restoring the snapshot will override the current state of your flow.

5. Select Restore Snapshot. The snapshot's version of your flow appears on the canvas, and you can run and edit it.

Archive a snapshot

You can archive snapshots you no longer need. Archived snapshots can't be viewed, run, or restored. For example, you could archive a snapshot of a flow that no longer works due to underlying API changes, or a snapshot of a flow that includes sensitive information.

To archive a snapshot, do the following:

1. Next to the snapshot you want to archive, select More actions.

2. Select Archive. In the confirmation that appears, select Archive Snapshot.