Prepare your internal workspace for team collaboration

You can use an internal workspace to draft and organize your work, and collaborate with your team. To prepare your internal workspace, you’ll fork your public collections from your public workspace to your internal 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 internal workspace

Depending on your team’s workflow, you can create a workspace that’s visible only to you and specific people or your entire team.

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

1. From the Postman header, click Workspaces > Create Workspace.
2. If you want to use a workspace template, select one.
3. Click Next.
4. Name your workspace.
5. Click Internal. Then, click Everyone in team or Only you and invited people.
6. Click 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, click Invite.
2. Use the available options, such as email, to invite your team members.
3. Choose a role for each team member.
4. Click 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 tab isn’t open, from the Postman sidebar, click 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, click Collections.
3. Next to your collection, click View more actions. Then, select Create a fork.
4. Select your team workspace. Then, click 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.