ESC
Type to search...
↑↓ Navigate ↵ Open ESC Close

Tasks.ReadWrite

Export JSON
Export CSV
Copy URL
Print
Delegated Read/Write User Scope

Allows the app to create, read, update, and delete the signed-in user's tasks and task lists, including any shared with the user.

Permission data: April 6, 2026 at 4:06 AM UTC
Delegated Access App-Only Access

Permission Details

Delegated Permission User consent allowed

Create, read, update, and delete user’s tasks and task lists

Allows the app to create, read, update, and delete the signed-in user's tasks and task lists, including any shared with the user.

User sees: Allows the app to create, read, update, and delete your tasks and task lists, including any shared with you.
Permission ID: 2219042f-cab5-40cc-b0d2-16b1540b4c5f

Properties

Microsoft Graph beta exact-category-docs

Properties is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.

Property Type Description
attachments attachmentBase collection A collection of file attachments for the task.
attachmentSessions attachmentSession collection
body object The task body that typically contains information about the task.
bodyLastModifiedDateTime date-time The date and time when the task body was last modified. By default, it is in UTC. You can provide a custom time zone in the request header. The property value uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2020 would look like this: '2020-01-01T00:00:00Z'.
categories string collection The categories associated with the task. Each category corresponds to the displayName property of an outlookCategory that the user has defined.
checklistItems checklistItem collection A collection of checklistItems linked to a task.
completedDateTime object The date and time in the specified time zone that the task was finished.
createdDateTime date-time The date and time when the task was created. By default, it is in UTC. You can provide a custom time zone in the request header. The property value uses ISO 8601 format. For example, midnight UTC on Jan 1, 2020 would look like this: '2020-01-01T00:00:00Z'.
dueDateTime object The date and time in the specified time zone that the task is to be finished.
extensions extension collection The collection of open extensions defined for the task. Nullable.
hasAttachments booleanNullable Indicates whether the task has attachments.
id string The unique identifier for an entity. Read-only.
importance importance
isReminderOn boolean Set to true if an alert is set to remind the user of the task.
lastModifiedDateTime date-time The date and time when the task was last modified. By default, it is in UTC. You can provide a custom time zone in the request header. The property value uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2020 would look like this: '2020-01-01T00:00:00Z'.

Showing 15 of 21 properties.

JSON Representation

Microsoft Graph beta exact-category-docs

JSON representation is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.

JSON representation 
{
  "@odata.type": "#microsoft.graph.tasks",
  "id": "String (identifier)"
}

Relationships

Microsoft Graph beta exact-category-docs

Relationships is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.

Relationship Type Description
alltasks baseTask collection All tasks in the users mailbox.
lists baseTaskList collection The task lists in the users mailbox.
linkedResources linkedResource collection Resources linked to the task.
checklistItems checklistItem collection Checklist items linked to the task.
attachments attachmentBase collection Attachments linked to the task.
attachmentSessions attachmentSession collection Related attachmentSessions data exposed by this resource.
categories string collection The categories associated with the task. Each category corresponds to the displayName property of an outlookCategory that the user has defined.
extensions extension collection The collection of open extensions defined for the task. Nullable.
importance importance Related importance data exposed by this resource.
status taskStatus Related status data exposed by this resource.
singleValueExtendedProperties singleValueExtendedProperty collection A collection of custom fields linked to the task.

Graph Methods

