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.
- Creating a public workspace
- Accessing a public workspace
- Sharing a public workspace
- Joining a public workspace
- Leaving a public workspace
- Adding elements to a public workspace
- Removing elements from a public workspace
- Deleting a public workspace
- Managing public workspace members
- Next steps
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.
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.
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.
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 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.
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.
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.
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.
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.
Copy the Public profile URL and paste it in your browser to access your 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.
Select the public workspace, then click Join Workspace at the top right.
Once you join the workspace, you can start creating collections, sending requests, visualizing your responses, and more.
To leave a public workspace, select the ... on the right corner of the workspace overview > Leave workspace. Click Leave to finalize leaving the 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.
To share an environment, open it via Environments on the left-hand side, click ... > Share environment.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Click X next to the team member you want to remove from the public workspace, and click Save.