If any team uses your product as a design platform for the APIs, they will face a real challenge regarding sharing notes and feedback during the designing process.
It will be better to have one of two options.
[ Simple ] A comments per endpoint with resolve status (to close the comment/note once is closed) like GitHub pull request comments
[ Advance ] A comment per section (endpoint path, query field, path field, the schema of the request, the schema of the response, …)
I second that! It was really useful that in postman you could add comments. In my team’s case especially on pre- and post processing scripts, which made test automation code reviews possible and smooth. It would be really nice if this tool supported comments as well, both on API design and testing parts as well, thus boost teamwork!