Skip to content

API Spec Converter: RAML and OpenAPI

Runs only in your browser. Your data is not sent to our servers.

Convert an API specification between RAML and OpenAPI. Paste or open a RAML 1.0, RAML 0.8 or OpenAPI file, choose what to convert it to, and copy the result.

Result

About this tool

The tool reads RAML 1.0, RAML 0.8, OpenAPI 2.0 (Swagger), OpenAPI 3.0 and OpenAPI 3.1, in YAML or JSON. The format is found from the first lines, so there is nothing to choose for the input. It converts to OpenAPI 3.0, OpenAPI 2.0 or RAML 1.0.

  • Errors and warnings are shown with line and column, for example a type that is not declared.
  • This version reads one file. A RAML file that uses !include must have the included content pasted in its place.
  • Not everything has a match in the other format. Fields with no match are kept as annotations, such as (amf-summary) in RAML or x-amf-mediaType in OpenAPI. Check the result before you use it.
  • In RAML 1.0, query parameters are required unless they say otherwise, so they become required: true in OpenAPI.

The converter is AMF, an open source library that runs in your browser. It is about 1.6 MB and is loaded the first time you convert. The specification is not sent to a server.

Found a problem?

Tell us what went wrong. You decide whether your own work is included.

Licences

This tool is built with these third-party libraries:

Report a problem

Show exactly what will be sent

The report goes to the ipaashub team and is stored with Cloudflare in Western Europe, and included work in the EU. Included work is deleted when the problem is fixed, and at the latest after 90 days. See Privacy.