Turn on types for an API collection

Types in collections is a beta feature available with Postman Professional plans.

Turn on types in a collection to add more details to its requests. Types in collections is available for HTTP collections with application/json type request and response bodies. It isn't available for other request protocols or body types. You can also turn off types for a collection.

You must have the Editor role for the collection to turn on types or add properties.

Turn on types for a collection

Once types is turned on, you can add properties to request components such as parameters, headers, bodies, and example responses. Consumers of your collection can use these details to understand your API and make sure they're sending valid requests.

To turn on types for a collection, do the following:

1. Select Collections in the sidebar and select a collection.
2. Select View more actions in the upper right, then select Turn on Types.

Turn off types for a collection

If you no longer want to use types for your collection, you can turn it off from the collection or a request. You won't be able to add properties to parameters, headers, and body data in the collection. Also, properties won't appear in the collection's documentation.

To turn off types for a collection, do the following:

1. Select Collections in the sidebar and select a collection.
2. Select View more actions in the upper right, then select Turn off Types.

To turn off types from a request, do the following:

1. Open a request and select the Params or Headers tab.
2. Hover over a query or path parameter or a header and select Add more properties.
3. Select View more actions in the upper right, then select Disable Types.

If you turn off types for a collection, any properties you added to parameters, headers, and body data are retained but are hidden. If you turn on types for the collection again, you can continue to view and work with the properties you added before.