Tasks.Read.Shared
Export JSON
Export CSV
Copy URL
Print
Delegated
Read
Shared Resources
Allows the app to read tasks a user has permissions to access, including their own and shared tasks.
Delegated Access
App-Only Access
Permission Details
Delegated Permission
User consent allowed
Read user and shared tasks
Allows the app to read tasks a user has permissions to access, including their own and shared tasks.
User sees: Allows the app to read tasks you have permissions to access, including your own and shared tasks.
Permission ID:
88d21fd4-8e5a-4c32-b5e2-4a1c95f34f72
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
No API methods available for this version.
No API methods available for this version.
No PowerShell cmdlets found for this permission.
No PowerShell cmdlets found for this permission.
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.Read.Shared" };
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.Read.Shared"]
});
const authProvider = new AuthCodeMSALBrowserAuthenticationProvider(pca, {
account: loginResponse.account,
scopes: ["Tasks.Read.Shared"],
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.Read.Shared"
# 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.Read.Shared"]
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.Read.Shared
4
Grant Admin Consent
Users can consent to this permission themselves during sign-in.