openapi: 3.0.0 info: description: | This is a test to show how model reference from another file fails. This file references api2.yaml. If you load this file first in the browser it fails. However, if you load api2.yaml first, then load this one it will work. version: 1.0.0 title: API1 Test paths: '/test-api-1': get: summary: Api 1 responses: '200': description: 'api 2 response' content: application/json: schema: $ref: '#/components/schemas/TestResponse' components: schemas: Api1Prop: type: string example: 'api1prop-value' TestResponse: type: object properties: api1prop: $ref: '#/components/schemas/Api1Prop' api2prop: $ref: 'api2.yaml#/components/schemas/Api2Prop'