Table of Contents

EduAssignments.ReadWrite

Allows the app to read and write assignments and their grades on behalf of the user.

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the EduAssignments.ReadWrite permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category Application Delegated
Identifier - 2f233e90-164b-4501-8bce-31af2559a2d3
DisplayText - Read and write users' class assignments and their grades
Description - Allows the app to read and write assignments and their grades on behalf of the user.
AdminConsentRequired Yes Yes

Graph Methods

API supports delegated access (access on behalf of a user)
API supports app-only access (access without a user)

Methods

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

Graph reference: educationAssignment

Property Type Description
addedStudentAction String Optional field to control the assignment behavior for students who are added after the assignment is published. If not specified, defaults to none. Supported values are: none, assignIfOpen. For example, a teacher can use assignIfOpen to indicate that an assignment should be assigned to any new student who joins the class while the assignment is still open, and none to indicate that an assignment shouldn't be assigned to new students.
addToCalendarAction educationAddToCalendarOptions Optional field to control the assignment behavior for adding assignments to students' and teachers' calendars when the assignment is published. The possible values are: none, studentsAndPublisher, studentsAndTeamOwners, unknownFutureValue, and studentsOnly. You must use the Prefer: include-unknown-enum-members request header to get the following values in this evolvable enum: studentsOnly. The default value is none.
allowLateSubmissions Boolean Identifies whether students can submit after the due date. If this property isn't specified during create, it defaults to true.
allowStudentsToAddResourcesToSubmission Boolean Identifies whether students can add their own resources to a submission or if they can only modify resources added by the teacher.
assignDateTime DateTimeOffset The date when the assignment should become active. If in the future, the assignment isn't shown to the student until this date. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
assignTo educationAssignmentRecipient Which users, or whole class should receive a submission object once the assignment is published.
assignedDateTime DateTimeOffset The moment that the assignment was published to students and the assignment shows up on the students timeline. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
classId String Class to which this assignment belongs.
closeDateTime DateTimeOffset Date when the assignment is closed for submissions. This is an optional field that can be null if the assignment doesn't allowLateSubmissions or when the closeDateTime is the same as the dueDateTime. But if specified, then the closeDateTime must be greater than or equal to the dueDateTime. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
createdBy identitySet Who created the assignment.
createdDateTime DateTimeOffset Moment when the assignment was created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
displayName String Name of the assignment.
dueDateTime DateTimeOffset Date when the students assignment is due. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
feedbackResourcesFolderUrl String Folder URL where all the feedback file resources for this assignment are stored.
grading educationAssignmentGradeType How the assignment will be graded.
id String The unique identifier for the assignment. Inherited from entity. Read-only.
instructions itemBody Instructions for the assignment. The instructions and the display name tell the student what to do.
lastModifiedBy identitySet Who last modified the assignment.
lastModifiedDateTime DateTimeOffset The date and time on which the assignment was modified. A student submission doesn't modify the assignment; only teachers can update assignments. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
moduleUrl string The URL of the module from which to access the assignment.
notificationChannelUrl String Optional field to specify the URL of the channel to post the assignment publish notification. If not specified or null, defaults to the General channel. This field only applies to assignments where the assignTo value is educationAssignmentClassRecipient. Updating the notificationChannelUrl isn't allowed after the assignment is published.
resourcesFolderUrl string Folder URL where all the file resources for this assignment are stored.
status educationAssignmentStatus Status of the assignment. You can't PATCH this value. Possible values are: draft, scheduled, published, assigned, unknownFutureValue, inactive. Note that you must use the Prefer: include-unknown-enum-members request header to get the following value(s) in this evolvable enum: inactive.
webUrl string The deep link URL for the given **a