Rubrics

POST - Rubric Criteria

This API allows authenticated users to add a new criteria to an existing rubric by specifying its title, score range, and detailed scoring logic.

Key Notes:

name, maxScore, and minScore are required fields.
scoringLogic is an array of objects, each containing a score and its associated scoringLogic explanation.
This helps maintain a transparent and consistent evaluation framework.

Scenario: Adding a Criterion to a Rubric

A teacher wants to assess ‘Confidence & fluency in speaking’ in a student presentation rubric.

Outcome:

The teacher sends a POST request with the criterion name and scoring details.
The criterion is added to the existing rubric.
The rubric becomes more detailed and useful for structured evaluation.

POST

rubrics

rubric

{id}

criteria

curl --request POST \
  --url https://api-staging.crazygoldfish.com/rubrics/v1/rubric/{id}/criteria/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Confidence & fluency in speaking",
  "description": "Evaluates how confidently and fluently the student speaks",
  "maxScore": "5 Star",
  "minScore": "1 Star",
  "scoringLogic": [
    {
      "score": "5 Star",
      "scoringLogic": "Speaking: Reflects poise & confidence. Great body language, eye contact."
    }
  ]
}'

{
  "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.

Body

application/json

name

string

required

Name of the rubric criterion

Example:

"Confidence & fluency in speaking"

maxScore

string

required

Maximum score for the criterion

Example:

"5 Star"

minScore

string

required

Minimum score for the criterion

Example:

"1 Star"

scoringLogic

object[]

required

description

string

Description of the rubric criterion

Example:

"Evaluates how confidently and fluently the student speaks"

Response

201

application/json

Rubric criteria created 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

createdAt

string

Created date for the rubric

Example:

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

modifiedAt

string

Modified date of the rubric

Example:

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

LIST - Rubric GET - Rubric Criteria

curl --request POST \
  --url https://api-staging.crazygoldfish.com/rubrics/v1/rubric/{id}/criteria/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Confidence & fluency in speaking",
  "description": "Evaluates how confidently and fluently the student speaks",
  "maxScore": "5 Star",
  "minScore": "1 Star",
  "scoringLogic": [
    {
      "score": "5 Star",
      "scoringLogic": "Speaking: Reflects poise & confidence. Great body language, eye contact."
    }
  ]
}'

{
  "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"
}

Authentication

K12

Assessment Rubrics

Standardized Language Exams

POST - Rubric Criteria

Authorizations

Body

Response