Update a rubric criterion
Change one rubric criterion: its name, description, score range, or scoring bands.
Rules
- Every field is optional. Anything you leave out keeps its current value.
- Sending
scoringLogicreplaces every band. Send the full list, not just the band you changed. - Every band you send needs both
scoreandscoringLogic. maxScoreandminScorestay strings of at most 10 characters.- 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.
rubricCriteria.criteriaId returns 404 with Rubric criteria not found.Authorizations
Access token from Get an access token.
Path Parameters
Unique ID of the rubric, from Create a rubric or List rubrics.
Unique ID of the criterion, from the rubricCriteria array of any rubric response.
Body
Every field is optional. Fields you leave out keep their current value.
What this criterion measures.
"Grammar and mechanics"
Optional longer explanation of the criterion.
"Spelling, punctuation, and sentence construction."
Highest score this criterion can award. A string, not a number, so 5 Star and 10 are both valid. At most 10 characters.
10"5 Star"
Lowest score this criterion can award. A string, not a number. At most 10 characters.
10"1 Star"
One band per score the criterion can award, from maxScore down to minScore. Every band needs both score and scoringLogic.
Response
The updated rubric, with the changed criterion inside rubricCriteria.
A rubric and all of its criteria.
Unique ID of the rubric. Send it as rubricId when you attach the rubric to an assignment.
"2b973c83-2830-4712-87b7-64a8c0a99035"
Name of the rubric.
"Grade 5 English homework"
Longer explanation of the rubric. null if you did not send one.
"Grades handwritten English homework on grammar and clarity."
Every criterion on this rubric, oldest first. Empty until you add one.
"2026-03-27T11:30:18.402117Z"
"2026-03-27T11:30:18.402145Z"