GET - Rubric Criteria

This API allows authenticated users to retrieve all rubric criteria associated with a specific rubric ID.

Key Notes:

id in the URL path refers to the unique identifier of the rubric.
Each criterion contains detailed scoring information including name, minScore, maxScore, and scoringLogic.
The scoringLogic is an array that defines what each score (e.g., 1 Star to 5 Star) represents.

Scenario: Viewing Criteria for a Rubric

A teacher wants to view detailed evaluation criteria for a rubric assigned to a student activity.

Outcome:

The teacher sends a GET request with the rubric ID.
The response returns a list of all rubric criteria with full scoring definitions.
This helps the teacher ensure clarity and consistency during evaluation.

GET

rubrics

rubric

{id}

criteria

Get Rubric Criterion

curl --request GET \
  --url https://api-staging.crazygoldfish.com/rubrics/v1/rubric/{id}/criteria/ \
  --header 'Authorization: Bearer <token>'

{
  "id": "2b973c83-2830-4712-87b7-64a8c0a99035",
  "name": "English Rubric",
  "description": "A rubric for evaluating english hand written assignment.",
  "rubricCriteria": [
    {
      "id": "d102b0ff-1111-4235-b8e9-764ef03c57cb",
      "name": "Confidence & fluency in speaking",
      "maxScore": "5 Star",
      "minScore": "1 Star",
      "scoringLogic": [
        {
          "score": "5 Star",
          "scoringLogic": "Speaking: Reflects poise & confidence. Great body language, eye contact."
        }
      ],
      "createdAt": "2025-03-27T11:34:53.172550Z",
      "modifiedAt": "2025-03-27T11:35:17.739952Z"
    }
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "modifiedAt": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string

required

Unique identifier for the rubric.

Response

Rubric criteria retrieved successfully.

string

Unique ID of the rubric

Example:

"2b973c83-2830-4712-87b7-64a8c0a99035"

name

string

Name of the rubric

Example:

"English Rubric"

description

string

Description of the rubric

Example:

"A rubric for evaluating english hand written assignment."

rubricCriteria

object[]

List of rubric criteria

Show child attributes

createdAt

string<date-time>

Created date for the rubric

Example:

"2023-11-07T05:31:56Z"

modifiedAt

string<date-time>

Modified date of the rubric

Example:

"2023-11-07T05:31:56Z"

PATCH - Rubric Criteria This API allows authenticated users to partially update an existing rubric criteria using its ID. Only the fields that need modification should be sent in the request body. **Key Notes:** - This is a **partial update**, so all fields are optional. - Useful when you want to update just one or two properties like `maxScore` or `scoringLogic`. - Returns the updated rubric criteria along with its metadata. **Fields You Can Update:** - `name`: Title of the criteria (e.g., *Cohesiveness*). - `description`: (Optional) More context or explanation of the criteria. - `maxScore` / `minScore`: Scoring range (e.g., *1 Star* to *5 Star*). - `scoringLogic`: Array of objects defining logic per score. **Scenario: Editing Scoring Logic** A teacher wants to improve clarity in the scoring explanation for a specific score value.

Get Rubric Criterion

curl --request GET \
  --url https://api-staging.crazygoldfish.com/rubrics/v1/rubric/{id}/criteria/ \
  --header 'Authorization: Bearer <token>'

{
  "id": "2b973c83-2830-4712-87b7-64a8c0a99035",
  "name": "English Rubric",
  "description": "A rubric for evaluating english hand written assignment.",
  "rubricCriteria": [
    {
      "id": "d102b0ff-1111-4235-b8e9-764ef03c57cb",
      "name": "Confidence & fluency in speaking",
      "maxScore": "5 Star",
      "minScore": "1 Star",
      "scoringLogic": [
        {
          "score": "5 Star",
          "scoringLogic": "Speaking: Reflects poise & confidence. Great body language, eye contact."
        }
      ],
      "createdAt": "2025-03-27T11:34:53.172550Z",
      "modifiedAt": "2025-03-27T11:35:17.739952Z"
    }
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "modifiedAt": "2023-11-07T05:31:56Z"
}