Skip to main content
This endpoint grades a student’s homework submission by setting a numeric rating and an optional written comment, marking the submission as reviewed. Use it to provide feedback after evaluating a student’s uploaded work.

Endpoint

Required role: Admin

Required Headers

Path Parameters

integer
required
The unique submission ID. Must be a numeric value.

Request Body

integer
required
The numeric grade to assign to the submission. Must be an integer between 0 and 10 (inclusive).
string
Optional written feedback for the student. Maximum 1000 characters.

Example Request

Response

200 OK

Returns a confirmation message and the updated SubmissionObject reflecting the saved grade.

Validation Error Responses (422)

The API returns a 422 status with field-level error details when request body validation fails. The examples below show the possible validation errors: Missing rating:
Rating out of range:
Comment too long:

Error Responses

Grading is idempotent — calling this endpoint again on the same submission overwrites the previous rating and comment. There is no lock once a submission is marked as reviewed, so you can update a grade at any time.