Manage Postman workspaces

Whether you're a team or admin user of Postman workspaces, you have many options to establish and enhance collaboration in your workspaces. Learn more about managing the workspace roles, editing and sharing workspaces, responding to requests to create workspaces, and moving elements and whole workspaces.

To learn how to make a new workspace, go to Create a workspace in Postman. For more information about workspace usage, see Use Postman workspaces.

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 - Removes the user from the workspace. (You can invite the user again in the future.)

Edit workspace details

A summary and description help others understand what your workspace is for. You must be a Workspace Admin to edit workplace details.

On the workspace's Overview tab, select the workspace name and enter a new name. You can also select the summary, description, or tags (Enterprise plans only) to edit it. You can add Markdown to the description. Select the area outside of each section to save your changes.

Edit Workspace Summary & Description

Change workspace visibility

The visibility setting for a workspace determines who can access it. You must be a Workspace Admin to change the visibility for a workspace.

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

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

  3. Select who can access the workspace:

    Changing workspace visibility
  4. Select Update.

You always have one personal workspace in Postman. If you change the visibility of all of your personal workspaces to private, team, or public, Postman creates a new personal workspace for you.

Change workspace themes

You can customize the visual experience for your workspace members in order to:

  • Denote the sensitivity level of data handled within your team's workspaces.
  • Reflect team branding or corporate identity in public workspaces.
  • Distinguish Partner Workspaces integrated with different third-party services or clients.
  • Represent different stages of a workflow in team workspaces, such as planning, development, testing, and deployment.

To change the theme, in your workspace's Overview tab, select the Settings tab and navigate to Workspace theme.

For Accent color, select a hex value to style the color of buttons and highlights for all primary actions. You can also select a Theme color using a color picker. Select Apply Theme to set the selection.

Select a workspace theme

The version of the theme that your workspace members see depends on the current app theme they set. If a member selects a dark theme in the Postman app settings, they see a dark variant of your workspace theme. Toggle the preview to visualize both the light and dark variants of your custom workspace theme.

To restore the default theme, select Reset to Default.

Changing the colors of the workspace theme sets the workspace user experience for all workspace visitors and overrides the colors of the application theme set by workspace members. Their application theme colors are restored when they leave the workspace.

Share workspaces

You can invite team members, groups, and external users to collaborate in a workspace by navigating to the workspace and selecting Invite in the Postman header.

Share team workspace

Your ability to share workspaces with teammates depends on your workspace role:

  • Workspace Admin - Can invite Postman teammates or external users to personal, private, team, and public workspaces, and assign them a workspace role. If a Workspace Admin invites an external user to a workspace, Postman shares this request with Team Admins. Once approved, an invite to join the team is sent to the individual.

    Workspace Admins can also use the Postman VS Code extension to invite Postman teammates to workspaces, and assign them a workspace role.

  • Workspace Editor - Can invite external users to team and public workspaces, but can't assign them workspace roles. For private workspaces, Workspace Editors using the Postman web app can copy and share a link to the workspace with a teammate, who can then request access to the workspace.

  • Workspace Viewer - Can't invite teammates to private, team, or public workspaces. For private workspaces, Workspace Viewers using the Postman web app can copy and share a link to the workspace with a teammate, who can then request access to the workspace.

When you invite a collaborator to a personal workspace, it's automatically converted into a team workspace.

Individual team members and groups you invite are notified of your request to collaborate.

External users who aren't on your Postman team will receive an invitation to join if you're a Team Admin or Super Admin. On Free, Basic, and Professional plans, team members with the Developer role can invite external users as Developers automatically, without the need for approval by a Team Admin.

You can also invite collaborators by selecting Link icon Copy Invite Link and sharing the link with them outside of Postman. When individuals select the link, Postman prompts them to sign in or sign up.

If you're a Team Admin or a Developer inviting another Developer on a Free, Basic, or Professional plan, they'll be automatically added to your team. If you aren't a Team Admin or a Developer, your request to add external users to your Postman team is shared with your Team Admins for approval.

Inviting collaborators to Partner Workspaces is different from inviting them to other types of workspaces. To learn more, see Inviting collaborators to a Partner Workspace.

Approve workspace creation requests

Requests to create a public or a partner workspace are approved by Partner Managers and Community Managers, respectively. If team workspace creation is restricted, a team workspace approver has to approve the request. For more information about team workspace management, see Manage team workspaces.

To see all workspaces, on the Home page, select Workspaces. You can also select Workspaces > View all workspaces in the Postman header. A directory of workspaces displays, showing the number of contributors, authors, access type, and the last updated date for each workspace.

View all workspaces

To approve a request to create a workspace, select the Pending requests tab. This is where you can approve requests to change the visibility of a workspace, for example, when a user wants to make an existing workspace public.

Community Managers can also approve requests to change a workspace's visibility to public from its workspace settings. Learn more about converting a workspace to a public workspace.

Approve request to change workspace visibility

Approve requests for access to private workspaces

Private workspaces are only available to Professional and Enterprise teams.

Team members can request access to a private workspace if another user with access provides them with a link to it. All Workspace Admins are notified of requests for access in Notification icon Notifications and by email. Select Respond to Request to review requests for access.

Respond to request for access to private workspace

You can assign a workspace role to define a user's permissions within the workspace, then select Approve to grant them access. You can also choose to reject a request for access by selecting Deny. Team members who have requested access are notified of your decision in Postman and by email.

Requests for access to private workspaces expire if they aren't reviewed within 15 days. If this occurs, Postman alerts the affected users to resubmit their request for access.

Move elements to workspaces

Workspaces can contain elements such as collections, APIs, environments, mock servers, and Flows. An element can exist only in a single workspace. If needed, you can move elements to a different workspace.

You must be a Super Admin or Workspace Admin to move an API, collection, environment, mock server, or Flow to a workspace.

An API's collections move with the API to the new workspace. Some items related to the element you're moving won't automatically move. You must manually move or reconfigure the following in the new workspace:

  • Monitors can't be moved to a new workspace. If you move a collection that has an active monitor, the associated monitor is paused and stays in the original workspace.
  • If you move an environment that's associated with an element or integration, the element or integration using the environment may no longer work.

To move an element to a different workspace, do the following:

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

  2. Select Options icon View more actions next to an element and then select Move.

    Move collection
  3. Select the workspace where you want to move the element. Then select Move (Collection, API, Environment, Mock Server, or Flow).

    You can move elements to personal, private, team, partner, and public workspaces you have access to. You can't move elements from a private, team, partner, or public workspace to a personal workspace.

    Move collection to workspace

Add workspaces to the Private API Network

You can also share workspaces with your teammates by adding them to your team's Private API Network. To learn more, see Requesting to add a workspace from the workbench.

Delete a workspace

Deleting a workspace removes the workspace and all data in it from Postman. Use caution, as once you delete a workspace it's gone forever. You must be a Workspace Admin to delete a workspace.

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

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

  3. At the bottom of the Workspace settings screen, select Delete Workspace.

    Delete workspace

To delete a public workspace, you must first change the workspace visibility to team or private.

Last modified: 2024/07/24