Skip to content

Commit 968a12e

Browse files
DanipocketDanipocket
authored
Merge pull request #28804 from microsoftgraph/todo-task-update-permissions
[Permissions restructuring] Convert PATCH TODO TASK to 2-table doc instead of 1
2 parents ac647d4 + 38eb129 commit 968a12e

4 files changed

Lines changed: 61 additions & 6 deletions

File tree

‎api-reference/beta/api/todotask-update.md‎

Lines changed: 19 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: "avijityadav"
55
ms.localizationpriority: medium
66
ms.subservice: "outlook"
77
doc_type: apiPageType
8-
ms.date: 04/05/2024
8+
ms.date: 05/05/2026
99
---
1010

1111
# Update todoTask
@@ -17,19 +17,35 @@ Update the properties of a [todoTask](../resources/todotask.md) object.
1717
[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
1818

1919
## Permissions
20-
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
20+
21+
The following tables show the least privileged permission or permissions required to call this API on each supported resource type. Follow [best practices](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions) to request least privileged permissions. For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
22+
23+
### Permissions acting on self
2124

2225
<!-- { "blockType": "permissions", "name": "todotask_update" } -->
2326
[!INCLUDE [permissions-table](../includes/permissions/todotask-update-permissions.md)]
2427

25-
## HTTP request
28+
### Permissions acting on other users
2629

30+
<!-- { "blockType": "permissions", "name": "todotask_update_2" } -->
31+
[!INCLUDE [permissions-table](../includes/permissions/todotask-update-2-permissions.md)]
32+
33+
## HTTP request
34+
Permissions to update a task of the signed-in user:
2735
<!-- {
2836
"blockType": "ignored"
2937
}
3038
-->
3139
```http
3240
PATCH /me/todo/lists/{todoTaskListId}/tasks/{taskId}
41+
```
42+
43+
Permissions to update a task of another user:
44+
<!-- {
45+
"blockType": "ignored"
46+
}
47+
-->
48+
```http
3349
PATCH /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{taskId}
3450
```
3551

‎api-reference/beta/includes/permissions/todotask-update-2-permissions.md‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
---
2+
description: "Automatically generated file. DO NOT MODIFY"
3+
ms.topic: include
4+
ms.localizationpriority: medium
5+
---
6+
7+
|Permission type|Least privileged permissions|Higher privileged permissions|
8+
|:---|:---|:---|
9+
|Delegated (work or school account)|Tasks.ReadWrite|Not available.|
10+
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
11+
|Application|Tasks.ReadWrite.All|Not available.|

‎api-reference/v1.0/api/todotask-update.md‎

Lines changed: 20 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: "avijityadav"
55
ms.localizationpriority: medium
66
ms.subservice: "outlook"
77
doc_type: apiPageType
8-
ms.date: 04/04/2024
8+
ms.date: 05/05/2026
99
---
1010

1111
# Update todoTask
@@ -16,19 +16,36 @@ Update the properties of a [todoTask](../resources/todotask.md) object.
1616
[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
1717

1818
## Permissions
19-
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
19+
20+
The following tables show the least privileged permission or permissions required to call this API on each supported resource type. Follow [best practices](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions) to request least privileged permissions. For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
21+
22+
### Permissions acting on self
2023

2124
<!-- { "blockType": "permissions", "name": "todotask_update" } -->
2225
[!INCLUDE [permissions-table](../includes/permissions/todotask-update-permissions.md)]
2326

24-
## HTTP request
27+
### Permissions acting on other users
28+
29+
<!-- { "blockType": "permissions", "name": "todotask_update_2" } -->
30+
[!INCLUDE [permissions-table](../includes/permissions/todotask-update-2-permissions.md)]
2531

32+
33+
## HTTP request
34+
Permissions to update a task of the signed-in user:
2635
<!-- {
2736
"blockType": "ignored"
2837
}
2938
-->
3039
```http
3140
PATCH /me/todo/lists/{todoTaskListId}/tasks/{taskId}
41+
```
42+
43+
Permissions to update a task of another user:
44+
<!-- {
45+
"blockType": "ignored"
46+
}
47+
-->
48+
```http
3249
PATCH /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{taskId}
3350
```
3451

‎api-reference/v1.0/includes/permissions/todotask-update-2-permissions.md‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
---
2+
description: "Automatically generated file. DO NOT MODIFY"
3+
ms.topic: include
4+
ms.localizationpriority: medium
5+
---
6+
7+
|Permission type|Least privileged permissions|Higher privileged permissions|
8+
|:---|:---|:---|
9+
|Delegated (work or school account)|Tasks.ReadWrite|Not available.|
10+
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
11+
|Application|Tasks.ReadWrite.All|Not available.|

0 commit comments

Comments
 (0)