Forum Discussion

mewalig's avatar
mewalig
New Contributor
5 years ago

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

Hi,   The following link contains an example at the bottom, that starts with "openapi: 3.0.0". https://swagger.io/docs/specification/describing-request-body/   If I paste that example into https...
  • HKosova's avatar
    HKosova
    5 years ago

    Hi mewalig,

     

    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.

     

    Thanks!

  • HKosova's avatar
    HKosova
    SmartBear Alumni (Retired)
    5 years ago

    Hi mewalig,

     

    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.

     

    Thanks!