Grade Submission

PATCH https://ed.link/api/v2/my/classes/:class_id/assignments/:assignment_id/submissions/:submission_id

Though this is typically used to "Grade" a Submission, it actually allows you to update metadata more broadly. 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

Request Body

The request body should contain a partial Submission object.

{
    "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",
        "updated_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",
        "properties": {},
        "identifiers": [{ "type": "canvas_id", "value": "55" }],
        "rule_ids": [],
        "references": {},
        "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.