Swagger Editor shows the “Schema error: should NOT have additional properties” error for a path parameter

Question

I\'m using http://editor.swagger.io to design an API and I get an error which I don\'t know how to address:

Schema error at paths[\'/employees/{employeeId}/r         


        

Answer 1

Had the same problem. I accidentally mixed up the syntax from Swagger 2.0 with Openapi 3.0.x. In Openapi 3.0.x, definitions are redefined as components. In the online editor you can click on the button Edit > Convert to OpenAPI 3 to use Openapi 3.0.x.

Read more about components here.

Remark:

OAS 3 is the latest version of the OpenAPI Specification.