Delegated access App-only access
Exact Microsoft Learn match

Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET /drive/root/createdByUser/planner/plans
GET /groups/{group-id}/planner/plans
GET /me/planner/plans
GET /me/planner/tasks
GET /me/todo/lists
GET /me/todo/lists/{id}/tasks/{id}/attachments/{id}
GET /me/todo/lists/{id}/tasks/{id}/attachments/{id}/$value
GET /me/todo/lists/{id}/tasks/delta
GET /me/todo/lists/{todoTaskListId}
GET /me/todo/lists/{todoTaskListId}/tasks
GET /me/todo/lists/{todoTaskListId}/tasks/{taskId}
GET /me/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources
GET /me/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources/{linkedResourcesId}
GET /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/attachments
GET /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems
GET /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}
GET /me/todo/lists/delta
GET /planner/buckets
GET /planner/buckets/{id}
GET /planner/buckets/{id}/tasks
GET /planner/plans
GET /planner/plans/{id}/details
GET /planner/plans/{plan-id}
GET /planner/plans/{plan-id}/buckets
GET /planner/plans/{plan-id}/tasks
GET /planner/tasks
GET /planner/tasks/{id}
GET /planner/tasks/{id}/assignedToTaskBoardFormat
GET /planner/tasks/{id}/bucketTaskBoardFormat
GET /planner/tasks/{id}/details
GET /planner/tasks/{id}/progressTaskBoardFormat
GET /users/{id | userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems
GET /users/{id | userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}
GET /users/{id}/planner/plans
GET /users/{id}/planner/tasks
GET /users/{id}/todo/lists/{id}/tasks/{id}/attachments
GET /users/{id}/todo/lists/{id}/tasks/{id}/attachments/{id}
GET /users/{id}/todo/lists/{id}/tasks/{id}/attachments/{id}/$value
GET /users/{id|userPrincipalName}/todo/lists
GET /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}
GET /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks
GET /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{taskId}
GET /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources
GET /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources/{linkedResourcesId}
GET /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/delta
GET /users/{id|userPrincipalName}/todo/lists/delta
POST /me/todo/lists
POST /me/todo/lists/{id}/tasks/{id}/attachments
POST /me/todo/lists/{id}/tasks/{id}/attachments/createUploadSession
POST /me/todo/lists/{todoTaskListId}/tasks
POST /me/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources
POST /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems
POST /planner/buckets
POST /planner/plans
POST /planner/tasks
POST /users/{id | userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems
POST /users/{id}/todo/lists/{id}/tasks/{id}/attachments
POST /users/{id}/todo/lists/{id}/tasks/{id}/attachments/createUploadSession
POST /users/{id|userPrincipalName}/todo/lists
POST /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks
POST /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources
PATCH /me/todo/lists/{todoTaskListId}
PATCH /me/todo/lists/{todoTaskListId}/tasks/{taskId}
PATCH /me/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources/{linkedResourcesId}
PATCH /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}
PATCH /planner/buckets/{id}
PATCH /planner/plans/{id}/details
PATCH /planner/plans/{plan-id}
PATCH /planner/tasks/{id}
PATCH /planner/tasks/{id}/assignedToTaskBoardFormat
PATCH /planner/tasks/{id}/bucketTaskBoardFormat
PATCH /planner/tasks/{id}/details
PATCH /planner/tasks/{id}/progressTaskBoardFormat
PATCH /users/{id | userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}
PATCH /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks
PATCH /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{taskId}
PATCH /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources/{linkedResourcesId}
DELETE /me/todo/lists/{id}/tasks/{id}/attachments/{id}
DELETE /me/todo/lists/{todoTaskListId}
DELETE /me/todo/lists/{todoTaskListId}/tasks/{taskId}
DELETE /me/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources/{linkedResourcesId}
DELETE /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}
DELETE /planner/buckets/{id}
DELETE /planner/plans/{id}
DELETE /planner/tasks/{id}
DELETE /users/{id | userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}
DELETE /users/{id}/todo/lists/{id}/tasks/{id}/attachments/{id}
DELETE /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}
DELETE /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{taskId}
DELETE /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources/{linkedResourcesId}
Exact Microsoft Learn match

Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET /drive/root/createdByUser/planner/plans
GET /groups/{group-id}/planner/plans
GET /me/planner
GET /me/planner/all/delta
GET /me/planner/favoritePlans
GET /me/planner/myDayTasks
GET /me/planner/plans
GET /me/planner/recentPlans
GET /me/planner/tasks
GET /me/tasks/alltasks/{baseTaskId}
GET /me/tasks/lists
GET /me/tasks/lists/{baseTaskListId}/tasks
GET /me/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}
GET /me/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}/checklistItems
GET /me/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}/checklistItems/{checklistItemId}
GET /me/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}/linkedResources
GET /me/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}/linkedResources/{linkedResourceId}
GET /me/tasks/lists/{baseTaskListId}/tasks/delta
GET /me/tasks/lists/delta
GET /me/todo/lists
GET /me/todo/lists/{id}/tasks/{id}/attachments/{id}
GET /me/todo/lists/{id}/tasks/{id}/attachments/{id}/$value
GET /me/todo/lists/{id}/tasks/delta
GET /me/todo/lists/{todoTaskListId}
GET /me/todo/lists/{todoTaskListId}/tasks
GET /me/todo/lists/{todoTaskListId}/tasks/{taskId}
GET /me/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources
GET /me/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources/{linkedResourcesId}
GET /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/attachments
GET /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems
GET /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}
GET /me/todo/lists/delta
GET /planner/buckets
GET /planner/buckets/{id}
GET /planner/buckets/{id}/tasks
GET /planner/plans
GET /planner/plans/{id}/details
GET /planner/plans/{plan-id}
GET /planner/plans/{plan-id}/buckets
GET /planner/plans/{plan-id}/tasks
GET /planner/rosters/{plannerRosterId}
GET /planner/rosters/{plannerRosterId}/members
GET /planner/rosters/{plannerRosterId}/members/{plannerRosterMemberId}
GET /planner/rosters/{plannerRosterId}/plans
GET /planner/tasks
GET /planner/tasks/{id}
GET /planner/tasks/{id}/assignedToTaskBoardFormat
GET /planner/tasks/{id}/bucketTaskBoardFormat
GET /planner/tasks/{id}/details
GET /planner/tasks/{id}/progressTaskBoardFormat
GET /teams/{team-id}/channels/{channel-id}/planner/plans
GET /users/{id | userPrincipalName}/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}/checklistItems
GET /users/{id | userPrincipalName}/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}/checklistItems/{checklistItemId}
GET /users/{id | userPrincipalName}/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}/linkedResources
GET /users/{id | userPrincipalName}/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}/linkedResources/{linkedResourceId}
GET /users/{id | userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems
GET /users/{id | userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}
GET /users/{id}/planner
GET /users/{id}/planner/all/delta
GET /users/{id}/planner/favoritePlans
GET /users/{id}/planner/myDayTasks
GET /users/{id}/planner/plans
GET /users/{id}/planner/recentPlans
GET /users/{id}/planner/tasks
GET /users/{id}/todo/lists/{id}/tasks/{id}/attachments
GET /users/{id}/todo/lists/{id}/tasks/{id}/attachments/{id}
GET /users/{id}/todo/lists/{id}/tasks/{id}/attachments/{id}/$value
GET /users/{id|userPrincipalName}/todo/lists
GET /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}
GET /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks
GET /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{taskId}
GET /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources
GET /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources/{linkedResourcesId}
GET /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/delta
GET /users/{id|userPrincipalName}/todo/lists/delta
GET /users/{userId|userPrincipalName}/tasks/alltasks/{baseTaskId}
GET /users/{userId|userPrincipalName}/tasks/lists
GET /users/{userId|userPrincipalName}/tasks/lists/{baseTaskListId}/tasks
GET /users/{userId|userPrincipalName}/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}
GET /users/{userId|userPrincipalName}/tasks/lists/{baseTaskListId}/tasks/delta
GET /users/{userId|userPrincipalName}/tasks/lists/delta
GET /users/{usersId}/planner/rosterPlans
POST /me/outlook/taskFolders
POST /me/outlook/taskFolders/{id}/tasks
POST /me/outlook/taskGroups
POST /me/outlook/taskGroups/{id}/taskFolders
POST /me/outlook/taskGroups/{id}/taskFolders/{id}/tasks
POST /me/outlook/tasks
POST /me/outlook/tasks/{id}/attachments
POST /me/outlook/tasks/{id}/complete
POST /me/tasks/alltasks/{baseTaskId}/move
POST /me/tasks/lists
POST /me/tasks/lists/{baseTaskListId}/tasks
POST /me/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}/checklistItems
POST /me/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}/linkedResources
POST /me/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}/move
POST /me/todo/lists
POST /me/todo/lists/{id}/tasks/{id}/attachments
POST /me/todo/lists/{id}/tasks/{id}/attachments/createUploadSession
POST /me/todo/lists/{todoTaskListId}/tasks
POST /me/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources
POST /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems
POST /planner/buckets
POST /planner/plans
POST /planner/plans/{planId}/archive
POST /planner/plans/{planId}/moveToContainer
POST /planner/plans/{planId}/unarchive
POST /planner/rosters
POST /planner/rosters/{plannerRosterId}/members
POST /planner/rosters/{rosterId}/assignSensitivityLabel
POST /planner/tasks
POST /planner/tasks/{task-id}/messages
POST /planner/tasks/{task-id}/messages/{message-id}/setReaction
POST /planner/tasks/{task-id}/messages/{message-id}/unsetReaction
POST /users/{id | userPrincipalName}/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}/checklistItems
POST /users/{id | userPrincipalName}/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}/linkedResources
POST /users/{id | userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems
POST /users/{id}/todo/lists/{id}/tasks/{id}/attachments
POST /users/{id}/todo/lists/{id}/tasks/{id}/attachments/createUploadSession
POST /users/{id|userPrincipalName}/outlook/taskFolders
POST /users/{id|userPrincipalName}/outlook/taskFolders/{id}/tasks
POST /users/{id|userPrincipalName}/outlook/taskGroups
POST /users/{id|userPrincipalName}/outlook/taskGroups/{id}/taskFolders
POST /users/{id|userPrincipalName}/outlook/taskGroups/{id}/taskFolders/{id}/tasks
POST /users/{id|userPrincipalName}/outlook/tasks
POST /users/{id|userPrincipalName}/outlook/tasks/{id}/attachments
POST /users/{id|userPrincipalName}/outlook/tasks/{id}/complete
POST /users/{id|userPrincipalName}/todo/lists
POST /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks
POST /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources
POST /users/{userId|userPrincipalName}/tasks/alltasks/{baseTaskId}/move
POST /users/{userId|userPrincipalName}/tasks/lists
POST /users/{userId|userPrincipalName}/tasks/lists/{baseTaskListId}/tasks
POST /users/{userId|userPrincipalName}/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}/move
POST /users/{usersId}/outlook/taskFolders/{outlookTaskFolderId}/permanentDelete
POST /users/{usersId}/outlook/taskGroups/{outlookTaskGroupId}/taskFolders/{outlookTaskFolderId}/permanentDelete
POST /users/{usersId}/outlook/taskGroups/{outlookTaskGroupId}/taskFolders/{outlookTaskFolderId}/tasks/{outlookTaskId}/permanentDelete
POST /users/{usersId}/outlook/tasks/{outlookTaskId}/permanentDelete
PATCH /me/outlook/taskFolders/{id}
PATCH /me/outlook/taskGroups/{id}
PATCH /me/outlook/taskGroups/{id}/taskFolders/{id}
PATCH /me/outlook/tasks/{id}
PATCH /me/planner
PATCH /me/tasks/alltasks/{baseTaskId}
PATCH /me/tasks/lists/{baseTaskListId}
PATCH /me/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}
PATCH /me/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}/checklistItems/{checklistItemId}
PATCH /me/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}/linkedResources/{linkedResourceId}
PATCH /me/todo/lists/{todoTaskListId}
PATCH /me/todo/lists/{todoTaskListId}/tasks/{taskId}
PATCH /me/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources/{linkedResourcesId}
PATCH /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}
PATCH /planner/buckets/{id}
PATCH /planner/plans/{id}/details
PATCH /planner/plans/{plan-id}
PATCH /planner/tasks/{id}
PATCH /planner/tasks/{id}/assignedToTaskBoardFormat
PATCH /planner/tasks/{id}/bucketTaskBoardFormat
PATCH /planner/tasks/{id}/details
PATCH /planner/tasks/{id}/progressTaskBoardFormat
PATCH /planner/tasks/{task-id}/messages/{message-id}
PATCH /users/{id | userPrincipalName}/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}/checklistItems/{checklistItemId}
PATCH /users/{id | userPrincipalName}/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}/linkedResources/{linkedResourceId}
PATCH /users/{id | userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}
PATCH /users/{id|userPrincipalName}/outlook/taskFolders/{id}
PATCH /users/{id|userPrincipalName}/outlook/taskGroups/{id}
PATCH /users/{id|userPrincipalName}/outlook/taskGroups/{id}/taskFolders/{id}
PATCH /users/{id|userPrincipalName}/outlook/tasks/{id}
PATCH /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks
PATCH /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{taskId}
PATCH /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources/{linkedResourcesId}
PATCH /users/{userId|userPrincipalName}/tasks/alltasks/{baseTaskId}
PATCH /users/{userId|userPrincipalName}/tasks/lists/{baseTaskListId}
PATCH /users/{userId|userPrincipalName}/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}
DELETE /me/outlook/taskFolders/{id}
DELETE /me/outlook/taskGroups/{id}
DELETE /me/outlook/taskGroups/{id}/taskFolders/{id}
DELETE /me/outlook/tasks/{id}
DELETE /me/tasks/alltasks/{baseTaskId}
DELETE /me/tasks/lists/{baseTaskListId}
DELETE /me/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}
DELETE /me/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}/linkedResources/{linkedResourceId}
DELETE /me/tasks/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}
DELETE /me/todo/lists/{id}/tasks/{id}/attachments/{id}
DELETE /me/todo/lists/{todoTaskListId}
DELETE /me/todo/lists/{todoTaskListId}/tasks/{taskId}
DELETE /me/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources/{linkedResourcesId}
DELETE /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}
DELETE /planner/buckets/{id}
DELETE /planner/plans/{id}
DELETE /planner/rosters/{plannerRosterId}
DELETE /planner/rosters/{plannerRosterId}/members/{plannerRosterMemberId}
DELETE /planner/tasks/{id}
DELETE /planner/tasks/{task-id}/messages/{message-id}
DELETE /users/{id | userPrincipalName}/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}/linkedResources/{linkedResourceId}
DELETE /users/{id | userPrincipalName}/tasks/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}
DELETE /users/{id | userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}
DELETE /users/{id}/todo/lists/{id}/tasks/{id}/attachments/{id}
DELETE /users/{id|userPrincipalName}/outlook/taskFolders/{id}
DELETE /users/{id|userPrincipalName}/outlook/taskGroups/{id}
DELETE /users/{id|userPrincipalName}/outlook/taskGroups/{id}/taskFolders/{id}
DELETE /users/{id|userPrincipalName}/outlook/tasks/{id}
DELETE /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}
DELETE /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{taskId}
DELETE /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources/{linkedResourcesId}
DELETE /users/{userId|userPrincipalName}/tasks/alltasks/{baseTaskId}
DELETE /users/{userId|userPrincipalName}/tasks/lists/{baseTaskListId}
DELETE /users/{userId|userPrincipalName}/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}
Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
Get-MgGroupPlannerPlan /groups/{group-id}/planner/plans
List plans
Get-MgPlannerBucket /planner/buckets
List buckets
Get-MgPlannerBucket /planner/buckets/{id}
Get plannerBucket
Get-MgPlannerBucketTask /planner/buckets/{id}/tasks
List tasks
Get-MgPlannerPlan /planner/plans
List plans
Get-MgPlannerPlan /planner/plans/{plan-id}
Get plannerPlan
Get-MgPlannerPlanBucket /planner/plans/{plan-id}/buckets
List buckets
Get-MgPlannerPlanDetail /planner/plans/{id}/details
Get plannerPlanDetails
Get-MgPlannerPlanTask /planner/plans/{plan-id}/tasks
List tasks
Get-MgPlannerTask /planner/tasks
List plannerTask objects
Get-MgPlannerTask /planner/tasks/{id}
Get plannerTask
Get-MgPlannerTaskAssignedToTaskBoardFormat /planner/tasks/{id}/assignedToTaskBoardFormat
Get plannerAssignedToTaskBoardTaskFormat
Get-MgPlannerTaskBucketTaskBoardFormat /planner/tasks/{id}/bucketTaskBoardFormat
Get plannerBucketTaskBoardTaskFormat
Get-MgPlannerTaskDetail /planner/tasks/{id}/details
Get plannerTaskDetails
Get-MgPlannerTaskProgressTaskBoardFormat /planner/tasks/{id}/progressTaskBoardFormat
Get plannerProgressTaskBoardTaskFormat
Get-MgUserPlannerPlan /me/planner/plans
List plans
Get-MgUserPlannerTask /me/planner/tasks
List tasks
Get-MgUserTodoList /me/todo/lists
List lists
Get-MgUserTodoList /me/todo/lists/{todoTaskListId}
Get todoTaskList
Get-MgUserTodoListDelta /me/todo/lists/delta
todoTaskList: delta
Get-MgUserTodoTask /me/todo/lists/{todoTaskListId}/tasks
List Todo tasks
Get-MgUserTodoTask /me/todo/lists/{todoTaskListId}/tasks/{taskId}
Get todoTask
Get-MgUserTodoTaskAttachment /me/todo/lists/{id}/tasks/{id}/attachments/{id}
Get taskFileAttachment
Get-MgUserTodoTaskAttachment /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/attachments
List taskFileAttachments
Get-MgUserTodoTaskChecklistItem /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems
List checklistItems
Get-MgUserTodoTaskChecklistItem /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}
Get checklistItem
Get-MgUserTodoTaskDelta /me/todo/lists/{id}/tasks/delta
todoTask: delta
Get-MgUserTodoTaskLinkedResource /me/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources
List linkedResources
Get-MgUserTodoTaskLinkedResource /me/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources/{linkedResourcesId}
Get linkedResource
New-MgPlannerBucket /planner/buckets
Create plannerBucket
New-MgPlannerPlan /planner/plans
Create plannerPlan
New-MgPlannerTask /planner/tasks
Create plannerTask
New-MgUserTodoList /me/todo/lists
Create todoTaskList
New-MgUserTodoListTask /me/todo/lists/{todoTaskListId}/tasks
Create todoTask
New-MgUserTodoListTaskAttachment /me/todo/lists/{id}/tasks/{id}/attachments
Create taskFileAttachment
New-MgUserTodoListTaskAttachmentUploadSession /me/todo/lists/{id}/tasks/{id}/attachments/createUploadSession
taskFileAttachment: createUploadSession
New-MgUserTodoListTaskChecklistItem /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems
Create checklistItem
New-MgUserTodoListTaskLinkedResource /me/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources
Create linkedResource
Remove-MgPlannerBucket /planner/buckets/{id}
Delete plannerBucket
Remove-MgPlannerPlan /planner/plans/{id}
Delete plannerPlan
Remove-MgPlannerTask /planner/tasks/{id}
Delete plannerTask
Remove-MgUserTodoList /me/todo/lists/{todoTaskListId}
Delete todoTaskList
Remove-MgUserTodoListTask /me/todo/lists/{todoTaskListId}/tasks/{taskId}
Delete todoTask
Remove-MgUserTodoListTaskAttachment /me/todo/lists/{id}/tasks/{id}/attachments/{id}
Delete taskFileAttachment
Remove-MgUserTodoListTaskChecklistItem /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}
Delete checklistItem
Remove-MgUserTodoListTaskLinkedResource /me/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources/{linkedResourcesId}
Delete linkedResource
Update-MgPlannerBucket /planner/buckets/{id}
Update plannerbucket
Update-MgPlannerPlan /planner/plans/{plan-id}
Update plannerPlan
Update-MgPlannerPlanDetail /planner/plans/{id}/details
Update plannerplandetails
Update-MgPlannerTask /planner/tasks/{id}
Update plannerTask
Update-MgPlannerTaskAssignedToTaskBoardFormat /planner/tasks/{id}/assignedToTaskBoardFormat
Update plannerAssignedToTaskBoardTaskFormat
Update-MgPlannerTaskBucketTaskBoardFormat /planner/tasks/{id}/bucketTaskBoardFormat
Update plannerBucketTaskBoardTaskFormat
Update-MgPlannerTaskDetail /planner/tasks/{id}/details
Update plannerTaskDetails
Update-MgPlannerTaskProgressTaskBoardFormat /planner/tasks/{id}/progressTaskBoardFormat
Update plannerProgressTaskBoardTaskFormat
Update-MgUserTodoList /me/todo/lists/{todoTaskListId}
Update todoTaskList
Update-MgUserTodoListTask /me/todo/lists/{todoTaskListId}/tasks/{taskId}
Update todoTask
Update-MgUserTodoListTaskChecklistItem /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}
Update checklistItem
Update-MgUserTodoListTaskLinkedResource /me/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources/{linkedResourcesId}
Update linkedResource
Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
Get-MgBetaGroupPlannerPlan /groups/{group-id}/planner/plans
List plans
Get-MgBetaPlannerBucket /planner/buckets
List buckets
Get-MgBetaPlannerBucket /planner/buckets/{id}
Get plannerBucket
Get-MgBetaPlannerBucketTask /planner/buckets/{id}/tasks
List plannerTask objects for a plannerBucket
Get-MgBetaPlannerPlan /planner/plans
List plans
Get-MgBetaPlannerPlan /planner/plans/{plan-id}
Get plannerPlan
Get-MgBetaPlannerPlanBucket /planner/plans/{plan-id}/buckets
List buckets
Get-MgBetaPlannerPlanDetail /planner/plans/{id}/details
Get plannerPlanDetails
Get-MgBetaPlannerPlanTask /planner/plans/{plan-id}/tasks
List tasks
Get-MgBetaPlannerRoster /planner/rosters/{plannerRosterId}
Get plannerRoster
Get-MgBetaPlannerRosterMember /planner/rosters/{plannerRosterId}/members
List plannerRosterMembers
Get-MgBetaPlannerRosterMember /planner/rosters/{plannerRosterId}/members/{plannerRosterMemberId}
Get plannerRosterMember
Get-MgBetaPlannerRosterPlan /planner/rosters/{plannerRosterId}/plans
List plans
Get-MgBetaPlannerTask /planner/tasks
List plannerTask objects
Get-MgBetaPlannerTask /planner/tasks/{id}
Get plannerTask
Get-MgBetaPlannerTaskAssignedToTaskBoardFormat /planner/tasks/{id}/assignedToTaskBoardFormat
Get plannerAssignedToTaskBoardTaskFormat
Get-MgBetaPlannerTaskBucketTaskBoardFormat /planner/tasks/{id}/bucketTaskBoardFormat
Get plannerBucketTaskBoardTaskFormat
Get-MgBetaPlannerTaskDetail /planner/tasks/{id}/details
Get plannerTaskDetails
Get-MgBetaPlannerTaskProgressTaskBoardFormat /planner/tasks/{id}/progressTaskBoardFormat
Get plannerProgressTaskBoardTaskFormat
Get-MgBetaTeamChannelPlannerPlan /teams/{team-id}/channels/{channel-id}/planner/plans
List plans
Get-MgBetaUserPlanner /me/planner
Get plannerUser
Get-MgBetaUserPlannerAllDelta /me/planner/all/delta
Planner: delta
Get-MgBetaUserPlannerFavoritePlan /me/planner/favoritePlans
List favoritePlans
Get-MgBetaUserPlannerMyDayTask /me/planner/myDayTasks
List myDayTasks
Get-MgBetaUserPlannerPlan /me/planner/plans
List plans
Get-MgBetaUserPlannerRecentPlan /me/planner/recentPlans
List recentPlans
Get-MgBetaUserPlannerRosterPlan /users/{usersId}/planner/rosterPlans
List rosterPlans
Get-MgBetaUserPlannerTask /me/planner/tasks
List tasks
Get-MgBetaUserTodoList /me/todo/lists
List lists
Get-MgBetaUserTodoList /me/todo/lists/{todoTaskListId}
Get todoTaskList
Get-MgBetaUserTodoTask /me/todo/lists/{todoTaskListId}/tasks
List Todo tasks
Get-MgBetaUserTodoTask /me/todo/lists/{todoTaskListId}/tasks/{taskId}
Get todoTask
Get-MgBetaUserTodoTaskAttachment /me/todo/lists/{id}/tasks/{id}/attachments/{id}
Get taskFileAttachment
Get-MgBetaUserTodoTaskAttachment /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/attachments
List taskFileAttachments
Get-MgBetaUserTodoTaskChecklistItem /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems
List checklistItems
Get-MgBetaUserTodoTaskChecklistItem /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}
Get checklistItem
Get-MgBetaUserTodoTaskLinkedResource /me/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources
List linkedResources
Get-MgBetaUserTodoTaskLinkedResource /me/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources/{linkedResourcesId}
Get linkedResource
Invoke-MgBetaArchivePlannerPlan /planner/plans/{planId}/archive
plannerPlan: archive
Invoke-MgBetaUnarchivePlannerPlan /planner/plans/{planId}/unarchive
plannerPlan: unarchive
New-MgBetaPlannerBucket /planner/buckets
Create plannerBucket
New-MgBetaPlannerPlan /planner/plans
Create plannerPlan
New-MgBetaPlannerRoster /planner/rosters
Create plannerRoster
New-MgBetaPlannerRosterMember /planner/rosters/{plannerRosterId}/members
Create plannerRosterMember
New-MgBetaPlannerTask /planner/tasks
Create plannerTask
New-MgBetaUserOutlookTask /me/outlook/tasks
Create outlookTask
New-MgBetaUserOutlookTaskAttachment /me/outlook/tasks/{id}/attachments
Create attachment
New-MgBetaUserOutlookTaskFolder /me/outlook/taskFolders
Create outlookTaskFolder
New-MgBetaUserOutlookTaskFolderTask /me/outlook/taskFolders/{id}/tasks
Create outlookTask
New-MgBetaUserOutlookTaskGroup /me/outlook/taskGroups
Create outlookTaskGroup
New-MgBetaUserOutlookTaskGroupTaskFolder /me/outlook/taskGroups/{id}/taskFolders
Create outlookTaskFolder
New-MgBetaUserTodoList /me/todo/lists
Create todoTaskList
New-MgBetaUserTodoListTask /me/todo/lists/{todoTaskListId}/tasks
Create todoTask
New-MgBetaUserTodoListTaskAttachment /me/todo/lists/{id}/tasks/{id}/attachments
Create taskFileAttachment
New-MgBetaUserTodoListTaskAttachmentUploadSession /me/todo/lists/{id}/tasks/{id}/attachments/createUploadSession
taskFileAttachment: createUploadSession
New-MgBetaUserTodoListTaskChecklistItem /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems
Create checklistItem
Remove-MgBetaPlannerBucket /planner/buckets/{id}
Delete plannerBucket
Remove-MgBetaPlannerPlan /planner/plans/{id}
Delete plannerPlan
Remove-MgBetaPlannerRoster /planner/rosters/{plannerRosterId}
Delete plannerRoster
Remove-MgBetaPlannerRosterMember /planner/rosters/{plannerRosterId}/members/{plannerRosterMemberId}
Delete plannerRosterMember
Remove-MgBetaPlannerTask /planner/tasks/{id}
Delete plannerTask
Remove-MgBetaUserOutlookTask /me/outlook/tasks/{id}
Delete outlookTask
Remove-MgBetaUserOutlookTaskFolder /me/outlook/taskFolders/{id}
Delete outlookTaskFolder
Remove-MgBetaUserOutlookTaskFolderPermanent /users/{usersId}/outlook/taskFolders/{outlookTaskFolderId}/permanentDelete
outlookTaskFolder: permanentDelete
Remove-MgBetaUserOutlookTaskGroup /me/outlook/taskGroups/{id}
Delete outlookTaskGroup
Remove-MgBetaUserOutlookTaskPermanent /users/{usersId}/outlook/tasks/{outlookTaskId}/permanentDelete
outlookTask: permanentDelete
Remove-MgBetaUserTodoList /me/todo/lists/{todoTaskListId}
Delete todoTaskList
Remove-MgBetaUserTodoListTask /me/todo/lists/{todoTaskListId}/tasks/{taskId}
Delete todoTask
Remove-MgBetaUserTodoListTaskAttachment /me/todo/lists/{id}/tasks/{id}/attachments/{id}
Delete taskFileAttachment
Remove-MgBetaUserTodoListTaskChecklistItem /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}
Delete checklistItem
Remove-MgBetaUserTodoListTaskLinkedResource /me/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources/{linkedResourcesId}
Delete linkedResource
Set-MgBetaPlannerRosterSensitivityLabel /planner/rosters/{rosterId}/assignSensitivityLabel
plannerRoster: assignSensitivityLabel
Update-MgBetaPlannerBucket /planner/buckets/{id}
Update plannerbucket
Update-MgBetaPlannerPlan /planner/plans/{plan-id}
Update plannerPlan
Update-MgBetaPlannerPlanDetail /planner/plans/{id}/details
Update plannerplandetails
Update-MgBetaPlannerTask /planner/tasks/{id}
Update plannertask
Update-MgBetaPlannerTaskAssignedToTaskBoardFormat /planner/tasks/{id}/assignedToTaskBoardFormat
Update plannerAssignedToTaskBoardTaskFormat
Update-MgBetaPlannerTaskBucketTaskBoardFormat /planner/tasks/{id}/bucketTaskBoardFormat
Update plannerBucketTaskBoardTaskFormat
Update-MgBetaPlannerTaskDetail /planner/tasks/{id}/details
Update plannerTaskDetails
Update-MgBetaPlannerTaskProgressTaskBoardFormat /planner/tasks/{id}/progressTaskBoardFormat
Update plannerProgressTaskBoardTaskFormat
Update-MgBetaUserOutlookTask /me/outlook/tasks/{id}
Update outlooktask
Update-MgBetaUserOutlookTaskFolder /me/outlook/taskFolders/{id}
Update outlooktaskfolder
Update-MgBetaUserOutlookTaskGroup /me/outlook/taskGroups/{id}
Update outlooktaskgroup
Update-MgBetaUserPlanner /me/planner
Update plannerUser
Update-MgBetaUserTodoList /me/todo/lists/{todoTaskListId}
Update todoTaskList
Update-MgBetaUserTodoListTask /me/todo/lists/{todoTaskListId}/tasks/{taskId}
Update todoTask
Update-MgBetaUserTodoListTaskChecklistItem /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}
Update checklistItem
Update-MgBetaUserTodoListTaskLinkedResource /me/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources/{linkedResourcesId}
Update linkedResource

