Collections
Request collections in Insomnia
Collections are a way to group requests in Insomnia. You can use them to:
- Create and send requests
- Run multiple requests with the Collection Runner
- Write scripts to modify requests or check responses
Write scripts
The pre-request and after-response scripts allows you to interact with the request and its response. You can use these to:
- Set or unset variables
- Update the contents of the request
- Dynamically update request bodies
- Test the response
Frequently asked questions
What’s the difference between a collection and a design document?
Documents are a data object that can contain an API spec, a collection of API requests, and tests. Collections are simply a series of API requests that you intend to interact with Insomnia.
Can I import requests from another tool?
Yes, you can create requests in collections by importing:
- Postman collections
- Swagger/OpenAPI specifications
- cURL commands
- Insomnia files
- HAR files
- WSDL files
Can I run collections in CI/CD environments?
Yes, you can use the inso run collection command in Inso CLI to run a collection automatically.
Can I set authentication headers at the collection level so I do not repeat them on every request?
No. As a workaround, group the relevant requests in a folder and then set authentication at the folder level for that group to avoid duplicating headers on each request.