Collaborate in a Partner Workspace

Partner Workspaces are available with Postman Professional and Enterprise plans.

The collaborative experience that Partner Workspaces offer depends on your role and access as a Team Member or external Partner. Team Members can access Partner Workspaces they’re invited to from the Workspaces menu by selecting Only invited partners from the Access filter. Partner Workspaces from other teams have an External tag. To access external workspaces, navigate to the Workspaces menu, select All workspaces, then go to the External Workspaces tab.

Learn how to collaborate, keep your Partners informed about the API changes, and fork Partner Workspace collections.

You can also learn more about managing team-to-team partnerships.

Collaborate as a Team Member

Partner Workspaces are only visible to invited Team Members. Users can be assigned the team-level Partner Manager role. Partner Managers can view all Partner Workspaces within an organization, and can control their settings, visibility, and Partner invites.

Collaborate as a Partner

Partners are trusted external developers and other stakeholders with whom you want to share your APIs. When an external partner is invited to a Partner Workspace by a team they’re working with, they only have access to that Partner Workspace and can’t access any other workspaces or resources within the team. Partners don’t have internal workspaces within the team they’re partnering with.

When Partners from domain-captured teams accept a Partner invite, they can choose their team and accept the invite. The Partner Workspace will show up in their team as an External workspace. To see the list of partners, go to Partnerships.

Partners can be assigned the following roles:

• Partner Lead — Partner Leads can only invite people who are part of their own Postman team as Partners.

• Partner Editor — A Partner Editor is a Partner who has Editor permissions on one or more Partner workspaces. The Partner Editor role is an add-on. For more information, see Postman API Platform plans and pricing.

• Partner Viewer — Workspace Admins can invite Partners as Viewers to the Partner Workspace. When you’re collaborating with people who aren’t part of your team, you’ll recognize them by a diamond symbol over their avatar.

  

For more information about Partner roles and permissions, see Partner team and Partner Workspace roles.

Keep your Partners informed about API changes

API publishers can use workspace updates to communicate API changes. Suppose you set up a single Partner Workspace to work with your highly valued API consumer. When you save a change, for example, to a request, you’re prompted to post a workspace update. Select Post an update and the Updates tab opens.

You can access workspace updates at any time by selecting the Updates tab on the workspace overview page. Select the workspace name on the top left, and select the Updates tab. To create an update, follow the instructions in Communicate API changes using workspace updates.

When your Partner accesses your workspace, a notification badge appears on the Updates tab, signaling that there are new updates since the last visit. Your Partner can then respond with comments, questions, and other types of feedback.

Slack and Team integrations aren’t available for Partner Workspaces.

In multi-partner mode, API publishers can use workspace updates to broadcast API changes to multiple partners.

Commenting and replying to workspace updates is turned off in multi-partner workspaces to keep collaboration private.

Fork and create your own collection

When you set up a Partner Workspace and collaborate with Partners, your Partners can create a fork and take a copy to their own team. This helps Partners edit the collection privately and also collaborate with their colleagues in the Partner organization. Your Partners can then construct their own real-world API workflows using the forked collection.

Any Partner, whether they’re a Viewer and Editor, can fork to their own team as long as they’re on a paid Postman plan (Basic, Professional, or Enterprise). If your Partner isn’t on a paid plan, and you want to provide them the ability to fork, you can assign them the Editor role in the Partner Workspace. Learn more about roles.

To fork a collection as a Partner Editor, you can follow the same steps as a Partner Viewer. Partner Editors can fork to any workspace in their team where they have Editor access.