Migrate your RAML 1.0 API specifications to OpenAPI 3.0 (OAS 3.0) YAML or JSON instantly. Supports resources, methods, query parameters, headers, request/response bodies, and data types. All processing is 100% in your browser.
Migrate your MuleSoft RAML 1.0 API specs to OpenAPI 3.0 in four simple steps.
Copy your RAML 1.0 spec from Anypoint Design Center or your editor and paste it into the input panel. Click Load Example to see a working sample first.
Choose between YAML (recommended for readability) or JSON output. Both are valid OpenAPI 3.0 formats supported by Swagger UI, Postman, and other tools.
Hit Convert to OpenAPI 3.0. The tool maps your resources, methods, query params, headers, body types, and responses to their OAS 3.0 equivalents. Conversion notes highlight any unsupported features.
Click Copy to paste into Swagger Editor or Postman, or Download
the .yaml / .json file for your project.
Key RAML 1.0 constructs and their OpenAPI 3.0 equivalents handled by this tool.
title, version, baseUriinfo.title, info.version, servers[]/resources + HTTP methodspaths + get/post/put/deletetypes: with propertiescomponents/schemasqueryParameters:parameters[in: query]headers:parameters[in: header]body: application/jsonrequestBody.contentresponses: 200/201/...responses.200/201/...securitySchemes:components/securitySchemesraml-to-oas CLI tool for production migrations.
types: are converted to components/schemas in OAS 3.0.
RAML property types like string, integer, number, boolean,
and object map directly. Arrays use type: array with items.
Custom type references are preserved as $ref links.
Deeper dives into API design, RAML, and OpenAPI patterns.
Loading latest articles...