> ## 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.

# PATCH - Raise Feedback

>  This endpoint allows you to update the status of a query that has been raised against a specific feedback. You need to provide the exam ID, answer sheet ID, answer ID, feedback ID, and feedback query ID to identify the query. The status of the query can be updated to reflect its current state. 

**Scenario: Updating the Status of a Student's Query:**

1. **Updating Query Status:**
   - After reviewing a student’s query about feedback on their answer sheet, the teacher or administrator updates the status of the query (either resolved or pending).
   - **The API requires:**
     - **Identifiers such as:** exam ID, answer sheet ID, answer ID, feedback ID, and feedback query ID.
   - **Outcome:**
     - The status update clarifies whether the query is resolved or still pending, helping track the progress and resolution of each student’s query.




## OpenAPI

````yaml PATCH /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}/:
    patch:
      summary: Update Feedback Query
      description: >-
        Updates a specific feedback query raised by the student for a given
        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:
                status:
                  type: integer
                  description: Status of the feedback query.
                  example: 1
      responses:
        '200':
          description: Success - Feedback details retrieved successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    description: Feedback details retrieved successfully.
                    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: 1
                            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: {}
        '400':
          description: Bad Request - Invalid input or missing required fields
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: integer
                        example: 400
                      message:
                        type: object
                        properties:
                          non_field_errors:
                            type: array
                            items:
                              type: string
                              example: >-
                                Invalid status: The provided status is not
                                valid.
        '403':
          description: Authentication failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    example: Token has expired
              example:
                detail: Token has expired
        '404':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: integer
                        example: 400
                      message:
                        type: object
                        properties:
                          non_field_errors:
                            type: array
                            items:
                              type: string
                              example: >-
                                Invalid Answer ID: The provided Answer ID does
                                not exist
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````