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
All messages from the converter
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
!includemust 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 orx-amf-mediaTypein OpenAPI. Check the result before you use it. - In RAML 1.0, query parameters are required unless they say otherwise, so they become
required: truein 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: