Requesting access

You can request edit access to a team member's personal or private collection, API, or monitor. You will need a link to the collection, API, or monitor, or have access to it in Postman. When you submit a request, the owner will receive a notification prompting them to choose whether to grant you the role.

Requesting access to collections

You will have a viewer role on a collection by default. You can request an editor role on a collection.

Requesting editor role on a collection

There might be collections that you can view but not edit. These collections have a lock icon next to the collection name.

Collection Lock

You can request the Editor role on this collection:

  1. Click the ellipsis icon (...) next to the collection name in the sidebar to open the following menu and choose Manage Roles.
Collection Context Menu
  1. Click Request Access in the modal.
Manage Roles Blocked
  1. Select a person to send the request to and select the Editor role from the Role dropdown list.
Request Additional Access
  1. Complete your request by clicking Request Access.

This will trigger an email to the person you requested access from. When they approve your request, you will be notified by email. Your request will expire in 15 days, but you can make additional requests on the same collection after that period.

Requesting access to APIs

You will have a viewer role on an API by default. You can request an editor role on an API.

Requesting editor role on an API

There might be APIs that you can view in your team workspace but can't edit. These APIs have a lock icon next to the API name.

Requesting Editor Role on an API

You can request the Editor role on this API:

  1. Click the ellipsis icon (...) next to the API name in the sidebar to open the following menu and choose Manage Roles.
Manage roles for API
  1. Click Request Access in the modal.

  2. Select a person to send the request to and select the Editor role from the Role dropdown list.

  3. Complete your request by clicking Request Access.

Request Access to API

This will trigger an email to the person you requested access from. When they approve your request, you will be notified by email. Your request will expire in 15 days, but you can make additional requests on the same API after that period.

Requesting access to Monitors

Editing a monitor requires you to have edit access for that specific monitor.

Requesting editor role on a monitor

To get edit access for a monitor, you will first need to be a member of the team that owns the monitor, and then a member of the workspace that contains the monitor.

Once you have joined the team and joined the workspace, navigate to the monitor in question in Postman. In the upper right, hover over the monitor and select ... > Edit.

Manage roles request access

Click Request Access.

You need additional access modal

Select the team member you would like to send your request to and the Editor role, then Request Access.

Request access to monitor

When your request for access is approved, you will receive a notification in Postman.

Approving requests for access

Your team members can request access from you in the following cases:

  1. If your team members have the link to a personal collection, API, or monitor, they won't be able to view it, but they will be able to see the name and request access to it.

  2. If you have the Editor role on a collection, API, or monitor that is shared, a team member who has the Viewer role will be able to request an additional role from you.

The Viewer role is available depending on your Postman plan.

You will receive an email detailing the request for access.

Request Detail Email

Click Approve Request if you want to grant access to the collection, API, or monitor. If you do not wish to give access, you can ignore the request. A request for access will expire in 15 days.

To learn more about how you can collaborate with your team in Postman, see Working with your team.