outlookTaskGroup resource type

Important: APIs under the /beta version in Microsoft Graph are in preview and are subject to change. Use of these APIs in production applications is not supported.

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

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

Methods

Method Return Type Description
Get outlookTaskGroup 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.

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

Here is a JSON representation of the resource.

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