Start a classroom analysis

POST

class-track

analysis

cURL

curl -X POST https://api.crazygoldfish.com/class-track/v1/analysis \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "teacher_id": "T-2087",
    "institution_id": "INST-14",
    "board_id": "baf36573-d049-4636-9c4b-bc9cda6270fe",
    "grade_id": "28820b1a-34e1-4003-b5bd-96455ca2c6d8",
    "subject_id": "6dd7ebda-1bc5-4c01-8649-372579189073",
    "rubric_id": "c4a1e8f2-7d36-4b59-8e0a-5f2c3d9b1a47",
    "date": "2026-09-16",
    "link": "https://storage.example.com/recordings/grade-10-science-2026-09-16.mp3"
  }'

import requests

# ClassTrack takes the token on its own, with no "Bearer " prefix
headers = {"Authorization": "YOUR_ACCESS_TOKEN"}

response = requests.post(
    "https://api.crazygoldfish.com/class-track/v1/analysis",
    headers=headers,
    json={
        "teacher_id": "T-2087",
        "institution_id": "INST-14",
        "board_id": "baf36573-d049-4636-9c4b-bc9cda6270fe",
        "grade_id": "28820b1a-34e1-4003-b5bd-96455ca2c6d8",
        "subject_id": "6dd7ebda-1bc5-4c01-8649-372579189073",
        "rubric_id": "c4a1e8f2-7d36-4b59-8e0a-5f2c3d9b1a47",
        "date": "2026-09-16",
        "link": "https://storage.example.com/recordings/lesson.mp3",
    },
)
response.raise_for_status()
analysis_id = response.json()["detail"][0]["id"]

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    teacher_id: 'T-2087',
    board_id: 'baf36573-d049-4636-9c4b-bc9cda6270fe',
    grade_id: '28820b1a-34e1-4003-b5bd-96455ca2c6d8',
    subject_id: '6dd7ebda-1bc5-4c01-8649-372579189073',
    rubric_id: 'c4a1e8f2-7d36-4b59-8e0a-5f2c3d9b1a47',
    date: '2026-09-16',
    link: 'https://storage.example.com/recordings/grade-10-science-2026-09-16.mp3'
  })
};

fetch('https://api.crazygoldfish.com/class-track/v1/analysis', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "detail": [
    {
      "id": "7f3c9a24-5b18-4d6e-9c07-2a4f8e1b6d35",
      "message": "Class track analysis process started!"
    }
  ]
}

Step 1 of 2 in Analyze a classroom recording. This call starts a background job and returns the analysis id. Save it: it is the only way to read the result.

Rules

Send teacher_id, board_id, grade_id, subject_id, rubric_id, date, and link. institution_id is optional.
teacher_id and institution_id are your own identifiers, and must be 50 characters or fewer. The API stores them and does not check them.
board_id, grade_id, and subject_id must be IDs that exist. Get them from List boards, List grades, and List subjects.
rubric_id takes either the rubric’s UUID from List rubrics or its integer ID. The rubric’s criteria become the categories in the result.
date is the day of the lesson, as YYYY-MM-DD. Today is allowed, a future date is rejected.
link must start with https://, its path must end with .mp3 in lower case, and the file must be publicly reachable.

Send the token without the Bearer prefix on ClassTrack. This service reads the whole Authorization header as the token, so Authorization: YOUR_ACCESS_TOKEN works and Authorization: Bearer YOUR_ACCESS_TOKEN returns 401 Unauthorized User. Every other CrazyGoldFish API expects the prefix.

How the link is checked

The API checks the link before it accepts the request:

Check	Rejected example
Starts with `https://`	`http://example.com/lesson.mp3`
Path ends with `.mp3`, in lower case	`.../lesson.MP3`, `.../lesson.wav`
No query string after the file name	`.../lesson.mp3?token=abc`
Not `localhost` or a private IP address	`https://192.168.1.10/lesson.mp3`
Answers an HTTP `HEAD` request with `200`, `206`, or `302` within 10 seconds	A link that needs a login, or one that has expired

A pre-signed storage URL with credentials in the query string is rejected, because the query string comes after .mp3. Host the file where the path itself ends in .mp3, and keep it reachable until the analysis finishes.

This call returns 200, not 201, and the message field in the response is called message, not msg.

