Create an assignment answer sheet

POST

assignment-evaluation

assignment

{id}

answer-sheet

Create an assignment answer sheet

curl --request POST \
  --url https://api.crazygoldfish.com/assignment-evaluation/v1/assignment/{id}/answer-sheet/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "studentId": "STU-10432",
  "name": "Aarav Sharma"
}
'

import requests

url = "https://api.crazygoldfish.com/assignment-evaluation/v1/assignment/{id}/answer-sheet/"

payload = {
    "studentId": "STU-10432",
    "name": "Aarav Sharma"
}
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({studentId: 'STU-10432', name: 'Aarav Sharma'})
};

fetch('https://api.crazygoldfish.com/assignment-evaluation/v1/assignment/{id}/answer-sheet/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "6e1d2c3b-4a5f-4e6d-8c7b-9a0f1e2d3c4b",
  "status": 0,
  "batchId": "BATCH-7A",
  "sessionId": "2025-26",
  "studentId": "STU-10432",
  "name": "Aarav Sharma",
  "teacherId": "TEA-204",
  "documents": []
}

Step 4 of 6 in Evaluate an assignment. Call it once per student, and save the id it returns.

Rules

The assignment’s status and its model answer sheet’s status must both be 2 (Completed). Otherwise this returns 400 with Assignment is not extracted yet or Model answer sheet is not extracted yet.
studentId and name are required. batchId, sessionId, and teacherId are optional, and CrazyGoldFish stores and returns them unchanged.
studentId and teacherId hold up to 50 characters. name, batchId, and sessionId hold up to 200. A longer value returns a 500.
Nothing stops you creating two sheets for the same student, so keep your own record of the id you use.
A successful call returns 201, not 200.

Next step

Submit an assignment answer sheet for evaluation

Add the student’s answer as documents or as an audio link, then start evaluation.

Authorizations

Authorization

string

header

required

Access token from Get an access token.

Path Parameters

string<uuid>

required

The assignment id returned by Create an assignment. Use it exactly as returned: the lowercase form is the only one the nested paths accept.

Example:

"3c9e1f2a-7b4d-4a8e-9f1c-2d5e6a7b8c9d"

Body

application/json

studentId

string

required

Your own ID for the student. Also a filter on List assignment answer sheets.

Maximum string length: 50

Example:

"STU-10432"

name

string

required

The student's name.

Maximum string length: 200

Example:

"Aarav Sharma"

batchId

string

Your own ID for the batch. Stored and returned unchanged.

Maximum string length: 200

Example:

"BATCH-7A"

sessionId

string

Your own ID for the academic session. Stored and returned unchanged.

Maximum string length: 200

Example:

"2025-26"

teacherId

string

Your own ID for the teacher. Also a filter on List assignment answer sheets.

Maximum string length: 50

Example:

"TEA-204"

Response

The answer sheet was created. Its status is 0 (Open) until you submit an answer.

string<uuid>

ID of the answer sheet.

Example:

"6e1d2c3b-4a5f-4e6d-8c7b-9a0f1e2d3c4b"

status

enum<integer>

0 Open, 1 In Progress, 2 Completed, 3 Failed.

Available options:

0,

1,

2,

3

Example:

2

batchId

string | null

Example:

"BATCH-7A"

sessionId

string | null

Example:

"2025-26"

studentId

string

Example:

"STU-10432"

name

string | null

Example:

"Aarav Sharma"

teacherId

string | null

Example:

"TEA-204"

documents

object[]

The student's answer: uploaded files, or one audio link.

Show child attributes

Create an assignment answer sheet

curl --request POST \
  --url https://api.crazygoldfish.com/assignment-evaluation/v1/assignment/{id}/answer-sheet/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "studentId": "STU-10432",
  "name": "Aarav Sharma"
}
'

import requests

url = "https://api.crazygoldfish.com/assignment-evaluation/v1/assignment/{id}/answer-sheet/"

payload = {
    "studentId": "STU-10432",
    "name": "Aarav Sharma"
}
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({studentId: 'STU-10432', name: 'Aarav Sharma'})
};

fetch('https://api.crazygoldfish.com/assignment-evaluation/v1/assignment/{id}/answer-sheet/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "6e1d2c3b-4a5f-4e6d-8c7b-9a0f1e2d3c4b",
  "status": 0,
  "batchId": "BATCH-7A",
  "sessionId": "2025-26",
  "studentId": "STU-10432",
  "name": "Aarav Sharma",
  "teacherId": "TEA-204",
  "documents": []
}

Get started

Guides

Exam Evaluation

Assignment Evaluation

Rubrics

Action Plans

Lesson Plan Builder

Worksheet Builder

ClassTrack

Metadata

Webhooks

Create an assignment answer sheet

Rules

Next step

Submit an assignment answer sheet for evaluation

Authorizations

Path Parameters

Body

Response

​Rules

​Next step

Submit an assignment answer sheet for evaluation

Authorizations

Path Parameters

Body

Response

Rules

Next step