courses

PATCH /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}

Changed on Nov 2, 2026

Updates one or more fields of a student submission. See google.classroom.v1.StudentSubmission for details of which fields may be updated and who may change them. This request must be made by the Developer Console project of the OAuth client ID used to create the corresponding course work item or an add-on attachment with Grade Sync enabled on the corresponding course work item. This method returns the following error codes: * PERMISSION_DENIED if the requesting developer project did not create the corresponding course work or an add-on attachment on the corresponding course work with Grade Sync enabled, if the user is not permitted to make the requested modification to the student submission, or for access errors. * INVALID_ARGUMENT if the request is malformed. * NOT_FOUND if the requested course, course work, or student submission does not exist.

Request

Base URL
https://classroom.googleapis.com
URL
https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}
Auth
- OAuth 2 and OAuth 2
  Implicit: https://accounts.google.com/o/oauth2/auth
  Scopes: https://www.googleapis.com/auth/classroom.coursework.me
  Authorization code: https://accounts.google.com/o/oauth2/auth
  Token URL: https://accounts.google.com/o/oauth2/token scopes: https://www.googleapis.com/auth/classroom.coursework.me
- or OAuth 2 and OAuth 2
  Implicit: https://accounts.google.com/o/oauth2/auth
  Scopes: https://www.googleapis.com/auth/classroom.coursework.students
  Authorization code: https://accounts.google.com/o/oauth2/auth
  Token URL: https://accounts.google.com/o/oauth2/token scopes: https://www.googleapis.com/auth/classroom.coursework.students

Path parameters

courseIdstring required

Identifier of the course. This identifier can be either the Classroom-assigned identifier or an alias.

courseWorkIdstring required

Identifier of the course work.

idstring required

Identifier of the student submission.

Query parameters

updateMaskstring google-fieldmask

Mask that identifies which fields on the student submission to update. This field is required to do an update. The update fails if invalid fields are specified. The following fields may be specified by teachers: * draft_grade * assigned_grade

Request body

alternateLinkstring

Absolute link to the submission in the Classroom web UI. Read-only.

assignedGradenumber double

Optional grade. If unset, no grade was set. This value must be non-negative. Decimal (that is, non-integer) values are allowed, but are rounded to two decimal places. This may be modified only by course teachers.

assignedRubricGradesobject

Assigned rubric grades based on the rubric's Criteria. This map is empty if there is no rubric attached to this course work or if a rubric is attached, but no grades have been set on any Criteria. Entries are only populated for grades that have been set. Key: The rubric's criterion ID. Read-only.

associatedWithDeveloperboolean

Whether this student submission is associated with the Developer Console project making the request. See CreateCourseWork for more details. Read-only.

courseIdstring

Identifier of the course. Read-only.

courseWorkIdstring

Identifier for the course work this corresponds to. Read-only.

courseWorkType'COURSE_WORK_TYPE_UNSPECIFIED' | 'ASSIGNMENT' | 'SHORT_ANSWER_QUESTION' | 'MULTIPLE_CHOICE_QUESTION'

Type of course work this submission is for. Read-only.

creationTimestring google-datetime

Creation time of this submission. This may be unset if the student has not accessed this item. Read-only.

draftGradenumber double

Optional pending grade. If unset, no grade was set. This value must be non-negative. Decimal (that is, non-integer) values are allowed, but are rounded to two decimal places. This is only visible to and modifiable by course teachers.

draftRubricGradesobject

Pending rubric grades based on the rubric's criteria. This map is empty if there is no rubric attached to this course work or if a rubric is attached, but no grades have been set on any criteria. Entries are only populated for grades that have been set. Key: The rubric's criterion ID. Read-only.

idstring

Classroom-assigned Identifier for the student submission. This is unique among submissions for the relevant course work. Read-only.

lateboolean

Whether this submission is late. Read-only.

State of this submission. Read-only.

updateTimestring google-datetime

Last update time of this submission. This may be unset if the student has not accessed this item. Read-only.

userIdstring

Identifier for the student that owns this submission. Read-only.

Response

Successful response