openapi: "3.0.3" info: title: Recursive refs example version: "1.0" paths: /foo: $ref: ./paths/foo.yml /double-ref-foo: get: summary: Double ref response description: Reference response with double reference. responses: "400": $ref: "#/components/responses/400" components: schemas: Foo: $ref: ./components/Foo.yml Foo2: $ref: ./components/Foo/Foo2.yml Bar: $ref: ./components/Bar.yml Cat: $ref: ./components/Cat.yml Error: $ref: ./components/models/error.yaml responses: "400": description: 400 Bad Request content: application/json: schema: $ref: "#/components/schemas/Error"