Working with your team

Free collaboration is available in version 6.2 and above.

Postman allows all users to collaborate with their teams through Team Workspaces. Using this feature, you can easily collaborate and share your collections, environments, integrations, history, mocks, monitors, and more.

Postman will alert you with notifications when activities occur within your team and workspace. You can view and opt in or out notifications by selecting your avatar in the upper-right corner of Postman and clicking Notification Preferences.


Working with team workspaces

Create a Team Workspace by inviting a team member to join a personal workspace or create a new one.

Postman creates a default Team Workspace. You cannot delete this workspace but you can rename it.

Inviting a team member to a personal workspace

In Postman, select Invite.

Invite button

Enter the email address of the individual you would like to invite to your team workspace or the group name, then click Add > Send Invitations.

Invite users

The individual or group will be added to the team once they accept their invitation.

You can also use the Copy Invite Link and send it to people you would like to join your workspace.

"My Workspace" is a default workspace created by Postman. This workspace is different from other personal workspaces as it cannot be shared with anyone. It cannot be deleted, however it can be renamed. When you invite a teammate to join another personal workspace, Postman converts it into a team workspace.

All members of your workspace will have avatars displayed at the top of Postman. If the avatar is brightly colored, that person is active in the workspace at that time. Hover over an avatar to see the names of the people in your workspace.

Active member

Creating a new workspace from the menu

Select your current workspace in Postman to open the workspace menu, then click + New Workspace.

New workspace

Specify a workspace name and summary. For a team workspace, add collaborators by entering their email addresses, then define their workspace roles.

Team workspace

Team discovery

Enabling team discovery encourages collaboration and eases the onboarding process by allowing users accessing Postman with their company email address to request to join pre-existing teams within their organization.

Making your team discoverable

You can enable team discovery in the dashboard by selecting Team > Team Settings > Team Discovery.

Enable team discovery

Team admins will receive an email notification when team discovery is enabled.

You can optionally add a question for pending team members to answer when they request to join your team. Enter your question and click Update Question—anyone requesting to join the team will be prompted with the question.

If you do not specify a question, team members can still add a note when they ask to join.

You will receive a notification when anyone makes a request to join your team, including their answer to any question you set, or an optional note.

Team Request Approval

Finding teams within your organization

When you log in to the Postman web dashboard using a verified email address for your company or organization, you can see available teams to join by selecting your avatar > Your Team. You will also be prompted with available teams when you first sign into your Postman account with a verified address.

Choose Team

You will see a list of available teams within your org. Select a team, answer the question set by the team admin if there is one (otherwise you can add an optional note), and click Request to join.

Team Join Question

The team administrator will receive a notification that you’ve asked to join the team. Once they approve your request, you will be able to access the team and collaborate on API projects within it.

Leaving a team

You can leave a Postman team by navigating to your Postman Dashboard, selecting your avatar in the top-right corner, and clicking Your Team. Click Leave Team.

Leave team

If you are the last member to leave your team, you will have the option to transfer collections to a personal workspace.

Leave and delete team

If you are invited to a new team and you are the last in your current team, all team data will be transferred to your personal default workspace.

Usage limit

You can check your usage limits within Postman. Free users can select the drop-down menu to the right of Upgrade in the app. Paid users can access the menu by selecting a team name.

The usage menu allows you to review limits for APIs, shared requests and history, mocks, monitors, and public documentation. Click Resource Usage to view your usage period.

usage info

How archiving works

Postman archives collections when a free team's collaboration exceeds usage limits. Archived collections cannot be collaborated on, however they are still accessible to users. You will receive an in-app notification when a collection is archived.

archived message

Postman chooses which collection(s) to archive based on last edit date. The collections that have gone the longest without a revision will be archived in order to bring your team within usage limits.

Postman indicates the number of archived collections at the bottom of the left sidebar.

archived message

Recovering your archived collections

To recover archived collections, select Archived Collections.

You will then be directed to your dashboard, where you can click Download your data > Request data export > Request an archive. export data1

You will then be able to select Download to retrieve your archived data.

Download Data

The archive.json inside the downloaded ZIP archive is not a Postman collection that can be imported; it is simply an index of files present in the archive. A collections folder contains all the files that can be imported.

Alternatively, you can download your archived data directly within Postman. To learn how, refer to Settings.

Next steps

For a more in-depth introduction to workspaces and how they can help organize your API development, check out Creating Workspaces.

To see how you can share the APIs that your teams use internally, check out Your private API Network.