Forum Discussion

New Contributor

5 years ago

Solved

$ref and description/title

The page https://swagger.io/docs/specification/using-ref/ says that when I am using $ref in an OpenAPI spec all sibling properties are ignored. It is not quite clear if there is a way to workaround t...

hugomario

Staff

5 years ago

Hello vsr

that depends of what open api version are you working, for openapi version 3.0.x the reference object does not have any other fields than $ref, you can check that here .

But for open api 3.1.x you can certainly add a description to the reference object as it's described here

vsr

New Contributor

5 years ago

Thanks!

As I understand, version 3.1 is not released yet? Do you know anything about planned release date?

Forum Discussion

$ref and description/title

Recent Discussions

Cookie Authentication used to work

[Open API 3.0.*]Does fraction of schema can be referred to the other schema

Incompleteness in string formats documentation, potentially misleading

Related Content

ref contextualisation

$ref in response example relative to response example

ref and out parameters in C#