This rule belongs to the
swagger-v1-validation ruleset and states that:
The Swagger specification's root object must specify the 'swaggerVersion' property to indicate the version of the Swagger standard document you are using to define your specification. Supported versions include the following:
|Specification version number of the Swagger document is empty or missing.
|API Transformer, Code Generation, Developer Experience Portal
- Make sure that you have added the
swaggerVersionproperty in the root JSON object.
- Ensure that the value of
swaggerVersionproperty is not null/empty and is set either as
- Check that you are not using properties like
openapiVersionto specify the version.
- This version is not to be confused with the API version or the API specification document version which is specified using the