Importing OpenAPI Documents

Swagger Editor can import your OpenAPI document, which can be formatted as JSON or YAML.

Local File

File → Import File

Click Choose File and select import. The file you are importing has to be a valid JSON or YAML OpenAPI document. Swagger Editor will prompt you about validation errors, if any exist.

Drag and Drop

Simply drag and drop your OpenAPI JSON or YAML document into the Swagger Editor browser window.

Public URL

File → Import URL

Paste the URL to your OpenAPI document.

GET Parameter

Request editor.swagger.io to import an OpenAPI specification from publicly accessible content via the ?url= parameter:

https://editor.swagger.io/?url=https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/examples/v2.0/yaml/api-with-examples.yaml