View properties and documentation for an API collection

Anyone with access to a collection with types turned on can view properties for request components such as parameters, headers, and body data. They can also view properties in the collection's documentation.

Knowing more details about a requests in a collection, such as a parameter's type or if a header is required, can help others better understand your API. It can also help consumers send valid API requests, so they get successful responses instead of errors.

View properties for parameters, headers, and body data

You can view properties for parameters, headers, and body data in a collection with types turned on. If you enter a value that isn't valid, Postman flags it with an orange underline. Hover over the text or variable with the orange underline to view a tooltip about the issue. This enables you to fix any issues before you send the request.

Open a request and click the Params or Headers tab. Hover over an empty value for a query or path parameter or a header to view more details. For example, more details may include the property type and if it's required (also indicated by a red asterisk).

Click the box to enter a value for the parameter or header, or select a value from the list if enumerations are defined.

You can also open a request and click the Body tab, or open a saved example and go to the response body. Click Schema to show the schema pane. Hover over a key or value in the body data to view more details, such as the property description, or view any issues with the body data.

When you fork a collection with types turned on, you fork both the collection and properties added to request components. Types is automatically turned on for the forked collection. Note that changes to properties can't be pulled into a forked collection, merged into the parent collection, or pulled or merged during the pull request process.

View documentation for a collection with types

To view documentation for an entire collection, click the collection's Overview tab and click View complete documentation. To view documentation for a single request, open the request and click Documentation in the right sidebar.

The documentation for a collection with types includes any properties added to parameters and headers, such as format, allowed values (enumerations), and if the component is required.

If a request has body data, you can view it in raw (JSON) format or as a schema. When viewing the schema, click Show properties to show the body's properties.