| title | taskList resource type |
|---|---|
| description | Represents a list created by a user in Microsoft To Do that contains one or more Task resources. |
| author | avijityadav |
| ms.localizationpriority | medium |
| ms.subservice | outlook |
| doc_type | resourcePageType |
| ms.date | 07/22/2024 |
Namespace: microsoft.graph
[!INCLUDE beta-disclaimer]
[!INCLUDE todo-deprecate-basetaskapi]
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.
| 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. |
| 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. |
| 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 |
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.taskList",
"displayName": "String",
"id": "String (identifier)"
}