- Installation and updates
- Sending your first request
- Creating the first collection
- Navigating Postman
- Keyboard Shortcuts
- Postman account
- New button
- Troubleshooting In-app Issues
- Customizing Postman
- Find and Replace
- Troubleshooting API requests
- Debugging and logs
- Authorizing requests
- Capturing HTTP requests
- Generate code snippets
- Making SOAP requests
- Working with Tabs
- Using GraphQL
- Visualize API responses
- Intro to collections
- Creating collections
- Sharing collections
- Managing collections
- Requesting access
- Using Markdown for descriptions
- Data formats
- Working with OpenAPI
- Commenting on collections
- Version Control for Collections
- Intro to scripts
- Pre-request scripts
- Test scripts
- Test examples
- Branching and looping
- Postman Sandbox
- Postman Sandbox API reference
- Intro to collection runs
- Starting a collection run
- Using environments in collection runs
- Working with data files
- Running multiple iterations
- Building workflows
- Sharing a collection run
- Debugging a collection run
- Command line integration with Newman
- Integration with Jenkins
- Integration with Travis CI
- Newman with Docker
- Documenting your API
- Viewing documentation
- Authoring your documentation
- Publishing your docs
- Custom documentation domains
- Intro to Monitoring
- Setting up a monitor
- Viewing monitor results
- Monitoring APIs and websites
- Set up integrations to receive alerts
- Pricing for monitors
- Troubleshooting monitors
- FAQs for monitors
- Intro to mock servers
- Setting up a mock server
- Mocking with examples
- Mocking with the Postman API
- Matching algorithm
- Introduction to APIs
- Managing APIs
- Sharing APIs and managing roles
- The API Workflow
- Validating Elements Against Schema
- Versioning APIs
- Reporting FAQs
- Viewing and analyzing APIs
- Intro to Workspaces
- Creating Workspaces
- Managing Workspaces
- Using Workspaces
- Sharing collections in Workspaces for version 5
- Viewing changelogs and restoring collections
- What is Postman Pro
- Purchasing Postman Pro
- Upgrading to Postman Pro from a trial team
- Team Settings
- Changing your plan
- Managing your team
- Migrating to Postman v7
- Roles and permissions
- Intro to Enterprise
- Purchasing Postman Enterprise
- Running Postman monitors using static IPs
- Intro to SSO
- Configuring SSO for a team
- Logging in to an SSO team
- Configuring Microsoft AD FS with Postman SSO
- Setting a custom SAML in Azure AD
- Setting up custom SAML in Duo
- Setting up custom SAML in GSuite
- Setting up custom SAML in Okta
- Setting up custom SAML in Onelogin
- Setting up custom SAML in Ping Identity
- Audit logs
- Publishing API documentation
Commenting on collections
Postman provides a quick way to collaborate with your team members by allowing you to post comments on collections and requests. This is an easy way to provide valuable feedback to your team members on your collections and requests.
This topic describes the following sections:
- Posting comments
- Reading comments
- Editing comments
- Deleting comments
- Tagging members in comments
- Markdown support
- Postman app currently supports comments on requests only.
- Team members must have access to the collection in question in order to post comments.
- You can only post comments on saved requests.
You can leave a comment on a collection through the Postman Dashboard. To post a comment on a collection, navigate to the
Collections tab at the top of the page, select the collection you want to leave a comment on, then click Comments.
You can comment on requests via the web dashboard or the Postman app. When you comment on a request, it is reflected in both the Dashboard and the app.
To post a comment, select the corresponding request and click Comments. Write your comment, then click Add Comment to publish. The procedure to post a comment is similar in the Postman app and the dashboard.
If someone tags you in a comment on a private collection that you don’t have access for, Postman sends a notification to you. However, you can’t read the comment until the collection or the request is shared with you.
You can see comments made by teammates on requests and collections with the Postman app or the web dashboard.
To review comments, navigate to the request in question and click Comments to view all comments associated with the request.
The comment button displays the number of existing comments between brackets.
You can read the comments made on a collection through the Postman Dashboard.
To read the comments on a collection, navigate to the Collections tab at the top of the page, select the collection in mind, then click Comments.
To read the comments on a specific request, navigate to the Collections tab at the top of the page, select the collection to which the request belongs, select the request, then click Comments.
After posting a comment, you can go back, edit your comment and save your changes. Only you as a creator of the comment will be able to update/modify your comment.
You can delete your comments by clicking delete:
For moderation purposes, Admins can delete anyone’s comment. However, admins will not be able to update/modify a comment.
Sometimes you may want to call the attention of a team member when posting a comment. In such a scenario, you can tag a person by typing the @ symbol followed by the member’s name and then choosing the corresponding name from the auto-suggested list. When you tag a member in your comment, Postman notifies the member by sending a notification.
The user tagged in your comment will get a notification by email and/or in-app as long as they have not disabled these types of notifications. The notifications in-app are shown at the top-right on the bell icon. To navigate to the comment, the recipient can click the collection name.
Postman comments support Markdown. For more information on formatting using Markdown refer to Markdown in API Documentation.