Breaking changes in the Microsoft Graph Tasks API (beta) 

Microsoft Graph team

For the past several months we’ve offered developers preview access to our new Tasks API on the beta endpoint of Microsoft Graph. The Tasks API helps bring users’ tasks from multiple sources such as Outlook emails, Teams chats, Office documents into one single place. However, as is sometimes the case with pre-production APIs, we’re making a few necessary changes to property names and types to align them with similar properties elsewhere in Microsoft Graph. Note that these are breaking changes that will impact developers whose solutions are currently calling the To Do API.

Breaking changes to the Tasks API

  • The personalProperties property of baseTask resource is now named viewpoint 
  • The reminderDatetime has been renamed to reminderDateTime 
  • The body property name is now textBody and its property type itemBody is now String. In the future, we’ll also support htmlBody on baseTask resource

For more information, see the task resource type documentation.

What do I need to do?

Please update your code to rename references to reflect the renamed properties. After the breaking change, calls to this API using out-of-date property names will return nothing in response. 

The changes will take effect on the Microsoft Graph beta endpoint on Feb 28th, 2022. Follow changes and updates on the Microsoft Graph developer blog.

Happy coding!