Microsoft Graph Education is a set of Microsoft Graph APIs that let developers build apps for schools by connecting directly to Microsoft 365 education data and workflows. It exposes structured resources such as schools, classes, teachers, students (educationUser), and supports end-to-end assignment workflows including assignments, submissions, grades, rubrics, and feedback.
openapi: 3.1.0
info:
title: Microsoft Graph Education
description: Needs a description.
paths:
/education:
description: Provides operations to manage the educationRoot singleton.
get:
tags:
- education.educationRoot
summary: Microsoft Graph Get education
operationId: education.educationRoot.GetEducationRoot
parameters:
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved entity
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.educationRoot'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- education.educationRoot
summary: Microsoft Graph Update education
operationId: education.educationRoot.UpdateEducationRoot
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.educationRoot'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.educationRoot'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
/education/classes:
description: >-
Provides operations to manage the classes property of the
microsoft.graph.educationRoot entity.
get:
tags:
- education.educationClass
summary: Microsoft Graph List educationClasses
description: Get a list of the educationClass objects and their properties.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/educationclass-list?view=graph-rest-1.0
operationId: education.ListClasses
parameters:
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: >-
#/components/responses/microsoft.graph.educationClassCollectionResponse
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- education.educationClass
summary: Microsoft Graph Create educationClass
description: Create a new educationClass object.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/educationclass-post?view=graph-rest-1.0
operationId: education.CreateClasses
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.educationClass'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.educationClass'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
/education/classes/{educationClass-id}:
description: >-
Provides operations to manage the classes property of the
microsoft.graph.educationRoot entity.
get:
tags:
- education.educationClass
summary: Microsoft Graph Get educationClass
description: >-
Retrieve 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 represent the students; group admins represent the
teachers in the class. If you're using the delegated token, the user
will only see classes in which they are members.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/educationclass-get?view=graph-rest-1.0
operationId: education.GetClasses
parameters:
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.educationClass'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- education.educationClass
summary: Microsoft Graph Update educationClass
description: Update the properties of an educationClass object.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/educationclass-update?view=graph-rest-1.0
operationId: education.UpdateClasses
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.educationClass'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.educationClass'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- education.educationClass
summary: Microsoft Graph Delete educationClass
description: >-
Delete an educationClass. Because a class is also a universal group,
deleting a class deletes the group.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/educationclass-delete?view=graph-rest-1.0
operationId: education.DeleteClasses
parameters:
- name: If-Match
in: header
description: ETag
schema:
type: string
responses:
'204':
description: Success
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
parameters:
- name: educationClass-id
in: path
description: The unique identifier of educationClass
required: true
schema:
type: string
x-ms-docs-key-type: educationClass
/education/classes/{educationClass-id}/assignmentCategories:
description: >-
Provides operations to manage the assignmentCategories property of the
microsoft.graph.educationClass entity.
get:
tags:
- education.educationClass
summary: Microsoft Graph List assignmentCategories
description: >-
Retrieve a list of educationCategory objects. Only teachers can perform
this operation.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/educationclass-list-categories?view=graph-rest-1.0
operationId: education.classes.ListAssignmentCategories
parameters:
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: >-
#/components/responses/microsoft.graph.educationCategoryCollectionResponse
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- education.educationClass
summary: Microsoft Graph Create educationCategory
description: >-
Create a new educationCategory on an educationClass. Only teachers can
perform this operation.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/educationclass-post-category?view=graph-rest-1.0
operationId: education.classes.CreateAssignmentCategories
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.educationCategory'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.educationCategory'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
parameters:
- name: educationClass-id
in: path
description: The unique identifier of educationClass
required: true
schema:
type: string
x-ms-docs-key-type: educationClass
/education/classes/{educationClass-id}/assignmentCategories/{educationCategory-id}:
description: >-
Provides operations to manage the assignmentCategories property of the
microsoft.graph.educationClass entity.
get:
tags:
- education.educationClass
summary: Microsoft Graph Get educationCategory
description: >-
Retrieve an educationCategory object. Only teachers, students, and
applications with application permissions can perform this operation.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/educationcategory-get?view=graph-rest-1.0
operationId: education.classes.GetAssignmentCategories
parameters:
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.educationCategory'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- education.educationClass
summary: Microsoft Graph Update the navigation property assignmentCategories in education
operationId: education.classes.UpdateAssignmentCategories
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.educationCategory'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.educationCategory'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- education.educationClass
summary: Microsoft Graph Delete educationCategory
description: Delete an existing category. Only teachers can perform this operation.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/educationcategory-delete?view=graph-rest-1.0
operationId: education.classes.DeleteAssignmentCategories
parameters:
- name: If-Match
in: header
description: ETag
schema:
type: string
responses:
'204':
description: Success
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
parameters:
- name: educationClass-id
in: path
description: The unique identifier of educationClass
required: true
schema:
type: string
x-ms-docs-key-type: educationClass
- name: educationCategory-id
in: path
description: The unique identifier of educationCategory
required: true
schema:
type: string
x-ms-docs-key-type: educationCategory
/education/classes/{educationClass-id}/assignmentCategories/$count:
description: Provides operations to count the resources in the collection.
get:
tags:
- education.educationClass
summary: Microsoft Graph Get the number of the resource
operationId: education.classes.assignmentCategories.GetCount-8570
parameters:
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
parameters:
- name: educationClass-id
in: path
description: The unique identifier of educationClass
required: true
schema:
type: string
x-ms-docs-key-type: educationClass
/education/classes/{educationClass-id}/assignmentCategories/delta():
description: Provides operations to call the delta method.
get:
tags:
- education.educationClass
summary: Microsoft Graph Invoke function delta
description: >-
Get a list of newly created or updated educationCategory objects without
having to perform a full read of the collection.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/educationcategory-delta?view=graph-rest-1.0
operationId: education.classes.educationClass.assignmentCategories.delta
parameters:
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of educationCategory
type: object
allOf:
- $ref: '#/components/schemas/BaseDeltaFunctionResponse'
- type: object
properties:
value:
type: array
items:
$ref: >-
#/components/schemas/microsoft.graph.educationCategory
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
parameters:
- name: educationClass-id
in: path
description: The unique identifier of educationClass
required: true
schema:
type: string
x-ms-docs-key-type: educationClass
x-ms-docs-grouped-path:
- >-
/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/categories/delta()
- /education/classes/{educationClass-id}/assignments/delta()
- /education/classes/delta()
- /education/me/assignments/{educationAssignment-id}/categories/delta()
- /education/me/assignments/delta()
- /education/schools/delta()
- >-
/education/users/{educationUser-id}/assignments/{educationAssignment-id}/categories/delta()
- /education/users/{educationUser-id}/assignments/delta()
- /education/users/delta()
/education/classes/{educationClass-id}/assignmentDefaults:
description: >-
Provides operations to manage the assignmentDefaults property of the
microsoft.graph.educationClass entity.
get:
tags:
- education.educationClass
summary: Microsoft Graph Get educationAssignmentDefaults
description: >-
Read the properties and relationships of an educationAssignmentDefaults
object. These are the class-level assignment defaults respected by new
assignments created in the class. Callers can continue to specify custom
values on each assignment creation if they don't want the default
behaviors. Only teachers can perform this operation.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/educationassignmentdefaults-get?view=graph-rest-1.0
operationId: education.classes.GetAssignmentDefaults
parameters:
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: >-
#/components/schemas/microsoft.graph.educationAssignmentDefaults
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- education.educationClass
summary: Microsoft Graph Update educationAssignmentDefaults
description: >-
Update the properties of an educationAssignmentDefaults object. Only
teachers can update these settings.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/educationassignmentdefaults-update?view=graph-rest-1.0
operationId: education.classes.UpdateAssignmentDefaults
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.educationAssignmentDefaults'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: >-
#/components/schemas/microsoft.graph.educationAssignmentDefaults
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- education.educationClass
summary: Microsoft Graph Delete navigation property assignmentDefaults for education
operationId: education.classes.DeleteAssignmentDefaults
parameters:
- name: If-Match
in: header
description: ETag
schema:
type: string
responses:
'204':
description: Success
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
parameters:
- name: educationClass-id
in: path
description: The unique identifier of educationClass
required: true
schema:
type: string
x-ms-docs-key-type: educationClass
/education/classes/{educationClass-id}/assignments:
description: >-
Provides operations to manage the assignments property of the
microsoft.graph.educationClass entity.
get:
tags:
- education.educationClass
summary: Microsoft Graph List class assignments
description: >-
Retrieve a list of assignment objects. Only teachers, students, and
applications with application permissions can perform this operation. A
teacher, or an application running with application permissions, can see
all assignment objects for the class. Students can only see assignments
that are assigned to them.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/educationclass-list-assignments?view=graph-rest-1.0
operationId: education.classes.ListAssignments
parameters:
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: >-
#/components/responses/microsoft.graph.educationAssignmentCollectionResponse
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- education.educationClass
summary: Microsoft Graph Create educationAssignment
description: >-
Create 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 assignment until it's published.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/educationclass-post-assignments?view=graph-rest-1.0
operationId: education.classes.CreateAssignments
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.educationAssignment'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.educationAssignment'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
parameters:
- name: educationClass-id
in: path
description: The unique identifier of educationClass
required: true
schema:
type: string
x-ms-docs-key-type: educationClass
/education/classes/{educationClass-id}/assignments/{educationAssignment-id}:
description: >-
Provides operations to manage the assignments property of the
microsoft.graph.educationClass entity.
get:
tags:
- education.educationClass
summary: Microsoft Graph Get educationAssignment
description: >-
Get the properties and relationships of an assignment. Only teachers,
students, and applications with application permissions can perform this
operation. Students can only see assignments assigned to them; teachers
and applications with application permissions can see all assignments in
a class. You can use the Prefer header in your request to get the
inactive status in case the assignment is deactivated; otherwise, the
response value for the status property is unknownFutureValue.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/educationassignment-get?view=graph-rest-1.0
operationId: education.classes.GetAssignments
parameters:
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.educationAssignment'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- education.educationClass
summary: Microsoft Graph Update educationassignment
description: >-
Update an educationAssignment 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.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/educationassignment-update?view=graph-rest-1.0
operationId: education.classes.UpdateAssignments
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.educationAssignment'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.educationAssignment'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- education.educationClass
summary: Microsoft Graph Delete educationAssignment
description: >-
Delete an existing assignment. Only teachers within a class can delete
assignments.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/educationassignment-delete?view=graph-rest-1.0
operationId: education.classes.DeleteAssignments
parameters:
- name: If-Match
in: header
description: ETag
schema:
type: string
responses:
'204':
description: Success
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
parameters:
- name: educationClass-id
in: path
description: The unique identifier of educationClass
required: true
schema:
type: string
x-ms-docs-key-type: educationClass
- name: educationAssignment-id
in: path
description: The unique identifier of educationAssignment
required: true
schema:
type: string
x-ms-docs-key-type: educationAssignment
/education/classes/{educationClass-id}/assignments/{educationAssignment-id}/categories:
description: >-
Provides operations to manage the categories property of the
microsoft.graph.educationAssignment entity.
get:
tags:
-
# --- truncated at 32 KB (812 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-graph/refs/heads/main/openapi/education-openapi-original.yml