Collaborate in Postman

Postman has a variety of features that enable you to collaborate with your team and API consumers. You can change your workspace visibility, assign roles to collaborators, share your workspaces, and use Postman's API version control. With these features, you can tailor your collaboration strategy to each project's specific goals.

Understand how teams and workflows function in Postman

Postman streamlines API collaboration by facilitating interactive planning, development, publication, and maintenance within teams, companies, and globally. Users can collaborate internally within a team, multiple teams, or across the entire company, as well as externally with partner companies, based on their API strategy. Postman supports collaboration workflows across different phases of the API development lifecycle, including prototyping, iterating, building, testing, deploying, and integrating with partners. Partner Workspaces in Postman enable direct collaboration with external partners, fostering API consumption and joint project work for efficient partnerships. Learn more about Postman collaboration concepts.

Learn about Postman's collaboration features

Postman has a variety of features that enable you to collaborate with your teammates and the Postman community. Learn about Postman's collaboration features that enable you to organize, share, comment on, announce, and publish changes to your APIs.

Organize your projects using workspaces

You can organize your projects using workspaces, enabling you to collaborate with teammates or anyone in the Postman community. Use the visibility setting for a workspace to determine who can access it. When you create a workspace, you can choose an empty workspace to start from scratch, or a workspace template to help you get started. You can also view changelogs for collections, workspaces, and APIs, enabling you to review actions taken on elements in your workspaces.

Share your workspaces and elements

You can share your workspaces and elements with specific team members and users who are not part of your team. You can also share with internal team members to your team's Private API Network, and share with your API's consumers on the Postman API Network.

You can share your workspaces and elements in the following ways:

  • Share your work - You can share elements with team members, groups, guests, and external users. You can share with users by name, email address, or group name. You can also copy an element's name to your clipboard, and share the URL with the user directly. Super Admins and Community Managers can use the Manage public elements dashboard (Enterprise plans only) to control which public workspaces, documentation, and collections are shared with external users.
  • Your Private API Network (Enterprise plans only) - You can share your team's APIs internally to your Postman Private API Network. This enables your Postman team to access workspaces, collections, and APIs that your team uses internally. You can also use the Postman API to programmatically manage elements shared to your team's Private API Network.
  • The Postman API Network - API publishers can share their public APIs externally to the Postman API Network. This enables them to improve their API's onboarding experience, increase their API's discovery, collect feedback from their API's consumers, and more. API consumers can access public workspaces and elements on the Postman API Network, and use public APIs in their own workspaces.

Define roles and permissions

You can define the roles and permissions assigned to team members at the team, workspace, and element levels. You can also define roles and permissions that relate to Partner Workspaces and your Private API Network.

You can organize team members into groups that reflect your organization. This enables you to add users to a group, then assign that group roles and access to the resources they'll be using across Postman. This also enables you to efficiently onboard new team members by adding them to existing groups assigned relevant roles.

You can also manage access to workspaces and elements in your team. Depending on your assigned roles, you can:

  • Manage the workspace and element-based roles assigned to team members.
  • Request the Editor role in workspaces and elements.
  • Approve requests to access workspaces and elements.

Build APIs using Postman's version control

You can use Postman's version control to collaboratively build APIs with your team. This enables you and your team to fork a new instance of an element, make updates to the fork, create a pull request, and merge your changes into the parent element.

Last modified: 2024/10/09