EduAssignments.ReadBasic

Allows the app to read assignments without 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.ReadBasic 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	-	c0b0103b-c053-4b2e-9973-9f3a544ec9b8
DisplayText	-	Read users' class assignments without grades
Description	-	Allows the app to read assignments without 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
	GET /education/classes/{class-id}/assignments/{assignment-id}/resources/{resource-id}
	GET /education/classes/{class-id}/assignments/{assignment-id}/submissions/{submission-id}
	GET /education/classes/{class-id}/assignments/{assignment-id}/submissions/{submission-id}/resources
	GET /education/classes/{class-id}/assignments/{assignment-id}/submissions/{submission-id}/resources/{resource-id}
	GET /education/classes/{educationClassId}/assignmentCategories/delta
	GET /education/classes/{educationClassId}/assignments/{educationAssignmentId}/categories/delta
	GET /education/classes/{educationClassId}/assignments/delta
	GET /education/classes/{id}/assignmentCategories
	GET /education/classes/{id}/assignmentCategories/{id}
	GET /education/classes/{id}/assignmentDefaults
	GET /education/classes/{id}/assignments
	GET /education/classes/{id}/assignments/{id}
	GET /education/classes/{id}/assignments/{id}/categories
	GET /education/classes/{id}/assignments/{id}/resources
	GET /education/classes/{id}/assignments/{id}/rubric
	GET /education/classes/{id}/assignments/{id}/submissions
	GET /education/classes/{id}/assignments/{id}/submissions/{id}/submittedResources
	GET /education/classes/{id}/assignments/{id}/submissions/{id}/submittedResources/{id}
	GET /education/classes/{id}/assignmentSettings
	GET /education/me/assignments
	GET /education/me/rubrics
	GET /education/me/rubrics/{id}
	GET /education/users/{user-id}/assignments

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

	Methods
	GET /education/classes/{class-id}/assignments/{assignment-id}/resources/{resource-id}
	GET /education/classes/{class-id}/assignments/{assignment-id}/submissions
	GET /education/classes/{class-id}/assignments/{assignment-id}/submissions/{submission-id}
	GET /education/classes/{class-id}/assignments/{assignment-id}/submissions/{submission-id}/resources/{resource-id}
	GET /education/classes/{educationClassId}/assignmentCategories/delta
	GET /education/classes/{educationClassId}/assignments/{educationAssignmentId}/categories/delta
	GET /education/classes/{educationClassId}/assignments/delta
	GET /education/classes/{educationClassId}/assignmentSettings/gradingSchemes/{educationGradingSchemeId}
	GET /education/classes/{id}/assignmentCategories
	GET /education/classes/{id}/assignmentCategories/{id}
	GET /education/classes/{id}/assignmentDefaults
	GET /education/classes/{id}/assignments
	GET /education/classes/{id}/assignments/{id}
	GET /education/classes/{id}/assignments/{id}/categories
	GET /education/classes/{id}/assignments/{id}/resources
	GET /education/classes/{id}/assignments/{id}/rubric
	GET /education/classes/{id}/assignments/{id}/submissions/{id}/resources
	GET /education/classes/{id}/assignments/{id}/submissions/{id}/submittedResources
	GET /education/classes/{id}/assignments/{id}/submissions/{id}/submittedResources/{id}
	GET /education/classes/{id}/assignmentSettings
	GET /education/me/assignments
	GET /education/me/rubrics
	GET /education/me/rubrics/{id}
	GET /education/users/{user-id}/assignments

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

	Commands
	Get-MgEducationClassAssignment
	Get-MgEducationClassAssignmentCategory
	Get-MgEducationClassAssignmentCategoryByRef
	Get-MgEducationClassAssignmentCategoryDelta
	Get-MgEducationClassAssignmentDefault
	Get-MgEducationClassAssignmentDelta
	Get-MgEducationClassAssignmentResource
	Get-MgEducationClassAssignmentRubric
	Get-MgEducationClassAssignmentSetting
	Get-MgEducationClassAssignmentSubmission
	Get-MgEducationClassAssignmentSubmissionResource
	Get-MgEducationClassAssignmentSubmissionSubmittedResource
	Get-MgEducationMeAssignment
	Get-MgEducationMeRubric

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

	Commands
	Get-MgBetaEducationClassAssignment
	Get-MgBetaEducationClassAssignmentCategory
	Get-MgBetaEducationClassAssignmentCategoryByRef
	Get-MgBetaEducationClassAssignmentCategoryDelta
	Get-MgBetaEducationClassAssignmentDefault
	Get-MgBetaEducationClassAssignmentDelta
	Get-MgBetaEducationClassAssignmentResource
	Get-MgBetaEducationClassAssignmentRubric
	Get-MgBetaEducationClassAssignmentSetting
	Get-MgBetaEducationClassAssignmentSettingGradingScheme
	Get-MgBetaEducationClassAssignmentSubmission
	Get-MgBetaEducationClassAssignmentSubmissionResource
	Get-MgBetaEducationClassAssignmentSubmissionSubmittedResource
	Get-MgBetaEducationMeAssignment
	Get-MgBetaEducationMeRubric

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

