View your scheduled collection runs

You can run collections at specific times each day or week. For example, you may want to run a collection that tests your API every day. You can use the Collection Runner to schedule collection runs to execute automatically at specified dates and times.

Viewing scheduled collection runs in Postman

You can view your scheduled collection runs in Postman by navigating to your workspace and selecting Collections > Your collection > Runs > Scheduled runs. Hover over your scheduled collection run and select View.

Scheduled collection runs in team workspaces are visible to all members of the workspace.

Scheduled collection run summary

You can use the graph to understand how your APIs have performed over time. Each bar in the graph represents a collection run iteration.

The upper section charts your scheduled collection run's average response time for each run. The lower section visualizes the number of failed tests for each run across all regions. To view the exact values for failed percentage and response time, hover over each run individually.

A red bar indicates that either tests failed or errors occurred during the run. For more information, view your Console Log.

Filters

You can use filters to identify recurring patterns in your scheduled collection runs by selecting particular run types and results.

You can Clear Filters to return to your original dashboard view.

Filtering by type

You can filter by run type to compare how the response time changes between all runs, manual runs, and scheduled runs. Select Type: All, then select the type of run you'd like to analyze further.

Manual runs are initiated in Postman. Scheduled runs are initiated by the schedule you set when creating or editing your scheduled run. Webhook runs are initiated by integrations you've created.

Filtering by run result

Each run is labeled based on its result:

• Successful - Your scheduled collection run completed with no issues and passed all tests.
• Failure - Your scheduled collection run completed, however one or more tests failed.
• Error - Your scheduled collection run was unable to complete due to an error. An error can occur if there is a syntax error in the code you've written, a network error, or for various other reasons. If you get an error, your Console Log will help you identify what caused it.
• Abort - Your scheduled collection run timed out because it didn't complete within the allotted 10 minutes (Postman Free plans) or 15 minutes (Postman paid plans).

You can filter by run result to compare how your runs with the same result have differed. Select Run result: All, then select one or more types of run results to view.

Time traverse

You can review past run results to understand what happened at a particular point in time. To do so, select Go to in the upper-left corner of the graph. Select the time and date, then select Apply to view a specific run.

To revert the view to your most recent runs, select the time and date you defined in the upper-left corner of the graph, then select Reset.

Test results

Select a bar in the graph and select Test Results to get more detailed information on that run's tests. Details include which tests passed or failed, the response codes, and the response times.

Console log

Select a bar in the graph and select Console Log to view details about the run and the console.log statements that run as part of your pre-request and test scripts. Run details specify the various stages of a collection run such as preparing run, running, rerunning, and the run result, along with error and test failure information. Selecting a request in the Console log will open it in a tab, allowing you to review and edit the request as needed.

You can use the Console to troubleshoot issues and learn more about an individual run's behavior.

Scheduled collection run logs are retained for a period of six months. If you select a scheduled collection run that's outside the retention period, you can view the number of failed tests and errors. Other collection run details will no longer be available. To request this information, contact Postman support.