Publish your public APIs to the Postman API Network

Once you've prepared your public workspace, prepared your public collections, curated them, and prepared your team workspace for team collaboration, you're ready to publish your public APIs.

Evaluate the developer experience

Before you make your workspace public, and begin to share and promote your public APIs, walk yourself through the steps you outlined in your overview collection. Invite others on your team to do the same.

If you haven't already, create a team workspace and fork your public collections. Even if you decide to use one workspace to manage your public APIs, the exercise will walk you through your API consumer's steps.

Gather feedback and iterate to curate your public collections. Continue to iterate until you're satisfied you can get your new users to their first 200 OK response in the fewest steps as possible.

Pin your collections to your workspace overview

To pin your collection to your workspace overview, do the following:

  1. From the Postman sidebar, select your workspace's name.
  2. Select Pin icon Pin Collections or Add icon, and pin your collection.
  3. Choose an environment for your collection.

When an API consumer selects your pinned collection, Postman opens it and sets the environment for them.

To learn more, see Pin collections to workspaces.

Make your workspace public

To make your workspace public, do the following:

  1. Open your public workspace.
  2. If your workspace's Overview icon Overview tab isn't open, from the Postman sidebar, select your workspace's name. Then, select Settings.
  3. Under Workspace type, select Change.
  4. Select Published icon Public.
  5. If you're prompted to submit a request, optionally add a note and select Submit Request.
  6. Otherwise, select Save Changes.

Your public workspace and its collections are available on the Postman API Network.

To learn more, see Convert an existing workspace to a public workspace.

Create a Run in Postman button

To create a Run in Postman button, do the following:

  1. Open your public collection.
  2. Next to your collection, select Options icon View more actions. Then, select Share.
  3. Select Run in Postman.
  4. Choose an environment.
  5. Choose HTML friendly or Markdown friendly, and select Copy icon Copy Code.

You can paste the code anywhere that supports HTML or Markdown. When someone selects the button, they're prompted to fork your collection.

To learn more, see Create a Run in Postman button.

Last modified: 2025/03/26