Manage, request, and approve access to Postman elements

By default, you can view workspaces and the Postman elements in them, such as collections, APIs, environments, mock servers, and monitors, that are shared with your team. If you need to edit a workspace or element in it, a team member with Admin access for the workspace or Editor access for an element can assign you the Editor role, or you can request it.

To be assigned or request role access for a workspace or element, you first need to join or get invited to the shared workspace, or be an external user with permission to view a collection.

After you submit a request to access, team members with Admin access for the workspace or Editor access for an element will receive a notification requesting their approval.

Roles and permissions are available depending on your Postman plan.

Managing workspace roles

Team members with Admin access for the workspace can manage workspace roles assigned to team members.

Managing 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 the more actions icon next to its name.

3. Select Manage roles.

   

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

5. Select the role next to their name, then select a different role. You can also select Remove to remove a team member or user group from the element.

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

   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.

   

6. Select Update Roles to save your changes.

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

Requesting role access for workspaces

You can request Editor access for a workspace to gain additional permissions.

To request an Editor role, open the workspace overview, then select Request to Edit in the upper-right corner. You can also request access when you try to create an element in the workspace by selecting the create new icon in the left sidebar.

You can add a note to the Workspace Admins, then select Request Access.

Workspace Admins will receive an in-app and email notification detailing your request. When it's approved or denied, you'll be notified in-app and by email of their response.

Requesting Editor role access for elements

If you can view an element in a workspace but can't edit it, there is a lock icon next to the name of the collection, API, environment, mock server, or monitor.

Requesting Editor role access for an element

1. Select Collections, APIs, Environments, Mock Servers, or Monitors in the sidebar.

2. Select the more actions icon next to the element name and select Manage Roles.

   

3. Select Request Access.

   

4. Select the person you want to send the request to, and select the Editor role.

   

5. Select Request Access.

Postman will send an in-app and email notification to the person you selected. Once they approve your request, you will also get notified in-app and by email. Your request will expire after 30 days, after which you can request access again.

Requesting Editor role access for a collection as an external user

You can request Editor role access for a collection if you're an external user who is allowed to view the collection. When you get Editor role access to a collection, your team role also changes from the Guest role to the Developer role. This team role change adds you to the team and gives you access to all team resources and workspaces.

1. Select Collections in the sidebar.
2. Select the collection.
3. Select Request to Edit.

Your team must have available seats or Auto-Flex enabled to give an external user Editor role access to a collection.

Postman will send in-app and email notifications to team members with Editor role access to the collection.

Approving requests for access

If you're an Admin of a workspace or an Editor of an API, collection, environment, mock server, or monitor, you may receive a request to give a teammate role access.

When a teammate requests Editor role access for an API, collection, environment, mock server, or monitor, you'll receive an in-app and email notification that details the request. Select Approve Request if you want to give your teammate Editor role access to the collection, API, environment, mock server, or monitor. If you don't want to give Editor access, you can ignore the request. The request will expire after 30 days.

When a teammate requests Editor role access for a workspace, you'll receive an in-app and email notification detailing the request. Select Respond to Request to open the workspace settings. You can select the role you'd like to give the user, then Approve or Deny the request.