Update an exam feedback query status

PATCH

evaluation-platform

exam

{examId}

answer-sheet

{ansSheetId}

answer

{ansId}

feedback

{feedbackId}

query

{feedbackQueryId}

Update an exam feedback query status

curl --request PATCH \
  --url https://api.crazygoldfish.com/evaluation-platform/v1/exam/{examId}/answer-sheet/{ansSheetId}/answer/{ansId}/feedback/{feedbackId}/query/{feedbackQueryId}/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "status": 3
}'

import requests

url = "https://api.crazygoldfish.com/evaluation-platform/v1/exam/{examId}/answer-sheet/{ansSheetId}/answer/{ansId}/feedback/{feedbackId}/query/{feedbackQueryId}/"

payload = { "status": 3 }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({status: 3})
};

fetch('https://api.crazygoldfish.com/evaluation-platform/v1/exam/{examId}/answer-sheet/{ansSheetId}/answer/{ansId}/feedback/{feedbackId}/query/{feedbackQueryId}/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "id": "3d1c8b57-6e94-4a2f-b0d3-7c5e9a18f462",
    "examId": "d19e6868-98dd-4274-a2a5-4a616dd93ea7",
    "studentId": "S-2043",
    "answerId": "f819bfd2-8aaa-42df-bd18-23cb989b2d16",
    "feedback": "The enzyme for location (iii) is trypsin, not pepsin.",
    "marks_deducted": "1",
    "justification": "Pepsin acts in the stomach, so it cannot be the enzyme at location (iii).",
    "room_for_improvement": "Revise which enzyme each digestive organ secretes.",
    "feedbackQuery": [
      {
        "id": "9c4e2a18-7d35-4b61-8e0f-2a6b5c3d9e71",
        "createdByRole": "Student",
        "queryType": 2,
        "status": 3,
        "text": "I wrote trypsin for (iii) in the second line, please check again.",
        "responses": [
          {
            "id": "4f8a1d27-3c65-4e92-b8a0-1d7e5c4b9f36",
            "createdByRole": "AI",
            "text": "The second line repeats pepsin, so the deduction stands."
          }
        ]
      }
    ]
  }
}

Step 8 of 8 in Evaluate an exam.

Rules

status is required, and must be the integer 1, 2, or 3. A missing or unknown value returns 400 Invalid status: The provided status is not valid.
Send the number, not the name. "2" as a string is rejected.
A successful call returns 200 with the whole feedback record.

`status`	Meaning
`1`	Submitted
`2`	In Review. Set automatically when the query is raised.
`3`	Resolved. Set automatically when the AI finishes its re-evaluation.

Statuses are for your own workflow. Changing one does not re-run the AI and does not change marks.

Authorizations

Authorization

string

header

required

Access token from Get an access token. A missing, invalid, or expired token returns 403.

Path Parameters

examId

string<uuid>

required

The exam id returned by Create an exam. Write it in lowercase: this path only matches lowercase hexadecimal characters and hyphens.

Example:

"d19e6868-98dd-4274-a2a5-4a616dd93ea7"

ansSheetId

string<uuid>

required

The answer sheet id returned by Create an exam answer sheet. Write it in lowercase.

Example:

"8a2f4c1e-5b3d-4e6f-9a7b-0c1d2e3f4a5b"

ansId

string<uuid>

required

The answer id from answer[].id in Get exam scores for review. Write it in lowercase.

Example:

"f819bfd2-8aaa-42df-bd18-23cb989b2d16"

feedbackId

string<uuid>

required

The feedback id from Get exam answer feedback and queries.

Example:

"3d1c8b57-6e94-4a2f-b0d3-7c5e9a18f462"

feedbackQueryId

string<uuid>

required

The query id from feedbackQuery[].id in Get exam answer feedback and queries.

Example:

"9c4e2a18-7d35-4b61-8e0f-2a6b5c3d9e71"

Body

application/json

status

enum<integer>

required

1 Submitted, 2 In Review, 3 Resolved. Send the number, not the name.

Available options:

1,

2,

3

Response

The status was saved. The response is the whole feedback record.

data

object

One reason the AI deducted marks from an answer, with any queries raised against it.

Show child attributes

Example:

{
  "id": "3d1c8b57-6e94-4a2f-b0d3-7c5e9a18f462",
  "examId": "d19e6868-98dd-4274-a2a5-4a616dd93ea7",
  "studentId": "S-2043",
  "answerId": "f819bfd2-8aaa-42df-bd18-23cb989b2d16",
  "feedback": "The enzyme for location (iii) is trypsin, not pepsin.",
  "marks_deducted": "1",
  "justification": "Pepsin acts in the stomach, so it cannot be the enzyme at location (iii).",
  "room_for_improvement": "Revise which enzyme each digestive organ secretes.",
  "feedbackQuery": [
    {
      "id": "9c4e2a18-7d35-4b61-8e0f-2a6b5c3d9e71",
      "createdByRole": "Student",
      "queryType": 2,
      "status": 2,
      "text": "I wrote trypsin for (iii) in the second line, please check again.",
      "responses": [
        {
          "id": "4f8a1d27-3c65-4e92-b8a0-1d7e5c4b9f36",
          "createdByRole": "AI",
          "text": "The second line repeats pepsin, so the deduction stands."
        }
      ]
    }
  ]
}

Update an exam feedback query status

curl --request PATCH \
  --url https://api.crazygoldfish.com/evaluation-platform/v1/exam/{examId}/answer-sheet/{ansSheetId}/answer/{ansId}/feedback/{feedbackId}/query/{feedbackQueryId}/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "status": 3
}'

import requests

url = "https://api.crazygoldfish.com/evaluation-platform/v1/exam/{examId}/answer-sheet/{ansSheetId}/answer/{ansId}/feedback/{feedbackId}/query/{feedbackQueryId}/"

payload = { "status": 3 }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({status: 3})
};

fetch('https://api.crazygoldfish.com/evaluation-platform/v1/exam/{examId}/answer-sheet/{ansSheetId}/answer/{ansId}/feedback/{feedbackId}/query/{feedbackQueryId}/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "id": "3d1c8b57-6e94-4a2f-b0d3-7c5e9a18f462",
    "examId": "d19e6868-98dd-4274-a2a5-4a616dd93ea7",
    "studentId": "S-2043",
    "answerId": "f819bfd2-8aaa-42df-bd18-23cb989b2d16",
    "feedback": "The enzyme for location (iii) is trypsin, not pepsin.",
    "marks_deducted": "1",
    "justification": "Pepsin acts in the stomach, so it cannot be the enzyme at location (iii).",
    "room_for_improvement": "Revise which enzyme each digestive organ secretes.",
    "feedbackQuery": [
      {
        "id": "9c4e2a18-7d35-4b61-8e0f-2a6b5c3d9e71",
        "createdByRole": "Student",
        "queryType": 2,
        "status": 3,
        "text": "I wrote trypsin for (iii) in the second line, please check again.",
        "responses": [
          {
            "id": "4f8a1d27-3c65-4e92-b8a0-1d7e5c4b9f36",
            "createdByRole": "AI",
            "text": "The second line repeats pepsin, so the deduction stands."
          }
        ]
      }
    ]
  }
}

Get started

Guides

Exam Evaluation

Assignment Evaluation

Rubrics

Action Plans

Lesson Plan Builder

Worksheet Builder

ClassTrack

Metadata

Webhooks

Update an exam feedback query status

Rules

Authorizations

Path Parameters

Body

Response

​Rules

Authorizations

Path Parameters

Body

Response

Rules