+Get the decisions from a stage in a multi-stage access review. The decisions in an [accessReviewStage](../resources/accessReviewStage.md) object are represented by an [accessReviewInstanceDecisionItem](../resources/accessreviewinstancedecisionitem.md) object.

+# Delete baseTask (deprecated)

+# baseTask: delta (deprecated)

+# Get baseTask (deprecated)

+description: "Get the checklistItem resources associated to the checklistItems navigation property of a baseTask."

+Get the [checklistItem](../resources/checklistitem.md) resources associated to the **checklistItems** navigation property of a [baseTask](../resources/baseTask.md).

+# List linkedResources (deprecated)

+# baseTask: move (deprecated)

+Create a new [checklistItem](../resources/checklistitem.md) object as a subtask in a bigger [baseTask](../resources/basetask.md).

+# Create linkedResource_v2 (deprecated)

+# Update baseTask (deprecated)

+# baseTaskList: delta (deprecated)

+# Get baseTaskList (deprecated)

+# List baseTasks (deprecated)

+# Create baseTask (deprecated)

+This section lists the syntax for each of the two `PATCH` scenarios described above.

+### Delete a checklistItem associated to a specified todoTask

+DELETE /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}

+DELETE /users/{id | userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}

+```

+### Delete a checklistItem associated to a specified baseTask (deprecated)

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+DELETE /me/tasks/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}

+DELETE /users/{id | userPrincipalName}/tasks/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}

+### Request 1

+Here is an example to delete a **checklistItem** associated to a **todoTask**.

+ "name": "delete_checklistitem_1"

+DELETE https://graph.microsoft.com/beta/me/todo/lists/AAMkADliMmU5YjJlLTVmMmQtNGQzNS1iYjA0LTdmZTA2NTI0MTE5YwAuAAAAAADdOMUbUmCfTKa7OC-fqjkdAQBnu3olF7NfToRyJ2f__TNcAAAAAAESAAA=/tasks/AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AZ7t6JRezX06Ecidn-vkzXAABPDii4gAA/checklistitems/e3a26c2e-7c6f-4317-9d71-c27267008202

+### Request 2

+Here is an example to delete a **checklistItem** associated to a **baseTask** (deprecated).

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "delete_checklistitem_2"

+}

+-->

+``` http

+DELETE https://graph.microsoft.com/beta/me/tasks/lists/AAMkADliMmU5YjJlLTVmMmQtNGQzNS1iYjA0LTdmZTA2NTI0MTE5YwAuAAAAAADdOMUbUmCfTKa7OC-fqjkdAQBnu3olF7NfToRyJ2f__TNcAAAAAAESAAA=/tasks/AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AZ7t6JRezX06Ecidn-vkzXAABPDii4gAA/checklistitems/e3a26c2e-7c6f-4317-9d71-c27267008202

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Objective-C](#tab/objc)

+# [Java](#tab/java)

+# [Go](#tab/go)

+### Response

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true

+}

+-->

+``` http

+HTTP/1.1 204 No Content

+```

+This section lists the syntax for each of the two `GET` scenarios described above.

+### Get a checklistItem associated to a specified todoTask

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+GET /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}

+GET /users/{id | userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}

+```

+### Get a checklistItem associated to a specified baseTask (deprecated)

+### Request 1

+Here is an example to get a **checklistItem** associated to a **todoTask**.

+ "name": "get_checklistitem_1"

+GET https://graph.microsoft.com/beta/me/todo/lists/AAMkADliMmU5YjJlLTVmMmQtNGQzNS1iYjA0LTdmZTA2NTI0MTE5YwAuAAAAAADdOMUbUmCfTKa7OC-fqjkdAQBnu3olF7NfToRyJ2f__TNcAAAAAAESAAA=/tasks/AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AZ7t6JRezX06Ecidn-vkzXAABPDii4gAA/checklistitems/51d8a471-2e9d-4f53-9937-c33a8742d28f

+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('6f9a2a92-8527-4d64-937e-b5312852f35d')/todo/lists('AAMkADliMmU5YjJlLTVmMmQtNGQzNS1iYjA0LTdmZTA2NTI0MTE5YwAuAAAAAADdOMUbUmCfTKa7OC-fqjkdAQBnu3olF7NfToRyJ2f__TNcAAAAAAESAAA%3D')/tasks('AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AZ7t6JRezX06Ecidn-vkzXAABPDii4gAA')/checklistItems/$entity",

+### Request 2

+Here is an example to get a **checklistItem** associated to a **baseTask** (deprecated).

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "get_checklistitem_2"

+}

+-->

+``` http

+GET https://graph.microsoft.com/beta/me/tasks/lists/AAMkADliMmU5YjJlLTVmMmQtNGQzNS1iYjA0LTdmZTA2NTI0MTE5YwAuAAAAAADdOMUbUmCfTKa7OC-fqjkdAQBnu3olF7NfToRyJ2f__TNcAAAAAAESAAA=/tasks/AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AZ7t6JRezX06Ecidn-vkzXAABPDii4gAA/checklistitems/51d8a471-2e9d-4f53-9937-c33a8742d28f

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Objective-C](#tab/objc)

+# [Java](#tab/java)

+# [Go](#tab/go)

+### Response

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.checklistItem"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('6f9a2a92-8527-4d64-937e-b5312852f35d')/tasks/lists('AAMkADliMmU5YjJlLTVmMmQtNGQzNS1iYjA0LTdmZTA2NTI0MTE5YwAuAAAAAADdOMUbUmCfTKa7OC-fqjkdAQBnu3olF7NfToRyJ2f__TNcAAAAAAESAAA%3D')/tasks('AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AZ7t6JRezX06Ecidn-vkzXAABPDii4gAA')/checklistItems/$entity",

+ "displayName": "Create draft",

+ "createdDateTime": "2021-11-17T05:22:14.2207813Z",

+ "isChecked": false,

+ "id": "51d8a471-2e9d-4f53-9937-c33a8742d28f"

+}

+```

+This section lists the syntax for each of the two `PATCH` scenarios described above.

+### Update a checklistItem associated to a specified todoTask

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+PATCH /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}

+PATCH /users/{id | userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}

+```

+### Update a checklistItem associated to a specified baseTask (deprecated)

+### Request 1

+Here is an example to update a **checklistItem** associated to a **todoTask**.

+ "name": "update_checklistitem_1"

+}

+-->

