We’re excited to announce that the Microsoft To Do API is now generally available in Microsoft Graph worldwide. Previously, the API was available through the beta endpoint only; now you can access it through the production v1.0 endpoint.
API details
The organization of the To Do API is structurally similar the organization of To Do tasks in our first party app. We have a todoTaskList entity, consisting of a collection of todoTask entities. We are also are introducing a new entity called linkedResource, which enables task completion. You can use it to store and display the link back to the item in your app from where the task was created.
The new API supports personal and work and school accounts. The required permission scope to access the API is Tasks.ReadWrite. All the resources support CRUD operations.
| CRUD operation on todoTaskList entity | Â /me/todo/lists |
| CRUD operation on todoTask entity | Â /me/todo/lists/<listId>/tasks |
| CRUD operation on linkedResource entity | Â /me/todo/lists/<listId>/tasks/<taskId>/linkedResources |
Now that these APIs are available in v1.0, you can use them in your production apps. To learn more and get started:
- Try out the APIs in Graph Explorer.
- See the To Do API reference documentation.
What’s next?
We are committed to bring continuous improvements and capabilities to make To Do APIs best in class. If you have any feedback, suggestions or questions, let us know on our User Voice or on Stack Overflow or email us at todofeedback@microsoft.com .
We can’t wait to see what you’ll build with the APIs!
