Postman’s API documentation feature lets you share public or private API documentation in a beautifully formated web page.
Postman generates and hosts browser-based API documentation for your collections automatically in real-time. Each collection has a private and public documentation view that Postman generates from synced data in the servers.
To access the private view that’s available to your team, click “View in web” in the Postman app or in the “Team Library”.
When you publish your documentation, you can use the public link to view the documentation. The public link displays after you publish your documentation. The documentation is also accessible in the “Published” dropdown in the private documentation view.
You can create documentation from the:
Note: At the bottom, you can select “Show this window at launch” to indicate whether you want the Create New tab to display each time you open Postman.
In the Next steps tab, see a list of suggested next steps to maximize the effectiveness of your documentation.
The Create New tab appears by default when you launch Postman.
Note: At the bottom, you can select “Show this window at launch” to indicate whether you want the Create New tab to display each time you open Postman.
Documentation for your API includes:
Postman uses ordered requests and folders to organize documentation in sections to reflect the structure of your collection.
You can customize descriptions using Markdown styling with embedded graphics to complement your documentation.
We support GitHub flavored markdown so you can include tables. When including block elements, make sure you leave an empty line before and after to avoid any rendering issues.
Your Postman account gives you a limited number of free documentation views per month. You can check your usage limits through the Postman API or the account usage page.