Documentation helps you get more out of the collections and APIs that you work with in Postman. View documentation to learn more about the requests in a collection or how to interact with an API's endpoints.
By default, documentation for a collection or API is private. You can view the documentation for any collections or APIs that have been shared with you directly or through a team workspace.
Documentation authors can also choose to publish their documentation to make it publicly available. Anyone in the world can view the public documentation using a web browser. If the associated collection is in a public workspace, people can also view the collection in Postman.
You can view the documentation for any collection that you created or for collections that have been shared with you.
Postman teammates with the Viewer role can view documentation, while teammates with the Editor role can also create and update documentation. Learn more about roles and permissions.
To view documentation for a collection, do the following:
Select Collections in the sidebar, then select a collection.
You can also search for collections on the Postman API Network.
In the Overview tab, select View complete documentation.
You can't view complete documentation if your collection has gRPC requests or WebSocket requests. To view the description for a collection or folder, select it in the sidebar. To view the request description, open the request and select the documentation icon in the right sidebar.
The documentation includes a description of each request and details such as the method and URL, the required authorization type, and any headers or parameters. For each request, you can view sample code in various client languages, together with example response bodies and headers.
Use the following options to customize the appearance of the documentation:
Another way to view documentation is to visit your user profile. Select the Collections tab for a list of collections that have been shared with you and your own collections. Select a collection to view its documentation.
Postman automatically generates API docs for any OpenAPI 2.0 or 3.0 API defined in the API Builder. API developers can also create detailed documentation for any API to help consumers understand and interact with their API's endpoints.
To view documentation for an API, do the following:
Select APIs in the sidebar, then select an API.
You can also search for APIs on your Private API Network or the Postman API Network.
Select a documentation source on the API's overview:
API developers can publish different versions of an API. You can view documentation for each published version. Learn more about viewing a published API version.
Public documentation is hosted on the web by Postman. To access public documentation, enter the documentation URL in the address bar of your web browser. The URL is generated by Postman during the publication process.
Each request entry has a description of the request, the method and URL, the required authorization type, and any headers or parameters. Postman also provides sample client code for the request, along with example response bodies and headers.
Use the options in the header to customize the appearance of the documentation:
Postman supports various programming languages and frameworks for displaying sample code. Is a language you want to use not available? Is there a setting missing that you'd find useful? Select the language settings icon and then select Contribute on GitHub to contribute to the open-source project.
Want to share a specific endpoint with someone or bookmark it for later? You can save links to sections in public documentation, including the introduction, requests, folders, and responses.
To save a link, select a section, folder, or request in the sidebar. Copy the URL in your browser's address bar, or save it as a bookmark. Next time, you can use the URL to link directly to the selected section.
Last modified: 2023/07/21
Additional resources
Videos
Case Studies