openapi: 3.1.0
info:
title: Test
version: 1.0.0
servers:
- url: "https://example.com/{someParameter}"
variables:
someParameter:
default: sometest123
description: Some description!
paths: {}
swagger-cli reports:
Swagger schema validation failed.
/servers/0/variables/someParameter must NOT have unevaluated properties
The error goes away if I remove the description property.
The error message is rather arcane (what is an unevaluated property? What does it mean for a property to be "unevaluated"? What can I do to fix this?), but besides that, the error is, as far as I can tell, a false positive, because the specification for openapi 3.1.0 allows this schema and the description property.
This only occurs for 3.1.0: if I change the first line to openapi: 3.0.3 the schema validates correctly. Note that the description property is allowed on both the mentioned versions.
Given the following spec:
swagger-cli reports:
The error goes away if I remove the
descriptionproperty.The error message is rather arcane (what is an unevaluated property? What does it mean for a property to be "unevaluated"? What can I do to fix this?), but besides that, the error is, as far as I can tell, a false positive, because the specification for openapi 3.1.0 allows this schema and the
descriptionproperty.This only occurs for 3.1.0: if I change the first line to
openapi: 3.0.3the schema validates correctly. Note that thedescriptionproperty is allowed on both the mentioned versions.