ESC
Type to search...

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.

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.

Properties

Property Type Description
id string The unique identifier for an entity. Read-only.
startDateTime object The date and time in the specified time zone at which the task is scheduled to start.
body object The task body that typically contains information about the task.
categories array The categories associated with the task. Each category corresponds to the displayName property of an outlookCategory that the user has defined.
importance microsoft.graph.importance
attachmentSessions microsoft.graph.attachmentSession collection
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'.
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'.
extensions microsoft.graph.extension collection The collection of open extensions defined for the task. Nullable.
checklistItems microsoft.graph.checklistItem collection A collection of smaller subtasks linked to the more complex parent task.
title stringNullable A brief description of the task.
isReminderOn boolean Set to true if an alert is set to remind the user of the task.
singleValueExtendedProperties microsoft.graph.singleValueExtendedProperty collection A collection of custom fields linked to the task.
linkedResources microsoft.graph.linkedResource collection A collection of resources linked to the task.
dueDateTime object The date and time in the specified time zone that the task is to be finished.

Showing 15 of 22 properties. View all on Microsoft Learn →

JSON Representation

JSON representation
{
  "id": "String",
  "startDateTime": "{...}",
  "body": "{...}",
  "categories": "array",
  "importance": "microsoft.graph.importance",
  "attachmentSessions": "[...]",
  "lastModifiedDateTime": "String",
  "createdDateTime": "String",
  "extensions": "[...]",
  "checklistItems": "[...]",
  "title": "String",
  "isReminderOn": "Boolean",
  "singleValueExtendedProperties": "[...]",
  "linkedResources": "[...]",
  "dueDateTime": "{...}",
  "hasAttachments": "Boolean",
  "reminderDateTime": "{...}",
  "attachments": "[...]",
  "recurrence": "{...}",
  "completedDateTime": "{...}"
}

Relationships

Relationship Type Description
linkedResources linkedResource collection A collection of resources linked to the task.
checklistItems checklistItem collection A collection of checklistItems linked to a task.
attachments attachmentBase collection A collection of file attachments for the task.
attachmentSessions attachmentSession collection A collection of attachment sessions for the task.
extensions extension collection The collection of open extensions defined for the task. Nullable.

Graph Methods

Delegated access App-only access
Methods
GET /devices/{Id}/extensions/{extensionId}
GET /drive/root/createdByUser/planner/plans
GET /groups/{group-id}/planner/plans
GET /groups/{Id}/events/{Id}/extensions/{extensionId}
GET /groups/{Id}/extensions/{extensionId}
GET /groups/{Id}/threads/{Id}/posts/{Id}/extensions/{extensionId}
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/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 /organization/{Id}/extensions/{extensionId}
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 /subscriptions
GET /subscriptions/{id}
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|userPrincipalName}/contacts/{Id}/extensions/{extensionId}
GET /users/{Id|userPrincipalName}/events/{Id}/extensions/{extensionId}
GET /users/{Id|userPrincipalName}/extensions/{extensionId}
GET /users/{Id|userPrincipalName}/messages/{Id}/extensions/{extensionId}
GET /users/{id|userPrincipalName}/todo/lists
GET /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}
GET /users/{Id|userPrincipalName}/todo/lists/{todoTaskListId}/extensions/{extensionId}
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}/extensions/{extensionId}
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 /groups/{id}/events
POST /groups/{id}/threads/{id}/posts/{id}/reply
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 /subscriptions
POST /subscriptions/{subscriptionsId}/reauthorize
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}/contacts
POST /users/{id|userPrincipalName}/events
POST /users/{id|userPrincipalName}/messages
POST /users/{id|userPrincipalName}/todo/lists
POST /users/{id|userPrincipalName}/todo/lists/{id}/tasks
POST /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks
POST /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources
PATCH /devices/{Id}/extensions/{extensionId}
PATCH /groups/{id}/events/{id}/extensions/{extensionId}
PATCH /groups/{id}/extensions/{extensionId}
PATCH /groups/{id}/threads/{id}/posts/{id}/extensions/{extensionId}
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 /organization/{Id}/extensions/{extensionId}
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 /subscriptions/{id}
PATCH /users/{id | userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}
PATCH /users/{id|userPrincipalName}/contacts/{id}/extensions/{extensionId}
PATCH /users/{id|userPrincipalName}/events/{id}/extensions/{extensionId}
PATCH /users/{id|userPrincipalName}/extensions/{extensionId}
PATCH /users/{id|userPrincipalName}/messages/{id}/extensions/{extensionId}
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/me/todo/lists/{todoTaskListId}/extensions/{extensionId}
PATCH /users/me/todo/lists/{todoTaskListId}/tasks/{taskId}/extensions/{extensionId}
DELETE /devices/{Id}/extensions/{extensionId}
DELETE /groups/{id}/events/{id}/extensions/{extensionId}
DELETE /groups/{id}/extensions/{extensionId}
DELETE /groups/{id}/threads/{id}/posts/{id}/extensions/{extensionId}
DELETE /me/extensions/{extensionId}
DELETE /me/todo/lists/{id}/tasks/{id}/attachments/{id}
DELETE /me/todo/lists/{todoTaskListId}
DELETE /me/todo/lists/{todoTaskListId}/extensions/{extensionId}
DELETE /me/todo/lists/{todoTaskListId}/tasks/{taskId}
DELETE /me/todo/lists/{todoTaskListId}/tasks/{taskId}/extensions/{extensionId}
DELETE /me/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources/{linkedResourcesId}
DELETE /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItemId}
DELETE /organization/{Id}/extensions/{extensionId}
DELETE /planner/buckets/{id}
DELETE /planner/plans/{id}
DELETE /planner/tasks/{id}
DELETE /subscriptions/{subscription-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}/contacts/{id}/extensions/{extensionId}
DELETE /users/{id|userPrincipalName}/events/{id}/extensions/{extensionId}
DELETE /users/{id|userPrincipalName}/extensions/{extensionId}
DELETE /users/{id|userPrincipalName}/messages/{id}/extensions/{extensionId}
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}/todo/lists/{todoTaskListId}/extensions/{extensionId}
DELETE /users/{userId}/todo/lists/{todoTaskListId}/tasks/{taskId}/extensions/{extensionId}
Methods
GET /administrativeUnits/{administrativeUnitId}/extensions/{extensionId}
GET /devices/{deviceId}/extensions/{extensionId}
GET /drive/items/{itemId}/extensions/{extensionId}
GET /drive/root/createdByUser/planner/plans
GET /groups/{group-id}/planner/plans
GET /groups/{groupId}/events/{eventId}/extensions/{extensionId}
GET /groups/{groupId}/extensions/{extensionId}
GET /groups/{groupId}/threads/{threadId}/posts/{postId}/extensions/{extensionId}
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}/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/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 /organization/{organizationId}/extensions/{extensionId}
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 /sites/{siteId}/extensions/{extensionId}
GET /subscriptions
GET /subscriptions/{id}
GET /subscriptions/getVapidPublicKey
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}/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|userPrincipalName}/events/{eventId}/extensions/{extensionId}
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}/contacts/{contactId}/extensions/{extensionId}
GET /users/{userId|userPrincipalName}/extensions/{extensionId}
GET /users/{userId|userPrincipalName}/messages/{messageId}/extensions/{extensionId}
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/{listId}/extensions/{extensionId}
GET /users/{userId|userPrincipalName}/tasks/lists/{listId}/tasks/{baseTaskId}/extensions/{extensionId}
GET /users/{userId|userPrincipalName}/tasks/lists/delta
GET /users/{userId|userPrincipalName}/todo/lists/{listId}/extensions/{extensionId}
GET /users/{userId|userPrincipalName}/todo/lists/{listId}/tasks/{todoTaskId}/extensions/{extensionId}
GET /users/{usersId}/planner/rosterPlans
POST /drive/items/{itemId}/children
POST /groups/{id}/conversations
POST /groups/{id}/conversations/{id}/threads/{id}/posts/{id}/reply
POST /groups/{id}/conversations/{id}/threads/{id}/reply
POST /groups/{id}/events
POST /groups/{id}/threads
POST /groups/{id}/threads/{id}/posts/{id}/reply
POST /groups/{id}/threads/{id}/reply
POST /groups/{userId}/events
POST /groups/{userId}/threads/{threadId}/posts/{postId}/reply
POST /me/calendars
POST /me/contactFolders
POST /me/contacts
POST /me/events
POST /me/mailFolders
POST /me/mailFolders/{id}/messages
POST /me/messages
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?$expand=singleValueExtendedProperties($filter=id eq '{singleValueExtendedPropertyId}')
POST /me/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources
POST /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}?$expand=singleValueExtendedProperties($filter=id eq '{singleValueExtendedPropertyId}')
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 /subscriptions
POST /subscriptions/{subscriptionsId}/reauthorize
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}/calendars
POST /users/{id|userPrincipalName}/contactFolders
POST /users/{id|userPrincipalName}/contacts
POST /users/{id|userPrincipalName}/events
POST /users/{id|userPrincipalName}/mailFolders
POST /users/{id|userPrincipalName}/messages
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}/contacts
POST /users/{userId|userPrincipalName}/events
POST /users/{userId|userPrincipalName}/messages
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/{userId|userPrincipalName}/tasks/lists/{listId}/tasks
POST /users/{userId|userPrincipalName}/todo/lists
POST /users/{userId|userPrincipalName}/todo/lists/{listId}/tasks
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 /administrativeUnits/{administrativeUnitId}/extensions/{extensionId}
PATCH /devices/{deviceId}/extensions/{extensionId}
PATCH /drive/items/{itemId}/extensions/{extensionId}
PATCH /groups/{groupId}/events/{eventId}/extensions/{extensionId}
PATCH /groups/{groupId}/extensions/{extensionId}
PATCH /groups/{groupId}/threads/{threadId}/posts/{postId}/extensions/{extensionId}
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}/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 /organization/{organizationId}/extensions/{extensionId}
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 /sites/{siteId}/extensions/{extensionId}
PATCH /subscriptions/{id}
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}/contacts/{contactId}/extensions/{extensionId}
PATCH /users/{userId|userPrincipalName}/events/{eventId}/extensions/{extensionId}
PATCH /users/{userId|userPrincipalName}/extensions/{extensionId}
PATCH /users/{userId|userPrincipalName}/messages/{messageId}/extensions/{extensionId}
PATCH /users/{userId|userPrincipalName}/tasks/alltasks/{baseTaskId}
PATCH /users/{userId|userPrincipalName}/tasks/lists/{baseTaskListId}
PATCH /users/{userId|userPrincipalName}/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}
PATCH /users/me/tasks/lists/{listId}/extensions/{extensionId}
PATCH /users/me/tasks/lists/{listId}/tasks/{taskId}/extensions/{extensionId}
PATCH /users/me/todo/lists/{listId}/extensions/{extensionId}
PATCH /users/me/todo/lists/{listId}/tasks/{taskId}/extensions/{extensionId}
DELETE /administrativeUnits/{administrativeUnitId}/extensions/{extensionId}
DELETE /devices/{deviceId}/extensions/{extensionId}
DELETE /drive/items/{itemId}/extensions/{extensionId}
DELETE /groups/{groupId}/events/{eventId}/extensions/{extensionId}
DELETE /groups/{groupId}/extensions/{extensionId}
DELETE /groups/{groupId}/threads/{threadIid}/posts/{postId}/extensions/{extensionId}
DELETE /me/calendar/events/{id}/attachments/{id}
DELETE /me/events/{id}/attachments/{id}
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/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 /organization/{organizationId}/extensions/{extensionId}
DELETE /planner/buckets/{id}
DELETE /planner/plans/{id}
DELETE /planner/rosters/{plannerRosterId}
DELETE /planner/rosters/{plannerRosterId}/members/{plannerRosterMemberId}
DELETE /planner/tasks/{id}
DELETE /sites/{site-id}/extensions/{extensionId}
DELETE /subscriptions/{subscription-id}
DELETE /users/{id | userPrincipalName}/calendar/events/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/events/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}/linkedResources/{linkedResourceId}
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}/contacts/{contactId}/extensions/{extensionId}
DELETE /users/{userId|userPrincipalName}/events/{eventId}/extensions/{extensionId}
DELETE /users/{userId|userPrincipalName}/extensions/{extensionId}
DELETE /users/{userId|userPrincipalName}/tasks/alltasks/{baseTaskId}
DELETE /users/{userId|userPrincipalName}/tasks/lists/{baseTaskListId}
DELETE /users/{userId|userPrincipalName}/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}
DELETE /users/{userIid|userPrincipalName}/messages/{messageId}/extensions/{extensionId}
DELETE /users/me/tasks/lists/{listId}/extensions/{extensionId}
DELETE /users/me/tasks/lists/{listId}/tasks/{taskId}/extensions/{extensionId}
DELETE /users/me/todo/lists/{listId}/extensions/{extensionId}
DELETE /users/me/todo/lists/{listId}/tasks/{taskId}/extensions/{extensionId}
Commands
Get-MgGroupPlannerPlan
Get-MgPlannerBucket
Get-MgPlannerBucketTask
Get-MgPlannerPlan
Get-MgPlannerPlanBucket
Get-MgPlannerPlanDetail
Get-MgPlannerPlanTask
Get-MgPlannerTask
Get-MgPlannerTaskAssignedToTaskBoardFormat
Get-MgPlannerTaskBucketTaskBoardFormat
Get-MgPlannerTaskDetail
Get-MgPlannerTaskProgressTaskBoardFormat
Get-MgSubscription
Get-MgUserMessage
Get-MgUserPlannerPlan
Get-MgUserPlannerTask
Get-MgUserTodoList
Get-MgUserTodoListDelta
Get-MgUserTodoTask
Get-MgUserTodoTaskAttachment
Get-MgUserTodoTaskChecklistItem
Get-MgUserTodoTaskDelta
Get-MgUserTodoTaskLinkedResource
Invoke-MgReauthorizeSubscription
New-MgGroupConversation
New-MgPlannerBucket
New-MgPlannerPlan
New-MgPlannerTask
New-MgSubscription
New-MgUserTodoList
New-MgUserTodoListTask
New-MgUserTodoListTaskAttachment
New-MgUserTodoListTaskAttachmentUploadSession
New-MgUserTodoListTaskChecklistItem
New-MgUserTodoListTaskLinkedResource
Remove-MgPlannerBucket
Remove-MgPlannerPlan
Remove-MgPlannerTask
Remove-MgSubscription
Remove-MgUserMessageExtension
Remove-MgUserTodoList
Remove-MgUserTodoListTask
Remove-MgUserTodoListTaskAttachment
Remove-MgUserTodoListTaskChecklistItem
Remove-MgUserTodoListTaskLinkedResource
Update-MgGroupThreadPostExtension
Update-MgPlannerBucket
Update-MgPlannerPlan
Update-MgPlannerPlanDetail
Update-MgPlannerTask
Update-MgPlannerTaskAssignedToTaskBoardFormat
Update-MgPlannerTaskBucketTaskBoardFormat
Update-MgPlannerTaskDetail
Update-MgPlannerTaskProgressTaskBoardFormat
Update-MgSubscription
Update-MgUserTodoList
Update-MgUserTodoListTask
Update-MgUserTodoListTaskChecklistItem
Update-MgUserTodoListTaskLinkedResource
Commands
Complete-MgBetaUserOutlookTask
Get-MgBetaDriveItem
Get-MgBetaGroupPlannerPlan
Get-MgBetaPlannerBucket
Get-MgBetaPlannerBucketTask
Get-MgBetaPlannerPlan
Get-MgBetaPlannerPlanBucket
Get-MgBetaPlannerPlanDetail
Get-MgBetaPlannerPlanTask
Get-MgBetaPlannerRoster
Get-MgBetaPlannerRosterMember
Get-MgBetaPlannerRosterPlan
Get-MgBetaPlannerTask
Get-MgBetaPlannerTaskAssignedToTaskBoardFormat
Get-MgBetaPlannerTaskBucketTaskBoardFormat
Get-MgBetaPlannerTaskDetail
Get-MgBetaPlannerTaskProgressTaskBoardFormat
Get-MgBetaSubscription
Get-MgBetaSubscriptionVapidPublicKey
Get-MgBetaTeamChannelPlannerPlan
Get-MgBetaUserPlanner
Get-MgBetaUserPlannerAllDelta
Get-MgBetaUserPlannerFavoritePlan
Get-MgBetaUserPlannerMyDayTask
Get-MgBetaUserPlannerPlan
Get-MgBetaUserPlannerRecentPlan
Get-MgBetaUserPlannerRosterPlan
Get-MgBetaUserPlannerTask
Get-MgBetaUserTodoList
Get-MgBetaUserTodoListDelta
Get-MgBetaUserTodoTask
Get-MgBetaUserTodoTaskAttachment
Get-MgBetaUserTodoTaskChecklistItem
Get-MgBetaUserTodoTaskDelta
Get-MgBetaUserTodoTaskLinkedResource
Invoke-MgBetaArchivePlannerPlan
Invoke-MgBetaReauthorizeSubscription
Invoke-MgBetaReplyGroupConversationThread
Invoke-MgBetaReplyGroupConversationThreadPost
Invoke-MgBetaReplyGroupThread
Invoke-MgBetaReplyGroupThreadPost
Invoke-MgBetaUnarchivePlannerPlan
Move-MgBetaPlannerPlanToContainer
New-MgBetaDriveItemChild
New-MgBetaGroupConversation
New-MgBetaGroupEvent
New-MgBetaGroupThread
New-MgBetaPlannerBucket
New-MgBetaPlannerPlan
New-MgBetaPlannerRoster
New-MgBetaPlannerRosterMember
New-MgBetaPlannerTask
New-MgBetaSubscription
New-MgBetaUserCalendar
New-MgBetaUserContact
New-MgBetaUserContactFolder
New-MgBetaUserEvent
New-MgBetaUserMailFolder
New-MgBetaUserMailFolderMessage
New-MgBetaUserMessage
New-MgBetaUserOutlookTask
New-MgBetaUserOutlookTaskAttachment
New-MgBetaUserOutlookTaskFolder
New-MgBetaUserOutlookTaskFolderTask
New-MgBetaUserOutlookTaskGroup
New-MgBetaUserOutlookTaskGroupTaskFolder
New-MgBetaUserOutlookTaskGroupTaskFolderTask
New-MgBetaUserTodoList
New-MgBetaUserTodoListTask
New-MgBetaUserTodoListTaskAttachment
New-MgBetaUserTodoListTaskAttachmentUploadSession
New-MgBetaUserTodoListTaskChecklistItem
Remove-MgBetaDriveItemExtension
Remove-MgBetaPlannerBucket
Remove-MgBetaPlannerPlan
Remove-MgBetaPlannerRoster
Remove-MgBetaPlannerRosterMember
Remove-MgBetaPlannerTask
Remove-MgBetaSubscription
Remove-MgBetaUserEventAttachment
Remove-MgBetaUserOutlookTask
Remove-MgBetaUserOutlookTaskFolder
Remove-MgBetaUserOutlookTaskFolderPermanent
Remove-MgBetaUserOutlookTaskGroup
Remove-MgBetaUserOutlookTaskPermanent
Remove-MgBetaUserTodoList
Remove-MgBetaUserTodoListTask
Remove-MgBetaUserTodoListTaskAttachment
Remove-MgBetaUserTodoListTaskChecklistItem
Remove-MgBetaUserTodoListTaskLinkedResource
Set-MgBetaPlannerRosterSensitivityLabel
Update-MgBetaDriveItemExtension
Update-MgBetaPlannerBucket
Update-MgBetaPlannerPlan
Update-MgBetaPlannerPlanDetail
Update-MgBetaPlannerTask
Update-MgBetaPlannerTaskAssignedToTaskBoardFormat
Update-MgBetaPlannerTaskBucketTaskBoardFormat
Update-MgBetaPlannerTaskDetail
Update-MgBetaPlannerTaskProgressTaskBoardFormat
Update-MgBetaSubscription
Update-MgBetaUserOutlookTask
Update-MgBetaUserOutlookTaskFolder
Update-MgBetaUserOutlookTaskGroup
Update-MgBetaUserPlanner
Update-MgBetaUserTodoList
Update-MgBetaUserTodoListTask
Update-MgBetaUserTodoListTaskChecklistItem
Update-MgBetaUserTodoListTaskLinkedResource

Code Examples

C# / .NET SDK
// Install: dotnet add package Microsoft.Graph
// Install: dotnet add package Azure.Identity
using Microsoft.Graph;
using Azure.Identity;

// Delegated permissions - interactive user sign-in
var scopes = new[] { "Tasks.ReadWrite" };
var options = new InteractiveBrowserCredentialOptions
{
    ClientId = "YOUR_CLIENT_ID",
    TenantId = "YOUR_TENANT_ID",
    RedirectUri = new Uri("http://localhost")
};
var credential = new InteractiveBrowserCredential(options);
var graphClient = new GraphServiceClient(credential, scopes);

// Example: GET /me
var result = await graphClient.Me.GetAsync();
Console.WriteLine($"User: {result?.DisplayName}");
JavaScript / TypeScript
// npm install @azure/msal-browser @microsoft/microsoft-graph-client
import { PublicClientApplication } from "@azure/msal-browser";
import { Client } from "@microsoft/microsoft-graph-client";
import { AuthCodeMSALBrowserAuthenticationProvider } from 
    "@microsoft/microsoft-graph-client/authProviders/authCodeMsalBrowser";

const msalConfig = {
    auth: {
        clientId: "YOUR_CLIENT_ID",
        authority: "https://login.microsoftonline.com/YOUR_TENANT_ID"
    }
};

