Import & Export

Import from Postman with auto script conversion, export as JSON or encrypted VTX, drag-drop, URL import, and AI-generated collections from descriptions or source code.

Import

VortexHQ can import API collections from multiple sources:

File import — Browse for .json or .vtx files
Drag-and-drop — Drop collection files directly onto the app window to trigger the import flow
URL import — Paste a URL to a publicly accessible collection file (the Import modal has a File tab and a URL tab)
Postman format — VortexHQ automatically parses Postman Collection v2.1 format, including nested folders, request configurations, and auth

Postman Script Conversion

When importing a Postman collection, VortexHQ automatically converts all pm.* API calls in scripts to the VortexHQ vx.* equivalents. This includes pm.response, pm.collectionVariables, pm.test, and pm.expect.

Duplicate Detection

If an imported cluster has the same name as an existing one, VortexHQ prompts you to choose: Replace the existing cluster, import as a Copy (with a renamed slug), or Cancel.

Export

Export your clusters in two formats:

Format	Description
`.json`	Standard JSON — human-readable, compatible with other tools. Cloud metadata is stripped on export.
`.vtx`	VortexHQ encrypted format — passphrase-protected, portable between machines (Pro+ only, feature-gated).

AI-Generated Collections

VortexHQ can generate entire API clusters using AI:

From Description

Describe your API in plain English (e.g., “REST API for a blog with posts, comments, and users”) and AI generates the complete collection with folders, requests, headers, and body templates. Provide an optional base URL for the generated endpoints.

From Project Source Code

Select your project’s route files (e.g., Laravel routes/api.php) and VortexHQ will scan them:

Auto-detects local development projects (scans common project directories)
Searchable project picker, or browse for a custom folder
Automatically expands Route::resource and grouped routes (Laravel)
Target cluster selection — Import into a new cluster or merge into an existing one (with deduplication)
Background processing — Batch processing (15 routes at a time, 3 in parallel) with a progress badge and popup showing elapsed time and completion stats

Single Request

Generate individual requests from a description within an existing cluster (right-click cluster → AI Generate Request).

Sync from Project

Re-sync an existing cluster from its connected project source code to pick up new routes (right-click cluster → Sync from Project).