Collections

Collections help you organize groups of related requests within a bucket for later reference (like bookmarks).


Add a Request to a Collection

To add a request to a collection, choose the Organizer on a request in any stream view. From there, add the request to a new or existing collection.

Collections Screenshot


Retry All

When you're viewing a Collection, you can run all of the requests in that collection again as a batch with the Retry All button. The requests are executed in parallel and they will update individually as they complete.

After each request is finished, click the View Comparison link to see a side-by-side comparison of the original and the new results. You can also expand the message in the list to see the original and retried request and response data.

If you want to stop the requests click on the Cancel button or press Esc to cancel any remaining requests.


Create Test from Collection

You can quickly create an API test from an existing collection by clicking Create Test. A new test will be created based on the requests and current sort order of the collection.


Changing the Order of Requests

To change the display order of requests within a collection, click the Change Order toolbar button to start reordering mode. While this is active you can drag requests into the desired order using your mouse or trackpad. Once you've set the desired order, click Save Order to save your changes, or press Cancel to revert to the previously saved order. Changing the display order of requests does not affect the 'Retry All' function which executes multiple requests in parallel.


Message Retention

Each bucket in your account has a limit on the number of requests that it will retain at any given time according to the current plan for that account or team. When a bucket reaches its retention limit the oldest requests contained within it are deleted. By adding a request to a collection, it becomes exempt from pruning. Read more about Request Retention.