When should you put "-" before $ref: in OpenAPI (Swagger)?

Question

API

I don't grasp the system, in which cases it is necessary to write like this:

- $ref: '#/components/schemas/User'

and when like this:

$ref: '#/components/schemas/User'

Clarify the question plz, who knows :)

What does this hyphen mean in OpenAPI?

Answer 1

Read about YAML syntax.
A hyphen at the beginning of a line means "array element"
. the first entry is the second just
[ { "$ref": "#/components/schemas/User" } ]
{ "$ref": "#/components/schemas/User" }