Public workspaces

Public workspaces enable you to collaborate on entities with anyone across the world. Before you create a public workspace, navigate to your team profile settings and enable your public team profile. This will ensure your team's profile will show up on the Public API Network.

Enable team profile

Contents

Creating a public workspace

There are four types of workspaces - personal, team, private, and public workspaces. When you open a workspace, Postman will provide an overview of its contents, activity, and members in a new tab.

Open the workspace menu, then click + New Workspace.

New workspace

Specify a workspace name and summary.

If you are on a Postman Team or Free plan, you can create a public workspace by changing the workspace's visibility to Public. Add collaborators by entering their email addresses, then define their workspace roles.

You need to be a workspace admin to change the visibility of a workspace to public.

Public workspace

You can also create a public workspace by selecting the team workspace, changing the team's visibility dropdown to Public, then clicking Request to Change Visibility.

Visibility

If you are on a Postman Business or Enterprise plan, you need a community manager's approval to change the workspace visibility to Public.

Once you make a workspace public, a notification is sent to workspace members. Click the notification bell in the top right corner to view notifications.

In app notification

In addition to this, all users will receive an email with the workspace information regarding who has made the change and which workspace was affected. The email will also provide a direct link to the workspace.

Email notification

Once you make a workspace public, all entities within that workspace become publicly accessible through the workspace. You can convert a private workspace directly to public.

Within a team, you cannot have two public workspaces with the same name.

Accessing a public workspace

You can access public workspaces via the Workspaces category in the API Network. You can also access personal, team, and private workspaces using the workspace selector at the top of Postman.

Access Public Workspaces

To view and edit your public workspace details (e.g. name, description), navigate to the workspace selector and hover over a workspace. Then, click ... and select View.

Create public workspace dropdown

Sharing a public workspace

You can share a public workspace by sharing its public profile URL directly. To access the public profile URL, navigate to your Team, then click Team Settings.

View team settings

Copy the Public profile URL and paste it in your browser to access your workspace.

Enable public profile url

Joining a public workspace

If you are part of a team in Postman, you can find public workspaces to join. Open the workspaces drop-down from the control at the top of Postman in the left. Search for a public workspace and select the workspace you want to join.

Joining a public workspace overview

Select the public workspace, then click Join Workspace at the top right.

Join public workspace

Once you join the workspace, you can start creating collections, sending requests, visualizing your responses, and more.

Leaving a public workspace

To leave a public workspace, select the ... on the right corner of the workspace overview > Leave workspace. Click Leave to finalize leaving the workspace.

Leave public workspace

Adding elements to a public workspace

You can add existing collections and environments to another public workspace by sharing them.

To share a collection to a public workspace, open it via Collections on the left-hand side, click ... > Share collection.

Adding an collection to public workspace

To share an environment, open it via Environments on the left-hand side, click ... > Share environment.

Adding an environment to public workspace

Select the public workspace you want to share to, and choose whether you also want to remove the element from its current workspace. Click Share and Continue.

Share element to public workspace

Removing elements from a public workspace

When you remove an element from a public workspace, it is no longer visible in that particular workspace. The element is still available in any other workspace where it has been added.

From Postman, you can remove a collection from the sidebar. Click ... to open the collection menu. Select Remove from workspace and confirm that you would like to remove the collection from the current workspace. The collection will no longer be visible in the workspace.

Removing a collection to public workspace

To remove an environment from the sidebar, click ... next to the environment menu or click ... next to the Share button in the Environment tab. Select Remove from workspace and confirm that you would like to remove the environment from the current workspace. The environment will no longer be visible in the workspace.

Removing an environment to public workspace

Note that deleting an element is different to removing it. When you delete an element it is no longer available in any workspace. When you remove an element from a specific workspace, it will still be available in any other workspaces it was in.

Deleting a public workspace

Public workspaces must have their visibility reverted in order to be deleted. If you try to delete a public workspace by clicking ... on the right corner of the workspace overview, the option to delete will be greyed out.

Deleting a public workspace

To change the visibility of a public workspace, change the visibility dropdown to Team, then Save Changes. After changing the visibility, you will be able to delete the workspace. Click ... > Delete workspace.

Managing public workspace members

If you're a team administrator you can add or remove any member from your public workspace via the Members tab. To add members to a public workspace, see Inviting to team workspaces.

Another way to add workspace members is to click Manage Team and select Invite Users.

add workspace members public workspace (2)

Enter an email address, click Add to the team, select the roles you would like to assign to them, then select Send Invitations. You can also generate a link and invite people to your team by sharing the link with them.

Edit members for a public workspace

Team members will receive an email and in-app notification when added to a public workspace.

To remove any team member, click the trash icon next to the individual you want to remove from the workspace, and select Remove User From Team.

Remove team members for a public workspace

Click X next to the team member you want to remove from the public workspace, and click Save.

Remove members for a public workspace from overview

Next steps

To add an API to the network, see Adding your API. For more details on how to add categories to a public workspace, visit Adding categories and summaries.