+``` http

+PATCH https://graph.microsoft.com/beta/me/todo/lists/AAMkADliMmU5YjJlLTVmMmQtNGQzNS1iYjA0LTdmZTA2NTI0MTE5YwAuAAAAAADdOMUbUmCfTKa7OC-fqjkdAQBnu3olF7NfToRyJ2f__TNcAAAAAAESAAA=/tasks/AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AZ7t6JRezX06Ecidn-vkzXAABPDii4gAA/checklistitems/e3a26c2e-7c6f-4317-9d71-c27267008202

+Content-Type: application/json

+{

+ "displayName": "buy cake"

+}

+```

+# [JavaScript](#tab/javascript)

+# [C#](#tab/csharp)

+# [Objective-C](#tab/objc)

+# [Java](#tab/java)

+# [Go](#tab/go)

+### Response

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.checklistItem"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('6f9a2a92-8527-4d64-937e-b5312852f35d')/todo/lists('AAMkADliMmU5YjJlLTVmMmQtNGQzNS1iYjA0LTdmZTA2NTI0MTE5YwAuAAAAAADdOMUbUmCfTKa7OC-fqjkdAQBnu3olF7NfToRyJ2f__TNcAAAAAAESAAA%3D')/tasks('AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AZ7t6JRezX06Ecidn-vkzXAABPDii4gAA')/checklistItems/$entity",

+ "displayName": "buy cake",

+ "createdDateTime": "2021-11-17T05:35:03Z",

+ "isChecked": false,

+ "id": "e3a26c2e-7c6f-4317-9d71-c27267008202"

+}

+```

+### Request 2

+Here is an example to update a **checklistItem** associated to a **baseTask** (deprecated).

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "update_checklistitem_2"

+ "status": "succeeded",

+ "status": "succeeded",

+ "status": "succeeded",

+ "status": "succeeded",

+description: "Remove an existing educationCategory from this educationAssignment."

+### Request

+### Response

+# [PowerShell](#tab/powershell)

+# Delete linkedResource_v2 (deprecated)

+# Get linkedResource_v2 (deprecated)

+# Update linkedResource_v2 (deprecated)

+| [baseTask](../resources/basetask.md) (deprecated) | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |

+| [baseTasklist](../resources/basetasklist.md) (deprecated) | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |

+| [todoTask](../resources/todotask.md) | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |

+| [todoTasklist](../resources/todotasklist.md) | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |

+DELETE /users/me/todo/lists/{Id}/extensions/{extensionId}

+DELETE /users/me/todo/lists/{Id}/tasks/{Id}/extensions/{extensionId}

+DELETE /users/me/tasks/lists/{Id}/extensions/{extensionId}

+DELETE /users/me/tasks/lists/{Id}/tasks/{Id}/extensions/{extensionId}

+|Get a specific extension from a known resource instance.| [Administrative unit](../resources/administrativeunit.md), [baseTask](../resources/basetask.md) (deprecated), [baseTaskList](../resources/basetasklist.md) (deprecated), [device](../resources/device.md), [event](../resources/event.md), [group](../resources/group.md), [group event](../resources/event.md), [group post](../resources/post.md), [message](../resources/message.md), [organization](../resources/organization.md), [personal contact](../resources/contact.md), [user](../resources/user.md), [todoTask](../resources/todotask.md), [todoTaskList](../resources/todotasklist.md) | Open extension only.|

+|Get a known resource instance expanded with a specific extension.|Administrative unit, base task, base task list, device, event, group, group event, group post, message, organization, personal contact, user, to-do task, to-do task list. |A resource instance expanded with the open extension.|

+|Find and expand resource instances with a specific extension. | Base task, base task list, event, group event, group post, message, personal contact, to-do task, to-do task list |Resource instances expanded with the open extension.|

+| [baseTask](../resources/basetask.md) (deprecated) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |

+| [baseTaskList](../resources/basetasklist.md) (deprecated) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |

+| [todoTask](../resources/todotask.md) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |

+| [todoTaskList](../resources/todotasklist.md) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |

+GET /users/{Id|userPrincipalName}/todo/lists/{Id}/tasks/{todoTaskId}/extensions/{extensionId}

+GET /users/{Id|userPrincipalName}/todo/lists/{Id}/extensions/{extensionId}

+GET /users/{Id|userPrincipalName}/tasks/lists/{Id}/tasks/{baseTaskId}/extensions/{extensionId}

+GET /users/{Id|userPrincipalName}/tasks/lists/{Id}/extensions/{extensionId}

+GET /users/{Id|userPrincipalName}/todo/lists/{Id}/tasks/{Id}?$expand=extensions($filter=id eq '{extensionId}')

+GET /users/{Id|userPrincipalName}/todo/lists/{Id}?$expand=extensions($filter=id eq '{extensionId}')

+GET /users/{Id|userPrincipalName}/tasks/lists/{Id}/tasks/{Id}?$expand=extensions($filter=id eq '{extensionId}')

+```http

+| [baseTask](../resources/basetask.md) (deprecated) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |

+| [baseTaskList](../resources/basetasklist.md) (deprecated) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |

+| [todoTask](../resources/todotask.md) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |

+| [todoTaskList](../resources/todotasklist.md) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |

+POST /users/{id|userPrincipalName}/todo/lists/{id}/tasks

+POST /users/{id|userPrincipalName}/todo/lists

+POST /users/{id|userPrincipalName}/todo/lists/{id}/tasks/{id}/extensions

+POST /users/{id|userPrincipalName}/todo/lists/{id}/extensions

+| [baseTask](../resources/basetask.md) (deprecated) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |

+| [baseTasklist](../resources/basetasklist.md) (deprecated) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |

+| [todoTask](../resources/todotask.md) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |

+| [todoTasklist](../resources/todotasklist.md) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |

+PATCH /users/me/todo/lists/{Id}/tasks/{Id}/extensions/{extensionId}

+PATCH /users/me/todo/lists/{Id}/extensions/{extensionId}

+PATCH /users/me/tasks/lists/{Id}/tasks/{Id}/extensions/{extensionId}

+PATCH /users/me/tasks/lists/{Id}/extensions/{extensionId}

+# organization: activateService (deprecated)

+> [!CAUTION]

+> The **activateService** API is deprecated and will stop returning data on June 30, 2022.

+| Property | Type |Description|

+|:|:--|:-|

+|title|String|Title of the plan.|

+|[baseTask](../resources/todotask.md) (deprecated) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported. |

