New Inline Comments Make Collaboration Easier in Postman

As APIs become more important to modern businesses—and as the number of people working with APIs on any company’s team increases—the need for easier API collaboration during the development process also increases. Not only is the idea of API-first development gaining momentum, there is a wider variety of roles and new developers working on APIs today (read more about who works with APIs here). This means that seamless communication is essential. Postman’s engineering team is continuously addressing this need by implementing helpful collaboration features to both our web and desktop versions.

In this blog post, we’ll show how we’ve recently optimized the comments function for better collaboration.

Postman users have already been utilizing our commenting feature for a while now, leaving comments on APIs, collections, and requests. And you can tag your collaborators in the comment to notify them of a question or feedback. While this has proven great in helping teams collaborate thus far, we’ve been receiving requests to take it even further and provide the ability to comment within specific parts of the request. We’re excited to share that we’ve built this function so that you can now leave inline comments.

Today, inline comments ensure that collaborators leave and see questions or feedback in the right context. Less confusion means greater accuracy and efficiency.

You can now add comments in these specific parts of a request:

  • Request parameters (query parameters, path parameters, headers, request bodies of type form-data, and x-www-form-urlencoded)
  • Specific part of a raw body, a pre-request script, or a test script
Postman API Collaboration Comments
An example of adding an inline comment to a test script in Postman

Here are some scenarios in which inline comments help:

  • When you are helping to debug a request for a team member and want to point them to a particular part of the request so that they can change it
  • When you are unable to get the correct response of an API and want to ask a team member to take a look and debug the request
  • When you are reviewing the documentation of an API and want to comment on specific parts of the documentation to suggest changes
  • When you are reviewing a PR in Postman and want to comment on specific changes so that the author can correct mistakes

This new ability to conveniently leave inline comments and tag team members in specific parts of a request enables clearer communication, saves developers time, and helps teams avoid mistakes.

Watch and learn

Level up your Postman game with our YouTube video that quickly explains how to use inline comments:

What do you think of this feature? Tell us in a comment below. You can also give product feedback through our Community forum and GitHub repository.


Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

5 thoughts on “New Inline Comments Make Collaboration Easier in Postman

  • Looks like the new link is gona make it lot cleaner and more accessible for us together information

  • Thank you to all the staff who work so diligently, for being motivated to create our new Inline.

  • Very useful feature !!! Thanks for adding it.

    No more need to write fields name in bold in comments bodies.

  • After I initially commented I clicked the -Notify me when new feedback are added- checkbox and now each time a remark is added I get four emails with the identical comment. Is there any method you may take away me from that service? Thanks!

  • I’m always impressed by the level of achievement and dedication shown in your blog posts. Your team’s commitment to providing critical content is truly remarkable. save up the great work!