For Developers

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

ParameterTypeDescription
class_idstringThe UUID of the desired Class.
assignment_idstringThe UUID of the desired Assignment.
submission_idstringThe 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.