Using Workspaces
Workspaces is an easy and efficient way to collaborate with a group of users to develop and test APIs. You can either organize your work in personal workspaces or work with others in team workspaces. Postman designed a set of features that unleashes the power and versatiltity of using workspaces.
Here you’ll learn how to perform actions on workspaces and how to use workspaces to work with Postman elements.
Performing actions in workspaces
Using workspaces with Postman elements
Adding collections and environments from another workspace
You can add collections or environments from one workspace to another personal or team workspace.
In the Workspaces dashboard, select a workspace and click the Add to workspace button. The personal workspaces view appears by default.
Click “Team” to add collections or environments to team workspaces.
In the Add to this workspace page, select the source workspace that contains the collection or environment you want to add to the target workspace.
Click “Collection” or “Environment” and select the element(s) you want.
Click the Add to this Workspace button. The element(s) appear in your list of collections or environments in the target workspace.
Removing elements from workspaces
When you remove a workspace, it is no longer visible in that particular workspace. The element is still available in any other workspace where it exists.
You can remove an element from a workspace in the Postman app sidebar, or in the Workspaces dashboard.
In the sidebar
In the Postman app, select a collection and click the ellipses (…) button.
Click “Remove from Workspace”. The collection is no longer visible in the workspace.
In the Dashboard
In the Workspaces dashboard, click an element. In this example, we click “Collections”.
Click the ellipses (…) button in the element you want to remove and select “Remove from workspace”. The workspace is no longer visible.
Deleting workspaces
When you delete a workspace, you erase its existence in Postman.
To delete a workspace, go to the Workspaces dashboard and select a personal or team workspace. In this example, we select a team workspace to delete.
Click the ellipses (…) button for the workspace you want to delete and select “Delete”.
In “Delete Workspace”, click the Delete button. Remember when you delete a workspace, it is gone forever!
Deleting elements in workspaces
In the Dashboard
To delete a workspace element, go to the Workspaces dashboard and click a personal or team workspace.
Click the ellipses (…) button for the workspace element you want to delete and select “Delete”.
In the app
To delete an element in a workspace, go to the status bar at the bottom of the screen and click the “Build” menu.
Select “Browse” and select an element view: Collections, Environments, Monitors, Mocks, or Integrations view. The collection view appears by default.
Click the ellipses (…) button for the workspace element you want to delete and select “Delete”.
Joining workspaces
A user can join a workspace to work on collections, environments, monitors, mocks, and integrations. Let’s see how.
In the app
In the Postman app, click a Workspace in the header bar, which is “Neutrino level dectection” in this example.
Select “Team” and select a workspace to join under WORKSPACES YOU CAN JOIN.
In the collections view, click the Join button.
In the confirmation message, click the Start Building button to complete the process.
In the Dashboard
Go to the Workspaces dashboard and select team workspaces.
Scroll down to “Workspaces you can join” and click the Join button next to the workspace you want to join.
Sharing workspaces
Postman lets you share your personal workspaces with other users.
In the Dashboard
In the Workspaces dashboard, select a personal workspace you want to share. Next, click the ellipses (…) button and select “Share”.
In “Share a personal workspace”, select the users with whom you want to share the workspace from the “Members” dropdown menu.
Click the Share this workspace button. Your shared workspace appears in team workspaces.
In the app
To share a workspace, go to the status bar at the bottom of the screen and click the “Build” menu.
Select “Browse” and click the Share button to share a collection, environment, monitor, mock, or integration to share.
Sharing collections and environments in workspaces
Postman enables you to share your collections and environments in workspaces from the Postman app and the Workspaces dashboard.
Sharing collections in the app
In the sidebar
In the Postman app, select a collection in the sidebar and click the ellipses (…) button.
Select “Share Collection”. The SHARE COLLECTION modal appears. It offers three ways to share a collection: “Share in another workspace”, “Embed”, and “Get Link”.
Sharing collections in another workspace
Select this option to add a collection to a team workspace. The collection is visible to the team.
In the Workspaces dashboard, select a collection and then click the Share button. The collection is visible in your target workspace.
Sharing collections with the Embed or Run In Postman button
Select this option to embed a Run in Postman button in your collection for your API documentation, website, or Github readme.
The Run in Postman button lets anyone import and run this collection with one click. When you click the Generate Code button, you get a link that you can use for a dynamic or static button. You can also select the environment you want for the generated code.
The Run in Postman button shares the collection directly from Postman, so the collection is uploaded to Postman servers when you generate the embed code
Sharing collections with a link
Select this option to generate a shareable link for others to access your collections. You can manage a complete list of your collection links from your Workspaces dashboard.
In the Build menu
In the Postman app, click the Build menu in the status bar at the bottom of the screen.
Select “Browse”, and then select a collection.
Click the Share button.
Sharing collections in the Dashboard
In the Workspaces dashboard, select “Browse”, and then select a collection.
Click the Share button.
Sharing environments in the app
In the Build menu
In the Postman app, click the Build menu in the status bar at the bottom of the screen.
Select “Browse”, and then select an environment.
Click the Share button.
Sharing environments in the dashboard
In the Workspaces dashboard, select “Browse”, and then select an environment.
Click the Share button.
Viewing details of Workspaces
You can view the details of your personal or team workspaces.
In the Workspaces dashboard, select a personal or team workspace.
Viewing details of personal workspaces
To view the details of your personal workspaces, select “View Details” from the ellipses (…) button menu.
Viewing details of team workspaces
To view the details of your team workspaces, select “View Details” from the ellipses (…) button menu.
Renaming workspaces
You can rename your personal or team workspaces.
In the Workspaces dashboard, select a personal or team workspace and click the ellipses (…) button.
Renaming personal Workspaces
To rename your personal workspaces, select “Rename” from the ellipses (…) button menu. Then enter the new name for the workspace in the “Name” field and save your changes.
Renaming team workspaces
To rename your team workspaces, select “Rename” from the ellipses (…) button menu. Then enter the new name for the workspace in the “Name” field and save your changes. You must have admin privileges to modify team settings.
Publishing collections
Postman enables you to publish your collection and make it availabe to anyone with the published link.
To publish a workspace collection, go to the Workspaces dashboard and click a personal or team workspace.
In the collections view, click the ellipses (…) button and select “Publish”.
In “Publish Collection”, select the:
-
Environment
The collection’s public documentation contains the shared environment.
-
Custom domain
The selected domain contains the published domain.
-
Custom styling options
You can determine the color of the top bar, right side bar, and the highlight.
Click the Publish Collection button. Postman generates API documentation for your collections automatically in real-time.
Leaving workspaces
Postman allows you to leave a team workspace.
To leave a team workspace, select a team Workspace, click the ellipses (…) button, and select “Leave”.
In “Delete Workspace”, click the Leave workspace button. You can no longer work or add collections and environments to the workspace.
Editing descriptions of workspaces
You can edit descriptions for personal and team workspaces. In this example, we use a personal workspace.
In the Workspaces dashboard, select a workspace, click the ellipses (…) button, and select “Edit Description”.
In “Edit workspace details”, enter a new description in the “Summary” text box and save your changes.
Managing members of team workspaces
When you need to manage the members of your team workspace, go the Workspaces dashboard and select the “Team” view.
Click the ellipses (…) button and select “Manage Members”.
In “Edit workspace details”, add or remove team members in the “Members” dropdown menu, and save your changes.