Customize your Postman Insights

The Postman Insights Agent watches your API traffic to automatically populate your endpoints inside your Insights Project.

To monitor a set of endpoints of your choosing, you can select and save them to a Postman Collection. If the Postman Insights AI didn't get your endpoints right, you can also give path hints to improve the inference.

Curate your endpoints

Adding your endpoints to a collection enables you to keep track of a specific set of endpoints. Before you decide to save endpoints to a collection, take a look at the endpoint details to help you make a selection. To learn more, see Explore your endpoints.

To curate your endpoints, do the following:

1. In your Insights Project, select the Endpoints tab.

2. Find endpoints that you would like to monitor and add them to a curated collection. For example, select all endpoints by a specific host and select Save to Collection.

   

3. Add the selected endpoints to an existing curated collection or create a new collection. Select Add.

   

4. Access your curated collection and check the Endpoints tab. To explore and debug your endpoints, see Debug with Insights.

Edit path parameters

As Postman Insights watches your API traffic, it's automatically finding the dynamic parts of API paths and replacing them with path argument variables. However, the Insights AI doesn't always get things right, and you may have to give some hints.

To edit a path parameter, do the following:

1. In your Insights Project, select the Endpoints tab.

2. Select Edit path parameters next to the endpoint you want to edit.

   

3. From the dropdown list, select the component to edit.

   

4. Give the component a name, which will automatically display as a variable in the endpoint.

5. Specify the parameter values. You can select the types of characters the parameter can include or, for better precision, specify a string by entering regular expressions. Make sure to select Enter after each expression. Values that will and won't be included appear at the bottom.

   

6. Select Next to review any exceptions you want to use to avoid merging specific values into the parameter, for example, if you want to watch a specific endpoint separately.

7. Select Confirm to apply the change. The timeline will be recomputed, and the API model will apply the new rule to future traffic.