Update a rubric

PATCH

rubrics

rubric

{id}

Update a rubric

curl --request PATCH \
  --url https://api.crazygoldfish.com/rubrics/v1/rubric/{id}/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Grade 5 English homework (term 2)"
}
'

import requests

url = "https://api.crazygoldfish.com/rubrics/v1/rubric/{id}/"

payload = { "name": "Grade 5 English homework (term 2)" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({name: 'Grade 5 English homework (term 2)'})
};

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

{
  "id": "2b973c83-2830-4712-87b7-64a8c0a99035",
  "name": "Grade 5 English homework (term 2)",
  "description": "Grades handwritten English homework on grammar and clarity.",
  "rubricCriteria": [
    {
      "id": "d102b0ff-1111-4235-b8e9-764ef03c57cb",
      "name": "Grammar and mechanics",
      "description": "Spelling, punctuation, and sentence construction.",
      "maxScore": "5 Star",
      "minScore": "1 Star",
      "scoringLogic": [
        {
          "score": "5 Star",
          "scoringLogic": "No spelling or punctuation errors. Sentences are complete and varied."
        },
        {
          "score": "4 Star",
          "scoringLogic": "One or two small errors that do not change the meaning."
        },
        {
          "score": "3 Star",
          "scoringLogic": "Several errors that the reader notices but can work around."
        },
        {
          "score": "2 Star",
          "scoringLogic": "Frequent errors that make some sentences hard to follow."
        },
        {
          "score": "1 Star",
          "scoringLogic": "Errors throughout. The writing is very hard to read."
        }
      ],
      "createdAt": "2026-03-27T11:34:53.172550Z",
      "modifiedAt": "2026-03-27T11:34:53.172581Z"
    },
    {
      "id": "9c4e7a15-63b2-4f80-a1d7-5e0cb8f2a934",
      "name": "Clarity and expression",
      "description": "How easily a reader follows the answer.",
      "maxScore": "5 Star",
      "minScore": "1 Star",
      "scoringLogic": [
        {
          "score": "5 Star",
          "scoringLogic": "Every idea is clear on the first reading."
        },
        {
          "score": "4 Star",
          "scoringLogic": "Mostly clear, with one or two vague sentences."
        },
        {
          "score": "3 Star",
          "scoringLogic": "Understandable, but the reader has to work at it."
        },
        {
          "score": "2 Star",
          "scoringLogic": "Often vague or confusing."
        },
        {
          "score": "1 Star",
          "scoringLogic": "The meaning does not come through."
        }
      ],
      "createdAt": "2026-03-27T11:36:02.884910Z",
      "modifiedAt": "2026-03-27T11:36:02.884938Z"
    }
  ],
  "createdAt": "2026-03-27T11:30:18.402117Z",
  "modifiedAt": "2026-03-27T12:02:41.117334Z"
}

Rules

Only name and description are read. Send either, or both.
Anything you leave out keeps its current value.
Keep the trailing slash on the path. Without it the API redirects, and most HTTP clients drop the request body when they follow a redirect.
The rubric’s criteria are not changed. To edit one, use Update a rubric criterion.

This call does not validate the body. A misspelled field name, such as nmae, is ignored instead of rejected, and you get back 200 with an unchanged rubric. Check the name and description in the response to confirm your change landed.

Never send "name": null. A rubric must always have a name. To leave the name alone, leave the field out. "description": null is fine and clears the description.

The response is the whole rubric, including its criteria. 404 with Rubric not found means no rubric exists with this ID.

Authorizations

Authorization

string

header

required

Access token from Get an access token.

Path Parameters

string<uuid>

required

Unique ID of the rubric, from Create a rubric or List rubrics.

Body

application/json

Send either field, or both. Any other field in the body is ignored.

name

string

New name for the rubric. Send a non-empty string: an explicit null fails with 500.

Example:

"Grade 5 English homework (term 2)"

description

string | null

