Creating workspaces

Workspaces allow you to organize your Postman work and collaborate with teammates. You can group your projects together, with workspace acting as the single source of truth for related APIs, collections, environments, mocks, monitors, and other linked entities. By collaborating in a workspace, your edits are synced with your team in realtime.

Workspaces selected

Personal workspaces are visible only to you—with a Postman account you can create unlimited workspaces. With team workspaces, you can share and manage access to project components with collaborators. Public workspaces enable you to collaborate on entities with anyone across the world.

By adding an entity such as a collection to a workspace, collaborators with access to the workspace will also be able to access the entity by default with read-only permissions. You can configure access settings for the workspace on an individual basis to provide permissions depending on your account.

Workspaces can also create visibility for the projects within a team, as collections in a workspace are visible to all members with access to the workspace. Request history is also saved to a workspace, which can aid collaborative debugging efforts.

Workspace as an entity represents a whole container where being an admin gives you full access to the workspace. This concept works like the inheritance property where you will have editor access to all the elements within that particular workspace.

For Postman Professional and Enterprise teams, a private workspace is a team workspace that is only visible to the user who created it, plus team members who have been invited to join it. Private workspaces allow teams to restrict access to collections, environments, mocks, and monitors that are relevant only to a particular group.

Creating a new workspace

To create a new workspace, select the workspace dropdown menu at the left of Postman, and click Create Workspace.

Create new workspace

Use the visibility dropdown to choose a Personal, Team, Private, or Public workspace.

Note that you can only move elements from one workspace to another.

To create a personal workspace, enter the workspace name and summary, then select Personal under Visibility.

Create personal workspace

To create a team workspace, enter the workspace name and summary, then select Team under Visibility.

Team workspace

Click Create Workspace and Postman will open your new workspace. You can add elements to the workspace and invite new members using the Invite button in the upper right of Postman.

To create a new workspace, you can click the New button above the navigation bar, select Workspace and follow the same steps.

Create workspace new button

You can also create a new workspace in the Workspaces dashboard. Select New workspace and follow the same steps.

Create new workspace dashboard

Next steps

Check out some tips on how to use and manage your workspaces. You can also use your workspace activity feed to keep up to date with progress on the projects within it.

Last modified: 2021/12/15