Forking + Merging: A Conflict Resolution Solution

Reading Time: 3 minutes

One of our New Year’s resolutions at Postman is to avoid unnecessary conflict and to help our users do the same, which is why we’re excited to introduce version control in Postman 6.7! Similar to branching and merging in version control systems, this new functionality gives Postman teams more control over their collaborative workflows.

Forking a collection creates a linked version of that collection that syncs for teammates who are in the workspace where the fork was created. This makes it simple for teams to make and test changes without affecting the base collection. After making changes, users can view the diff, verify changes, resolve conflicts, and merge those changes back to the base collection.

This functionality improves collaboration for teams by allowing multiple teammates to work off of different versions of Postman Collections in real time.

How to Fork a Collection in Postman

1. Go to your collection and click the ellipsis ()

2. Select “Create a fork”

Forking a collection in Postman
Create a new fork in Postman

3. Give your fork a label – this will be used to identify this fork, and distinguish it from the parent

Forking a collection in Postman
Give your fork a label to distinguish it from the parent

4. That’s it! You’ll see your fork added as a new collection with its given label

Forking a collection in Postman
A forked collection with fork label

How to Merge a Collection and View the Diff in Postman

1. Go to your collection and click the ellipsis ()

2. Select “Merge changes” and you’ll be taken to your dashboard

Merging in Postman
Merge changes in Postman

3. Within your dashboard, you can view the diff, select which changes you’d like to use, and resolve any conflicts

View the diff and select changes within the Postman dashboard

4. Once you’ve addressed all changes and conflicts, select “Merge all changes”

Select changes, and view the diff from the Postman dashboard

5. You’ll be prompted on whether you want to:

  • update the destination (the original) with the changes,
  • update both the source (the fork) and destination with the changes, or
  • update the destination and delete the source.
Select how you want the destination and source to be updated

This new functionality paired with another recent Postman launch, comments on collections makes it even easier to collaborate with your team in Postman!

Happy forking and merging everybody!




Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

You might also like: