Prepare your team workspace for team collaboration

You can use a team workspace to draft and organize your work, and collaborate with your team. To prepare your team workspace, you'll fork your public collections from your public workspace to your team workspace.

When your public API's next iteration is ready to publish, you can create a pull request and merge your changes to your public workspace. This makes your latest changes available to your API consumers on the Postman API Network.

If you prefer to use one workspace to manage your public APIs, you can skip the following sections and publish your public APIs to the Postman API Network.

Create your private or team workspace

Depending on your team's workflow, you can create a private or team workspace. If you want to limit access to invited team members, create a private workspace. If you want to invite everyone from your team, create a team workspace.

To create your private or team workspace, do the following:

  1. From the Postman header, select Workspaces > Create Workspace.
  2. If you want to use a workspace template, select one.
  3. Select Next.
  4. Name your workspace.
  5. Select Team icon Internal. Then, select Everyone in team or Only you and invited people.
  6. Select Create.

To learn more, see Create a workspace in Postman.

Invite team members to your workspace

To invite team members to your workspace, do the following:

  1. From the Postman header, select Invite icon Invite.
  2. Use the available options, such as email, to invite your team members.
  3. Choose a role for your team members.
  4. Select Invite.

You can continue to invite team members as your workspace, its collections, and your public APIs evolve.

To learn more, see Share workspace.

Edit your workspace details

To edit your workspace details, do the following:

  1. If your workspace's Overview icon Overview tab isn't open, from the Postman sidebar, select your workspace's name.
  2. Under Workspace description, add a description.
  3. Under About, add a summary.
  4. If you're on the Postman Enterprise plan, under Tags, add tags.

You can continue to edit your workspace details as your workspace, its collections, and your public APIs evolve.

To learn more, see Edit workspace details.

Fork your public collections from your public workspace

To fork your public collections from your public workspace, do the following:

  1. Open your public workspace.
  2. From the Postman sidebar, select Collection icon Collections.
  3. Next to your collection, select Options icon View more actions. Then, select Create a fork.
  4. Select your team workspace. Then, select Fork Collection.
  5. Repeat these steps for each of your public collections.

Your team workspace is ready to serve as your public API's source of truth.

To learn more, see Create a fork.

Last modified: 2025/03/26