OpenAPI support
We both support OpenAPI 2 (Swagger) and 3, but sometimes with specificities.

Not (yet) supported properties

Partially supported: securitySchemes (V3) / securityDefinitions (V2)

We support OpenAPI securitySchemes property (securityDefinitions with openAPI v2) with these authentication type values:
  • http
  • apiKey
  • oauth2
  • openIdConnect
We do not support mutualTLS. To describe a mutualTLS authentication method, please use the x-topics property for now.


The oneOf/anyOf support was one of the most expected features to come. The team is currently working on supporting it: we are currently looking for beta testers, feel free to contact us!

Add topics to your documentation

As this is not supported by OpenAPI, we created a custom property to enrich your documentation. Find out more in our dedicated section.