Forking + Merging: A Conflict Resolution Solution

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!

Comment

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.

2 thoughts on “Forking + Merging: A Conflict Resolution Solution

    Since this is happening in your own workspace, how would your team members make changes to the same collection? They obviously have their own workspaces. They can create their own forks, but then how do they get your changes and merge them?

    It looks like the article is maybe missing some context.

    Currently, our way of “collaborating” on collections is:
    1) someone checks out the collection from GitHub, imports it into Postman
    2) they make some changes
    3) they export the collection again
    4) they commit the changes to Git

    Often times when two people do this at the same time, changes get lost because the collection is one giant file Postman tends to save things to the file that aren’t really relevant, like test results.

    How do we move from this way of working to being able to use this Fork and Merge functionality as a team?

    Thanks,
    Frans

    This is not working on my end, i am getting: Resolve the active conflicts in the diff.
    But all the conflicts have been issued.