Breaking changes to the me/assignments endpoint in the Microsoft Graph Assignments API (beta)

Microsoft Graph team

Today, we’re announcing some upcoming breaking changes for developers using the Microsoft Graph assignments API. The assignments API enables education users and partners to get and set properties associated with assignments in Microsoft Teams EDU. We will be removing some properties and navigation properties in the response to the me/assignments GET endpoint to enhance its performance. These changes will be rolling out to the Microsoft Graph beta endpoint on October 8, 2021.

Properties to be removed

What is the change?

The following properties will be removed.

Name Type Description
instructions {“@odata.type”: “microsoft.graph.itemBody”} Instructions for the assignment. This along with the display name tells the student what to do.
assignedDateTime String (timestamp) The moment that the assignment was published to students and the assignment shows up on the students’ timeline.
assignTo {“@odata.type”: “microsoft.graph.educationAssignmentRecipient”} Which users or whole class should receive a submission object after the assignment is published.
resourcesFolderUrl string Folder URL where all the file resources for an assignment are stored.
webUrl string The deep link URL for the given assignment.

 

Why the change?

This change will result in improved performance of the me/assignments endpoint.

What do I need to do?

Please update your code to remove references to the properties that will be obsolete. These properties will return null value.

What is the change?

The following navigation properties will be removed.

Name Type Description
resource {“@odata.type”: “microsoft.graph.educationResource”} A wrapper object that stores the resources associated with an assignment.
rubric {“@odata.type”: “microsoft.graph.educationRubric”} A grading rubric that can be attached to an assignment. A rubric is associated with an educationUser (teacher) and attached to one or more educationAssignment resources.

 

Why the change?

This change will result in improved performance of the me/assignments endpoint.

Example

The following is an example of a request before the implementation of these changes.

`https://graph.microsoft.com/beta/education/me/assignments?$top=2&$orderby=dueDateTime desc&$expand=rubric`

The following is an example of the new request.

`https://graph.microsoft.com/beta/education/me/assignments?$top=2&$orderby=dueDateTime desc`

Alternative  method to get the navigation properties

You can still use the https://graph.microsoft.com/beta/education/classes/{classid}/assignments/{assignmentid}?expand=resources endpoint to expand the navigation properties.

 

Happy coding!

 

 

 

 

0 comments

Discussion is closed.

Feedback usabilla icon