Edit

taskList resource type (deprecated)

  • Article

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 is deprecated as of May 31, 2022, and will stop returning data on August 31, 2022. Please use the API set built on todoTask.

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 taskLists taskList collection Get a list of the taskList objects and their properties.
Get taskList taskList Read the properties and relationships of a taskList object.
Update taskList taskList Update the properties of a taskList object.
Delete taskList None Deletes a taskList object.
List tasks baseTask collection Get the baseTask resources from the tasks navigation property.
Create baseTask 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 is a JSON representation of the resource.

{
  "@odata.type": "#microsoft.graph.taskList",
  "displayName": "String",
  "id": "String (identifier)"
}