Organize your projects in Postman using workspaces

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.

Workspaces selected

With a Postman account you can create various types of workspaces:

  • Personal - Personal workspaces are visible to you. If you're on an Enterprise team, Super Admins will also have access to any personal workspaces created within the team.
  • Private - Private workspaces are visible to you and to any team members you invite to them (Professional and Enterprise plans).
  • Team - Team workspaces enable you to share projects with collaborators and manage access to them within your team.
  • Partner - Invited team members and partners can access Partner Workspaces (Enterprise Ultimate plans only).
  • Public - Public workspaces enable you to collaborate on elements with anyone across the world.

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.

Contents

Create a new workspace

  1. To create a new workspace, select Workspaces in the header, then select Create Workspace.

    Create new workspace
  2. 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.

    Create new workspace
  3. Enter a Name for your workspace.

  4. Use the visibility menu to choose a Personal, Private, Partner, Team, or Public workspace.

    Create new 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.

  5. 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.

Create new workspace

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

Create new workspace dashboard

Apply a template to a workspace

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:

  1. In the workspace overview, select Explore workspace templates.
  2. Select a template from the list in the sidebar, then select Apply Template.

Next steps

After you create a workspace, you can use the workspace to collaborate with your team.

Last modified: 2023/10/24