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 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 internal workspace, do the following:

1. In the Postman header, open the workspace switcher. Then, click Create.
2. If you want to use a workspace template, choose one.
3. Click Next.
4. Name your workspace.
5. If you’re part of an organization, choose a team.
6. Click Internal. Then, choose whether to share access with everyone in your team or only you and invited people.
7. 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. Open your workspace.
2. In the Postman header, click Invite.
3. Use the available options, such as email, to invite your team members.
4. Choose a role for your team members.
5. 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. Open your workspace.
2. In the left sidebar, click Options > Workspace overview.
3. Add a summary and description.

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 and the collection you want to fork.
2. Next to your collection, click View more actions. Then, click Fork.
3. Choose your team workspace. Then, click Fork Collection.
4. 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.