Forum Discussion

utkuozan's avatar
utkuozan
New Member
5 years ago

How can I define and reference an array of object as a parameter

I have a REST endpoint which accepts and Id and an object as input parameter. I have documented it as follows :

 

 

/api/exam/end:
    post:
      tags:
        - Exam
      summary: Bla bla
      operationId: exam_end
      description: Bla bla
      parameters:
        - in: query
          name: sectionId
          description: Bla bla
          required: true
          schema:
            type: integer
            format: int32
        - in: query
          name: answers
          description: Bla bla
          required: true
          schema:
            type: array
            items:
              $ref: '#/components/schemas/ExamAnswerObject'
      responses:
        '200':
          description: Bla bla
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EndExamSectionResponse'

 

I also have a valid definition for "ExamAnswerObject" where it is correctly displayed in the Schemas section. The problem is the document does not have a "Schema" link as it has in other parts.

 

IS there anything I am missing here or the "parameters" part does not allow such definition?