New description for the rubric. An explicit null clears it.

Example:

"Grades handwritten English homework on grammar, clarity, and effort."

Response

The updated rubric, with its criteria.

A rubric and all of its criteria.

string<uuid>

Unique ID of the rubric. Send it as rubricId when you attach the rubric to an assignment.

Example:

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

name

string

Name of the rubric.

Example:

"Grade 5 English homework"

description

string | null

Longer explanation of the rubric. null if you did not send one.

Example:

"Grades handwritten English homework on grammar and clarity."

rubricCriteria

object[]

Every criterion on this rubric, oldest first. Empty until you add one.

Show child attributes

createdAt

string<date-time>

Example:

"2026-03-27T11:30:18.402117Z"

modifiedAt

string<date-time>

Example:

"2026-03-27T11:30:18.402145Z"

Update a rubric

curl --request PATCH \
  --url https://api.crazygoldfish.com/rubrics/v1/rubric/{id}/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Grade 5 English homework (term 2)"
}
'

import requests

url = "https://api.crazygoldfish.com/rubrics/v1/rubric/{id}/"

payload = { "name": "Grade 5 English homework (term 2)" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({name: 'Grade 5 English homework (term 2)'})
};

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

{
  "id": "2b973c83-2830-4712-87b7-64a8c0a99035",
  "name": "Grade 5 English homework (term 2)",
  "description": "Grades handwritten English homework on grammar and clarity.",
  "rubricCriteria": [
    {
      "id": "d102b0ff-1111-4235-b8e9-764ef03c57cb",
      "name": "Grammar and mechanics",
      "description": "Spelling, punctuation, and sentence construction.",
      "maxScore": "5 Star",
      "minScore": "1 Star",
      "scoringLogic": [
        {
          "score": "5 Star",
          "scoringLogic": "No spelling or punctuation errors. Sentences are complete and varied."
        },
        {
          "score": "4 Star",
          "scoringLogic": "One or two small errors that do not change the meaning."
        },
        {
          "score": "3 Star",
          "scoringLogic": "Several errors that the reader notices but can work around."
        },
        {
          "score": "2 Star",
          "scoringLogic": "Frequent errors that make some sentences hard to follow."
        },
        {
          "score": "1 Star",
          "scoringLogic": "Errors throughout. The writing is very hard to read."
        }
      ],
      "createdAt": "2026-03-27T11:34:53.172550Z",
      "modifiedAt": "2026-03-27T11:34:53.172581Z"
    },
    {
      "id": "9c4e7a15-63b2-4f80-a1d7-5e0cb8f2a934",
      "name": "Clarity and expression",
      "description": "How easily a reader follows the answer.",
      "maxScore": "5 Star",
      "minScore": "1 Star",
      "scoringLogic": [
        {
          "score": "5 Star",
          "scoringLogic": "Every idea is clear on the first reading."
        },
        {
          "score": "4 Star",
          "scoringLogic": "Mostly clear, with one or two vague sentences."
        },
        {
          "score": "3 Star",
          "scoringLogic": "Understandable, but the reader has to work at it."
        },
        {
          "score": "2 Star",
          "scoringLogic": "Often vague or confusing."
        },
        {
          "score": "1 Star",
          "scoringLogic": "The meaning does not come through."
        }
      ],
      "createdAt": "2026-03-27T11:36:02.884910Z",
      "modifiedAt": "2026-03-27T11:36:02.884938Z"
    }
  ],
  "createdAt": "2026-03-27T11:30:18.402117Z",
  "modifiedAt": "2026-03-27T12:02:41.117334Z"
}

Get started

Guides

Exam Evaluation

Assignment Evaluation

Rubrics

Action Plans

Lesson Plan Builder

Worksheet Builder

ClassTrack

Metadata

Webhooks

Rules

Authorizations

Path Parameters

Body

Response

​Rules

Authorizations

Path Parameters

Body

Response

Rules