Certain team options are only available with paid plans. To learn which roles are available with your plan, go to your web dashboard.
Roles define user permissions within Postman and levels of access to a Postman element, like a collection or an API.
Postman Organizations is available with Postman Enterprise plans.
Each team within an organization has its own set of independent roles:
With the Admin role, you have the power to define Postman access at the team level. You can use Postman’s role-based access control system to limit visibility of team resources, define your development workflow, and give access to administrative and billing personnel. Each user on a team must have at least one role attached to them, and can hold multiple roles simultaneously.
You can assign one or more role types to team members, based on the functions those team members require:
If you are on a Postman Enterprise plan, you can also assign roles at the group level.
Team roles offer high-level access control:
There are additional specialized roles for Enterprise teams:
* On non-Enterprise plans, any developer can change the visibility of workspaces.
** On Enterprise plans, only Super Admins and Community Managers can change and approve requests to change the visibility of a workspace to internal or public.
*** Enterprise plans only. Teams can allow users with the Folder Manager role to manage elements in specific folders in your team’s Private API Network.
Team members with a Developer or Super Admin role consume a paid seat on your team. Team members who have only Admin or Billing roles become support users and don’t consume paid seats. Each team can have two support users.
To learn how to manage team roles in Postman, see Manage your team.
You can assign three role types in Postman workspaces: Admin, Editor, and Viewer. Partner Workspaces offer an additional role type: Partner Lead.
Partners have different permissions for Workspace Editor and Viewer roles in Partner Workspaces (Enterprise plans only). To learn more, see Partner team and Partner Workspace roles.
You can use the Postman API to programmatically manage users and user groups for workspaces. For more information, see the Postman API collection.
The following roles control access at a workspace level:
* Workspace Editors can’t move or delete any API. They must have the API Admin role on APIs they want to move or delete.
** On Enterprise plans, an Admin for a workspace must request to change its visibility to public. This request will go to the Community Manager. On Team plans, if a team has no Community Manager assigned, an Admin for a workspace can control its visibility.
At the element level, you can assign roles to team members that decide their level of access to the following elements:
You can assign two role types in Postman collections: Editor and Viewer.
Partners have different permissions for Collection Editor and Viewer roles in Partner Workspaces (Enterprise plans only). To learn more, see Partner team and Partner Workspace roles.
You can assign a limited Viewer role to a coworker who isn’t in your Postman team by allowing them to view specific collections. Users with this role can only view specific collections and send requests in the collections that have been shared with them.
The following roles control access at a collection level:
You can assign two role types for Postman environments: Editor and Viewer.
The following roles control access at an environment level:
You can assign two role types for Postman mock servers: Editor and Viewer.
The following roles control access at the mock server level:
You can assign two role types for Postman Monitors: Editor and Viewer.
Partner team and Partner Workspace roles are available with Postman Enterprise plans. For more information, see the pricing page.
Partner team and Partner Workspace roles relate to Partner Workspaces and are applied at the team, workspace, and collection levels. There are different team and Partner Workspace roles you can assign to team members and external partners:
You can assign the Partner Manager role to team members at the team level, and invite partners with the Partner role:
You can assign Partner Workspace roles to partners at the workspace level:
You can also assign Partner Workspace roles to partners at the collection level:
To learn more about collaborating as a team member or partner, see Collaborate in a Partner Workspace.
Network roles are available with Postman Enterprise plans.
Network roles related to your Private API Network are applied at the team and folder level.
You can assign the following role at the team level:
After learning about the roles available to team members, you can manage your team’s level of access and control more effectively.