Tasks.ReadWrite.Shared | Graph Permissions

Permission Details

Delegated Permission

Read and write user and shared tasks

Allows the app to create, read, update, and delete tasks a user has permissions to, including their own and shared tasks.

Permission ID: c5ddf11b-c114-4886-8558-8a4e557cd52b

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`	`boolean`Nullable	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

No Learn or OpenAPI mapping available

Microsoft Graph v1.0 endpoints are not available from refreshed Microsoft Learn or Microsoft Graph OpenAPI metadata for this permission.

No API methods available for this version.

No Learn or OpenAPI mapping available

Microsoft Graph beta endpoints are not available from refreshed Microsoft Learn or Microsoft Graph OpenAPI metadata for this permission.

No API methods available for this version.

No Microsoft Learn PowerShell mapping available

Microsoft Graph PowerShell v1.0 commands are not available from refreshed Microsoft Learn PowerShell snippets for this permission.

No deterministic PowerShell command map is available for this permission.

Browse PowerShell docs

No Microsoft Learn PowerShell mapping available

Microsoft Graph PowerShell beta commands are not available from refreshed Microsoft Learn PowerShell snippets for this permission.

No deterministic PowerShell command map is available for this permission.

Browse PowerShell docs

Code Examples

C# / .NET SDK

using Azure.Identity;
using Microsoft.Graph;

var scopes = new[] { "Tasks.ReadWrite.Shared" };
var credential = new InteractiveBrowserCredential(
    new InteractiveBrowserCredentialOptions
    {
        ClientId = "YOUR_CLIENT_ID",
        TenantId = "YOUR_TENANT_ID",
        RedirectUri = new Uri("http://localhost")
    });

var graphClient = new GraphServiceClient(credential, scopes);
var response = await graphClient
    .WithUrl("https://graph.microsoft.com/v1.0/todoTask")
    .GetAsync();

JavaScript

import { Client } from "@microsoft/microsoft-graph-client";
import { InteractiveBrowserCredential } from "@azure/identity";

const credential = new InteractiveBrowserCredential({
  clientId: "YOUR_CLIENT_ID",
  tenantId: "YOUR_TENANT_ID",
  redirectUri: "http://localhost"
});

const token = await credential.getToken(["Tasks.ReadWrite.Shared"]);
const client = Client.init({
  authProvider: (done) => done(null, token.token)
});

const response = await client.api("/todoTask").get();

PowerShell

Connect-MgGraph -Scopes "Tasks.ReadWrite.Shared"
Invoke-MgGraphRequest -Method GET -Uri "https://graph.microsoft.com/v1.0/todoTask"

Python

from azure.identity import InteractiveBrowserCredential
import requests

credential = InteractiveBrowserCredential(
    client_id="YOUR_CLIENT_ID",
    tenant_id="YOUR_TENANT_ID"
)

token = credential.get_token("Tasks.ReadWrite.Shared")
response = requests.get(
    "https://graph.microsoft.com/v1.0/todoTask",
    headers={"Authorization": f"Bearer {token.token}"}
)

print(response.json())

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.Shared

4

Grant Admin Consent

Users can consent to this permission during sign-in.