Skip to main content

Importing

Rostyman can import requests and collections from multiple formats and tools.

How to Import​

There are three ways to import:

Import Dialog​

  1. Click ☰ hamburger menu → File → Import (or press Ctrl+O)
  2. Choose your import format from the tabs
  3. Paste content or click Choose File
  4. Click Import

Drag & Drop​

  1. Drag any supported file from your file browser onto the Rostyman window
  2. A drop zone overlay appears — release to import
  3. Rostyman auto-detects the format and imports the collection
  4. If a collection with the same name already exists, you'll be asked whether to Sync or Import as New

Double-Click (.rostyman files)​

Double-click any .rostyman file in Explorer (Windows), Finder (macOS), or your file manager (Linux) — Rostyman opens automatically and imports the collection — this works even when Rostyman isn't running yet. If Rostyman is already running, the file opens in the existing window.

Default environment​

When a .rostyman collection defines a default environment, importing it selects that environment automatically, so requests are ready to send with the right variables.

A new collection is created with all the imported requests.

Supported Import Formats​

cURL​

Paste any curl command — including complex ones with headers, body, and auth:

curl -X POST https://api.example.com/users \
  -H "Authorization: Bearer mytoken" \
  -H "Content-Type: application/json" \
  -d '{"name": "Alice", "email": "alice@example.com"}'

Rostyman parses the method, URL, headers, and body automatically.

Postman Collection (v2.0 / v2.1)​

Import a Postman Collection v2.0 or v2.1 JSON file:

  1. Export the collection as JSON from your current tool
  2. In Rostyman: Import → Postman tab → Choose File

Imports:

  • All requests with their method, URL, headers, params, body
  • Folder structure
  • Collection variables
  • Pre-request and test scripts (compatible with pm.* — note: scripts use rm.* in Rostyman)

OpenAPI 3.0 / Swagger 2.0​

Import an API spec to generate a collection of all endpoints:

  • Supports JSON and YAML formats
  • Paste the spec or choose a file
  • Each API operation becomes a request
  • Path parameters, query params, and request body schemas are imported

Insomnia (v4)​

Export from Insomnia as JSON and import directly:

  1. In Insomnia: Application → Export Data → Current Workspace → JSON
  2. In Rostyman: Import → Insomnia tab → Choose File

HAR (HTTP Archive)​

Import requests captured from browser DevTools:

  1. In Chrome DevTools: Network tab → right-click → Save all as HAR with content
  2. In Rostyman: Import → HAR tab → Choose File

Each request in the HAR file becomes a saved request in a new collection.

Import Source Sync​

When you import a collection or environment from a file, Rostyman automatically remembers the source file path. This lets you re-sync your collection whenever the source file is updated.

How It Works​

  1. Import a collection from any supported format (Postman, OpenAPI, Insomnia, HAR, etc.)
  2. Open the collection → Overview tab → you'll see the source file path with a format badge
  3. Click Sync from Source to re-import from the same file

Merge Strategy​

When you sync, Rostyman merges changes intelligently:

  • New requests and folders in the source file are added
  • Changed requests (different URL, body, or auth) are updated
  • Your manual additions (requests you added yourself) are kept untouched
  • Variables are upserted by key — existing values are updated, new keys are added
  • Environment changes and script-only edits (pre-request or test scripts changed with nothing else) are picked up too

Environment Source Sync​

Environments imported from file also remember their source. Select the environment in the Environments tab to see the source banner with a Sync button above the variable table.

Link / Unlink​

  • Link: You can manually link any collection to a source file from the Overview tab
  • Unlink: Remove the source connection if you no longer want to sync

Sharing Collections​

Export your collection as a .rostyman file and share it with teammates via any method — WhatsApp, email, Slack, Google Drive, Dropbox, or any file-sharing service.

Your teammate can:

  1. Double-click the file to open it in Rostyman
  2. Drag & drop the file onto their Rostyman window
  3. Use the Import dialog to browse and select the file

When the source file is updated (e.g., via a shared Drive folder), Rostyman detects the change and prompts to sync — keeping everyone's collection up to date.