Edit

Share via

outlookTaskGroup 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 Outlook tasks API is deprecated and stopped returning data on August 20, 2022. Use the To Do API instead.

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.

Methods

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

Properties

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.

Relationships

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"
}