postman-openapi-converter

OpenAPI → Postman Collection Converter

When to Use

Use this skill when you need convert OpenAPI 3.x or Swagger 2.0 specs (YAML or JSON) into complete, import-ready Postman Collection v2.1 JSON files. Use this skill whenever the user provides or references an OpenAPI spec, Swagger file, openapi.yaml, swagger.json, or uses phrases like "convert my OpenAPI spec",...

Converts OpenAPI 3.x or Swagger 2.0 specs into a valid Postman Collection v2.1.

---

Step 1 — Detect & Validate Input

Identify the spec version from the input:

• openapi: 3.x.x → OpenAPI 3
• swagger: "2.0" → Swagger 2

If the input is truncated or partial, convert what's available and note missing sections.

---

Step 2 — Extraction Mapping

OpenAPI 3 → Postman

OpenAPI field	Postman mapping
info.title	Collection name
info.description	Collection description
servers[0].url	{{base_url}} variable
paths.<path>.<method>	One request item per operation
operationId or summary	Request name
parameters (path/query/header)	URL path variables, query params, headers
requestBody.content.application/json.schema	Body (raw JSON), generate example from schema
responses	Saved example responses
components.securitySchemes	Collection-level auth
tags	Folder grouping

Swagger 2 → Postman

Swagger field