Manage roles in Postman

Each team member must have one or more team roles assigned to them, which will enable them to perform different actions within your team. Roles can be granted to team members individually, or to members of a group.

You can change a team member's roles at any time in the team dashboard.

Search for a specific user by typing their name or email address in the search field. You can also filter users by role type. Select the roles next to the user you'd like to update, then select the roles you'd like to assign or remove. Select Update Roles to confirm your changes.

Some team roles are only available with Postman Professional and Enterprise plans.

Teams can have two support accounts at no extra cost. Support accounts are team members with only Admin or Billing roles. Team members with a Super Admin or Developer role will consume a paid seat on your team.

To learn more about the team roles that you can assign as a Team Admin, see Team roles.

Manage workspace roles

Workspace roles control access to elements within a workspace. Roles can be assigned to an individual user or to a user group.

To change the role of users in a workspace, or to remove a user from a workspace, do the following:

1. Select Workspaces in the Postman header, and then select a workspace.

2. On the workspace's Overview tab, select Settings.

3. Select a different workspace Role for a user or group:

   • Admin - Can manage workspace resources and settings.
   • Editor - Can create and edit workspace resources.
   • Viewer - Can view, fork, and export workspace resources.
   • Remove from workspace - Removes the user from the workspace. (You can invite the user again in the future.)

Manage element-based roles

Team members with Admin access for the workspace or Editor access for an element in it can manage element-based roles assigned to team members. Learn more about roles you can assign at the element level.

1. Hover over the element in the sidebar.

2. Select View more actions next to its name.

3. Select Share.

4. (Optional) Search for team members and user groups in the workspace to add to the element.

5. Select the role next to the name. Select Invite if you're adding for the first time. Otherwise, update the role. You can also select Remove to remove a team member or user group from the element.

   

Team members inherit permissions from the workspace role they're assigned. Team members can be individually assigned a workspace role, and the user group they're a member of can be assigned a workspace role. For example, a team member assigned the Workspace Editor role and Collection Viewer role will have Editor access to all collections in the workspace.

If you're managing roles for a collection, you can learn more about setting merge checks.

You can also use the Postman VS Code extension to manage collection and environment roles assigned to team members.

Manage Super Admins

Super Admins are available with Postman Enterprise plans.

If your team doesn't have a Super Admin yet, a Team Admin can assign the role to anyone in the team. Once your team has at least one Super Admin, only a Super Admin can assign this role to another user.

Super Admins can assign the Super Admin role to a user in the team dashboard, while inviting a new team member, and to a group. If your team is using SCIM, a Super Admin must create the SCIM credentials in order for SCIM to change the membership of a group that's been assigned the Super Admin role.

Regular Team Admins can't remove Super Admins from a team or remove their Super Admin role assignment.

It's recommended that you create a service user, such as postman-admin@example.com, that isn't tied to any individual and assign that user the Super Admin role. By doing so, your team can avoid the risk of a disruption in services due to an actual user leaving your company. This ensures that your team's management is able to sign in to the service account when needed. Learn more about assigning the Super Admin role to a service account.

Manage Partners

Partners are available with Postman Professional and Enterprise plans.

You can manage external partners similarly to internal team members. Learn more about managing a Partner Workspace.

Manage Guests

You can manage Guests in your team dashboard. To remove Guests, select Remove guest next to the user. To upgrade a Guest user to a Developer, select Convert. When a Guest becomes a Developer, they get access to all internal workspaces and can collaborate with other team members.

If you're on an Enterprise team, only Team Admins can assign a Guest user the Developer role.

Your team must have available seats or Auto-Flex enabled to change a user's role from the Guest role to the Developer role.

To review the workspaces and collections a Guest has access to, open your team dashboard. Locate the Guest user and select View resources. You can select the workspace name or collection name to open it in a new tab, or select the user's name to go to their Postman profile.

To learn more about sharing collections with Guests, see Share collections with Guests.

For information on how to remove a Guest from a team or collection, see Change Guest access to collections.

Manage groups

Groups are available with Postman Enterprise plans.

You can assign roles and provide access to team resources at scale with Postman groups. To learn how to create and manage groups, see Organize users into Postman groups.