Graph reference: educationAssignmentDefaults

Property	Type	Description
addedStudentAction	educationAddedStudentAction	Class-level default behavior for handling students who are added after the assignment is published. Possible values are: `none`, `assignIfOpen`.
addToCalendarAction	educationAddToCalendarOptions	Optional field to control 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 value in this evolvable enum: `studentsOnly`. The default value is `none`.
dueTime	TimeOfDay	Class-level default value for due time field. Default value is `23:59:00`.
id	String	Unique identifier for the educationAssignmentDefaults.
notificationChannelUrl	String	Default Teams channel to which notifications are sent. Default value is `null`.

Graph reference: educationAssignmentResource

Property	Type	Description
distributeForStudentWork	Boolean	Indicates whether this resource should be copied to each student submission for modification and submission. Required
id	String	ID of this resource. Read-only.
resource	educationResource	Resource object that has been associated with this assignment.

Graph reference: educationAssignmentSettings

Property	Type	Description
id	String	Unique identifier for the educationAssignmentSettings.
submissionAnimationDisabled	Boolean	Indicates whether to show the turn-in celebration animation. If `true`, indicates to skip the animation. The default value is `false`.

Property	Type	Description
displayName	String	Unique identifier for the category.
id	String	Unique identifier for the category.

Graph reference: educationClass

Property	Type	Description
classCode	String	Class code used by the school to identify the class.
createdBy	identitySet	Entity who created the class
description	String	Description of the class.
displayName	String	Name of the class.
externalId	String	ID of the class from the syncing system.
externalSource	educationExternalSource	How this class was created. Possible values are: `sis`, `manual`.
externalSourceDetail	String	The name of the external source this resource was generated from.
externalName	String	Name of the class in the syncing system.
grade	String	Grade level of the class.
id	String	Object identifier. Inherited from entity.
mailNickname	String	Mail name for sending email to all members, if this is enabled.
term	educationTerm	Term for this class.

Graph reference: educationGradingScheme

Property	Type	Description
displayName	String	The name of the grading scheme.
grades	educationGradingSchemeGrade collection	The grades that make up the scheme.
hidePointsDuringGrading	Boolean	The display setting for the UI. Indicates whether teachers can grade with points in addition to letter grades.
id	String	The ID of the grading scheme. Inherited from entity.

Graph reference: educationOutcome

Property	Type	Description
id	String	Unique identifier for the educationOutcome object. Inherited from entity. Read-only.
lastModifiedBy	identitySet	The individual who updated the resource.
lastModifiedDateTime	DateTimeOffset	The moment in time when the resource was last modified. 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, 2021 is `2021-01-01T00:00:00Z`.

Graph reference: educationResource

