Collections will take your productivity to the next level.
A collection lets you group individual requests together. These requests can be further organized into folders to accurately mirror your API. Requests can also store sample responses when saved in a collection. You can add metadata like name and description too so that all the information that a developer needs to use your API is available easily. Collections are listed in the sidebar alphabetically. You can search through collection requests using the search form for quick access.
You can also reorder requests inside a collection by dragging and reordering through the sidebar itself. The request order is also preserved for requests that are in folders. The order of folders inside a collection, however, is alphabetical and cannot be changed (at least for now).
To create a collection, click on “new collection” button under the collections side bar tab.
Collections are also created -
Editing a collection is quite simple. Hover over the collection name and click on the edit icon to change the collection name and description.
Collections can be downloaded as a JSON file which you can share with others or shared through your Postman account. You can also share collections anonymously but it is strongly recommended to create a Postman account when uploading collections. This will let you update your existing collection, make it public or delete it later.
If you are a member of a team using Postman Pro, you can share a collection with your whole team or a sub section of it in this modal. You can also make it view-only versus editable.
Deleting a collection from the sidebar deletes the local copy of the collection. Please note that it does not remove the collections you have shared through getpostman.com
Folders are basically sub-collections. You can have as many folders as you want in a collection. You can add requests directly to a folder through the “Add collection” modal or drag and drop requests into a folder. Folders support Markdown-based descriptions as well.
Right now you can have only one level of folders inside a collection.
To save a request inside a collection click the “Add to collection” button and select the target collection. You can add a request name and description to help your collection users get more information about the request right inside Postman.
You can also duplicate an existing request using the same flow. You can edit a request any time and hit save to update it inside the collection.
Please note that form-data requests and binary requests which contain files will not be saved along with the collection. This limitation is due to the restrictions with the HTML5 spec.
With v0.9.x you can save entire API responses as part of the collection request. API endpoints have different responses depending on the data sent to them and you can capture all of that by pressing the “save response” icon in the response viewer.
Postman saves the response as well as the request which was used to generate the response. This means that you can have many variations of the original request saved as sample responses.
You can transfer requests to any other folder or collection in the sidebar. Just drag-and-drop the request to a collection, or any of its child folders.
You can use the search box in the sidebar to search for collections, folders, and requests.
Hover over the folder/request name in the sidebar, and click the edit (pencil) icon. This will allow you to change the name and description. Note that the description supports Markdown.
Duplicating will create a copy of the folder/request. The new folder/request will be created as a sibling of the original.
Note: Deleting a folder will delete its constituent requests, and deleting a request will delete any responses saved with the request.