+|[baseTask](../resources/basetask.md) (deprecated) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |

+|[baseTask](../resources/basetask.md) (deprecated) | Tasks.ReadWrite, Subscription.Read.All | Tasks.ReadWrite, Subscription.Read.All | Not supported |

+|[baseTask](../resources/basetask.md) (deprecated) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |

+|[baseTask](../resources/basetask.md) (deprecated) | `/me/tasks/lists/{Id}/tasks`

+|[baseTask](../resources/basetask.md) (deprecated) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |

+ Title: "Delete baseTaskList"

+# Delete baseTaskList (deprecated)

+Deletes a [baseTaskList](../resources/tasklist.md) object.

+# Update baseTaskList (deprecated)

+Update the properties of a [baseTaskList](../resources/tasklist.md) object.

+# List lists (deprecated)

+# Create baseTaskList (deprecated)

+Create a new [baseTaskList](../resources/basetasklist.md) object.

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+ "categories": [

+ "Important",

+ "Urgent"

+ ],

+ Title: "List checklistItems"

+description: "Get the checklistItem resources associated to the checklistItems navigation property of a todoTask."

+ms.localizationpriority: medium

+# List checklistItems

+Namespace: microsoft.graph

+Get the [checklistItem](../resources/checklistitem.md) resources associated to the **checklistItems** navigation property of a [todoTask](../resources/todoTask.md).

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|Tasks.Read, Tasks.ReadWrite|

+|Delegated (personal Microsoft account)|Tasks.Read, Tasks.ReadWrite|

+|Application|Tasks.Read, Tasks.ReadWrite|

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+GET /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems

+GET /users/{id | userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems

+```

+## Optional query parameters

+This method does not support OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required.|

+## Request body

+Do not supply a request body for this method.

+## Response

+If successful, this method returns a `200 OK` response code and a collection of [checklistItem](../resources/checklistitem.md) objects in the response body.

+## Examples

+### Request

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "list_checklistitem"

+}

+-->

+``` http

+GET https://graph.microsoft.com/beta/me/todo/lists/AAMkADliMmU5YjJlLTVmMmQtNGQzNS1iYjA0LTdmZTA2NTI0MTE5YwAuAAAAAADdOMUbUmCfTKa7OC-fqjkdAQBnu3olF7NfToRyJ2f__TNcAAAAAAESAAA=/tasks/AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AZ7t6JRezX06Ecidn-vkzXAABPDii4gAA/checklistitems

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Objective-C](#tab/objc)

+# [Java](#tab/java)

+# [Go](#tab/go)

+### Response

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "Collection(microsoft.graph.checklistItem)"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('6f9a2a92-8527-4d64-937e-b5312852f35d')/todo/lists('AAMkADliMmU5YjJlLTVmMmQtNGQzNS1iYjA0LTdmZTA2NTI0MTE5YwAuAAAAAADdOMUbUmCfTKa7OC-fqjkdAQBnu3olF7NfToRyJ2f__TNcAAAAAAESAAA%3D')/tasks('AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AZ7t6JRezX06Ecidn-vkzXAABPDii4gAA')/checklistItems",

+ "value": [

+ {

+ "displayName": "Create draft",

+ "createdDateTime": "2021-11-17T05:22:14.2207813Z",

+ "isChecked": false,

+ "id": "51d8a471-2e9d-4f53-9937-c33a8742d28f"

+ },

+ {

+ "displayName": "Review with the team",

+ "createdDateTime": "2021-11-17T05:22:43.0916521Z",

+ "isChecked": false,

+ "id": "a7720293-4ef9-45da-9056-e000796889fa"

+ }

+ ]

+}

+```

+ Title: "Create checklistItem"

+description: "Create a new checklistItem object."

+ms.localizationpriority: medium

+# Create checklistItem

+Namespace: microsoft.graph

+Create a new [checklistItem](../resources/checklistitem.md) object as a subtask in a bigger [todoTask](../resources/todotask.md).

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|Tasks.ReadWrite|

+|Delegated (personal Microsoft account)|Tasks.ReadWrite|

+|Application|Tasks.ReadWrite|

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+POST /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems

+POST /users/{id | userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required.|

+|Content-Type|application/json. Required.|

+## Request body

+In the request body, supply a JSON representation of the [checklistItem](../resources/checklistitem.md) object.

+You can specify the following properties when creating a **checklistItem**.

+|Property|Type|Description|

+|:|:|:|

+|checkedDateTime|DateTimeOffset|The date and time when the **checklistItem** was finished.|

+|createdDateTime|DateTimeOffset|The date and time when the **checklistItem** was created.|

+|displayName|String|Field indicating the title of **checklistItem**.|

+|isChecked|Boolean|State indicating whether the item is checked off or not.|

+## Response

+If successful, this method returns a `201 Created` response code and a [checklistItem](../resources/checklistitem.md) object in the response body.

+## Examples

+### Request

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "create_checklistitem_from_"

+}

+-->

+``` http

+POST https://graph.microsoft.com/beta/me/todo/lists/AAMkADliMmU5YjJlLTVmMmQtNGQzNS1iYjA0LTdmZTA2NTI0MTE5YwAuAAAAAADdOMUbUmCfTKa7OC-fqjkdAQBnu3olF7NfToRyJ2f__TNcAAAAAAESAAA=/tasks/AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AZ7t6JRezX06Ecidn-vkzXAABPDii4gAA/checklistitems/

+Content-Type: application/json

+{

+ "displayName": "Final sign-off from the team"

+}

+```

+# [JavaScript](#tab/javascript)

+# [C#](#tab/csharp)

+# [Objective-C](#tab/objc)

+# [Java](#tab/java)

+# [Go](#tab/go)

+### Response

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.checklistItem"

+}

+-->

+``` http

+HTTP/1.1 201 Created

+Content-Type: application/json

+{

+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('6f9a2a92-8527-4d64-937e-b5312852f35d')/todo/lists('AAMkADliMmU5YjJlLTVmMmQtNGQzNS1iYjA0LTdmZTA2NTI0MTE5YwAuAAAAAADdOMUbUmCfTKa7OC-fqjkdAQBnu3olF7NfToRyJ2f__TNcAAAAAAESAAA%3D')/tasks('AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AZ7t6JRezX06Ecidn-vkzXAABPDii4gAA')/checklistItems/$entity",

+ "displayName": "Final sign-off from the team",

+ "createdDateTime": "2021-11-17T05:35:03.9736453Z",

+ "isChecked": false,

+ "id": "e3a26c2e-7c6f-4317-9d71-c27267008202"

+}

