Use comments to discuss your work with your teammates in Postman. You can add comments to collections, folders, requests, examples, and pull requests. Reply to a comment to keep the discussion going, or resolve a comment if it's been addressed. If you have questions or feedback, you can let your teammates know by mentioning them in your comments.
You can also add comments to APIs and API definitions in Postman. Learn more about commenting on APIs.
You can add comments to a collection in Postman. You can also add comments to folders, requests, examples, or pull requests in collections. When you add a comment, Postman notifies other collection contributors about your comment.
You must have access to a collection to add comments to it.
To add a comment to a collection, folder, request, example, or pull request, do the following:
Select Collections in the sidebar and select the collection, folder, request, example, or pull request you want to comment on.
Select the comments icon in the right sidebar and enter your comment.
Postman supports Markdown in comments. See the Markdown Cheatsheet on GitHub for tips on formatting.
(Optional) Select the Watch collection checkbox to be notified when there are changes to the collection. This option isn't available when commenting on pull requests.
Select Comment to add your comment.
Use inline comments to comment on a specific part of a request, or example, or script. You can add comments to parameters, headers, request bodies, and lines of code in scripts. When there are new inline comments, a notification appears on the comments icon in the request pane.
To add an inline comment to a request or example, do the following:
Open the request or example.
Select the part of the request or example you want to comment on and select Comment.
Enter your comment. You can select text within a query parameter, path parameter, header, and request body (form-data, x-www-form-urlencoded, and raw).
Select Comment to add your comment.
To add an inline comment to a script, do the following:
Use inline comments to comment on a change in a pull request.
To add an inline comment to a pull request, do the following:
Open the pull request.
Select the comments icon next to a change and enter your comment.
Select Comment to add your comment. If comments are associated with a change, you can select the notification comments icon next to a change to view its comments.
You can edit or delete a comment, or a get a link to a comment you can share with others.
Select a collection, folder, request, example, or pull request 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're a Workspace Admin, you can delete contributor comments, but you can't edit contributor comments.
You can reply to a comment to keep the conversation going. Replies are grouped with the original comment, so you can have more than one comment thread on a collection, folder, request, example, or pull request. When you reply to a comment, the user who added the comment will receive a notification about your reply.
To reply to a comment, do the following:
Select a collection, folder, request, example, or pull request in the sidebar, then select the comments icon in the right sidebar.
Select the comment you want to reply to and enter your reply.
(Optional) Select the Watch collection checkbox to be notified when there are changes to the collection. This option isn't available when commenting on pull requests.
Select Reply.
If you're replying to a comment on a request or example, you can also select the highlighted part of the request or example.
If you're replying to a comment on a change in a pull request, you can also select the notification comments icon next to a change.
You can resolve a comment after it's been addressed.
Select a collection, folder, request, example, or pull request 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.
If you leave feedback or a question for a specific teammate, you can let them know by mentioning them in your comment. To mention a teammate in a comment, enter @
followed by their name, then select the person from the list.
When you mention a teammate in a comment, Postman sends them a notification about it. Select the notifications icon in the Postman header to view in-app notifications.
If your teammate doesn't have access to the collection they've been mentioned in, they'll need to request access before they can read the comment.
Last modified: 2023/11/15