Postman’s API documentation feature allows Postman Pro users to share public or private API documentation, beautifully viewable via a web page.
Postman Pro generates and hosts browser-based API documentation for your collections automatically in real-time. Each collection has a private and public documentation view, generated in real-time using the data synced to our servers. In order to access the private view, which is only available to your team, click “View Docs” in the Postman app or in the “Team Library”. The public view is accessible via the public link, generated when you publish your documentation. This link will be displayed right after your documentation is published, and is also accessible via the “Published” dropdown in the private documentation view.
Documentation for your API includes the following:
Documentation is organized into sections that reflect the structure of your collection, by ordered requests and folders. Descriptions can be customized using Markdown styling with embedded graphics to complement your documentation. GitHub flavored markdown is also supported, so you can even include tables. When including block elements, ensure that you leave an empty line before and after to avoid any rendering issues.
Note: Custom examples are coming soon. Check out our public roadmap for updates.