Importing Open Api 3.0 yaml to Postman 7.1

I’d like to import an open-api 3.0 yaml file into postman, v. 7.1.1.

I am generating OpenApi 3.0 docs in Laravel using darkaonline/l5-swagger by Zircote – https://github.com/zircote/swagger-php. The generated open-api 3.0 yaml file produces an error-free output when pasted into editor.swagger.io. The api is being written in accordance with json:api spec (or is intended to be). When the file is imported to postman (v 7.1.1) this error is generated : “Error while importing Open API 3.0: Could not import”

Things I’ve tried

  • I Incrementally imported pieces of the document. Result: Import somewhat worked with all components of the document except path objects containing path variables. I say somewhat worked because for some reason, the endpoints display in postman with only the baseURL. The actual endpoint path is not actually shown.

  • I found examples of other valid open api 3.0.0 examples and imported them successfully. The requests have full endpoint paths. When I compared my path variables declarations, they looked identical, down to white space; however, when I copied the example’s path variable (i.e. parameters block, and rewrote it with with my information. It worked AND it displayed the full path for that end point.

My guess is that postman doesn’t like exactly how the generator is spitting out the yaml, so there
may be some white space issue that I’m not seeing? However, my thought is that, since my api definition passes all the open api specs, it should be as simple as dragging and dropping the file–not all of this going through my file with a fine tooth comb. Are there known compatibility issues with any open-api definition generators and importing to postman?
Any help or insight anyone has would be greatly appreciated!
If you need additional info, I’m happy to supply it.
Here’s a code excerpt from the 2000+ line file (any obvious indentation issues are from copying and pasting)

    info:
      title: 'NAME OF MY API'
      version: 1.0.0
    servers:
      -
        url: 'https://api.API.com/v1'
    paths:
       /accounts:
        get:
          tags:
            - accounts
          summary: 'list accounts'
          operationId: 'App\Http\Controllers\v1\AccountsController::index'
          responses:
            200:
              description: 'A list of accounts'
              content:
                application/vnd.api+json:
                  schema:
                    required:
                      - data
                    properties:
                      data:
                        description: 'Show all accounts for this request.'
                        type: array
                        items:
                          properties:
                            type:
                              type: string
                            id:
                              type: string
                            attributes:
                              $ref: '#/components/schemas/account'
                            relationships:
                              properties:
                                persons:
                                  type: array
                                  items:
                                    $ref: '#/components/schemas/relationship'
                              type: object
                            links:
                              $ref: '#/components/schemas/relationship/properties/links'
                          type: object
                      meta:
                        $ref: '#/components/schemas/meta'
                      links:
                        $ref: '#/components/schemas/links'
                    type: object
            401:
              description: 'Unauthorized access'
              content:
                application/vnd.api+json:
                  schema:
                    $ref: '#/components/schemas/error-response'
            404:
              description: 'No records found'
              content:
                application/vnd.api+json:
                  schema:
                    $ref: '#/components/schemas/error-response'
          servers:
            -
              url: 'https://api.API.com/v1'
        post:
          tags:
            - accounts
          summary: 'new account'
          operationId: 'App\Http\Controllers\v1\AccountsController::store'
          responses:
            201:
              description: 'Successful save'
            401:
              description: 'Unauthorized access'
              content:
                application/vnd.api+json:
                  schema:
                    $ref: '#/components/schemas/error-response'
            400:
              description: 'Bad request, save failed'
              content:
                application/vnd.api+json:
                  schema:
                    $ref: '#/components/schemas/error-response'
          servers:
            -
              url: 'https://api.API.com/v1'
      '/accounts/{id}':
        get:
          tags:
            - accounts
          summary: 'get one account'
          operationId: 'App\Http\Controllers\v1\AccountsController::show'
          parameters:
            -
              name: id
              in: path
              required: true
              schema:
                type: string
          responses:
            200:
              description: 'An account object'
              content:
                application/vnd.api+json:
                  schema:
                    properties:
                      type:
                        description: 'Display the specified resource.'
                        type: string
                      id:
                        description: 'Display the specified resource.'
                        type: string
                      attributes:
                        $ref: '#/components/schemas/account'
                      relationships:
                        description: 'Display the specified resource.'
                        properties:
                          persons:
                            description: 'Display the specified resource.'
                            type: array
                            items:
                              $ref: '#/components/schemas/relationship'
                        type: object
                      links:
                        $ref: '#/components/schemas/relationship/properties/links'
                    type: object
            401:
              description: 'Unauthorized access'
              content:
                application/vnd.api+json:
                  schema:
                    $ref: '#/components/schemas/error-response'
            404:
              description: 'Record not found'
              content:
                application/vnd.api+json:
                  schema:
                    $ref: '#/components/schemas/error-response'
          servers:
            -
              url: 'https://api.API.com/v1'
    ```

The problem is that within each path object’s servers object, I defined only the base URL, assuming for some reason that the base URL would be concatenated with the path. If you define a server object within the path object, you have to use the FULL URL for the endpoint. It was giving me errors specifically with /{id} endpoints because I defined a path variable that not present in the servers object