Manage and organize Postman Collections

You can save, organize, and find all of your API requests in Postman Collections. Use folders to group requests by type or use case, and reorder requests to replicate workflows. If you don't want to keep a change, you can revert your collection to an earlier state.

Collection basics

To view all collections in the current workspace, select Collections in the sidebar. From here you can take the following actions:

• Select a collection to open its overview in the workbench.
• Select the arrow next to a collection to expand its contents.
• Hover over a collection and select the star icon ★ to move that collection to the top of the list.
• Use the search box in the sidebar to filter collections and their contents.
• Reorder the requests, folders, and examples inside a collection by dragging and dropping them.

Add folders to a collection

You can use folders to organize the requests and examples in a collection. You can also add subfolders to create more levels of nesting.

1. Select the more actions icon next to the collection, then select Add folder.

   To add a subfolder, select the more actions icon next to a folder, then select Add folder.

2. Add items to the folder or subfolder by dragging and dropping them.

Delete a collection

If you no longer need a collection, you can delete it.

1. Select the more actions icon next to the collection, then select Delete.

   You can also select the collection and select Delete on your keyboard.

2. Select Delete to confirm the action.

If a deleted collection is larger than 30 MB, you won't be able to recover it. You can split the collection's contents into multiple smaller collections, or back up the collection, before deleting it.

Recover a deleted collection

Deleted collections are retained and can be recovered for a limited period of time depending on your Postman plan. Deleted collections that are larger than 30 MB can't be recovered.

1. Select Trash in the Postman footer.
2. Select the restore icon next to the collection you want to recover.

If a collection you expected to be in the trash isn't there, it may have been moved to another workspace rather than deleted. Learn more about moving elements.

Revert collection changes

Postman retains a changelog of the changes made to a collection. If needed, you can revert the collection to an earlier state.

1. Select the changelog icon in the right sidebar.

2. Select a session to expand it.

3. Select the more actions icon next to a change and select Restore to this change.

   The collection is reverted to the state it was in after the selected change.