Skip to content

OpenAPI Import/Export

API Dev Studio supports importing OpenAPI 3.x specifications to quickly generate mock endpoints, and exporting your mocks back to OpenAPI format for documentation or sharing.

Importing OpenAPI Specs

Supported Formats

  • OpenAPI 3.0 and 3.1
  • JSON and YAML formats
  • Local files or URLs

How to Import

  1. Click Import in the project toolbar
  2. Select OpenAPI Specification
  3. Choose your spec file (.json or .yaml)
  4. Preview the endpoints that will be created
  5. Choose import options:
  6. Overwrite existing: Replace endpoints with matching paths
  7. Skip existing: Keep current endpoints, only add new ones
  8. Click Import

What Gets Imported

  • Paths become mock endpoints
  • Methods (GET, POST, PUT, DELETE, etc.)
  • Example responses become the response body
  • Response schemas are used to generate sample data if no examples exist
  • Path parameters like {id} are preserved

Preview Before Import

The preview screen shows: - Number of endpoints to be created - Any conflicts with existing endpoints - Warnings for unsupported features

Exporting to OpenAPI

Export your mock endpoints as an OpenAPI 3.0 specification.

How to Export

  1. Click Export in the project toolbar
  2. Select OpenAPI Specification from the dropdown
  3. Choose format: JSON or YAML
  4. Click Export and choose save location

What Gets Exported

  • All enabled mock endpoints
  • Path and method configuration
  • Response status codes
  • Response body as examples
  • Response variations as named examples
  • Inferred JSON schemas from response bodies

Use Cases

  • Generate documentation from your mocks
  • Share API contracts with team members
  • Seed API gateways with mock definitions
  • Create Postman collections (import the OpenAPI spec into Postman)

Other Export Formats

  • Docker Package -- Export your mock endpoints as a Docker-ready Node.js server with Dockerfile, docker-compose.yml, and Handlebars template support. Select Docker Package from the Export dropdown.

Other Import Formats

API Dev Studio also supports importing from:

  • Postman Collections -- Import Postman Collection v2.1 files with folder structure, selective import, and automatic variable mapping
  • cURL Commands -- Paste a cURL command to instantly create a mock endpoint