Next step

Get a classroom analysis

Poll the analysis ID, or wait for the class_track_analysis webhook.

Authorizations

Authorization

string

header

required

Access token from Get an access token. ClassTrack reads the Authorization header as the token itself, so send the token with no Bearer prefix on these two endpoints.

Body

application/json

teacher_id

string

required

Your own identifier for the teacher being observed. Stored as sent, and not checked against anything.

Maximum string length: 50

board_id

string<uuid>

required

The education board. Must exist. Get it from List boards.

grade_id

string<uuid>

required

The grade. Must exist. Get it from List grades.

subject_id

string<uuid>

required

The subject. Must exist. Get it from List subjects.

rubric_id

required

The rubric to score the lesson against. Send its UUID from List rubrics, or its integer ID. Either way the rubric must exist, and its criteria become the categories in rubric_evaluation.

date

string<date>

required

The date of the lesson, as YYYY-MM-DD. Today is allowed. A future date is rejected.

link

string<uri>

required

A link to the recording. It must start with https://, its path must end with .mp3 in lower case, and it must be publicly reachable. Links to localhost or a private IP range are rejected.

institution_id

string | null

Optional. Your own identifier for the school.

Maximum string length: 50

Response

The job is queued. Save id: it is the only way to read the result. Note that this call returns 200, not 201, and that the message field is called message, not msg.

detail

object[]

Show child attributes

cURL

curl -X POST https://api.crazygoldfish.com/class-track/v1/analysis \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "teacher_id": "T-2087",
    "institution_id": "INST-14",
    "board_id": "baf36573-d049-4636-9c4b-bc9cda6270fe",
    "grade_id": "28820b1a-34e1-4003-b5bd-96455ca2c6d8",
    "subject_id": "6dd7ebda-1bc5-4c01-8649-372579189073",
    "rubric_id": "c4a1e8f2-7d36-4b59-8e0a-5f2c3d9b1a47",
    "date": "2026-09-16",
    "link": "https://storage.example.com/recordings/grade-10-science-2026-09-16.mp3"
  }'

import requests

# ClassTrack takes the token on its own, with no "Bearer " prefix
headers = {"Authorization": "YOUR_ACCESS_TOKEN"}

response = requests.post(
    "https://api.crazygoldfish.com/class-track/v1/analysis",
    headers=headers,
    json={
        "teacher_id": "T-2087",
        "institution_id": "INST-14",
        "board_id": "baf36573-d049-4636-9c4b-bc9cda6270fe",
        "grade_id": "28820b1a-34e1-4003-b5bd-96455ca2c6d8",
        "subject_id": "6dd7ebda-1bc5-4c01-8649-372579189073",
        "rubric_id": "c4a1e8f2-7d36-4b59-8e0a-5f2c3d9b1a47",
        "date": "2026-09-16",
        "link": "https://storage.example.com/recordings/lesson.mp3",
    },
)
response.raise_for_status()
analysis_id = response.json()["detail"][0]["id"]

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    teacher_id: 'T-2087',
    board_id: 'baf36573-d049-4636-9c4b-bc9cda6270fe',
    grade_id: '28820b1a-34e1-4003-b5bd-96455ca2c6d8',
    subject_id: '6dd7ebda-1bc5-4c01-8649-372579189073',
    rubric_id: 'c4a1e8f2-7d36-4b59-8e0a-5f2c3d9b1a47',
    date: '2026-09-16',
    link: 'https://storage.example.com/recordings/grade-10-science-2026-09-16.mp3'
  })
};

fetch('https://api.crazygoldfish.com/class-track/v1/analysis', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "detail": [
    {
      "id": "7f3c9a24-5b18-4d6e-9c07-2a4f8e1b6d35",
      "message": "Class track analysis process started!"
    }
  ]
}

Get started

Guides

Exam Evaluation

Assignment Evaluation

Rubrics

Action Plans

Lesson Plan Builder

Worksheet Builder

ClassTrack

Metadata

Webhooks

Start a classroom analysis

Rules

How the link is checked

Next step

Get a classroom analysis

Authorizations

Body

Response

​Rules

​How the link is checked

​Next step

Get a classroom analysis

Authorizations

Body

Response

Rules

How the link is checked

Next step