> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crazygoldfish.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST - Feedback Query

>  This endpoint allows a student, teacher, or parent to reply to a query that has been raised against a specific feedback query. Additionally, a student can reply to the AI response related to the feedback query. You need to provide the exam ID, answer sheet ID, answer ID, feedback ID, and feedback query ID to identify the query.


**Scenario: Student Replying to a Feedback Query:**

1. **Student’s Additional Clarification:**
   - After receiving AI-generated feedback and the AI's response to their query, a student may want to explain why they believe their answer should be graded differently or address any misunderstandings.
   - **Outcome:**
     - The student’s reply is stored and linked to the specific feedback query, offering further context for the evaluator to review.

**Scenario: Teacher or Parent Replying to a Query:**

1. **Teacher or Parent's Input:**
   - A teacher or parent might reply to a query raised by the student to clarify feedback, explain reasoning behind marks, or provide additional insights.
   - **Outcome:**
     - The teacher or parent’s reply is stored, ensuring more transparency in the evaluation process. 



## OpenAPI

````yaml POST /evaluation-platform/v1/exam/{examId}/answer-sheet/{ansSheetId}/answer/{ansId}/feedback/{feedbackId}/query/{feedbackQueryId}/
openapi: 3.0.1
info:
  title: Evaluation Report API
  description: An API for retrieving evaluation reports.
  version: 1.0.0
servers:
  - url: https://api-staging.crazygoldfish.com
    description: SandBox endpoint
  - url: https://api.crazygoldfish.com
    description: Prod End Point
security: []
paths:
  /evaluation-platform/v1/exam/{examId}/answer-sheet/{ansSheetId}/answer/{ansId}/feedback/{feedbackId}/query/{feedbackQueryId}/:
    post:
      summary: Generate Feedback Query for answer
      description: Generates feedback query for an answer.
      parameters:
        - name: examId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Unique identifier of the exam.
        - name: ansSheetId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Unique identifier of the answer sheet.
        - name: ansId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Unique identifier of the answer.
        - name: feedbackId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Unique identifier of the feedback.
        - name: feedbackQueryId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Unique identifier of the feedback query.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                text:
                  type: string
                  description: Text of the feedback query.
                  example: ok got it
      responses:
        '200':
          description: Success - Feedback details retrieved successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                        example: def80534-8f59-49ea-b43e-553075b1db91
                        description: Feedback unique identifier against the answers.
                      examId:
                        type: string
                        example: edaf2e84-e911-4150-9628-6d182a05ed0d
                        description: Unique identifier of the exam.
                      studentId:
                        type: string
                        description: Unique identifier of the student.
                        example: '10160091'
                      answerId:
                        type: string
                        description: Unique identifier of the answer.
                        example: 11637fca-dc77-4b63-88c0-ec74126d951c
                      feedback:
                        type: string
                        description: Feedback provided for the answer.
                        example: >-
                          The student selected an incorrect option. It is
                          important to carefully analyze the question and the
                          options provided. Understanding the characteristics of
                          a homologous series is crucial for answering such
                          questions correctly.
                      marks_deducted:
                        type: string
                        description: Marks deducted for the answer.
                        example: 1 - incorrect option selected
                      justification:
                        type: string
                        description: Justification for the feedback provided.
                        example: >-
                          The student's answer (c) gradation in Physical
                          Properties is incorrect as it does not address the
                          question of what is not observed in a homologous
                          series. The model answer correctly identifies (a)
                          Change in chemical properties as the correct response.
                      room_for_improvement:
                        type: string
                        description: Room for improvement for the student.
                        example: >-
                          To achieve full marks, the student should select the
                          correct option (a) Change in chemical properties,
                          which is the only option that is not observed in a
                          homologous series.
                      feedbackQuery:
                        type: array
                        description: Feedback query raise by the student
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              description: Feedback query unique identifier.
                              example: e2b75a94-bc8a-4a2b-a23f-32abc1198f37
                            createdByRole:
                              type: string
                              description: Role of the user who created the feedback query.
                              example: Student
                            queryType:
                              type: integer
                              description: Type of query raised by the student.
                              example: 1
                            status:
                              type: integer
                              description: Status of the feedback query.
                              example: 3
                            text:
                              type: string
                              description: Text of the feedback query.
                              example: why my marks has been deducted
                            responses:
                              type: array
                              description: Responses to the feedback query.
                              items:
                                type: object
                                properties:
                                  id:
                                    type: string
                                    description: Feedback query response unique identifier.
                                    example: 3421ecec-30fd-4a51-89ba-aa796332ba51
                                  createdByRole:
                                    type: string
                                    description: >-
                                      Role of the user who created the feedback
                                      query response.
                                    example: AI
                                  text:
                                    type: string
                                    description: Text of the feedback query response.
                                    example: >-
                                      The student's selected answer '(c)
                                      gradation in Physical Properties' is
                                      incorrect according to the marking scheme.
                                      The correct answer is '(a) Change in
                                      chemical properties', as homologous series
                                      have the same functional group and show a
                                      gradation in physical properties, but do
                                      not have a change in chemical properties.
                                      Therefore, no change in marks is
                                      warranted.

````