Add a rubric criterion
Add one criterion to a rubric, with a scoring band describing what earns each score.
Rules
name,maxScore,minScore, andscoringLogicare required.descriptionis optional.maxScoreandminScoreare strings, not numbers, and each holds at most 10 characters."5 Star","Level 4", and"10"are all valid.scoringLogicis a list of bands. Every band needs both ascorelabel and ascoringLogicsentence. Write one band for each score the criterion can award.- 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.
- A rubric holds at most 20 criteria. The 21st returns
400withMaximum rubric criteria limit reached.
5 Star down to 1 Star, or Level 4 down to Level 1. Describe what a student did to earn a band, not what the grader should do.Next step
Add a rubric to an assignment
rubricId.Authorizations
Access token from Get an access token.
Path Parameters
Unique ID of the rubric, from Create a rubric or List rubrics.
Body
What this criterion measures.
"Grammar and mechanics"
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.
Optional longer explanation of the criterion.
"Spelling, punctuation, and sentence construction."
Response
The criterion was added. The body is the whole rubric, with the new criterion last in 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"