Update educationassignment

Namespace: microsoft.graph

Update an educationAssigment object.

Only teachers can perform this action.

Alternatively, request to change the status of an assignment with publish action. Don't use a PATCH operation for this purpose.


One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Permission type Permissions (from least to most privileged)
Delegated (work or school account) EduAssignments.ReadWriteBasic, EduAssignments.ReadWrite
Delegated (personal Microsoft account) Not supported.
Application Not supported.

HTTP request

PATCH /education/classes/acdefc6b-2dc6-4e71-b1e9-6d9810ab1793/assignments/cf6005fc-9e13-44a2-a6ac-a53322006454

Request headers

Header Value
Authorization Bearer {token}. Required.
Content-Type application/json

Request body

In the request body, supply only the values of the fields you want to update.

Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.

Property Type Description
addedStudentAction String Describes if the assignment should be distributed to students who are added after the assignment publication date.
allowLateSubmissions Boolean Whether students can send submission after the due date.
allowStudentsToAddResourcesToSubmission Boolean Whether a student can add resources to a submission or not. Also, indicates whether all resources in the submission correspond to the assignment resource list.
assignDateTime DateTimeOffset Indicates the date to publish the assignment to students.
assignTo educationAssignmentRecipient Students who get the assignment.
closeDateTime DateTimeOffset Date when the assignment will be closed for submissions. This is an optional field that can be null if the assignment does not allowLateSubmissions or the closeDateTime is the same as the dueDateTime but if specified, it must be greater than or equal to the dueDateTime.
displayName String Name of assignment.
dueDateTime DateTimeOffset Date assignment is due.
grading educationAssignmentGradeType How the assignment will be graded.
instructions itemBody Instructions to be given to the students along with the assignment.
notificationChannelUrl String The channel to communicate notifications related to the assignment. To change the URL, set the assignTo value to educationAssignmentClassRecipient. The channel URL can't change after the publication of the assignment.


If successful, this method returns a 200 OK response code and an updated educationAssignment object in the response body.



The following is an example of the request.

PATCH https://graph.microsoft.com/v1.0/education/classes/acdefc6b-2dc6-4e71-b1e9-6d9810ab1793/assignments/ad8afb28-c138-4ad7-b7f5-a6986c2655a8
Content-type: application/json
Content-length: 279

  "displayName": "Week 1 reading assignment",
  "instructions": {
    "contentType": "Text",
    "content": "Read chapters 1 through 3"
  "dueDateTime": "2014-02-01T00:00:00Z"


The following is an example of the response.

Note: The response object shown here might be shortened for readability.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 279

  "classId": "11021",
  "displayName": "Week 1 reading assignment",
  "instructions": {
    "contentType": "Text",
    "content": "Read chapters 1 through 3"
  "closeDateTime": "2014-02-11T00:00:00Z",
  "dueDateTime": "2014-02-01T00:00:00Z",
  "assignDateTime": "2014-01-01T00:00:00Z",
  "assignedDateTime": "2014-01-01T00:00:00Z",
  "resourcesFolderUrl": "https://graph.microsoft.com/v1.0/drives/b!0sGAoOieeE6iSj1WXCV-nYYTuh2luKRDvUVGQBLOmvYpRzc5ARnCRorRht6P3MhU/items/01N74NOEZL7P3VK22SQFDKBZ3PHVPKDVAQ",