Use the https://app.insomnia.rest/run URL scheme to deep-link into the Insomnia desktop app and open a pre-imported request. You can embed this URL as a button or link in documentation, readme.md, or API references.
Run in Insomnia
Uses:
Insomnia
Related Documentation
Tags
Related Resources
Overview
URL parameters
|
Parameter |
Description |
|---|---|
specUrl
|
A full URL to an OpenAPI specification in raw JSON or YAML format |
endpoint
|
A {method},{specPath} pair (e.g. GET,/api/v1/users/{userId})
|
operationId
|
An operation ID from an OpenAPI specification (e.g. get-flight-by-number)
|
curl
|
A url-encoded cURL command to be imported as a single request |
mcp
|
A full URL to an MCP server endpoint (e.g. https://mcp.slack.com/mcp)
|
Example
https://app.insomnia.rest/run?endpoint=GET,/flights/{flightNumber}&specUrl=https://raw.githubusercontent.com/Kong/KongAir/refs/heads/main/flight-data/flights/openapi.yaml
Copied!
Embedding the URL
HTML link
<a href="https://app.insomnia.rest/run?endpoint=GET,/flights/{flightNumber}&specUrl=https://raw.githubusercontent.com/Kong/KongAir/refs/heads/main/flight-data/flights/openapi.yaml">Run in Insomnia</a>
Copied!
Markdown link
[Run in Insomnia](https://app.insomnia.rest/run?endpoint=GET,/flights/{flightNumber}&specUrl=https://raw.githubusercontent.com/Kong/KongAir/refs/heads/main/flight-data/flights/openapi.yaml)
Copied!
Markdown image button
[](https://app.insomnia.rest/run?endpoint=GET,/flights/{flightNumber}&specUrl=https://raw.githubusercontent.com/Kong/KongAir/refs/heads/main/flight-data/flights/openapi.yaml)
Copied!
FAQs
Do I need to sign in to Insomnia to import a request from a URL?
Yes, you must be signed in to Insomnia.