What does this free Swagger / OpenAPI editor give you?
Postman’s free OpenAPI Editor lets you write or paste a definition, open a local file, or import one from a URL; it supports Swagger 2.0 and OpenAPI 3.0, 3.1, and 3.2 in YAML or JSON, renders visual documentation instantly, flags syntax and built-in governance issues as you write, and requires no account or installation.
Which formats are supported?
Swagger 2.0, OpenAPI 3.0, 3.1 and 3.2, in either YAML or JSON. Format and version are detected automatically.
Can I import Swagger specs into Postman?
Yes. Postman imports Swagger 2.0 specifications directly. Once your spec is clean here, paste it into Postman to generate a Collection that stays in two-way sync with the spec as it evolves.
What does Postman Spec Hub give you?
Spec Hub extends this into a visual editor with an outline view and code snippets, and covers OpenAPI, AsyncAPI, GraphQL, Proto, and Smithy in one place. You can generate a Postman Collection from your Specification and keep it in sync as the collection changes. You can lint your spec in CI with the Postman CLI on any plan, and define your own custom governance rulesets on Enterprise — Postman runs Spectral for custom rules and functions. You can also sync specs to git and generate a full SDK straight from the finished spec.
Does Postman upload my OpenAPI definition?
Definitions you type, paste, or open from a local file are parsed, rendered, and linted in your browser. Import from URL sends the URL to Postman’s Cloud Agent, which fetches the definition and returns it to the editor. No account is needed.
What are the signed-out limits?
Typed, pasted, and local-file definitions have no signed-out usage quota. Import from URL accepts response bodies up to 10 MB. Signed-out drafts are not auto-saved or restored after a page reload.
Can I turn this spec into something I can actually run and test?
Your spec generates a Collection you can run and test directly, staying in two-way sync as the spec evolves.
How can I keep my collection in sync with the spec?
Spec Hub lets you update the collection once the spec is updated — this way your collections always stay in sync with the specification.
Can I generate a specification from a collection?
Yes — you can start with a collection and enrich it with type information. The collection can then be converted into a specification and kept in sync, so Postman supports two-way sync between collections and specifications.
Why does my validation error not make sense?
OpenAPI validation errors often point at a symptom rather than the root cause — a missing required field upstream can surface as an unrelated error several lines later.
I need both REST and WebSocket support — should I use OpenAPI or AsyncAPI?
OpenAPI covers REST; AsyncAPI covers event-driven and WebSocket APIs.
Spec Hub supports both in one place if your API needs both.
