taskList resource type (deprecated)
Namespace: microsoft.graph
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.
Represents a list created by a user in Microsoft To Do that contains one or more task resources.
This resource supports the following:
- Adding your data to custom properties as open extensions
- Using delta query to track incremental additions, deletions and updates.
The taskList resource inherits from baseTaskList. Its contents, of the task resource type, inherit from baseTask.
Methods
| Method | Return type | Description |
|---|---|---|
| List base task lists | taskList collection | Get a list of the taskList objects and their properties. |
| Get base task list | taskList | Read the properties and relationships of a taskList object. |
| Update base task list | taskList | Update the properties of a taskList object. |
| Delete base task list | None | Deletes a taskList object. |
| List base tasks | baseTask collection | Get the baseTask resources from the tasks navigation property. |
| Create base task | baseTask | Create a new baseTask object. |
Properties
| Property | Type | Description |
|---|---|---|
| displayName | String | The name of the task list. Inherited from baseTaskList. |
| id | String | The identifier of the task list, unique in the user's mailbox. Read-only. Inherited from baseTaskList. |
Relationships
| Relationship | Type | Description |
|---|---|---|
| extensions | extension collection | The collection of open extensions defined for the task list. Nullable. Inherited from baseTaskList |
| tasks | baseTask collection | The tasks in this task list. Read-only. Nullable. Inherited from baseTaskList |
JSON representation
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.taskList",
"displayName": "String",
"id": "String (identifier)"
}