View documentation in Postman

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.

Contents

Viewing documentation for a collection

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:

  1. Select Collections in the sidebar, then select a collection.

    You can also search for collections on the Public API Network.

  2. In the Overview tab, select View complete documentation.

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 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:

  • Version - If the documentation has multiple versions, you can select a specific version to view. (You can no longer create versions or releases for collections in Postman v10, but API producers can publish versions of an API.)
  • Language - Select a language to use for sample code.
  • Code Generation Settings - Select the settings icon Settings icon to customize settings for the selected language.
Viewing collection 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.

Viewing API 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:

  1. Select APIs in the sidebar, then select an API.

    You can also search for APIs on the Private API Network or the Public API Network.

  2. Select a documentation source on the API's overview:

    • To view schema documentation, under Definition, select View schema documentation. (Schema documentation is available for OpenAPI 2.0 and 3.0 definitions.)
    • To view collection documentation, select a collection and select View complete documentation. To get sample code in a different language, select it in the Language menu.
Viewing API documentation

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.

Viewing public documentation

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:

  • Version - If the documentation has multiple versions, you can select a specific release to view. (You can no longer create versions or releases for collections in Postman v10, but API producers can publish versions of an API.)
  • Environment - If an environment was published with the documentation, you can select it to populate any variables.
  • Layout - Double column displays sample code in a column next to the documentation. Single column displays sample code inline beneath each request.
  • Language - Select a language to use for sample code.
  • Language Settings - Select the language settings icon Language settings icon to customize settings for any of the available languages.
  • Theme - Select the theme icon (Light theme icon or Dark theme icon) to switch between light and dark themes.
Published documentation example

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 Language settings icon and then select Contribute on GitHub to contribute to the open-source project.

Linking to public documentation

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.

Documentation links

Last modified: 2023/07/21