Your private API network

Share the APIs that your team uses internally to the private API network. Your team can learn about and access these APIs and start using them right away.

If you're logged in, go directly to your team's private API Network. You can always find it by clicking API Network at the top from anywhere in the Dashboard.

In order to add your API to the network, it must be in the API Builder. You can only add APIs, not collections, to the private API network.

Contents

• Adding your APIs

  • Security
  • Guidelines
• Discovering and consuming private APIs
• Next steps

Adding your APIs

You can only add an API to the network if you have edit access to the API, and your team members have permission to view or edit the API. Learn more about roles and permissions.

To add an API to your team's private API network from your Dashboard, sign in and click API Network at the top.

The default view is your team's private API network. Click + Add new.

In the modal, choose the workspace containing the API you want to add to the network. You can select as many APIs to add to the network at one time. For each API selected, specify the version(s) to add. Then click Add to Network.

The APIs that you add to the private API network reflect the latest state of the API in your team workspace. In other words, changes made to the API in the workspace will be reflected in the network in real time.

The API will immediately be visible in your team's private API network. From the listing, you can edit the network listing or remove the API from the network.

You can also add an API to your team's private API network from the Postman app. Go to the API Builder via APIs in the left sidebar. Select an API, and see a high-level description on the first tab Overview. You can add and edit your network listing next to the version details on the right.

Security

Private APIs are only visible to logged in users who are a part of your Postman team. They are not discoverable or accessible to anyone who is not a part of your team.

Guidelines

To submit an API to the network, you must have edit access to the API. You cannot add an API to the private network unless all team members have at least view access to the API. Learn more about team roles and permissions.

Discovering and consuming private APIs

The private API network is a good place to learn about APIs shared within your team. You can browse private APIs in the private API network under your team name, or explore public APIs in the public API network.

Private APIs are only visible to logged in users who are a part of your Postman team.

Under your team name, you can browse a directory of APIs shared within your team.

Select an API to see a high-level description.

Click through Open in Builder to see a more detailed overview of the API in the web version of the API builder. Under the Overview tab of the API builder, you can review information about the API and update the description. You can see team collaborators and activities like recently added collections associated with this API.

You can also review version-level details on the right. Next to Versions, you can Edit network listing. All available versions are listed below, with an indicator of the active version as well as the version(s) listed to the network. Add to API Network will display if you haven't yet added the API to the private network.

Next steps

• Writing API documentation
• Generating collections from the API