Add a rubric criterion
Add one criterion to a rubric, with a scoring band describing what earns each score.
POST
Add a rubric criterion
Step 2 of 3 in Create a rubric. Call it once per criterion.
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.
The grading model reads your band labels and reports one of them back as the student’s level, so keep the wording conventional and consistent:
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
Attach the finished rubric to an assignment’s model answer sheet with
rubricId.Authorizations
Access token from Get an access token.
Path Parameters
Unique ID of the rubric, from Create a rubric or List rubrics.
Body
application/json
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.