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

Create Rubric Criterion

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",
  "maxScore": "5 Star",
  "minScore": "1 Star",
  "scoringLogic": [
    {
      "score": "5 Star",
      "scoringLogic": "Speaking: Reflects poise & confidence. Great body language, eye contact."
    }
  ],
  "description": "Evaluates how confidently and fluently the student speaks"
}
'

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

ID of the rubric the criteria belongs to

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

Show child attributes

description

string

Description of the rubric criterion

Example:

"Evaluates how confidently and fluently the student speaks"

Response

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

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"

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.

Create Rubric Criterion

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",
  "maxScore": "5 Star",
  "minScore": "1 Star",
  "scoringLogic": [
    {
      "score": "5 Star",
      "scoringLogic": "Speaking: Reflects poise & confidence. Great body language, eye contact."
    }
  ],
  "description": "Evaluates how confidently and fluently the student speaks"
}
'

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

Documentation Index

Authorizations

Path Parameters

Body

Response