- Installation and updates
- Sending the first request
- Creating the first collection
- Navigating Postman
- Keyboard Shortcuts
- Postman account
- New button
- Troubleshooting In-app Issues
- Customizing Postman
- Find and Replace
- Troubleshooting API requests
- Debugging and logs
- Capturing HTTP requests
- Interceptor extension
- Generate code snippets
- Making SOAP requests
- Working with Tabs
- Using GraphQL
- Visualize API responses
- Intro to collections
- Creating collections
- Sharing collections
- Managing collections
- Using Markdown for descriptions
- Data formats
- Working with OpenAPI
- Commenting on collections
- Version Control for Collections
- Intro to scripts
- Pre-request scripts
- Test scripts
- Test examples
- Branching and looping
- Postman Sandbox
- Postman Sandbox API reference
- Intro to environments and globals
- Manage environments
- Manage globals
- Variables complete reference
- Dynamic Variables List
- Intro to collection runs
- Starting a collection run
- Using environments in collection runs
- Working with data files
- Running multiple iterations
- Building workflows
- Sharing a collection run
- Debugging a collection run
- Command line integration with Newman
- Integration with Jenkins
- Integration with Travis CI
- Newman with Docker
- Intro to API documentation
- Viewing documentation
- Local environments and shared environments
- How to document using Markdown
- Publishing public docs
- Adding and verifying custom domains
- Adding team name and logo
- Intro to Monitoring
- Setting up a monitor
- Viewing monitor results
- Monitoring APIs and websites
- Set up integrations to receive alerts
- Pricing for monitors
- Troubleshooting monitors
- FAQs for monitors
- Intro to mock servers
- Setting up a mock server
- Mocking with examples
- Mocking with the Postman API
- Matching algorithm
- Introduction to APIs
- Managing APIs
- Sharing APIs and managing roles
- The API Workflow
- Versioning APIs
- Reporting FAQs
- Viewing and analyzing APIs
- Intro to Workspaces
- Creating Workspaces
- Managing Workspaces
- Using Workspaces
- Sharing collections in Workspaces for version 5
- Activity feed and restoring collections
- What is Postman Pro
- Purchasing Postman Pro
- Billing and pricing
- Upgrading to Postman Pro from a trial team
- Team Settings
- Changing your plan
- Managing your team
- Migrating to Postman v7
- Roles and permissions
- Managing your billing
- Intro to Enterprise
- Purchasing Postman Enterprise
- Running Postman monitors using static IPs
- Intro to SSO
- Configuring SSO for a team
- Logging in to an SSO team
- Configuring Microsoft AD FS with Postman SSO
- Setting a custom SAML in Azure AD
- Setting up custom SAML in Duo
- Setting up custom SAML in GSuite
- Setting up custom SAML in Okta
- Setting up custom SAML in Onelogin
- Setting up custom SAML in Ping Identity
- Audit logs
- Public API documentation
This topic describes the tasks you can perform from the Collections tab in the sidebar.
- Navigate through collections
- Edit and view collection details
- Create a new collection
- Reorder collections
- Favoriting a collection
- Filter collections
- Delete a collection
- Recover a collection
- Share a collection
- Other collection features
- Adding folders
Click on a collection to show or hide the requests that comprise the Collection. Use the up and down arrow keys on your keyboard to navigate through the collections.
Expand the arrow (▸) to show the details view for the collection. Collapse the arrow (◂) to hide the details view. You can add metadata like name and description so that all the information a developer needs to use your API is available easily.
Click the "new collection" icon on the top right, or save a current request to a new collection.
Collections can be sorted either alphabetically by name or by when they were last updated. To do this, select the "sort" icon on the top right and select
Sort by name or
Sort by date.
If you're working on a few collections in particular, you can click on the star icon to bring the collection(s) to the top of the list.
If you have a lot of collections, filter collections in the sidebar using the search input field.
Click the ellipsis (...)next to a collection, and select "Delete". If you didn't intend to delete the collection, you can always recover your deleted collections. Refer to the next section Recover a collection to learn how to retrieve your deleted collections.
Collections deleted can be recovered via your web dashboard by clicking your avatar icon in the upper-right corner, then selecting
Trash from the drop-down menu. Locate the desired collection, hover your cursor over its row, then click
Restore. You can also recover your deleted collections clicking 'Trash' directly from the app, as illustrated in the screen below:
The Trash feature is available only for the signed-in users. So, if you are not a registered user you'll still see the Trash option but as a disabled one.
Note: Postman offers different recovery plans for Free, Pro and Enterprise users.
- Users on Postman Free license can recover one-day old collections.
- Users on Postman Pro license can recover collections up to 15-days.
- Users on Postman Enterprise license can recover collections up to 30-days.
If your collection seems deleted and you are not able to recover from your deleted collections list, it is possible it is removed from a workspace rather than deleted. To check, navigate back to the main page of the web dashboard, then click
View all collections. If listed, you can click on its share icon to move it back into a personal or shared workspace.
If you'd like to revert your collection to a previous state, you can do so by leveraging the collection's in-app activity feed.
To share a collection, see sharing collections.
Within a collection or folder, you can reorder requests using drag and drop. You can also reorder folders within a collection using drag and drop.
Requests can also store sample responses when saved in a collection.
Requests stored inside a collection can contain scripts to add dynamic behavior to the collection.
Folders are a way to organize your API endpoints within a collection into intuitive and logical groups to mirror your workflow. Next to the collection to which you want to add a folder, click on the ellipsis (...) and select "Add Folder".
Add a name and description to the folder. The description is reflected in your API documentation.
You can add deeper levels of nesting for folders. Drag and drop the folders to reorder them to create the ultimate customized folder structure.