Grade Submission
grade_submissionPost or update the top-level grade for one student's submission on a regular Canvas assignment; calling again with the same grade overwrites the prior posted grade.
Instructions
Post or update the grade for one student's submission on a regular assignment and return the updated Canvas submission object (score, grade, workflow_state, graded_at). Only grade is sent; nothing else on the submission changes. Idempotent: calling it again with the same grade string overwrites the previous posted_grade rather than creating a second grade. This sets only the top-level grade — for a rubric-based assignment use submit_rubric_assessment to score each criterion instead, and for a Classic Quiz use score_quiz_question to grade one question at a time rather than the assignment as a whole. Requires grading permission in the course.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"course_id": "<course_id>",
"assignment_id": "<assignment_id>",
"user_id": "<user_id>",
"grade": "<grade>"
},
"name": "grade_submission"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| grade | Yes | The grade to assign (e.g. "95", "A", "pass") | |
| user_id | Yes | The Canvas user ID | |
| course_id | Yes | The Canvas course ID | |
| assignment_id | Yes | The Canvas assignment ID |