Grade Submission
PATCH https://ed.link/api/v2/my/classes/:class\_id/assignments/:assignment\_id/submissions/:submission\_id
Update metadata for a specific Submission. This includes submitting grades, comments, or altering due date overrides (setting the due date for an individual student to be different than that of the other assignees).
The user must be enrolled as a teacher
, ta
, designer
, administrator
, or district-administrator
in the class to use this endpoint.
Please review our guide on patch requests for more information regarding their use.
Request Parameters
Parameter | Type | Description |
---|---|---|
class_id | string | The UUID of the desired Class. |
assignment_id | string | The UUID of the desired Assignment. |
submission_id | string | The UUID of the desired Submission. |
Request Body
The request body should contain a partial Submission object.
The following fields are allowed: grader_id
, flags
, grade_comment
, grade_points
, grade
, extra_attempts
, override_due_date
.
{
"grade_points": 12,
"override_due_date": "2022-01-27T17:10:09.702Z"
}
Sample Response
The response contains the updated Submission object.
{
"$request": "00000000-0000-0000-0000-000000000000",
"$data": {
"flags": [],
"state": "submitted",
"created_date": "2022-01-27T17:10:09.702Z",
"attempts": [
{
"body": {
"type": "link",
"url": "https://google.com"
},
"created_date": "2022-01-27T17:10:09.702Z"
}
],
"grade_points": 12,
"override_due_date": "2022-01-27T17:10:09.702Z",
"id": "00000000-0000-0000-0000-000000000000",
"person_id": "00000000-0000-0000-0000-000000000000"
}
}
Provider Specific Guidelines
Canvas
The Canvas API only accepts a singular flag. In the case multiple flags were sent as part of a request for grading/updating a Canvas submission, we will pass only one flag to be chosen based on the following order of importance, first being the most important: excused, missing, late.
The Canvas API ignores grader_id
when using this User API. It will always set grader_id
as the id of the user whose tokens we use to make the request. If you need to set grader_id
, use the Graph API and make sure the grader_id
you select is a valid teacher in the class.