Collaborating in team workspaces in Postman

Introduction

Postman collaboration is a critical feature that enables various stakeholders of an API to come together and participate in API development. Postman provides a wide range of tools to enhance collaboration with different users as a team. Users can create team workspaces to share their work and contribute to an API project. 

Collaboration in team workspaces

Users can use team workspaces to work on API collections, environments, integrations and other features. Professional and Enterprise Postman users create private workspaces visible only to the creator and the team members invited to join them. It restricts access to the contents of the workspace and helps maintain security.

Creating Team workspaces

Team workspaces are created by default for a team. They can be renamed but not deleted. New workspaces can be created by clicking on Create Workspace. New members can be invited to the workspace by sharing it.

Moving elements 

Collections, APIs and their environments can be moved into a team workspace from elsewhere. However, elements of a private, public or team workspace can not be transferred to a personal workspace. Moving elements between workspaces can be done by an editor, admin or super admin. Select the element you want to move and click on the three dots next to it. A Move inventory is displayed to select the destination.

Some items related to an element are not moved automatically. Monitors in a collection will pause and remain in the same workspace. API documentation, environments and collection will also remain in the current workspace unless they are separately moved or reconfigured in the new workspace.

Sharing and Watching

Contents of team workspaces can be shared with other members by sending them invites to join the workspace. Workspace admins can invite other users and assign them specific roles. Workspace editors can invite members but cannot assign roles. All invites are notified to the users via email. Users who join as Collaborators via invites are directly added to the team workspace after approval from the Team Admin.

Team Workspaces can be closely watched for updates by clicking on the eye button. Doing this will send the user a notification every time the workspace is modified. Specific elements of a workspace can also be watched.