User Warning: Ignoring unexpected property "$ref" for @OA\Parameter()

[cbrandolin]

for this definition the parameter generates an error

nelmio_api_doc:
  documentation:
    parameters:
      ejemploParam:
        name: exampleParam
        in: header
        description: Example parameter
        required: true
        schema:
          type: string
    openapi: 3.0.0
    info:
      title: api.com
      description: test
      contact:
        email: cbrandolin@akercontrol.com
      version: 1.0.0
    tags:
      - name: chofer
    servers:
      - url: https://127.0.0.1:8000
    paths:
      /api/chofer/login:
        get:
          tags:
            - chofer
          parameters: 
            - $ref: "#/parameters/ejemploParam"
          responses:
            "200":
              description: login ok

[DjordyKoert]

Does renaming $ref to ref fix the issue for you?

nelmio_api_doc:
  documentation:
    parameters:
      ejemploParam:
        name: exampleParam
        in: header
        description: Example parameter
        required: true
        schema:
          type: string
    openapi: 3.0.0
    info:
      title: api.com
      description: test
      contact:
        email: cbrandolin@akercontrol.com
      version: 1.0.0
    tags:
      - name: chofer
    servers:
      - url: https://127.0.0.1:8000
    paths:
      /api/chofer/login:
        get:
          tags:
            - chofer
          parameters: 
            - ref: "#/parameters/ejemploParam"
          responses:
            "200":
              description: login ok