Import & export
Gud API supports importing from several formats so you never have to rebuild requests from scratch.
cURL import
cURL is the most common way developers share API requests. Gud API makes it effortless to import them.
Paste into the URL bar -- Copy a cURL command from documentation, a browser's DevTools, or a colleague's message and paste it directly into the URL bar. Gud API auto-detects curl ... on paste and fills in the method, URL, headers, body, and authentication fields for you.
Multi-line cURL dialog -- For long or multi-line cURL commands, click the clipboard button next to the URL bar to open a dedicated import dialog. Paste the full command there and confirm.
TIP
Most API docs, browser network tabs, and tools like Insomnia let you copy a request as cURL. This is often the fastest way to get a request into Gud API.
File import formats
| Format | Notes |
|---|---|
| Postman v2.x | Collections, folders, requests, headers, bodies, and collection variables |
| Thunder Client | Thunder Client collections |
| OpenAPI 3.x | Paths become requests; tags become folder structure |
| Swagger 2.0 | Same behavior as OpenAPI 3 |
How to import a file
- Open the sidebar and click Import (or run Gud API: Import Collection from the Command Palette).
- Choose the JSON or YAML file from disk.
- Review the new folders and requests under Collections.
After import
- Collection variables imported from Postman appear alongside your existing variables. Combine them with environments for overrides.
- Fix base URLs if your file used a placeholder host. Point them at your
or an environment variable.
cURL export
One-click copy -- Click the cURL button in the URL bar to copy the current request as a cURL command to your clipboard. The exported command includes the method, URL, headers, and body exactly as configured.
Code Snippet dialog -- cURL is also available as an output format in the Code Snippets dialog alongside other languages and libraries.
Other export options
For file-based backup, workspace storage can put data under .gud-api. See Settings. For sharing individual requests, use code snippets or copy the cURL command as described above.