Workspaces enable 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 elements. By collaborating in a workspace, your edits sync with your team in real time.
With a Postman account you can create various types of workspaces:
By adding an element to a workspace, collaborators with access to the workspace will also be able to access the element by default with read permissions. You can configure access settings for the workspace on an individual basis to give permissions depending on the account.
Workspaces can also create visibility for the projects within a team, as collections in a workspace are visible to all team members with access to the workspace.
Workspace as an element represents a whole container where being an Admin gives you full access to the workspace. This 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's visible to the user who created it, plus team members who have been invited to join it. Private workspaces let teams restrict access to APIs, collections, environments, mocks, and monitors that are relevant to a particular group.
To create a new workspace, select Workspaces in the header, then select Create Workspace.
You can select a workspace template like the API development template, the API testing template, and others to help you set up a new workspace. Select a workspace template to populate the workspace with helpful information and sample collections and environments, or select Blank workspace to create an empty workspace. Then select Next.
You can also apply a workspace template to a newly created workspace. To learn more, see Apply a template to a workspace.
Enter a Name for your workspace.
Use the visibility menu to choose a Personal, Private, Partner, Team, or Public workspace.
(Enterprise plans only) If your team manages who can create team workspaces, users without permission to create team workspaces must submit a request for approval by a Super Admin, Team Admin, or user with permission to create team workspaces. You can also add an optional note to your request. The workspace's visibility will be set to private until your request is approved. Postman will notify you whether your request is approved or denied.
Select Create and Postman will open your new workspace. You can add elements to the workspace. Select Invite in the Postman header to add other users to the workspace.
To create a new workspace, you can also select New in the sidebar, then select Workspace and follow the same steps.
You can also create a new workspace in the Workspaces dashboard. Select Create Workspace and follow the same steps.
Learn how to approve workspace creation requests.
You can apply a workspace template to an existing workspace. Workspace templates are available for a variety of common use cases, including API demos, engineering onboarding, and API testing.
When you apply a workspace template, it will populate the workspace description with an introduction and information to help you get started. Each workspace template also includes sample collections and environments that you can use and change as needed. To use a template, create a new workspace or open a newly created workspace.
To use a template in a newly created workspace, do the following:
After you create a workspace, you can use the workspace to collaborate with your team.
Last modified: 2023/10/24
Additional resources
Videos
Blog posts
Case Studies