const pca = new PublicClientApplication(msalConfig);
await pca.initialize();

// Delegated: Login with required scope
const loginResponse = await pca.loginPopup({
    scopes: ["Tasks.ReadWrite"]
});

const authProvider = new AuthCodeMSALBrowserAuthenticationProvider(pca, {
    account: loginResponse.account,
    scopes: ["Tasks.ReadWrite"],
    interactionType: "popup"
});

const graphClient = Client.initWithMiddleware({ authProvider });

// Example: GET /me
const result = await graphClient.api("/me").get();
console.log(result);
PowerShell
# Install Microsoft Graph PowerShell module
Install-Module Microsoft.Graph -Scope CurrentUser

# Delegated access - interactive sign-in
Connect-MgGraph -Scopes "Tasks.ReadWrite"

# Verify connection
Get-MgContext | Select-Object Account, TenantId, Scopes

# Example: GET /me
$result = Invoke-MgGraphRequest -Method GET -Uri "https://graph.microsoft.com/v1.0/me"
$result | ConvertTo-Json -Depth 5


# Always disconnect when done
Disconnect-MgGraph
Python
# pip install msgraph-sdk azure-identity
from azure.identity import InteractiveBrowserCredential, ClientSecretCredential
from msgraph import GraphServiceClient
import asyncio

# Delegated permissions - interactive browser sign-in
credential = InteractiveBrowserCredential(
    client_id="YOUR_CLIENT_ID",
    tenant_id="YOUR_TENANT_ID"
)
scopes = ["Tasks.ReadWrite"]
client = GraphServiceClient(credential, scopes)

async def get_data():
    # Example: GET /me
    result = await client.me.get()
    print(f"User: {result.display_name}")
    return result

asyncio.run(get_data())

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 themselves during sign-in.