ESC
Type to search...

Tasks.ReadWrite.All

Export JSON
Export CSV
Copy URL
Print
Application Read/Write All Resources

Allows the app to create, read, update and delete all users’ tasks and task lists in your organization, without a signed-in user

Delegated Access App-Only Access

Permission Details

Application Permission

Read and write all users’ tasks and tasklists

Allows the app to create, read, update and delete all users’ tasks and task lists in your organization, without a signed-in 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 /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/tasks
GET /me/todo/lists/{id}/tasks/delta
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 /users/{id}/planner/tasks
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/{todoTaskListId}/extensions/{extensionId}
GET /users/{Id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{taskId}/extensions/{extensionId}
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 /planner/buckets
POST /planner/plans
POST /planner/tasks
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
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 /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 /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/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/{todoTaskListId}/extensions/{extensionId}
DELETE /me/todo/lists/{todoTaskListId}/tasks/{taskId}/extensions/{extensionId}
DELETE /organization/{Id}/extensions/{extensionId}
DELETE /planner/buckets/{id}
DELETE /planner/plans/{id}
DELETE /planner/tasks/{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/{userId}/todo/lists/{todoTaskListId}/extensions/{extensionId}
DELETE /users/{userId}/todo/lists/{todoTaskListId}/tasks/{taskId}/extensions/{extensionId}
Methods
GET /groups/{group-id}/planner/plans
GET /me/planner
GET /me/planner/myDayTasks
GET /me/planner/tasks
GET /me/todo/lists/{id}/tasks/delta
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}/planner
GET /users/{id}/planner/myDayTasks
GET /users/{id}/planner/tasks
GET /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/delta
GET /users/{id|userPrincipalName}/todo/lists/delta
GET /users/{usersId}/planner/rosterPlans
POST /me/todo/lists
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 /users/{id|userPrincipalName}/todo/lists
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
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 /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 /users/{userId|userPrincipalName}/contacts/{contactId}/extensions/{extensionId}
DELETE /users/{userId|userPrincipalName}/events/{eventId}/extensions/{extensionId}
DELETE /users/{userId|userPrincipalName}/extensions/{extensionId}
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}

Code Examples

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



// Application permissions - daemon/service app
var tenantId = "YOUR_TENANT_ID";
var clientId = "YOUR_CLIENT_ID";
var clientSecret = "YOUR_CLIENT_SECRET";

var credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
var graphClient = new GraphServiceClient(credential);

// Example: GET /users/{user-id}
var users = await graphClient.Users.GetAsync();
foreach (var user in users?.Value ?? [])
{
    Console.WriteLine($"User: {user.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();



// Application: Use client credentials (Node.js backend only)
// npm install @azure/identity @microsoft/microsoft-graph-client
import { ClientSecretCredential } from "@azure/identity";
import { TokenCredentialAuthenticationProvider } from 
    "@microsoft/microsoft-graph-client/authProviders/azureTokenCredentials";

const credential = new ClientSecretCredential(
    "YOUR_TENANT_ID",
    "YOUR_CLIENT_ID", 
    "YOUR_CLIENT_SECRET"
);

const authProvider = new TokenCredentialAuthenticationProvider(credential, {
    scopes: ["https://graph.microsoft.com/.default"]
});

const graphClient = Client.initWithMiddleware({ authProvider });
const result = await graphClient.api("/users").get();
console.log(result);
PowerShell
# Install Microsoft Graph PowerShell module
Install-Module Microsoft.Graph -Scope CurrentUser



# Application access with certificate
$params = @{
    ClientId = "YOUR_CLIENT_ID"
    TenantId = "YOUR_TENANT_ID"
    CertificateThumbprint = "YOUR_CERT_THUMBPRINT"
}
Connect-MgGraph @params

# Or with client secret (not recommended for production)
# Connect-MgGraph -ClientSecretCredential $credential

# Example: GET /users
$result = Invoke-MgGraphRequest -Method GET -Uri "https://graph.microsoft.com/v1.0/users"
$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



# Application permissions - client credentials
credential = ClientSecretCredential(
    tenant_id="YOUR_TENANT_ID",
    client_id="YOUR_CLIENT_ID",
    client_secret="YOUR_CLIENT_SECRET"
)
scopes = ["https://graph.microsoft.com/.default"]
client = GraphServiceClient(credential, scopes)

async def get_users():
    # Example: GET /users
    result = await client.users.get()
    for user in result.value:
        print(f"User: {user.display_name}")
    return result

asyncio.run(get_users())

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 Application permissions and search for Tasks.ReadWrite.All

4

Grant Admin Consent

Application permissions always require admin consent. Click "Grant admin consent" in the Azure portal.