- Installation and updates
- Sending your first request
- Creating the first collection
- Navigating Postman
- Keyboard Shortcuts
- Postman account
- New button
- Troubleshooting In-app Issues
- Customizing Postman
- Find and Replace
- Troubleshooting API requests
- Debugging and logs
- Authorizing requests
- Capturing HTTP requests
- Generate code snippets
- Making SOAP requests
- Working with Tabs
- Using GraphQL
- Visualize API responses
- Intro to collections
- Creating collections
- Sharing collections
- Managing collections
- Requesting access
- Using Markdown for descriptions
- Data formats
- Working with OpenAPI
- Commenting on collections
- Version Control for Collections
- Intro to scripts
- Pre-request scripts
- Test scripts
- Test examples
- Branching and looping
- Postman Sandbox
- Postman Sandbox API reference
- Intro to collection runs
- Starting a collection run
- Using environments in collection runs
- Working with data files
- Running multiple iterations
- Building workflows
- Sharing a collection run
- Debugging a collection run
- Command line integration with Newman
- Integration with Jenkins
- Integration with Travis CI
- Newman with Docker
- Documenting your API
- Viewing documentation
- Authoring your documentation
- Publishing your docs
- Custom documentation domains
- Intro to Monitoring
- Setting up a monitor
- Viewing monitor results
- Monitoring APIs and websites
- Set up integrations to receive alerts
- Pricing for monitors
- Troubleshooting monitors
- FAQs for monitors
- Intro to mock servers
- Setting up a mock server
- Mocking with examples
- Mocking with the Postman API
- Matching algorithm
- Introduction to APIs
- Managing APIs
- Sharing APIs and managing roles
- The API Workflow
- Validating Elements Against Schema
- Versioning APIs
- Reporting FAQs
- Viewing and analyzing APIs
- Intro to Workspaces
- Creating Workspaces
- Managing Workspaces
- Using Workspaces
- Sharing collections in Workspaces for version 5
- Viewing changelogs and restoring collections
- What is Postman Pro
- Purchasing Postman Pro
- Upgrading to Postman Pro from a trial team
- Team Settings
- Changing your plan
- Managing your team
- Migrating to Postman v7
- Roles and permissions
- Intro to Enterprise
- Purchasing Postman Enterprise
- Running Postman monitors using static IPs
- Intro to SSO
- Configuring SSO for a team
- Logging in to an SSO team
- Configuring Microsoft AD FS with Postman SSO
- Setting a custom SAML in Azure AD
- Setting up custom SAML in Duo
- Setting up custom SAML in GSuite
- Setting up custom SAML in Okta
- Setting up custom SAML in Onelogin
- Setting up custom SAML in Ping Identity
- Audit logs
- Publishing API documentation
Workspaces are 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.
In this section, you'll learn how to work in workspaces, including:
- Adding elements to another workspace
- Removing elements from a workspace
- Deleting a workspace
- Deleting elements in a workspace
- Joining a workspace
- Sharing a workspace
- Sharing collections and environments in workspaces
- Viewing details of a workspace
- Renaming a workspace
- Leaving a workspace
- Editing a description of a workspace
- Managing members of a team workspace
You can add collections or environments from one workspace to another workspace. In the Workspaces dashboard, click the Add to workspace button next to a workspace to which you would like to add a collection or environment.
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.
Under the Collections or Environments tab, select the element(s) you want to add.
Click the Add to this Workspace button. The element(s) will now appear in your list of collections or environments in the target workspace.
When you remove an element from a 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 the Postman app, you can remove a collection from the sidebar. Click the ellipsis (...) next to the collection you would like to remove. 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.
From the Postman app, you can remove an environment from the Manage Environments modal. Click the ellipsis (...) next to the environment you would like to remove. 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.
Similarly, you can also remove collections and environments from the Workspaces dashboard in the web view.
When you delete a workspace, you erase its existence in Postman. Only the original creator of a workspace or a team admin can delete a workspace.
To delete a workspace, go to the Workspaces dashboard and select a workspace.
Click the ellipsis (...) next to the workspace you want to delete and select "Delete".
In "Delete Workspace", confirm that you wish to delete the workspace. Remember when you delete a workspace, it is gone forever!
To delete an element in a workspace from the Postman app, go to the status bar at the bottom of the screen and make sure you are on the "Browse" mode.
Select an element view for either Collections, Environments, Monitors, Mocks, or Integrations.
Click the ellipsis (...) next to the workspace element you want to delete and select "Delete". Confirm that you would like to delete this element, and you will no longer see the element visible within the workspace.
Similarly, you can also delete elements from the Workspaces dashboard in the web view.
Note: Deleting an element is different than removing it. When you delete an element, it is gone forever! When you remove an element, it will continue to exist in other workspaces to which it has already been added.
A user can join a workspace to work on collections, environments, monitors, mocks, and integrations. Let's see how.
In the Postman app, click the workspace in the header bar to open the workspaces menu dropdown.
Under the "Team" tab, select a workspace to join under WORKSPACES YOU CAN JOIN.
Click the orange Join button in the top right.
In the confirmation message, click the Start Building button to complete the process.
Similarly, you can also join a workspace from the Workspaces dashboard by clicking the Join button next to the workspace that you wish to join.
Postman lets you share your personal workspaces with other users.
In the Postman app, click the workspace in the header bar to open the workspaces menu dropdown. Click the All workspaces link to open the the Workspaces dashboard in your web browser.
From the "All Workspaces" view of the Workspaces dashboard, click the ellipsis (...) next to the personal workspace that you wish to share, and select "Invite to workspace".
In "Share a personal workspace", search for existing team members with whom you want to share the workspace, or select them from the "Members" dropdown menu. If you are an Admin, adding users outside the team will invite them to join the team. Postman Enterprise users can check the box to limit the visibility of this workspace to invited members to make a private workspace.
Click the Share this workspace button. Your shared workspace will now appear as a team workspaces.
You can share collections, environments, and other Postman elements in workspaces so that your teammates can view or edit them. Sharing an element in a workspace is the same as adding an element to a workspace when you add the element to a team workspace.
If you add an element to a team workspace, the collection will be visible to others on the team. Postman Enterprise users can create private workspaces to limit the visibility of a workspace to only invited team members.
Select this option to add a collection to another workspace. If added to a team workspace, the collection will be visible to others on the team.
Admins can set team default permissions to either view only or edit. They are also able to grant existing team members individual user permissions.
Similarly, you can also share elements from the Workspaces dashboard. For example, select a collection and then click the Share button. The collection is visible in your target workspace.
From the Postman app workspace selector, click the ellipsis (...) next to the workspace for which you wish to view the details. Select the View Details option.
Similarly, you can also view the details of your workspace from the Workspaces dashboard.
In the Workspaces dashboard, click the ellipsis (...) next to the workspace that you wish to rename. Select "Rename". Update the name and save your changes.
To rename a team workspace, you must have admin privileges to modify team settings.
To leave a team workspace, click the ellipsis (...) next to the workspace that you wish to leave. Select the "Leave" option. In "Leave Workspace", confirm that you wish to leave.
Once you leave a workspace, you can no longer collaborate on elements within the workspace, however you can always join the workspace again in the future.
You can edit descriptions for personal and team workspaces.
From the "All Workspaces" view of the Workspaces dashboard, click the ellipsis (...) next to the workspace you wish to update, and select "Edit Description".
In "Edit workspace details", update the summary and save your changes.
For team administrators who want to manage the members of your team workspace, go the Workspaces dashboard and select the Team tab.
Click the ellipsis (...) next to the workspace you want to update, and select "Manage Members".
In "Edit workspace details", add or remove team members in the "Members" list, and save your changes.