create_rubric
Create rubric criteria for a course and optionally associate with an assignment. Define custom rating levels and point values using JSON.
Instructions
Create a new rubric in a course, optionally associating it with an assignment.
Uses bracket-notation form-data encoding required by the Canvas rubric API.
The ``criteria`` parameter is a JSON string mapping arbitrary criterion keys to
objects with the following fields:
- ``description`` (required): Short criterion label shown in the rubric grid
- ``points`` (required): Maximum points for this criterion (non-negative number)
- ``long_description`` (optional): Detailed criterion description
- ``ratings`` (optional): List (or object) of rating levels, each with:
- ``description`` (required): Rating label (e.g. "Excellent")
- ``points`` (required): Points for this rating (non-negative number)
- ``long_description`` (optional): Detailed rating description
Example ``criteria`` JSON::
{
"c1": {
"description": "Content Quality",
"points": 10,
"ratings": [
{"description": "Excellent", "points": 10},
{"description": "Satisfactory", "points": 7},
{"description": "Needs Work", "points": 3}
]
},
"c2": {
"description": "Grammar",
"points": 5,
"ratings": [
{"description": "No errors", "points": 5},
{"description": "Minor errors", "points": 3}
]
}
}
Args:
course_identifier: Course code or Canvas ID
title: Rubric title
criteria: JSON string defining rubric criteria (see docstring above)
assignment_id: Optional assignment ID to immediately associate the rubric with
use_for_grading: When associating with an assignment, use rubric for grade
calculation (default: False)
reusable: Make rubric reusable across courses (default: False)
free_form_criterion_comments: Allow free-form comments per criterion
instead of rating selection (default: False)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| course_identifier | Yes | ||
| title | Yes | ||
| criteria | Yes | ||
| assignment_id | No | ||
| use_for_grading | No | ||
| reusable | No | ||
| free_form_criterion_comments | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |