| title | outlookTaskFolder resource type |
|---|---|
| description | A folder that contains Outlook tasks (collection of outlookTask objects). |
| author | mashriv |
| ms.localizationpriority | medium |
| ms.subservice | outlook |
| doc_type | resourcePageType |
| toc.title | Outlook task folder (deprecated) |
| ms.date | 08/23/2024 |
Namespace: microsoft.graph
[!INCLUDE beta-disclaimer]
[!INCLUDE outlooktask-deprecate-allup]
A folder that contains Outlook tasks (collection of outlookTask objects).
In Outlook, the default task group, My Tasks, contains a default task folder, Tasks, for the user's mailbox.
You can't rename or delete these default task groups or folders, but you can create new task groups and folders.
| Method | Return Type | Description |
|---|---|---|
| Get | outlookTaskFolder | Get the properties and relationships of the specified Outlook task folder. |
| Create task folder in group | outlookTask | Create an Outlook task in the specified task folder. |
| List task folders in group | outlookTask collection | Get all the Outlook tasks in the specified folder. |
| Update | outlookTaskFolder | Update the writable properties of an Outlook task folder. |
| Delete | None | Delete the specified Outlook task folder. |
| Permanently delete | None | Permanently delete an Outlook task and place it in the Purges folder in the Recoverable Items folder in the user's mailbox. |
| Extended properties | ||
| Create single-value property | outlookTaskFolder | Create one or more single-value extended properties in a new or existing Outlook task folder. |
| Get single-value property | outlookTaskFolder | Get Outlook task folders that contain a single-value extended property by using $expand or $filter. |
| Create multi-value property | outlookTaskFolder | Create one or more multi-value extended properties in a new or existing Outlook task folder. |
| Get multi-value property | outlookTaskFolder | Get an Outlook task folder that contains a multi-value extended property by using $expand. |
| Property | Type | Description |
|---|---|---|
| changeKey | String | The version of the task folder. |
| id | String | The identifier of the task folder, unique in the user's mailbox. Read-only. |
| isDefaultFolder | Boolean | True if the folder is the default task folder. |
| name | String | The name of the task folder. |
| parentGroupKey | Guid | The unique GUID identifier for the task folder's parent group. |
| Relationship | Type | Description |
|---|---|---|
| multiValueExtendedProperties | multiValueLegacyExtendedProperty collection | The collection of multi-value extended properties defined for the task folder. Read-only. Nullable. |
| singleValueExtendedProperties | singleValueLegacyExtendedProperty collection | The collection of single-value extended properties defined for the task folder. Read-only. Nullable. |
| tasks | outlookTask collection | The tasks in this task folder. Read-only. Nullable. |
The following JSON representation shows the resource type.
{
"changeKey": "String",
"id": "String (identifier)",
"isDefaultFolder": true,
"name": "String",
"parentGroupKey": "Guid"
}