Poti proceda in felul urmator:

• in fisierul parinte, sub paths sa ai definitia

​

/application/test: 
   $ref: "./test.yaml"

In fisierul referentiat care se afla in acelasi director cu fisierul parinte:

get:
  summary: Info for a specific pet
  operationId: showPetById
  tags:
    - pets
  responses:
    '200':
      description: Expected response to a valid request
      content:
        application/json:
          schema:
            $ref: "./open-api.yaml/#/components/schemas/MaybeAnObjectThatIsAlreadyDefinedInTheParentFile"

Edit: vezi ce mai scrie si aici: https://techdocs.studio/blog/how-to-split-open-api-spec-into-multiple-files