outlookTaskGroup resource type (deprecated)

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