POST example from documentation fails to validate at https://editor.swagger.io/

Question

Hi,&nbsp;The following link contains an example at the bottom, that starts with "openapi: 3.0.0".https://swagger.io/docs/specification/describing-request-body/&nbsp;If I paste that example into&nbsp;https://editor.swagger.io/, why is it throwing an error at line 8? If that's normal or correct, how is the documented example supposed to be used?&nbsp;

hkosova · Accepted Answer

Hi&nbsp;mewalig,
&nbsp;
I have fixed the example in the docs - the error was that the "servers" definition was missing the "url" key:
# Incorrect
servers:
  - https://hooks.slack.com

# Correct
servers:
  - url: https://hooks.slack.com
The GitHub repository is the recommended place to report issues with swagger.io docs, but we monitor this forum as well.
&nbsp;
Thanks!

Forum Discussion

POST example from documentation fails to validate at https://editor.swagger.io/

2 Replies

Recent Discussions

How to customize the swagger-editor to include other definitions besides the PetStore

Jersey 3.x + Grizzly Web Service Swagger Advice

Weird css issue

Related Content

Validate Table content in PDF document

https://editor.swagger.io/

Data Validation