+```

+|categories|String collection|The categories associated with the task. Each category corresponds to the **displayName** property of an [outlookCategory](../resources/outlookcategory.md) that the user has defined.|

+ "categories": [],

+ "categories": [

+ "Important",

+ "Urgent"

+ ],

+|categories|String collection|The categories associated with the task. Each category corresponds to the **displayName** property of an [outlookCategory](../resources/outlookcategory.md) that the user has defined.|

+ "categories": ["Important"],

+ "categories": ["Important"],

+# user: activateServicePlan (deprecated)

+> [!CAUTION]

+> The **activateServicePlan** API is deprecated and will stop returning data on June 30, 2022.

+# activateService resource type (deprecated)

+# baseTask resource type (deprecated)

+An abstract type that represents a task, such as a piece of work or personal item, that can be tracked and completed.

+This is a base type inherited by the [task](task.md) resource.

+|[List checklistItems](../api/todotask-list-checklistitems.md)|[checklistItem](../resources/checklistitem.md) collection|Get the **checklistItem** resources from the checklistItems navigation property.|

+|[Create checklistItem](../api/todotask-post-checklistitems.md)|[checklistItem](../resources/checklistitem.md)|Create a new **checklistItem** object.|

+|checklistItems|[checklistItem](../resources/checklistitem.md) collection|A collection of smaller subtasks linked to the more complex parent task. |

+# baseTaskList resource type (deprecated)

+Contains one or more [baseTask](./basetask.md) resources.

+Represents a subtask in a bigger [todoTask](./todotask.md). **ChecklistItem** allows breaking down a complex task into more actionable, smaller tasks.

+|[List checklistItems](../api/todotask-list-checklistitems.md)|[checklistItem](../resources/checklistitem.md) collection|Get a list of the [checklistItem](../resources/checklistitem.md) objects and their properties associated to a specified [todoTask](./todotask.md).|

+|[Create checklistItem](../api/todotask-post-checklistitems.md)|[checklistItem](../resources/checklistitem.md)|Create a new [checklistItem](../resources/checklistitem.md) object associated to a specified [todoTask](./todotask.md).|

+|[List checklistItems](../api/basetask-list-checklistitems.md) (deprecated)|[checklistItem](../resources/checklistitem.md) collection|Get a list of the [checklistItem](../resources/checklistitem.md) objects and their properties associated to a specified [baseTask](./basetask.md).|

+|[Create checklistItem](../api/basetask-post-checklistitems.md) (deprecated)|[checklistItem](../resources/checklistitem.md)|Create a new [checklistItem](../resources/checklistitem.md) object associated to a specified [baseTask](./basetask.md).|

+### delegatedAdminRelationshipStatus values

+| Member | Description |

+| | |

+| created | The partner has created a new relationship. In this state, the relationship can be modified. |

+| approvalPending | The partner has finalized the relationship through the `lockForApproval` action of a [delegatedAdminRelationshipRequest](delegatedadminrelationshiprequest.md) object. |

+| approved | The customer has approved the relationship through the `approve` action of a [delegatedAdminRelationshipRequest](delegatedadminrelationshiprequest.md) object. |

+| activating | The system starts provisioning of the relationship. |

+| active | The system completes the provisioning of the relationship. |

+| expiring | The relationship has passed its expiration date. |

+| expired | The system completes the de-provisioning of the relationship. |

+| terminationRequested | The partner or customer has requested termination of the relationship through the `terminate` action of a [delegatedAdminRelationshipRequest](delegatedadminrelationshiprequest.md) object. |

+| terminating | The system starts de-provisioning the relationship. |

+| terminated | The system has completed de-provisioning the relationship. |

+| unknownFutureValue | Evolvable enumeration sentinel value. Do not use. |

+|status|longRunningOperationStatus|The status of the operation. Read-only. The possible values are: `notStarted`, `running`, `succeeded`, `failed`, `unknownFutureValue`. Read-only. Supports `$orderBy`.|

+|status|delegatedAdminRelationshipRequestStatus|The status of the request. Read-only. The possible values are: `created`, `pending`, `succeeded`, `failed`, `unknownFutureValue`.|

+ Title: "Granular delegated admin privileges (GDAP) API overview"

+# Granular delegated admin privileges (GDAP) API overview

+## GDAP Workflow

+### GDAP Relationship Status Transition

+The status of the Delegated Admin relationship transitions as follows:

+

+1. [Create delegatedAdminRelationship](../api/tenantrelationship-post-delegatedadminrelationships.md)

+2. [Update delegatedAdminRelationship](../api/delegatedadminrelationship-update.md)

+3. [Create delegatedAdminRelationshipRequest](../api/delegatedadminrelationship-post-requests.md) (action: lockForApproval)

+4. [Create delegatedAdminRelationshipRequest](../api/delegatedadminrelationship-post-requests.md) (action: terminate)

+### GDAP Relationship Access Assignment Status Transition

+The status of the Delegated Admin access assignment. The status transitions are as follows:

+

+1. [Create delegatedAdminAccessAssignment](../api/delegatedadminrelationship-post-accessassignments.md)

+2. [Delete delegatedAdminAccessAssignment](../api/delegatedadminaccessassignment-delete.md)

+|succeeded|

+# linkedResource_v2 resource type (deprecated)

+| [Base task (deprecated)](basetask.md) | Beta |

+| [Base task list (deprecated)](basetasklist.md) | Beta |

+| [To-do task](todotask.md) | GA |

+| [To-do task list](todotasklist.md) | GA |

+|[Create](../api/opentypeextension-post-opentypeextension.md) | [openTypeExtension](opentypeextension.md)(in an existing resource instance), or a new [baseTask](basetask.md), [baseTaskList](basetasklist.md)[contact](contact.md), [event](event.md), [message](message.md), [post](post.md), [todoTask](todotask.md), or [todoTaskList](todotasklist.md) that contains an openTypeExtension object. | Create an openTypeExtension object in an existing or new resource instance.|

+|[activateService](../api/organization-activateservice.md) (deprecated) | None | Activate a service for an organization. |

+Resources that can be assigned categories include [contact](contact.md), [event](event.md), [message](message.md), [outlookTask](outlooktask.md), [post](post.md), and [todoTask](todotask.md).

+|[Delete](../api/plannerplan-delete.md) | None | Delete **plannerPlan** object. |

+|[Confirm compromised](../api/signin-confirmcompromised.md)|None|Mark an event in the Azure AD sign in logs as risky.|

+|[Confirm safe](../api/signin-confirmsafe.md)|None|mark an event in Azure AD sign in logs as safe.|

+- A [baseTask][] (deprecated) of a user in Microsoft To Do.*

+- A [todoTask][] of a user in Microsoft To Do.

+| **todoTask** | 4230 minutes (under 3 days) |

+| **baseTask** (deprecated) | 4230 minutes (under 3 days) |

+[todoTask]: ./todotask.md

+[baseTask]: ./basetask.md

+# task resource type (deprecated)

+Represents a task, such as a piece of work or personal item, that can be tracked and completed. A **task** is always contained in a [base task list](basetasklist.md).

+|[List checklistItems](../api/todotask-list-checklistitems.md)|[checklistItem](../resources/checklistitem.md) collection|Get the checklistItem resources from the checklistItems navigation property.|

+|[Create checklistItem](../api/todotask-post-checklistitems.md)|[checklistItem](../resources/checklistitem.md)|Create a new checklistItem object.|

+# taskList resource type (deprecated)

+Represents a list created by a user in Microsoft To Do that contains one or more [task](./task.md) resources.

+This resource supports the following:

+The **taskList** resource inherits from [baseTaskList](../resources/basetasklist.md).

+Its contents, of the **task** resource type, inherit from [baseTask](../resources/basetask.md).

+# Use the To Do API built on base tasks in Microsoft Graph (deprecated)

+In this API set, a task list is represented by [baseTaskList](./basetasklist.md) which is a logical container of [baseTask](./basetask.md) resources. You can currently create tasks only in a task list. Tasks created without specifying list get created in the default Tasks list. To [get all your task lists](../api/basetasklist-get.md), make the following HTTP request:

+In this API set, a task is represented by a [baseTask](./basetask.md) resource which is a piece of work or personal item that can be tracked and completed. To get your tasks from a task list, make the following HTTP request:

+* [baseTask](./basetask.md) collection in a task list

+* [baseTaskList](./basetasklist.md)

+description: "You can use the Microsoft Graph API built on todoTask to create an app that connects with tasks in Microsoft To Do."

+Use the Microsoft Graph To Do API built on [todoTask](todotask.md) to create an app that connects with tasks across Microsoft To Do clients. Build a variety of experiences with tasks, such as the following:

+

+In this API set, a task list is represented by [todoTaskList](./todotasklist.md) which is a logical container of [todoTask](./todotask.md) resources. You can currently create tasks only in a task list. To [get all your task lists](../api/todotasklist-get.md), make the following HTTP request:

+In this API set, a task is represented by a [todoTask](./todotask.md) resource which is a piece of work or personal item that can be tracked and completed. To get your tasks from a task list, make the following HTTP request:

+## Checklist item

+A [checklistItem](checklistitem.md) represents a subtask in a bigger [todoTask](./todotask.md). **ChecklistItem** allows breaking down a complex task into more actionable, smaller tasks. To get a **checklistItem** from a task, make the following HTTP request:

+``` http

+GET /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItems}

+```

+|[List checklistItems](../api/todotask-list-checklistitems.md)|[checklistItem](../resources/checklistitem.md) collection|Get the **checklistItem** resources from the checklistItems navigation property.|

+|[Create checklistItem](../api/todotask-post-checklistitems.md)|[checklistItem](../resources/checklistitem.md)|Create a new **checklistItem** object.|

+|categories|String collection|The categories associated with the task. Each category corresponds to the **displayName** property of an [outlookCategory](../resources/outlookcategory.md) that the user has defined.|

+|checklistItems|[checklistItem](../resources/checklistitem.md) collection|A collection of smaller subtasks linked to the more complex parent task. |

+ "categories": ["string"],

+| [activateServicePlan](../api/user-activateserviceplan.md) (deprecated) | None | Activate a service with a given `servicePlanId` and `skuId` for a given [user](user.md). |

+| To Do [baseTask][] (deprecated) | Changes to all task in a specific task list:<br>`/me/tasks/lists/{baseTaskListId}/tasks`<br>Changes to all tasks:<br>`/me/tasks/lists/alltasks` | No |

+| [To Do task][] | Changes to all task in a specific task list:<br>`/me/todo/lists/{todoTaskListId}/tasks`<br>Changes to all tasks:<br>`/me/todo/lists/alltasks` | No |

+| Delegated - work or school account | [alert][], [baseTask][] (deprecated), [channel][], [chat][], [contact][], [conversation][], [conversationMember][], [driveItem][], [list][], [event][], [group][], [message][], [user][], [presence][], [chatMessage][] (preview), [team][], [todoTask][] |

+| Delegated - personal Microsoft account | [baseTask][] (deprecated), [contact][], [driveItem][], [list][], [event][], [message][], [todoTask][] |

+[todoTask]: ./todotask.md

+[To Do task]: ./todotask.md

+# wellKnownTaskList resource type (deprecated)

+ Title: "Delete checklistItem"

+description: "Delete a checklistItem object."

+ms.localizationpriority: medium

+# Delete checklistItem

+Namespace: microsoft.graph

+Delete a [checklistItem](../resources/checklistitem.md) object.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|Tasks.ReadWrite|

+|Delegated (personal Microsoft account)|Tasks.ReadWrite|

+|Application|Tasks.ReadWrite|

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+DELETE /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}

+DELETE /users/{id | userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required.|

+## Request body

+Do not supply a request body for this method.

+## Response

+If successful, this method returns a `204 No Content` response code.

+## Examples

+### Request

+<!-- {

+ "blockType": "request",

+ "name": "delete_checklistitem"

+}

+-->

+``` http

+DELETE https://graph.microsoft.com/v1.0/me/todo/lists/AAMkADliMmU5YjJlLTVmMmQtNGQzNS1iYjA0LTdmZTA2NTI0MTE5YwAuAAAAAADdOMUbUmCfTKa7OC-fqjkdAQBnu3olF7NfToRyJ2f__TNcAAAAAAESAAA=/tasks/AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AZ7t6JRezX06Ecidn-vkzXAABPDii4gAA/checklistitems/e3a26c2e-7c6f-4317-9d71-c27267008202

+```

+### Response

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true

+}

+-->

+``` http

+HTTP/1.1 204 No Content

+```

+ Title: "Get checklistItem"

+description: "Read the properties and relationships of a checklistItem object."

+ms.localizationpriority: medium

+# Get checklistItem

+Namespace: microsoft.graph

+Read the properties and relationships of a [checklistItem](../resources/checklistitem.md) object.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|Tasks.Read, Tasks.ReadWrite|

+|Delegated (personal Microsoft account)|Tasks.Read, Tasks.ReadWrite|

+|Application|Tasks.Read, Tasks.ReadWrite|

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+GET /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}

+GET /users/{id | userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}

+```

+## Optional query parameters

+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required.|

+## Request body

+Do not supply a request body for this method.

+## Response

+If successful, this method returns a `200 OK` response code and a [checklistItem](../resources/checklistitem.md) object in the response body.

+## Examples

+### Request

+<!-- {

+ "blockType": "request",

+ "name": "get_checklistitem"

+}

+-->

+``` http

+GET https://graph.microsoft.com/v1.0/me/todo/lists/AAMkADliMmU5YjJlLTVmMmQtNGQzNS1iYjA0LTdmZTA2NTI0MTE5YwAuAAAAAADdOMUbUmCfTKa7OC-fqjkdAQBnu3olF7NfToRyJ2f__TNcAAAAAAESAAA=/tasks/AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AZ7t6JRezX06Ecidn-vkzXAABPDii4gAA/checklistitems/51d8a471-2e9d-4f53-9937-c33a8742d28f

+```

+### Response

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.checklistItem"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('6f9a2a92-8527-4d64-937e-b5312852f35d')/todo/lists('AAMkADliMmU5YjJlLTVmMmQtNGQzNS1iYjA0LTdmZTA2NTI0MTE5YwAuAAAAAADdOMUbUmCfTKa7OC-fqjkdAQBnu3olF7NfToRyJ2f__TNcAAAAAAESAAA%3D')/tasks('AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AZ7t6JRezX06Ecidn-vkzXAABPDii4gAA')/checklistItems/$entity",

+ "displayName": "Create draft",

+ "createdDateTime": "2021-11-17T05:22:14.2207813Z",

+ "isChecked": false,

+ "id": "51d8a471-2e9d-4f53-9937-c33a8742d28f"

+}

+```

+ Title: "Update checklistItem"

+description: "Update the properties of a checklistItem object."

+ms.localizationpriority: medium

+# Update checklistItem

+Namespace: microsoft.graph

+Update the properties of a [checklistItem](../resources/checklistitem.md) object.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|Tasks.ReadWrite|

+|Delegated (personal Microsoft account)|Tasks.ReadWrite|

+|Application|Tasks.ReadWrite|

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+PATCH /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}

+PATCH /users/{id | userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required.|

+|Content-Type|application/json. Required.|

+## Request body

+|Property|Type|Description|

+|:|:|:|

+|checkedDateTime|DateTimeOffset|The date and time when the **checklistItem** was finished.|

+|createdDateTime|DateTimeOffset|The date and time when the **checklistItem** was created.|

+|displayName|String|Field indicating the title of **checklistItem**.|

+|isChecked|Boolean|State indicating whether the item is checked off or not.|

+## Response

+If successful, this method returns a `200 OK` response code and an updated [checklistItem](../resources/checklistitem.md) object in the response body.

+## Examples

+### Request

+<!-- {

+ "blockType": "request",

+ "name": "update_checklistitem"

+}

+-->

+``` http

+PATCH https://graph.microsoft.com/v1.0/me/todo/lists/AAMkADliMmU5YjJlLTVmMmQtNGQzNS1iYjA0LTdmZTA2NTI0MTE5YwAuAAAAAADdOMUbUmCfTKa7OC-fqjkdAQBnu3olF7NfToRyJ2f__TNcAAAAAAESAAA=/tasks/AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AZ7t6JRezX06Ecidn-vkzXAABPDii4gAA/checklistitems/e3a26c2e-7c6f-4317-9d71-c27267008202

+Content-Type: application/json

+{

+ "displayName": "buy cake"

+}

+```

+### Response

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.checklistItem"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('6f9a2a92-8527-4d64-937e-b5312852f35d')/todo/lists('AAMkADliMmU5YjJlLTVmMmQtNGQzNS1iYjA0LTdmZTA2NTI0MTE5YwAuAAAAAADdOMUbUmCfTKa7OC-fqjkdAQBnu3olF7NfToRyJ2f__TNcAAAAAAESAAA%3D')/tasks('AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AZ7t6JRezX06Ecidn-vkzXAABPDii4gAA')/checklistItems/$entity",

+ "displayName": "buy cake",

+ "createdDateTime": "2021-11-17T05:35:03Z",

+ "isChecked": false,

+ "id": "e3a26c2e-7c6f-4317-9d71-c27267008202"

+}

+```

+description: "Remove an existing educationCategory from this educationAssignment."

+|reviewSettings|[accessPackageAssignmentReviewSettings](../resources/accesspackageassignmentreviewsettings.md)|Settings for access reviews of assignments through this policy.|

+The following example shows a more complex policy with two stages of approval and recurring access reviews.

+ "reviewSettings": {

+ "isEnabled": true,

+ "expirationBehavior": "keepAccess",

+ "isRecommendationEnabled": true,

+ "isReviewerJustificationRequired": true,

+ "isSelfReview": false,

+ "schedule": {

+ "startDateTime": "2022-07-02T06:59:59.998Z",

+ "expiration": {

+ "duration": "P14D",

+ "type": "afterDuration"

+ },

+ "recurrence": {

+ "pattern": {

+ "type": "absoluteMonthly",

+ "interval": 3,

+ "month": 0,

+ "dayOfMonth": 0,

+ "daysOfWeek": []

+ },

+ "range": {

+ "type": "noEnd",

+ "numberOfOccurrences": 0

+ }

+ }

+ },

+ "primaryReviewers": [

+ {

+ "@odata.type": "#microsoft.graph.groupMembers",

+ "groupId": "1623f912-5e86-41c2-af47-39dd67582b66"

+ }

+ ],

+ "fallbackReviewers": []

+ },

+```msgraph-interactive

+| [todoTask](../resources/todotask.md) | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |

+| [todoTasklist](../resources/todotasklist.md) | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |

+|Get a specific extension from a known resource instance.| [Device](../resources/device.md), [event](../resources/event.md), [group](../resources/group.md), [group event](../resources/event.md), [group post](../resources/post.md), [message](../resources/message.md), [organization](../resources/organization.md), [personal contact](../resources/contact.md), [user](../resources/user.md), [todoTask](../resources/todotask.md), [todoTaskList](../resources/todotasklist.md). | Open extension only.|

+|Get a known resource instance expanded with a specific extension.|Device, event, group, group event, group post, message, organization, personal contact, user, todoTask, todoTaskList. |A resource instance expanded with the open extension.|

+| [todoTask](../resources/todotask.md) | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |

+| [todoTaskList](../resources/todotasklist.md) | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |

+```http

+| [todoTask](../resources/todotask.md) | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |

+| [todoTaskList](../resources/todotasklist.md) | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |

+| [todoTask](../resources/todotask.md) | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |

+| [todoTaskList](../resources/todotasklist.md) | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |

+|[todoTask](../resources/todotask.md) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |

+|[todoTask](../resources/todotask.md) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |

+|[todoTask](../resources/todotask.md) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |

+|[todoTask](../resources/todotask.md) | `/me/todo/lists/{todoTaskListId}/tasks`|

+|[todoTask](../resources/todotask.md) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |

+ "categories": [

+ "Important",

+ "Urgent"

+ ],

+ Title: "List checklistItems"

+description: "Get the checklistItem resources associated to a todoTask from the checklistItems navigation property."

+ms.localizationpriority: medium

+# List checklistItems

+Namespace: microsoft.graph

+Get the [checklistItem](../resources/checklistitem.md) resources associated to a [todoTask](../resources/todoTask.md) from the checklistItems navigation property.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|Tasks.Read, Tasks.ReadWrite|

+|Delegated (personal Microsoft account)|Tasks.Read, Tasks.ReadWrite|

+|Application|Tasks.Read, Tasks.ReadWrite|

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+GET /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems

