Reply to an exam feedback query

POST

evaluation-platform

exam

{examId}

answer-sheet

{ansSheetId}

answer

{ansId}

feedback

{feedbackId}

query

{feedbackQueryId}

Reply to an exam feedback query

curl --request POST \
  --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 '
{
  "text": "Checked again. The second line repeats pepsin, so the mark stands."
}
'

import requests

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

payload = { "text": "Checked again. The second line repeats pepsin, so the mark stands." }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({text: 'Checked again. The second line repeats pepsin, so the mark stands.'})
};

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": 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."
          }
        ]
      }
    ]
  }
}

Step 8 of 8 in Evaluate an exam.

Rules

feedbackQueryId is a query’s id from feedbackQuery[].id in Get exam answer feedback and queries.
text is the only field read. Anything else in the body is ignored.
A reply is not sent to the AI and does not change marks. To have the AI look again, raise a query.
A successful call returns 200 with the whole feedback record. The reply is inside that query’s responses.

To change a student’s marks after a discussion, use Edit exam questions, answers, or marks with entity set to answer and an updateReason.

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

text

string

The reply. Anything else in the body is ignored.

Response

The reply was added. The response is the whole feedback record, with the reply in the query's responses.

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."
        }
      ]
    }
  ]
}

Reply to an exam feedback query

curl --request POST \
  --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 '
{
  "text": "Checked again. The second line repeats pepsin, so the mark stands."
}
'

import requests

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

payload = { "text": "Checked again. The second line repeats pepsin, so the mark stands." }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({text: 'Checked again. The second line repeats pepsin, so the mark stands.'})
};

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": 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."
          }
        ]
      }
    ]
  }
}

Get started

Guides

Exam Evaluation

Assignment Evaluation

Rubrics

Action Plans

Lesson Plan Builder

Worksheet Builder

ClassTrack

Metadata

Webhooks

Reply to an exam feedback query

Rules

Authorizations

Path Parameters

Body

Response

​Rules

Authorizations

Path Parameters

Body

Response

Rules