When you define your APIs in Postman using the API Builder, each API is associated with a workspace. You can share access to your APIs, discuss them in comments, and view schema activity.
You can share APIs with collaborators by going to the API you want to share in the sidebar. Select the more actions icon next to the API you want to share, then select Share.
For more details about sharing APIs, see Share your work in Postman.
You can move APIs to shared private, team, or public workspaces to collaborate with your team on API development.
You must be an Admin on an API or the Workspace Admin to move the API to another workspace. Learn more about roles and permissions.
To move an API to a shared workspace, do the following:
Select APIs in the sidebar.
Select the more actions icon next to an API and select Move.
Use the search box to find the workspace you want to move the API to, or select the filter icon to filter workspaces by visibility.
You can move APIs to personal, private, team, and public workspaces that you have access to. You can't move APIs from team, private, or public workspaces to a personal workspace.
Select the workspace, then select Move API. Any collections in the API will move with the API to the new workspace.
Tagging APIs is available on Postman Enterprise plans. You can apply shared tags to workspaces, collections, and APIs. Tags must be between two and 64 alphanumeric characters, starting with an alphabetic character, and contain only dashes and no spaces. You can add up to five tags.
Adding shared tags to APIs enables you to organize and search for APIs.
Once you add tags to the API, you can select a tag to open search results associated with the tag in a new tab.
To learn more about searching using tag names in Postman, see Search Postman. You can also search using tag names in the Private API Network when searching elements in the network, elements to add to the network, and elements to request to add to the network.
To add tags to an API, do the following:
Select APIs in the sidebar.
Select an API.
Select the Tags section to edit it.
Select an existing tag or enter a new tag. If you're adding a new tag, enter the new tag name and then select Create "tag-name".
Select the area outside of the Tags section to save your changes.
To remove tags from an API, do the following:
Select APIs in the sidebar.
Select an API.
Select the Tags section to edit it.
Select the close icon next to a tag.
Select the area outside of the Tags section to save your changes.
The watch option enables you to receive an email or in-app notification when a team member belonging to the same workspace modifies the API. For example, you'll receive a notification when a team member updates the API's definition, adds an element to the API, or adds a comment to the API.
Select Watch to start watching the API.
For more information about the changes to the API, select the notifications icon in the Postman header.
You will also receive an email with the information regarding who made the change, what the change was, and when it was made.
You won't receive notifications for changes that you made.
You can add one or more comments to an API. Use comments to discuss your APIs with collaborators in Postman, keeping the conversation in context and available to other stakeholders.
API producers (Admin role or Editor role) can add comments to an API. API consumers (Viewer role) can't add comments to an API and won't see comments made by API producers. However, API consumers can comment on published versions of an API.
To add a new comment to an API, do the following:
You can also add comments to collections you've added to your API and to requests and folders in that collection. Learn more about commenting on a collection.
To leave an inline comment on an API definition, do the following:
You can use Markdown in your comments. Check out the Markdown Cheatsheet on GitHub for tips on formatting.
To mention a collaborator in a comment, type @
followed by their name, then choose the person from the auto-suggested list. When you mention a teammate in a comment, Postman sends them a notification.
To manage API comments, select an API or a definition file in the sidebar, then select the comments icon in the right sidebar.
Select the more actions icon next to a comment and do one of the following:
If you have the Admin role for the workspace, you can delete comments made by any contributor, but you can't edit comments made by others.
To reply to an API comment, select an API or a definition file in the sidebar, then select the comments icon in the right sidebar. Select Reply on the comment you want to reply to. Enter your reply and select Reply.
You can resolve a comment after it's been addressed. Select an API or a definition file in the sidebar, then select the comments icon in the right sidebar. Select the resolve icon to resolve a comment and any associated replies.
You can't undo resolving a comment, but you can view resolved comments by selecting the filter icon in the comments pane.
You can publish your API to share the current state of your API with consumers. Keep in mind the following when publishing an API:
You can connect a Git repository to your API to sync your API between Postman and the repository. Keep in mind the following differences when commenting on Git-linked APIs:
You can view a history of changes to your API schemas and all linked collections. To access the changelog, open an API, then select the changelog icon in the right sidebar.
If you connect your API to a Git repository, the changelog is replaced by the Source Control pane. Learn more about API version control.
The changelog shows a list of changes made to the schema and associated elements. Select each entry for more details.
Last modified: 2023/07/15
Additional resources
Videos
Blog posts