Microsoft

Microsoft Graph: Education (classes and assignments)

Schools, classes, teachers and students, and class assignments, submissions, rubrics and grades in Microsoft Teams for Education. This listing is one area of…

Education#openapi

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Schools, classes, teachers and students, and class assignments, submissions, rubrics and grades in Microsoft Teams for Education.

This listing is one area of Microsoft Graph, the single REST API for Microsoft 365, Outlook, OneDrive, Teams and Microsoft Entra ID. It holds 260 of the area's requests, the most direct ones first, generated from Microsoft's own OpenAPI description of Graph v1.0. The other areas (mail, calendar, files, Teams, users and more) are listed separately on the Microsoft page.

Get an access token

  1. Sign in to the Microsoft Entra admin center and open App registrations > New registration. For a quick test, the Graph Explorer signs you in and shows a token without registering anything.
  2. Under API permissions, add the Microsoft Graph permissions this area needs, for example: EduRoster.Read, EduAssignments.ReadWrite. Delegated permissions act as the signed-in user; application permissions act as the app itself and need an administrator's consent.
  3. Under Certificates & secrets, create a client secret (keep it out of shared collections).
  4. Get a token from https://login.microsoftonline.com/ /oauth2/v2.0/token: the authorization-code flow for a user, or grant_type=client_credentials with scope=https://graph.microsoft.com/.default for an app. Send it as Authorization: Bearer .

Using these requests

  • Base URL: https://graph.microsoft.com/v1.0. /me/... paths act on the signed-in user; with an application token use /users/{id or userPrincipalName}/... instead.
  • Shape responses with OData query parameters: $select (fields), $filter, $orderby, $top, $expand and $search (some need the ConsistencyLevel: eventual header). Long lists are paged: follow @odata.nextLink.
  • Combine up to 20 requests in one call with POST /$batch.

Common errors

StatusCodeWhat to do
401InvalidAuthenticationTokenThe token is missing, expired or for another resource: get a new one for https://graph.microsoft.com.
403Authorization_RequestDenied / ErrorAccessDeniedAdd the permission listed in the request's docs and grant consent.
404ResourceNotFound / itemNotFoundCheck the id; ids from another user or tenant are not found.
429TooManyRequestsThrottled: wait the Retry-After seconds, then retry.

Docs: Education (classes and assignments) overview · Permissions reference · Throttling

Endpoints 260

Education

  • GETGet education/education
  • PATCHUpdate education/education

Education: me

  • GETGet me/education/me
  • DELETEDelete me/education/me
  • PATCHUpdate me/education/me
  • GETGet user/education/me/userRetrieve the simple directory user that corresponds to this educationUser.
  • GETList classes/education/me/classesGet the educationClass resources an educationUser is a member of.
  • GETList rubrics/education/me/rubricsRetrieve a list of educationRubric objects.
  • POSTCreate rubric/education/me/rubricsCreate a new educationRubric object.
  • GETList schools/education/me/schoolsRetrieve a list of schools for a user.
  • GETList assignments/education/me/assignmentsReturns a list of educationAssignment assigned to a educationUser for all classes. Only teachers, students, and applications with application permissions can…
  • POSTCreate assignment/education/me/assignments
  • GETList taught classes/education/me/taughtClassesClasses for which the user is a teacher.
  • GETTrack changes to assignments (delta)/education/me/assignments/delta()Get a list of newly-created or updated assignments without reading the whole collection. A teacher or an application running with application permissions can…
  • GETGet mailbox settings/education/me/user/mailboxSettingsSettings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time…
  • PATCHUpdate mailbox settings/education/me/user/mailboxSettings
  • GETList service provisioning errors/education/me/user/serviceProvisioningErrorsErrors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports…
  • GETGet class/education/me/classes/:educationClass-idClasses to which the user belongs. Nullable.
  • GETGet rubric/education/me/rubrics/:educationRubric-idRetrieve the properties and relationships of an educationRubric object. Only teachers and students can perform this operation.
  • DELETEDelete rubric/education/me/rubrics/:educationRubric-idDelete an educationRubric object. Only teachers can perform this operation.
  • PATCHUpdate rubric/education/me/rubrics/:educationRubric-idUpdate the properties of an educationRubric object. Only teachers can perform this operation. Updating a rubric attached to an assignment (PATCH…
  • GETGet school/education/me/schools/:educationSchool-idSchools to which the user belongs. Nullable.
  • GETGet taught class/education/me/taughtClasses/:educationClass-idClasses for which the user is a teacher.
  • GETGet assignment/education/me/assignments/:educationAssignment-idAssignments belonging to the user.
  • DELETEDelete assignment/education/me/assignments/:educationAssignment-id
  • PATCHUpdate assignment/education/me/assignments/:educationAssignment-id
  • GETGet rubric/education/me/assignments/:educationAssignment-id/rubricWhen set, the grading rubric attached to this assignment.
  • DELETEDelete rubric/education/me/assignments/:educationAssignment-id/rubric
  • PATCHUpdate rubric/education/me/assignments/:educationAssignment-id/rubric
  • POSTCreate publish/education/me/assignments/:educationAssignment-id/publishPublish an education assignment. Change the status of an educationAssignment from its original draft status to the published status. You can change the status…
  • POSTCreate activate/education/me/assignments/:educationAssignment-id/activateActivate an inactive educationAssignment to signal that the assignment has further action items for teachers or students. This action can only be performed by…
  • GETList resources/education/me/assignments/:educationAssignment-id/resourcesLearning objects that are associated with this assignment. Only teachers can modify this list. Nullable.
  • POSTCreate resource/education/me/assignments/:educationAssignment-id/resources
  • GETList categories/education/me/assignments/:educationAssignment-id/categoriesWhen set, enables users to easily find assignments of a given type. Read-only. Nullable.
  • POSTCreate category/education/me/assignments/:educationAssignment-id/categories
  • POSTCreate deactivate/education/me/assignments/:educationAssignment-id/deactivateMark an assigned educationAssignment as inactive to signal that the assignment has no further action items for teachers and students. This action can only be…
  • GETList submissions/education/me/assignments/:educationAssignment-id/submissionsOnce published, there's a submission object for each student representing their work and grade. Read-only. Nullable.
  • POSTCreate submission/education/me/assignments/:educationAssignment-id/submissions
  • GETGet grading scheme/education/me/assignments/:educationAssignment-id/gradingSchemeWhen set, enables users to configure custom string grades based on the percentage of total points earned on this assignment.
  • GETGet grading category/education/me/assignments/:educationAssignment-id/gradingCategoryWhen set, enables users to weight assignments differently when computing a class average grade.
  • POSTSet up resources folder (assignment)/education/me/assignments/:educationAssignment-id/setUpResourcesFolderCreate a SharePoint folder to upload files for a given educationAssignment. Only teachers can perform this operation. The teacher determines the resources to…
  • POSTSet up feedback resources folder (assignment)/education/me/assignments/:educationAssignment-id/setUpFeedbackResourcesFolderCreate a SharePoint folder to upload feedback files for a given educationSubmission. Only teachers can perform this operation. The teacher determines the…
  • GETList assignments references/education/me/assignments/:educationAssignment-id/rubric/$refWhen set, the grading rubric attached to this assignment.
  • PUTSet assignments/education/me/assignments/:educationAssignment-id/rubric/$ref
  • DELETERemove assignment reference/education/me/assignments/:educationAssignment-id/rubric/$ref
  • GETList assignments references/education/me/assignments/:educationAssignment-id/categories/$refWhen set, enables users to easily find assignments of a given type. Read-only. Nullable.
  • POSTAdd assignment reference/education/me/assignments/:educationAssignment-id/categories/$ref
  • DELETERemove assignment reference/education/me/assignments/:educationAssignment-id/categories/$ref?@id=string
  • GETTrack changes to categories (delta)/education/me/assignments/:educationAssignment-id/categories/delta()Get a list of newly created or updated educationCategory objects without having to perform a full read of the collection.
  • GETGet submission/education/me/assignments/:educationAssignment-id/submissions/:educationSubmission-idOnce published, there's a submission object for each student representing their work and grade. Read-only. Nullable.
  • DELETEDelete submission/education/me/assignments/:educationAssignment-id/submissions/:educationSubmission-id
  • PATCHUpdate submission/education/me/assignments/:educationAssignment-id/submissions/:educationSubmission-id
  • GETGet resource/education/me/assignments/:educationAssignment-id/resources/:educationAssignmentResource-idLearning objects that are associated with this assignment. Only teachers can modify this list. Nullable.
  • DELETEDelete resource/education/me/assignments/:educationAssignment-id/resources/:educationAssignmentResource-id
  • PATCHUpdate resource/education/me/assignments/:educationAssignment-id/resources/:educationAssignmentResource-id
  • DELETERemove assignment reference/education/me/assignments/:educationAssignment-id/categories/:educationCategory-id/$ref
  • POSTCreate excuse/education/me/assignments/:educationAssignment-id/submissions/:educationSubmission-id/excuseExcuse a submission. Excused submissions aren't included in average grade calculations. Grading rubrics and feedback are deleted. Only teachers can perform…
  • POSTCreate return/education/me/assignments/:educationAssignment-id/submissions/:educationSubmission-id/returnMake the grade and feedback associated with this submission available to the student. This action changes the status of the submission from 'submitted' to…
  • POSTCreate submit/education/me/assignments/:educationAssignment-id/submissions/:educationSubmission-id/submitIndicate that a student is done with the work and is ready to hand in the assignment. Only teachers, students, and applications with application permissions…
  • GETList outcomes/education/me/assignments/:educationAssignment-id/submissions/:educationSubmission-id/outcomes
  • POSTCreate outcome/education/me/assignments/:educationAssignment-id/submissions/:educationSubmission-id/outcomes
  • POSTCreate reassign/education/me/assignments/:educationAssignment-id/submissions/:educationSubmission-id/reassignReassign the submission to the student with feedback for review. Only teachers can perform this action. Include the Prefer: include-unknown-enum-members…
  • POSTCreate unsubmit/education/me/assignments/:educationAssignment-id/submissions/:educationSubmission-id/unsubmitIndicate that a student wants to work on the submission of the assignment after it was turned in. Only teachers, students, and applications with application…
  • GETList resources/education/me/assignments/:educationAssignment-id/submissions/:educationSubmission-id/resources
  • POSTCreate resource/education/me/assignments/:educationAssignment-id/submissions/:educationSubmission-id/resources
  • GETList submitted resources/education/me/assignments/:educationAssignment-id/submissions/:educationSubmission-id/submittedResources
  • POSTCreate submitted resource/education/me/assignments/:educationAssignment-id/submissions/:educationSubmission-id/submittedResources
  • POSTSet up resources folder (submission)/education/me/assignments/:educationAssignment-id/submissions/:educationSubmission-id/setUpResourcesFolderTrigger the creation of the SharePoint resource folder where all file-based resources (Word, Excel, and so on) should be uploaded for a given submission. Only…
  • GETList dependent resources/education/me/assignments/:educationAssignment-id/resources/:educationAssignmentResource-id/dependentResourcesA collection of assignment resources that depend on the parent educationAssignmentResource.
  • POSTCreate dependent resource/education/me/assignments/:educationAssignment-id/resources/:educationAssignmentResource-id/dependentResources

Education: users

  • GETList users/education/usersGet a list of the educationUser objects and their properties.
  • POSTCreate user/education/usersCreate a new educationUser object.
  • GETTrack changes to users (delta)/education/users/delta()Get newly created or updated educationUser without having to perform a full read of the entire collection. See Use delta query for details.
  • GETGet user/education/users/:educationUser-idRead the properties and relationships of an educationUser object.
  • DELETEDelete user/education/users/:educationUser-idDelete a user.
  • PATCHUpdate user/education/users/:educationUser-idUpdate the properties of an educationUser object.
  • GETGet user/education/users/:educationUser-id/userThe directory user that corresponds to this user.
  • GETList classes/education/users/:educationUser-id/classesClasses to which the user belongs. Nullable.
  • GETList rubrics/education/users/:educationUser-id/rubricsWhen set, the grading rubric attached to the assignment.
  • POSTCreate rubric/education/users/:educationUser-id/rubrics
  • GETList schools/education/users/:educationUser-id/schoolsSchools to which the user belongs. Nullable.
  • GETList assignments/education/users/:educationUser-id/assignmentsReturns a list of educationAssignment assigned to a educationUser for all classes. Only teachers, students, and applications with application permissions can…
  • POSTCreate assignment/education/users/:educationUser-id/assignments
  • GETList taught classes/education/users/:educationUser-id/taughtClassesGet the educationClass resources owned by an educationUser.
  • GETTrack changes to assignments (delta)/education/users/:educationUser-id/assignments/delta()Get a list of newly-created or updated assignments without reading the whole collection. A teacher or an application running with application permissions can…
  • GETGet mailbox settings/education/users/:educationUser-id/user/mailboxSettingsSettings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale, and time…
  • PATCHUpdate mailbox settings/education/users/:educationUser-id/user/mailboxSettings
  • GETGet class/education/users/:educationUser-id/classes/:educationClass-idClasses to which the user belongs. Nullable.
  • GETGet rubric/education/users/:educationUser-id/rubrics/:educationRubric-idWhen set, the grading rubric attached to the assignment.
  • DELETEDelete rubric/education/users/:educationUser-id/rubrics/:educationRubric-id
  • PATCHUpdate rubric/education/users/:educationUser-id/rubrics/:educationRubric-id
  • GETGet school/education/users/:educationUser-id/schools/:educationSchool-idSchools to which the user belongs. Nullable.
  • GETList service provisioning errors/education/users/:educationUser-id/user/serviceProvisioningErrorsErrors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports…
  • GETGet taught class/education/users/:educationUser-id/taughtClasses/:educationClass-idClasses for which the user is a teacher.
  • GETGet assignment/education/users/:educationUser-id/assignments/:educationAssignment-idAssignments belonging to the user.
  • DELETEDelete assignment/education/users/:educationUser-id/assignments/:educationAssignment-id
  • PATCHUpdate assignment/education/users/:educationUser-id/assignments/:educationAssignment-id
  • GETGet rubric/education/users/:educationUser-id/assignments/:educationAssignment-id/rubricWhen set, the grading rubric attached to this assignment.
  • DELETEDelete rubric/education/users/:educationUser-id/assignments/:educationAssignment-id/rubric
  • PATCHUpdate rubric/education/users/:educationUser-id/assignments/:educationAssignment-id/rubric
  • POSTCreate publish/education/users/:educationUser-id/assignments/:educationAssignment-id/publishPublish an education assignment. Change the status of an educationAssignment from its original draft status to the published status. You can change the status…
  • POSTCreate activate/education/users/:educationUser-id/assignments/:educationAssignment-id/activateActivate an inactive educationAssignment to signal that the assignment has further action items for teachers or students. This action can only be performed by…
  • GETList resources/education/users/:educationUser-id/assignments/:educationAssignment-id/resourcesLearning objects that are associated with this assignment. Only teachers can modify this list. Nullable.
  • POSTCreate resource/education/users/:educationUser-id/assignments/:educationAssignment-id/resources
  • GETList categories/education/users/:educationUser-id/assignments/:educationAssignment-id/categoriesWhen set, enables users to easily find assignments of a given type. Read-only. Nullable.
  • POSTCreate category/education/users/:educationUser-id/assignments/:educationAssignment-id/categories
  • POSTCreate deactivate/education/users/:educationUser-id/assignments/:educationAssignment-id/deactivateMark an assigned educationAssignment as inactive to signal that the assignment has no further action items for teachers and students. This action can only be…
  • GETList submissions/education/users/:educationUser-id/assignments/:educationAssignment-id/submissionsOnce published, there's a submission object for each student representing their work and grade. Read-only. Nullable.
  • POSTCreate submission/education/users/:educationUser-id/assignments/:educationAssignment-id/submissions
  • GETGet grading scheme/education/users/:educationUser-id/assignments/:educationAssignment-id/gradingSchemeWhen set, enables users to configure custom string grades based on the percentage of total points earned on this assignment.
  • GETGet grading category/education/users/:educationUser-id/assignments/:educationAssignment-id/gradingCategoryWhen set, enables users to weight assignments differently when computing a class average grade.
  • POSTSet up resources folder (assignment)/education/users/:educationUser-id/assignments/:educationAssignment-id/setUpResourcesFolderCreate a SharePoint folder to upload files for a given educationAssignment. Only teachers can perform this operation. The teacher determines the resources to…
  • POSTSet up feedback resources folder (assignment)/education/users/:educationUser-id/assignments/:educationAssignment-id/setUpFeedbackResourcesFolderCreate a SharePoint folder to upload feedback files for a given educationSubmission. Only teachers can perform this operation. The teacher determines the…
  • GETList assignments references/education/users/:educationUser-id/assignments/:educationAssignment-id/rubric/$refWhen set, the grading rubric attached to this assignment.
  • PUTSet assignments/education/users/:educationUser-id/assignments/:educationAssignment-id/rubric/$ref
  • DELETERemove assignment reference/education/users/:educationUser-id/assignments/:educationAssignment-id/rubric/$ref
  • GETList assignments references/education/users/:educationUser-id/assignments/:educationAssignment-id/categories/$refWhen set, enables users to easily find assignments of a given type. Read-only. Nullable.
  • POSTAdd assignment reference/education/users/:educationUser-id/assignments/:educationAssignment-id/categories/$ref
  • DELETERemove assignment reference/education/users/:educationUser-id/assignments/:educationAssignment-id/categories/$ref?@id=string
  • GETTrack changes to categories (delta)/education/users/:educationUser-id/assignments/:educationAssignment-id/categories/delta()Get a list of newly created or updated educationCategory objects without having to perform a full read of the collection.
  • GETGet submission/education/users/:educationUser-id/assignments/:educationAssignment-id/submissions/:educationSubmission-idOnce published, there's a submission object for each student representing their work and grade. Read-only. Nullable.
  • DELETEDelete submission/education/users/:educationUser-id/assignments/:educationAssignment-id/submissions/:educationSubmission-id
  • PATCHUpdate submission/education/users/:educationUser-id/assignments/:educationAssignment-id/submissions/:educationSubmission-id
  • GETGet resource/education/users/:educationUser-id/assignments/:educationAssignment-id/resources/:educationAssignmentResource-idLearning objects that are associated with this assignment. Only teachers can modify this list. Nullable.
  • DELETEDelete resource/education/users/:educationUser-id/assignments/:educationAssignment-id/resources/:educationAssignmentResource-id
  • PATCHUpdate resource/education/users/:educationUser-id/assignments/:educationAssignment-id/resources/:educationAssignmentResource-id

Education: classes

  • GETList classes/education/classesGet a list of the educationClass objects and their properties.
  • POSTCreate class/education/classesCreate a new educationClass object.
  • GETTrack changes to classes (delta)/education/classes/delta()Get newly created or updated classes, including membership changes, without having to perform a full read of the entire class collection. See Use delta query…
  • GETGet class/education/classes/:educationClass-idRetrieve a class from the system. A class is a universal group with a special property that indicates to the system that the group is a class. Group members…
  • DELETEDelete class/education/classes/:educationClass-idDelete an educationClass. Because a class is also a universal group, deleting a class deletes the group.
  • PATCHUpdate class/education/classes/:educationClass-idUpdate the properties of an educationClass object.
  • GETGet group/education/classes/:educationClass-id/groupThe underlying Microsoft 365 group object.
  • GETList members/education/classes/:educationClass-id/membersRetrieves the educationUser members of an educationClass.
  • GETList modules/education/classes/:educationClass-id/modulesRetrieve a list of module objects. Only teachers, students, and applications with application permissions can perform this operation. A teacher or an…
  • POSTCreate module/education/classes/:educationClass-id/modulesCreate a new module in a class. Only teachers in a class can create a module. Modules start in the draft state, which means that students can't see the…
  • GETList schools/education/classes/:educationClass-id/schoolsRetrieve a list of schools in which the class is taught.
  • GETList teachers/education/classes/:educationClass-id/teachersRetrieve a list of teachers for a class. Delegated tokens must be members of the class to get the teacher list.
  • GETList assignments/education/classes/:educationClass-id/assignmentsRetrieve a list of assignment objects. Only teachers, students, and applications with application permissions can perform this operation. A teacher, or an…
  • POSTCreate assignment/education/classes/:educationClass-id/assignmentsCreate a new assignment. Only teachers in a class can create an assignment. Assignments start in draft status, which means that students can't see the…
  • GETList assignment defaults/education/classes/:educationClass-id/assignmentDefaultsRead the properties and relationships of an educationAssignmentDefaults object. These are the class-level assignment defaults respected by new assignments…
  • DELETEDelete assignment defaults/education/classes/:educationClass-id/assignmentDefaults
  • PATCHUpdate assignment defaults/education/classes/:educationClass-id/assignmentDefaultsUpdate the properties of an educationAssignmentDefaults object. Only teachers can update these settings.
  • GETGet assignment settings/education/classes/:educationClass-id/assignmentSettingsSpecifies class-level assignments settings.
  • DELETEDelete assignment settings/education/classes/:educationClass-id/assignmentSettings
  • PATCHUpdate assignment settings/education/classes/:educationClass-id/assignmentSettingsUpdate the properties of an educationAssignmentSettings object. Only teachers can update these settings.
  • GETList assignment categories/education/classes/:educationClass-id/assignmentCategoriesRetrieve a list of educationCategory objects. Only teachers can perform this operation.
  • POSTCreate assignment category/education/classes/:educationClass-id/assignmentCategoriesCreate a new educationCategory on an educationClass. Only teachers can perform this operation.
  • GETGet recently modified submissions (class)/education/classes/:educationClass-id/getRecentlyModifiedSubmissions()Retrieve submissions modified in the previous seven days. Only teachers and applications with application permissions can perform this operation. A submission…
  • GETList classes references/education/classes/:educationClass-id/members/$refRetrieves the educationUser members of an educationClass.
  • POSTAdd class reference/education/classes/:educationClass-id/members/$refAdd an educationUser member to an educationClass.
  • DELETERemove class reference/education/classes/:educationClass-id/members/$ref?@id=stringRemove an educationUser from an educationClass.
  • GETList classes references/education/classes/:educationClass-id/teachers/$refRetrieve a list of teachers for a class. Delegated tokens must be members of the class to get the teacher list.
  • POSTAdd class reference/education/classes/:educationClass-id/teachers/$refAdd a teacher to a class.
  • DELETERemove class reference/education/classes/:educationClass-id/teachers/$ref?@id=stringRemove a teacher from an educationClass.
  • GETTrack changes to assignments (delta)/education/classes/:educationClass-id/assignments/delta()Get a list of newly-created or updated assignments without reading the whole collection. A teacher or an application running with application permissions can…
  • GETTrack changes to assignment categories (delta)/education/classes/:educationClass-id/assignmentCategories/delta()Get a list of newly created or updated educationCategory objects without having to perform a full read of the collection.
  • GETGet module/education/classes/:educationClass-id/modules/:educationModule-idGet the properties and relationships of a module. Only teachers, students, and applications with application permissions can perform this operation. Students…
  • DELETEDelete module/education/classes/:educationClass-id/modules/:educationModule-idDelete an existing module in a class. Only teachers within a class can delete modules.
  • PATCHUpdate module/education/classes/:educationClass-id/modules/:educationModule-idUpdate an educationModule object in a class. Only teachers in the class can perform this operation. You can't use a PATCH request to change the status of a…
  • GETGet school/education/classes/:educationClass-id/schools/:educationSchool-idAll schools that this class is associated with. Nullable.
  • GETList service provisioning errors/education/classes/:educationClass-id/group/serviceProvisioningErrorsErrors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a group object. Supports…
  • GETList grading schemes/education/classes/:educationClass-id/assignmentSettings/gradingSchemesRead the properties and relationships of an educationGradingScheme object.
  • POSTCreate grading scheme/education/classes/:educationClass-id/assignmentSettings/gradingSchemesCreate a new educationGradingScheme on an educationClass. Only teachers can perform this operation.
  • GETList grading categories/education/classes/:educationClass-id/assignmentSettings/gradingCategoriesWhen set, enables users to weight assignments differently when computing a class average grade.
  • POSTCreate grading category/education/classes/:educationClass-id/assignmentSettings/gradingCategories
  • GETGet assignment/education/classes/:educationClass-id/assignments/:educationAssignment-idGet the properties and relationships of an assignment. Only teachers, students, and applications with application permissions can perform this operation.…
  • DELETEDelete assignment/education/classes/:educationClass-id/assignments/:educationAssignment-idDelete an existing assignment. Only teachers within a class can delete assignments.
  • PATCHUpdate assignment/education/classes/:educationClass-id/assignments/:educationAssignment-idUpdate an educationAssignment object. Only teachers can perform this action. Alternatively, request to change the status of an assignment with publish action.…
  • GETGet default grading scheme/education/classes/:educationClass-id/assignmentSettings/defaultGradingSchemeThe default grading scheme for assignments created in this class.
  • GETGet assignment category/education/classes/:educationClass-id/assignmentCategories/:educationCategory-idRetrieve an educationCategory object. Only teachers, students, and applications with application permissions can perform this operation.
  • DELETEDelete assignment category/education/classes/:educationClass-id/assignmentCategories/:educationCategory-idDelete an existing category. Only teachers can perform this operation.
  • PATCHUpdate assignment category/education/classes/:educationClass-id/assignmentCategories/:educationCategory-id
  • DELETERemove class reference/education/classes/:educationClass-id/members/:educationUser-id/$refRemove an educationUser from an educationClass.
  • POSTPin module/education/classes/:educationClass-id/modules/:educationModule-id/pinPin an educationModule in the class work list. This action sets the isPinned property to true for an educationModule. Only teachers can perform this action…
  • DELETERemove class reference/education/classes/:educationClass-id/teachers/:educationUser-id/$refRemove a teacher from an educationClass.
  • POSTUnpin module/education/classes/:educationClass-id/modules/:educationModule-id/unpinUnpin an educationModule in the classwork list. This action sets the isPinned property to false for an educationModule. Only teachers in the class can perform…
  • POSTCreate publish/education/classes/:educationClass-id/modules/:educationModule-id/publishChange the state of an educationModule from its original draft status to the published status. Only teachers in the class can perform this operation. When a…
  • GETList resources/education/classes/:educationClass-id/modules/:educationModule-id/resourcesGet all the educationModuleResource objects associated with a module. Only teachers, students, and applications with application permissions can perform this…
  • POSTCreate resource/education/classes/:educationClass-id/modules/:educationModule-id/resourcesCreate a resource in a module. Only teachers can perform this operation. You can create the following types of module resources: Every resource has an…
  • GETGet rubric/education/classes/:educationClass-id/assignments/:educationAssignment-id/rubricGet the educationRubric object attached to an educationAssignment, if one exists. Only teachers, students, and applications with application permissions can…
  • DELETEDelete rubric/education/classes/:educationClass-id/assignments/:educationAssignment-id/rubricRemove an educationRubric from an educationAssignment. This method doesn't delete the rubric itself and can only be performed by teachers.
  • PATCHUpdate rubric/education/classes/:educationClass-id/assignments/:educationAssignment-id/rubricAttach an existing educationRubric object to an educationAssignment. Only teachers can perform this operation.
  • POSTCreate publish/education/classes/:educationClass-id/assignments/:educationAssignment-id/publishPublish an education assignment. Change the status of an educationAssignment from its original draft status to the published status. You can change the status…
  • POSTCreate activate/education/classes/:educationClass-id/assignments/:educationAssignment-id/activateActivate an inactive educationAssignment to signal that the assignment has further action items for teachers or students. This action can only be performed by…
  • GETList resources/education/classes/:educationClass-id/assignments/:educationAssignment-id/resourcesGet all the educationAssignmentResource objects associated with an assignment. Only teachers, students, and applications with application permissions can…
  • POSTCreate resource/education/classes/:educationClass-id/assignments/:educationAssignment-id/resourcesCreate an assignment resource. Only teachers can perform this operation. You can create the following types of assignment resources: Every resource has an…
  • GETList categories/education/classes/:educationClass-id/assignments/:educationAssignment-id/categoriesList all the categories associated with an assignment. Only teachers, students, and applications with application permissions can perform this operation.
  • POSTCreate category/education/classes/:educationClass-id/assignments/:educationAssignment-id/categoriesAdd one or more existing educationCategory objects to the specified educationAssignment. Only teachers can perform this operation.
  • POSTCreate deactivate/education/classes/:educationClass-id/assignments/:educationAssignment-id/deactivateMark an assigned educationAssignment as inactive to signal that the assignment has no further action items for teachers and students. This action can only be…
  • GETList submissions/education/classes/:educationClass-id/assignments/:educationAssignment-id/submissionsList all the submissions associated with an assignment. Only teachers, students, and applications with application permissions can perform this operation. A…
  • POSTCreate submission/education/classes/:educationClass-id/assignments/:educationAssignment-id/submissions
  • POSTSet up resources folder (module)/education/classes/:educationClass-id/modules/:educationModule-id/setUpResourcesFolderCreate a SharePoint folder to upload files for a given educationModule. Only teachers can perform this operation. The teacher determines what resources to…
  • GETGet grading scheme/education/classes/:educationClass-id/assignments/:educationAssignment-id/gradingSchemeWhen set, enables users to configure custom string grades based on the percentage of total points earned on this assignment.
  • GETGet grading category/education/classes/:educationClass-id/assignments/:educationAssignment-id/gradingCategoryWhen set, enables users to weight assignments differently when computing a class average grade.
  • POSTSet up resources folder (assignment)/education/classes/:educationClass-id/assignments/:educationAssignment-id/setUpResourcesFolderCreate a SharePoint folder to upload files for a given educationAssignment. Only teachers can perform this operation. The teacher determines the resources to…
  • GETGet grading scheme/education/classes/:educationClass-id/assignmentSettings/gradingSchemes/:educationGradingScheme-idRead the properties and relationships of an educationGradingScheme object.
  • DELETEDelete grading scheme/education/classes/:educationClass-id/assignmentSettings/gradingSchemes/:educationGradingScheme-idDelete an educationGradingScheme object.
  • PATCHUpdate grading scheme/education/classes/:educationClass-id/assignmentSettings/gradingSchemes/:educationGradingScheme-id
  • POSTSet up feedback resources folder (assignment)/education/classes/:educationClass-id/assignments/:educationAssignment-id/setUpFeedbackResourcesFolderCreate a SharePoint folder to upload feedback files for a given educationSubmission. Only teachers can perform this operation. The teacher determines the…
  • GETGet grading category/education/classes/:educationClass-id/assignmentSettings/gradingCategories/:educationGradingCategory-idWhen set, enables users to weight assignments differently when computing a class average grade.
  • DELETEDelete grading category/education/classes/:educationClass-id/assignmentSettings/gradingCategories/:educationGradingCategory-id
  • PATCHUpdate grading category/education/classes/:educationClass-id/assignmentSettings/gradingCategories/:educationGradingCategory-idUpdate a single gradingCategory on the educationAssignmentSettings. Only teachers can perform this operation.
  • GETList assignments references/education/classes/:educationClass-id/assignments/:educationAssignment-id/rubric/$refGet the educationRubric object attached to an educationAssignment, if one exists. Only teachers, students, and applications with application permissions can…
  • PUTSet assignments/education/classes/:educationClass-id/assignments/:educationAssignment-id/rubric/$refAttach an existing educationRubric object to an educationAssignment. Only teachers can perform this operation.
  • DELETERemove assignment reference/education/classes/:educationClass-id/assignments/:educationAssignment-id/rubric/$refRemove an educationRubric from an educationAssignment. This method doesn't delete the rubric itself and can only be performed by teachers.
  • GETList assignments references/education/classes/:educationClass-id/assignments/:educationAssignment-id/categories/$refList all the categories associated with an assignment. Only teachers, students, and applications with application permissions can perform this operation.
  • POSTAdd assignment reference/education/classes/:educationClass-id/assignments/:educationAssignment-id/categories/$refAdd one or more existing educationCategory objects to the specified educationAssignment. Only teachers can perform this operation.
  • DELETERemove assignment reference/education/classes/:educationClass-id/assignments/:educationAssignment-id/categories/$ref?@id=stringRemove an educationCategory from an educationAssignment. Only teachers can perform this operation.
  • GETTrack changes to categories (delta)/education/classes/:educationClass-id/assignments/:educationAssignment-id/categories/delta()Get a list of newly created or updated educationCategory objects without having to perform a full read of the collection.
  • GETGet resource/education/classes/:educationClass-id/modules/:educationModule-id/resources/:educationModuleResource-idGet the properties of a resource associated with a module. Only teachers, students, and applications with application permissions can perform this operation.
  • DELETEDelete resource/education/classes/:educationClass-id/modules/:educationModule-id/resources/:educationModuleResource-idDelete a specific educationModuleResource attached to a module. Only teachers in the class can remove a resource.
  • PATCHUpdate resource/education/classes/:educationClass-id/modules/:educationModule-id/resources/:educationModuleResource-idUpdate a resource in a module. Only teachers can perform this operation. The only one property that can be updated is displayName, for all resource types.
  • GETGet submission/education/classes/:educationClass-id/assignments/:educationAssignment-id/submissions/:educationSubmission-idRetrieve a particular submission. Only teachers, students, and applications with application permissions can perform this operation. A submission object…
  • DELETEDelete submission/education/classes/:educationClass-id/assignments/:educationAssignment-id/submissions/:educationSubmission-id
  • PATCHUpdate submission/education/classes/:educationClass-id/assignments/:educationAssignment-id/submissions/:educationSubmission-id
  • GETGet resource/education/classes/:educationClass-id/assignments/:educationAssignment-id/resources/:educationAssignmentResource-idGet the properties of an education assignment resource associated with an assignment. Only teachers, students, and applications with application permissions…
  • DELETEDelete resource/education/classes/:educationClass-id/assignments/:educationAssignment-id/resources/:educationAssignmentResource-idDelete a specific educationAssignmentResource attached to an assignment. In general, only teachers in the class can remove a resource. However, teachers can't…
  • PATCHUpdate resource/education/classes/:educationClass-id/assignments/:educationAssignment-id/resources/:educationAssignmentResource-id

Education: reports

  • GETList reports/education/reports
  • DELETEDelete reports/education/reports
  • PATCHUpdate reports/education/reports
  • GETList reading coach passages/education/reports/readingCoachPassagesGet a list of Reading Coach passages that were practiced by a student.
  • POSTCreate reading coach passage/education/reports/readingCoachPassages
  • GETList reflect check in responses/education/reports/reflectCheckInResponsesGet a list of Reflect check-ins that were submitted by a student.
  • POSTCreate reflect check in response/education/reports/reflectCheckInResponses
  • GETList reading assignment submissions/education/reports/readingAssignmentSubmissionsGet a list of reading assignments that were submitted by a student.
  • POSTCreate reading assignment submission/education/reports/readingAssignmentSubmissions
  • GETList speaker assignment submissions/education/reports/speakerAssignmentSubmissionsGet a list of speaker assignments that were submitted by a student.
  • POSTCreate speaker assignment submission/education/reports/speakerAssignmentSubmissions
  • GETGet reading coach passage/education/reports/readingCoachPassages/:readingCoachPassage-idDetails of practiced Reading Coach passages.
  • DELETEDelete reading coach passage/education/reports/readingCoachPassages/:readingCoachPassage-id
  • PATCHUpdate reading coach passage/education/reports/readingCoachPassages/:readingCoachPassage-id
  • GETGet reflect check in response/education/reports/reflectCheckInResponses/:reflectCheckInResponse-idDetails of check-in responses.
  • DELETEDelete reflect check in response/education/reports/reflectCheckInResponses/:reflectCheckInResponse-id
  • PATCHUpdate reflect check in response/education/reports/reflectCheckInResponses/:reflectCheckInResponse-id
  • GETGet reading assignment submission/education/reports/readingAssignmentSubmissions/:readingAssignmentSubmission-idDetails of submitted reading assignments.
  • DELETEDelete reading assignment submission/education/reports/readingAssignmentSubmissions/:readingAssignmentSubmission-id
  • PATCHUpdate reading assignment submission/education/reports/readingAssignmentSubmissions/:readingAssignmentSubmission-id
  • GETGet speaker assignment submission/education/reports/speakerAssignmentSubmissions/:speakerAssignmentSubmission-idDetails of submitted speaker assignments.
  • DELETEDelete speaker assignment submission/education/reports/speakerAssignmentSubmissions/:speakerAssignmentSubmission-id
  • PATCHUpdate speaker assignment submission/education/reports/speakerAssignmentSubmissions/:speakerAssignmentSubmission-id

Education: schools

  • GETList schools/education/schoolsGet a list of the educationSchool objects and their properties.
  • POSTCreate school/education/schoolsCreate a new educationSchool object.
  • GETTrack changes to schools (delta)/education/schools/delta()Get newly created or updated schools without having to perform a full read of the entire school collection. See Use delta query for details.
  • GETGet school/education/schools/:educationSchool-idRead the properties and relationships of an educationSchool object.
  • DELETEDelete school/education/schools/:educationSchool-idDelete a school.
  • PATCHUpdate school/education/schools/:educationSchool-idUpdate the properties of an educationSchool object.
  • GETList users/education/schools/:educationSchool-id/usersGet the educationUser resources associated with an educationSchool.
  • GETList classes/education/schools/:educationSchool-id/classesGet the educationClass resources owned by an educationSchool.
  • GETGet administrative unit/education/schools/:educationSchool-id/administrativeUnitThe underlying administrativeUnit for this school.
  • PATCHUpdate administrative unit/education/schools/:educationSchool-id/administrativeUnit
  • GETList schools references/education/schools/:educationSchool-id/users/$refGet the educationUser resources associated with an educationSchool.
  • POSTAdd school reference/education/schools/:educationSchool-id/users/$refAdd a user to a school.
  • DELETERemove school reference/education/schools/:educationSchool-id/users/$ref?@id=stringDelete a user from a school.
  • GETList schools references/education/schools/:educationSchool-id/classes/$refGet the educationClass resources owned by an educationSchool.
  • POSTAdd school reference/education/schools/:educationSchool-id/classes/$refAdd a class to a school.
  • DELETERemove school reference/education/schools/:educationSchool-id/classes/$ref?@id=stringDelete a class from a school.
  • DELETERemove school reference/education/schools/:educationSchool-id/users/:educationUser-id/$refDelete a user from a school.
  • DELETERemove school reference/education/schools/:educationSchool-id/classes/:educationClass-id/$refDelete a class from a school.

API details

Base URL
https://graph.microsoft.com/v1.0
Authentication
OAuth 2.0 (authorization code, client credentials flows)
Operations
260 operations on 146 pathsGET 116POST 62DELETE 45PATCH 34PUT 3
Main resources
Education: classes 93Education: me 68Education: users 56Education: reports 23Education: schools 18Education 2
Description format
OpenAPI 3.0.4, API version v1.0

How to test the Microsoft Graph: Education (classes and assignments) in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Microsoft Graph: Education (classes and assignments) collection, without the publisher's secrets.
  3. Add your credentialsThis API uses OAuth 2.0 (authorization code, client credentials flows). Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Get education” (GET /education), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Microsoft Graph: Education (classes and assignments)?

Schools, classes, teachers and students, and class assignments, submissions, rubrics and grades in Microsoft Teams for Education. This listing is one area of… It is listed under Education and has 260 endpoints.

Who publishes the Microsoft Graph: Education (classes and assignments)?

It is listed from Microsoft's public API description (an OpenAPI document), not published by Microsoft on Swastik Codes. Anyone who controls microsoft.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Microsoft Graph: Education (classes and assignments)?

Requests go to https://graph.microsoft.com/v1.0. Endpoint paths are added to this base URL.

How do I authenticate with the Microsoft Graph: Education (classes and assignments)?

With OAuth 2.0 (authorization code, client credentials flows).

How many endpoints does the Microsoft Graph: Education (classes and assignments) have?

260 operations on 146 paths (116 GET, 62 POST, 45 DELETE, 34 PATCH, 3 PUT). The largest groups are Education: classes, Education: me, Education: users, Education: reports.

Is forking the Microsoft Graph: Education (classes and assignments) free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.