Property	Type	Description
createdBy	identitySet	The individual who created the resource.
createdDateTime	DateTimeOffset	Moment in time when the resource 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	Display name of resource.
lastModifiedBy	identitySet	The last user to modify the resource.
lastModifiedDateTime	DateTimeOffset	Moment in time when the resource was last modified. 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`.

Graph reference: educationRubric

Property	Type	Description
createdBy	identitySet	The user who created this resource.
createdDateTime	DateTimeOffset	The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
description	itemBody	The description of this rubric.
displayName	String	The name of this rubric.
grading	educationAssignmentGradeType	The grading type of this rubric. You can use `null` for a no-points rubric or educationAssignmentPointsGradeType for a points rubric.
id	String	Unique identifier for the rubric.
lastModifiedBy	identitySet	The last user to modify the resource.
lastModifiedDateTime	DateTimeOffset	Moment in time when the resource was last modified. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
levels	rubricLevel collection	The collection of levels making up this rubric.
qualities	rubricQuality collection	The collection of qualities making up this rubric.

Graph reference: educationSubmission

Property	Type	Description
excusedBy	identitySet	The user that marked the submission as excused.
excusedDateTime	DateTimeOffset	The time that the submission was excused. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
id	String	Unique identifier for the submission.
reassignedBy	identitySet	User who moved the status of this submission to reassigned.
reassignedDateTime	DateTimeOffset	Moment in time when the submission was reassigned. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
recipient	educationSubmissionRecipient	Who this submission is assigned to.
resourcesFolderUrl	String	Folder where all file resources for this submission need to be stored.
returnedBy	identitySet	User who moved the status of this submission to returned.
returnedDateTime	DateTimeOffset	Moment in time when the submission was returned. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
status	educationSubmissionStatus	Read-only. Possible values are: `excused`, `reassigned`, `returned`, `submitted` and `working`. You must use the `Prefer: include-unknown-enum-members` request header to get the following values in this evolvable enum: `excused` and `reassigned`.
submittedBy	identitySet	User who moved the resource into the submitted state.
submittedDateTime	DateTimeOffset	Moment in time when the submission was moved into the submitted state. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
unsubmittedBy	identitySet	User who moved the resource from submitted into the working state.
unsubmittedDateTime	DateTimeOffset	Moment in time when the submission was moved from submitted into the working state. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
webUrl	String	The deep link URL for the given submission.

Graph reference: educationSubmissionResource

Property	Type	Description
assignmentResourceUrl	String	Pointer to the assignment from which the resource was copied, and if null, the student uploaded the resource.
id	String	Read-only.
resource	educationResource	Resource object.

Graph reference: educationUser

Property	Type	Description
accountEnabled	Boolean	`True` if the account is enabled; otherwise, `false`. This property is required when a user is created. Supports `$filter`.
assignedLicenses	assignedLicense collection	The licenses that are assigned to the user. Not nullable.
assignedPlans	assignedPlan collection	The plans that are assigned to the user. Read-only. Not nullable.
businessPhones	String collection	The telephone numbers for the user. Note: Although this is a string collection, only one number can be set for this property.
createdBy	identitySet	The entity who created the user.
department	String	The name for the department in which the user works. Supports `$filter`.
displayName	String	The name displayed in the address book for the user. This is usually the combination of the user's first name, middle initial, and last name. This property is required when a user is created and it cannot be cleared during updates. Supports `$filter` and `$orderby`.
externalSource	educationExternalSource	Where this user was created from. Possible values are: `sis`, `manual`.
externalSourceDetail	String	The name of the external source this resource was generated from.
givenName	String	The given name (first name) of the user. Supports `$filter`.
id	String	Object identifier. Inherited from entity.
mail	String	The SMTP address for the user, for example, `[email protected]`. Read-Only. Supports `$filter`.
mailingAddress	physicalAddress	The mail address of the user.
mailNickname	String	The mail alias for the user. This property must be specified when a user is created. Supports `$filter`.
middleName	String	The middle name of the user.
mobilePhone	String	The primary cellular telephone number for the user.
officeLocation	String	The office location for the user.
onPremisesInfo	educationOnPremisesInfo	Additional information used to associate the Microsoft Entra user with its Active Directory counterpart.
passwordPolicies	String	Specifies password policies for the user. This value is an enumeration with one possible value being `DisableStrongPassword`, which allows weaker passwords than the default policy to be specified. `DisablePasswordExpiration` can also be specified. The two can be specified together; for example: `DisablePasswordExpiration, DisableStrongPassword`.
passwordProfile	passwordProfile	Specifies the password profile for the user. The profile contains the user's password. This property is required when a user is created. The password in the profile must satisfy minimum requirements as specified by the passwordPolicies property. By default, a strong password is required.
preferredLanguage	String	The preferred language for the user that should follow the ISO 639-1 code, for example, `en-US`.
primaryRole	educationUserRole	Default role for a user. The user's role might be different in an individual class. Possible values are: `student`, `teacher`, `none`, `unknownFutureValue`.
provisionedPlans	provisionedPlan collection	The plans that are provisioned for the user. Read-only. Not nullable.
refreshTokensValidFromDateTime	DateTimeOffset	Any refresh tokens or sessions tokens (session cookies) issued before this time are invalid, and applications get an error when using an invalid refresh or sessions token to acquire a delegated access token (to access APIs such as Microsoft Graph). If this happens, the application needs to acquire a new refresh token by requesting the authorized endpoint. Returned only on `$select`. Read-only.
relatedContacts	[relatedContact] collection	Related records associated with the user. Read-only.
residenceAddress	physicalAddress	The address where the user lives.
showInAddressList	Boolean	`True` if the Outlook Global Address List should contain this user; otherwise, `false`. If not set, this will be treated as `true`. For users invited through the invitation manager, this property will be set to `false`.
student	educationStudent	If the primary role is student, this block will contain student specific data.
surname	String	The user's surname (family name or last name). Supports `$filter`.
teacher	educationTeacher	If the primary role is teacher, this block will contain teacher specific data.
usageLocation	String	A two-letter country code (ISO standard 3166). Required for users who will be assigned licenses due to a legal requirement to check for availability of services in countries or regions. Examples include: `US`, `JP`, and `GB`. Not nullable. Supports `$filter`.
userPrincipalName	String	The user principal name (UPN) of the user. The UPN is an internet-style login name for the user based on the internet standard RFC 822. By convention, this should map to the user's email name. The general format is `alias@domain`, where domain must be present in the tenant's collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of the organization. Supports `$filter` and `$orderby`.
userType	String	A string value that can be used to classify user types in your directory, such as `Member` and `Guest`. Supports `$filter`.

Table of Contents

EduAssignments.ReadBasic

Graph Methods

Resources