Code Examples

C# / .NET SDK
Create checklistItem
View official example on Microsoft Learn
// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new ChecklistItem
{
	DisplayName = "Final sign-off from the team",
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Me.Todo.Lists["{todoTaskList-id}"].Tasks["{todoTask-id}"].ChecklistItems.PostAsync(requestBody);
JavaScript
Create checklistItem
View official example on Microsoft Learn
const options = {
	authProvider,
};

const client = Client.init(options);

const checklistItem = {
    displayName: 'Final sign-off from the team'
};

await client.api('/me/todo/lists/AAMkADliMmU5YjJlLTVmMmQtNGQzNS1iYjA0LTdmZTA2NTI0MTE5YwAuAAAAAADdOMUbUmCfTKa7OC-fqjkdAQBnu3olF7NfToRyJ2f__TNcAAAAAAESAAA=/tasks/AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AZ7t6JRezX06Ecidn-vkzXAABPDii4gAA/checklistItems/')
	.post(checklistItem);
PowerShell
Create checklistItem
View official example on Microsoft Learn
Import-Module Microsoft.Graph.Users

$params = @{
	displayName = "Final sign-off from the team"
}
# A UPN can also be used as -UserId.
New-MgUserTodoListTaskChecklistItem -UserId $userId -TodoTaskListId $todoTaskListId -TodoTaskId $todoTaskId -BodyParameter $params
Python
Create checklistItem
View official example on Microsoft Learn
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.checklist_item import ChecklistItem
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = ChecklistItem(
	display_name = "Final sign-off from the team",
)

result = await graph_client.me.todo.lists.by_todo_task_list_id('todoTaskList-id').tasks.by_todo_task_id('todoTask-id').checklist_items.post(request_body)

App Registration

1

Navigate to Azure Portal

Go to App registrations in Microsoft Entra admin center

2

Add API Permission

Select your app → API permissions → Add a permission → Microsoft Graph

3

Select Permission Type

Choose Delegated permissions and search for Tasks.ReadWrite

4

Grant Admin Consent

Users can consent to this permission during sign-in.