outlookTaskGroup resource type (deprecated)

Namespace: microsoft.graph


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.


The Outlook tasks API is deprecated and will stop returning data on August 20, 2022. Please use the new To Do API. For more information, see To Do APIs in public preview.

A group of folders (outlookTaskFolder) that contain Outlook tasks (collection of outlookTask objects).

In Outlook, there's a default task group My Tasks which you can't rename or delete. You can, however, create additional task groups.


Method Return Type Description
Get outlookTaskGroup Get the properties and relationships of the specified Outlook task group.
Create outlookTaskFolder outlookTaskFolder Create an Outlook task folder.
List taskFolders outlookTaskFolder collection Get a collection of Outlook task folders.
Update outlookTaskGroup Update the writable properties of an Outlook task group.
Delete None Delete the specified Outlook task group.


Property Type Description
changeKey String The version of the task group.
groupKey Edm.Guid The unique GUID identifier for the task group.
id String The unique string identifier of the task group. Read-only.
isDefaultGroup Boolean True if the task group is the default task group.
name String The name of the task group.


Relationship Type Description
taskFolders outlookTaskFolder collection The collection of task folders in the task group. Read-only. Nullable.

JSON representation

The following JSON representation shows the resource type.

  "changeKey": "String",
  "groupKey": "Guid",
  "id": "String (identifier)",
  "isDefaultGroup": true,
  "name": "String"