Use the To Do API built on base tasks in Microsoft Graph (deprecated)
Important
APIs under the /beta
version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.
Caution
The to-do API set built on baseTask was deprecated on May 31, 2022, and stopped returning data on August 31, 2022. Use the todoTask API instead.
Use the Microsoft Graph To Do API to create an app that connects with users' task in their mailbox. Build a variety of experiences with tasks, such as the following:
- Create tasks from your app’s workflow, for example, from email or notifications, and save them in To Do. Use the linkedResource entity to store the link back to your app.
- Sync your app’s existing tasks with To Do and create a single task view for better prioritization and manageability.
- Manage To Do tasks in a custom business application.
- Create checklistItems on a task to break down complex tasks in smaller steps.
Currently, the API supports only permissions delegated by the signed-in user.
Before starting with the To Do API, take a look at the resources and how they relate to one another.
Task list
In this API set, a task list is represented by baseTaskList which is a logical container of baseTask resources. You can currently create tasks only in a task list. Tasks created without specifying list get created in the default Tasks list. To get all your task lists, make the following HTTP request:
GET /me/tasks/lists
Task
In this API set, a task is represented by a baseTask resource which is a piece of work or personal item that can be tracked and completed. To get your tasks from a task list, make the following HTTP request:
GET /me/tasks/lists/{taskListId}/tasks
Checklist item
A checklistItem represents an item that helps break down complex task in much smaller steps. To get a checklistItem from a task, make the following HTTP request:
GET /me/tasks/lists/{taskListId}/tasks/{taskId}/checklistItems/{checklistItems}
Linked resource
A linkedResource represents any item from a partner application related to the task; for example, an email from where a task was created. You can use it to store information and the link back to the related item in your app. To get a linked resource from a task, make the following HTTP request:
GET /me/tasks/lists/{taskListId}/tasks/{taskId}/linkedresources/{linkedResourceId}
Track changes using delta query
For performance reasons, you may want to maintain a local cache of objects, and periodically synchronize the local cache with the server, using delta query.
The following To Do API resources support delta query:
- baseTask collection in a task list
- baseTaskList