Skip to content

Specification Extensions not supported for externalDocumentationObject #513

@AP-G

Description

@AP-G

Dear all,

it looks like Specification Extensions are not supported for an externalDocumentationObject. If I parse the file I get a

x-ExternalDoc-simple is not a valid property at #/paths/externalDocs

This is strange in two ways, as the externalDocs is part of the OpenAPI Object (root) and not as part of paths.

Here is my example:

...
components:
....
security:
...
tags:
...
externalDocs:
  description: My external API documentation
  url: https://external.server.tld/doc
  # extension
  x-ExternalDoc-simple: MyContent

Metadata

Metadata

Assignees

No one assigned

    Labels

    type:bugA broken experience

    Type

    No type

    Projects

    No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions