APIP YAML reference

ref.yaml

 <FQCN>:
   shortName: <string>
   description: <string>
   iri: <string>
   itemOperations:
       get:
           method: GET
           produces: ~
           summary: ~
           description: ~
           responses: ~
           parameters:
               -
                   name:
                   in: query
                   required: true
                   type:
                   schema:
                   style:
                   explode:
           deprecation_reason:
           route_name: <string>
           operationId: <string>
           output_formats:
               json: <mime>
           input_formats:
               json: <mime>
           input:
               name: <string>
               class: <string>
           output:
               name: <string>
               class: <string>
           deserialize:
           validate:
           status:
   collectionOperations:
       get:
           method: GET
           input:
               name: <string>
               class: <string>
           output:
               name: <string>
               class: <string>
           deserialize:
           validate:
           status:
   subresourceOperations: ???
   graphql:
       get:
           method: GET
           input:
               name: <string>
               class: <string>
           output:
               name: <string>
               class: <string>
           deserialize:
           validate:
           status:
   attributes: ???
   properties:
       <propertyName>:
           description: <string>
           readable: <bool>
           writable:  <bool>
           readableLink: <bool>
           writableLink: <bool>
           required: <bool>
           identifier: <bool>
           iri: <string>
           attributes: ???
           subresource: ???

i think parameters on line 12 should be under openapi_context:, it will not work otherwise (just checked it on latest api_platform version)
Docs for this: https://api-platform.com/docs/core/swagger/#changing-operations-in-the-openapi-documentation