What You Can Import
The importer supports both YAML and JSON OpenAPI files. When you upload a spec, Requestly automatically reads the file and creates API collections and requests based on your defined endpoints.How It Import
Open the API Client
Go to your API Client workspace in Requestly. Make sure you’re in the workspace where you want to import your API collection.
Preview Before Import
Requestly will show a preview of what will be imported — including:
- The collections that will be created
- The environments and variables that will be set up
Requestly builds your collection
- Each path in your OpenAPI file becomes an individual request.
- Requests are grouped under collections named after your API or service.
- Requestly automatically fills in the method, URL, headers, and body (if defined in the spec).
What Happens After Import
Once imported, Requestly automatically maps elements from your OpenAPI file to your workspace structure.| OpenAPI Element | Where It Appears in Requestly |
|---|---|
| Paths | Individual requests inside the imported collection |
| Methods (GET, POST, etc.) | Reflected automatically in each request |
| Servers (root level) | Creates environments with a {{base_url}} variable for each server URL |
| Servers (path level) | Used as collection variables in parent |
| Schemas / Components | Used internally for request and response structure |
| Request bodies & parameters | Automatically mapped to request body and query params |
Exporting an OpenAPI Spec
Need an OpenAPI definition for sharing or documentation? You can export any API collection as a standard OpenAPI (Swagger) file directly from Requestly.How to Export
Locate the Collection
In the left sidebar of the API Client, hover over the collection you wish to export and click the three‑dot menu (⋯).
Choose the Export Option
Select Export → OpenAPI (or Export as OpenAPI Spec in some releases). Requestly will generate the spec based on the requests and variables in the collection.
