Skip to content

Insomnia

Insomnia is a desktop app for sending API requests, saving groups of requests, and comparing replies. Choose where a project is stored before you add credentials.

Visit Insomnia

What can you save when you check an API?

Save the address, the action the API should take, and the settings that go with it as a named request. Group related requests in a collection. A collection named Demo inventory might have one request to list sample items and another to look up a particular item.

Where does the saved project go?

Kong documents a signed-out Scratch Pad and a Local Vault project mode for local work. Cloud Sync stores project data through Insomnia, while Git Sync uses a repository you configure. Changing the storage mode later changes where data can go.

Keeping the project local does not keep the request local if you send it to an outside API. Check both the selected project mode and the request destination. Review sample fields before syncing or sharing.

What can you export, and what does the free plan cover?

The free Essentials plan lists cloud and local projects, collection runs and Git Sync for up to three users. Check the separate collaboration allowance before choosing a storage mode for a team. The desktop export options include Insomnia YAML and HAR, a format for HTTP activity. The command-line tool can export an OpenAPI definition.

An OpenAPI definition describes the API’s interface. Save the collection separately if you also need the requests and settings you built around it. Inspect files for copied addresses, data and credentials before sending them to anyone.

How do you catch a reply that looks successful but is wrong?

Sketch a Demo inventory request whose reply should contain two fictional products. Do the exercise on paper before deciding whether to save or send anything.

  1. Name the request
    Write “List demo inventory” and mark the intended project as local.
  2. Compare two replies
    Both replies say the request succeeded. One contains both products and the other repeats the same product twice. Write a check for two distinct product names.
  3. Plan the handoff
    List the request and expected example separately from any credential or private address. Use only the sample values if you later export it.