OpenApi import with multi-file support

Ask the Experts and Postman Tips
,
8

Hi @arlem, I’m having trouble importing my OpenAPI spec with Postman 7.31.0. It’s split into multiple files. Here’s a generic example of what I’m trying to import. I have two files, openapi.yaml:

openapi: '3.0.0'
info:
  title: My API
  version: '1'
paths:
  /dummy:
    $ref: 'dummy.yaml'

and dummy.yaml:

get:
  responses:
    '200':
      description: 'OK'

in the same folder. I try to import that folder using Import Folder in the UI, and I get a collection with no requests (I expect one, “GET /dummy”). the only thing that is imported is the name of the API from info.title. What am I missing? My actual spec is much more complicated and works fine with e.g. openapi-generator.

Note: the multifile example I’ve seen posted has $ref under paths, but that is invalid according to the spec and my tooling doesn’t support it.

Looking forward to your reply. -Luc