+GET /users/{id | userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems

+```

+## Optional query parameters

+This method does not support OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required.|

+## Request body

+Do not supply a request body for this method.

+## Response

+If successful, this method returns a `200 OK` response code and a collection of [checklistItem](../resources/checklistitem.md) objects in the response body.

+## Examples

+### Request

+<!-- {

+ "blockType": "request",

+ "name": "list_checklistitem"

+}

+-->

+``` http

+GET https://graph.microsoft.com/v1.0/me/todo/lists/AAMkADliMmU5YjJlLTVmMmQtNGQzNS1iYjA0LTdmZTA2NTI0MTE5YwAuAAAAAADdOMUbUmCfTKa7OC-fqjkdAQBnu3olF7NfToRyJ2f__TNcAAAAAAESAAA=/tasks/AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AZ7t6JRezX06Ecidn-vkzXAABPDii4gAA/checklistitems

+```

+### Response

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "Collection(microsoft.graph.checklistItem)"

+}

+-->

+``` http

+HTTP/1.1 200 OK

+Content-Type: application/json

+{

+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('6f9a2a92-8527-4d64-937e-b5312852f35d')/todo/lists('AAMkADliMmU5YjJlLTVmMmQtNGQzNS1iYjA0LTdmZTA2NTI0MTE5YwAuAAAAAADdOMUbUmCfTKa7OC-fqjkdAQBnu3olF7NfToRyJ2f__TNcAAAAAAESAAA%3D')/tasks('AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AZ7t6JRezX06Ecidn-vkzXAABPDii4gAA')/checklistItems",

+ "value": [

+ {

+ "displayName": "Create draft",

+ "createdDateTime": "2021-11-17T05:22:14.2207813Z",

+ "isChecked": false,

+ "id": "51d8a471-2e9d-4f53-9937-c33a8742d28f"

+ },

+ {

+ "displayName": "Review with the team",

+ "createdDateTime": "2021-11-17T05:22:43.0916521Z",

+ "isChecked": false,

+ "id": "a7720293-4ef9-45da-9056-e000796889fa"

+ }

+ ]

+}

+```

+ Title: "Create checklistItem"

+description: "Create a new checklistItem object."

+ms.localizationpriority: medium

+# Create checklistItem

+Namespace: microsoft.graph

+Create a new [checklistItem](../resources/checklistitem.md) object.

+## Permissions

+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

+|Permission type|Permissions (from least to most privileged)|

+|:|:|

+|Delegated (work or school account)|Tasks.ReadWrite|

+|Delegated (personal Microsoft account)|Tasks.ReadWrite|

+|Application|Tasks.ReadWrite|

+## HTTP request

+<!-- {

+ "blockType": "ignored"

+}

+-->

+``` http

+POST /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems

+POST /users/{id | userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems

+```

+## Request headers

+|Name|Description|

+|:|:|

+|Authorization|Bearer {token}. Required.|

+|Content-Type|application/json. Required.|

+## Request body

+In the request body, supply a JSON representation of the [checklistItem](../resources/checklistitem.md) object.

+You can specify the following properties when creating a **checklistItem**.

+|Property|Type|Description|

+|:|:|:|

+|checkedDateTime|DateTimeOffset|The date and time when the **checklistItem** was finished.|

+|createdDateTime|DateTimeOffset|The date and time when the **checklistItem** was created.|

+|displayName|String|Field indicating the title of **checklistItem**.|

+|isChecked|Boolean|State indicating whether the item is checked off or not.|

+## Response

+If successful, this method returns a `201 Created` response code and a [checklistItem](../resources/checklistitem.md) object in the response body.

+## Examples

+### Request

+<!-- {

+ "blockType": "request",

+ "name": "create_checklistitem_from_"

+}

+-->

+``` http

+POST https://graph.microsoft.com/v1.0/me/todo/lists/AAMkADliMmU5YjJlLTVmMmQtNGQzNS1iYjA0LTdmZTA2NTI0MTE5YwAuAAAAAADdOMUbUmCfTKa7OC-fqjkdAQBnu3olF7NfToRyJ2f__TNcAAAAAAESAAA=/tasks/AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AZ7t6JRezX06Ecidn-vkzXAABPDii4gAA/checklistitems/

+Content-Type: application/json

+{

+ "displayName": "Final sign-off from the team"

+}

+```

+### Response

+>**Note:** The response object shown here might be shortened for readability.

+<!-- {

+ "blockType": "response",

+ "truncated": true,

+ "@odata.type": "microsoft.graph.checklistItem"

+}

+-->

+``` http

+HTTP/1.1 201 Created

+Content-Type: application/json

+{

+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('6f9a2a92-8527-4d64-937e-b5312852f35d')/todo/lists('AAMkADliMmU5YjJlLTVmMmQtNGQzNS1iYjA0LTdmZTA2NTI0MTE5YwAuAAAAAADdOMUbUmCfTKa7OC-fqjkdAQBnu3olF7NfToRyJ2f__TNcAAAAAAESAAA%3D')/tasks('AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AZ7t6JRezX06Ecidn-vkzXAABPDii4gAA')/checklistItems/$entity",

+ "displayName": "Final sign-off from the team",

+ "createdDateTime": "2021-11-17T05:35:03.9736453Z",

+ "isChecked": false,

+ "id": "e3a26c2e-7c6f-4317-9d71-c27267008202"

+}

+```

+|categories|String collection|The categories associated with the task. Each category corresponds to the **displayName** property of an [outlookCategory](../resources/outlookcategory.md) that the user has defined.|

+ "categories": [],

+ "categories": [

+ "Important",

+ "Urgent"

+ ],

+|categories|String collection|The categories associated with the task. Each category corresponds to the **displayName** property of an [outlookCategory](../resources/outlookcategory.md) that the user has defined.|

+ "categories": ["Important"],

+ "categories": ["Important"],

+|Software token | Allow users to perform multifactor authentication using an application that supports the OAUTH specification and provides a one-time code. | Get and delete a software token assigned to a user.|

+ Title: "checklistItem resource type"

+description: "Represents a collection of checklist items on a task"

+ms.localizationpriority: medium

+# checklistItem resource type

+Namespace: microsoft.graph

+Represents a subtask in a bigger [todoTask](./todotask.md). **ChecklistItem** allows breaking down a complex task into more actionable, smaller tasks.

+## Methods

+|Method|Return type|Description|

+|:|:|:|

+|[List checklistItems](../api/todotask-list-checklistitems.md)|[checklistItem](../resources/checklistitem.md) collection|Get a list of the [checklistItem](../resources/checklistitem.md) objects and their properties.|

+|[Create checklistItem](../api/todotask-post-checklistitems.md)|[checklistItem](../resources/checklistitem.md)|Create a new [checklistItem](../resources/checklistitem.md) object.|

+|[Get checklistItem](../api/checklistitem-get.md)|[checklistItem](../resources/checklistitem.md)|Read the properties and relationships of a [checklistItem](../resources/checklistitem.md) object.|

+|[Update checklistItem](../api/checklistitem-update.md)|[checklistItem](../resources/checklistitem.md)|Update the properties of a [checklistItem](../resources/checklistitem.md) object.|

+|[Delete checklistItem](../api/checklistitem-delete.md)|None|Deletes a [checklistItem](../resources/checklistitem.md) object.|

+## Properties

+|Property|Type|Description|

+|:|:|:|

+|checkedDateTime|DateTimeOffset|The date and time when the **checklistItem** was finished.|

+|createdDateTime|DateTimeOffset|The date and time when the **checklistItem** was created.|

+|displayName|String|Field indicating the title of **checklistItem**.|

+|id|String|Server generated ID for the **checkListItem**|

+|isChecked|Boolean|State indicating whether the item is checked off or not.|

+## Relationships

+None.

+## JSON representation

+The following is a JSON representation of the resource.

+<!-- {

+ "blockType": "resource",

+ "keyProperty": "id",

+ "@odata.type": "microsoft.graph.checklistItem",

+ "openType": false

+}

+-->

+``` json

+{

+ "@odata.type": "#microsoft.graph.checklistItem",

+ "displayName": "String",

+ "createdDateTime": "String (timestamp)",

+ "checkedDateTime": "String (timestamp)",

+ "isChecked": "Boolean",

+ "id": "String (identifier)"

+}

+```

+| [To-do task](todotask.md) | GA |

+| [To-do task list](todotasklist.md) | GA |

+Resources that can be assigned categories include [contact](contact.md), [event](event.md), [message](message.md), [post](post.md), and [todoTask](todotask.md).

+|[Delete](../api/plannerplan-delete.md) | None | Delete **plannerPlan** object. |

+- A [todoTask][] of a user in Microsoft To Do.*

+| **todoTask** | 4230 minutes (under 3 days) |

+[todoTask]: ./todotask.md

+

+## Checklist item

+A [checklistItem](checklistitem.md) represents a subtask in a bigger [todoTask](./todotask.md). **ChecklistItem** allows breaking down a complex task into more actionable, smaller tasks. To get a **checklistItem** from a task, make the following HTTP request:

+``` http

+GET /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItems}

+```

+|[List checklistItems](../api/todotask-list-checklistitems.md)|[checklistItem](../resources/checklistitem.md) collection|Get the **checklistItem** resources from the checklistItems navigation property.|

+|[Create checklistItem](../api/todotask-post-checklistitems.md)|[checklistItem](../resources/checklistitem.md)|Create a new **checklistItem** object.|

+|categories|String collection|The categories associated with the task. Each category corresponds to the **displayName** property of an [outlookCategory](../resources/outlookcategory.md) that the user has defined.|

+|checklistItems|[checklistItem](../resources/checklistitem.md) collection|A collection of checklistItems linked to a task. |

+ "categories": ["string"],

+| [To Do task][] | Changes to all task in a specific task list:<br>`/me/todo/lists/{todoTaskListId}/tasks`<br>Changes to all tasks:<br>`/me/todo/lists/alltasks` | No |

+| Delegated - work or school account | [alert][], [contact][], [conversation][], [driveItem][], [list][], [event][], [group][], [message][], [todoTask][], [user][]|

+| Delegated - personal Microsoft account | [contact][], [driveItem][], [list][], [event][], [message][], [todoTask][] |

+[To Do task]: ./todotask.md

+[todoTask]: ./todotask.md

+ - name: Delete plan

+ href: api/plannerplan-delete.md

+ - name: Checklist item

+ href: resources/checklistitem.md

+ items:

+ - name: List

+ href: api/todotask-list-checklistitems.md

+ - name: Create

+ href: api/todotask-post-checklistitems.md

+ - name: Get

+ href: api/checklistitem-get.md

+ - name: Update

+ href: api/checklistitem-update.md

+ - name: Delete

+ href: api/checklistitem-delete.md