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 Favorite 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.

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

To add a subfolder, select View more actions next to a folder, then select Add folder.
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.

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

You can also select the collection and then select Delete on your keyboard.
Select Delete to confirm.

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.

View a deleted collection

You can view collections that you and other team members deleted. Deleted collections are retained for a limited period of time depending on your Postman plan.

To view collections you and your team members deleted, select Trash in the Postman footer.

If you're on a free plan, you can view collections that you and other team members deleted. For each collection, you can view the collection's name, workspace it was deleted from, user who deleted it, and the date it was deleted. You can also view the date the collection will be permanently deleted. Take the following actions to search for and filter your team's deleted collections:

Select the Search Resources box and search for a collection by name.
Select the Workspaces dropdown list, and select the workspace a collection was deleted from.
Select the Deleted by dropdown list, and select a user who deleted the collection.
Select a collection to view more information, such as the number of times it was forked.

If you're on a paid plan, you can only view collections you deleted. For each collection, you can view its name and the date it was deleted.

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.

Use the changelog

To review the changelog for a collection in Postman, open the collection and select Changelog.

The changelog provides a chronological list of the collection's activities. You can view the time and date at which changes occurred, the users who made changes, and the affected parts of the collection.

Postman groups changes made within several minutes of each other into sessions for readability. You can select a session in the changelog to review its changes.

Select View diff to view the collection's diff. If a diff is too large to view in the changelog, you can hover over the diff and select View more to open it in a new tab.

Hide diffs in the changelog

If you have an Editor role for a collection, you can hide specific actions in its changelog. When you hide a changelog entry's diff, users who don't have Editor permissions on the collection can't view that diff in the changelog. This enables you to protect sensitive data in a public collection.

Select View more actions for the changelog entry, then select Hide diff for this change.

To restore the visibility of a diff, select View more actions for the changelog entry, then select Show diff to all users. Once you restore the visibility of a diff, all users can view it in the changelog.

Recover or permanently delete a collection

You can recover and permanently delete collections that you and other team members deleted. Deleted collections are retained for a limited period of time depending on your Postman plan.

If you're on a free plan, you can recover and permanently delete collections from your team where you had Admin or Editor permissions. If you're on a paid plan, you can recover or permanently delete your collections where you had Editor permissions. The actions you can take on the deleted collection depend on the roles you were assigned when the collection was deleted.

You can't recover deleted collections that are larger than 30 MB.

To recover a deleted collection, do the following:

Select Trash in the Postman footer.
Hover over a collection, and select Restore or Restore.

If you're on a free plan, you can also select the collection, and then select Restore.
Choose the workspace where you'd like to restore the collection.
Select Restore Collection.

To permanently delete a collection, do the following:

Select Trash in the Postman footer.
Hover over a collection, and select Delete permanently.

If you're on a free plan, you can also select the collection, and then select Delete.
Select Delete.

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.

Select Changelog in the right sidebar.
Select a session to expand it.
Select View more actions next to a change and select Restore to this change.

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