Merging changes synced from https://github.com/microsoftgraph/microsoft-graph-docs (branch live)

Author: Learn Build Service GitHub App

.github/copilot-instructions.md

@@ -8,6 +8,7 @@ Before doing any docs work, determine the task type and read the matching prompt
 
 - **Authoring or updating docs:** read `.github/prompts/author-api-docs.prompt.md`
 - **Reviewing docs changes:** read `.github/prompts/review-api-docs.prompt.md`
+- **Schema changes (additions, updates, deprecations, or retirements of any property, resource, method, enum, or enum member):** Before starting work, ask the author whether a changelog entry and What's New update are needed. Default to yes unless told otherwise.
 
 Then read the scenario-specific files that those prompt files direct you to use.
 
@@ -81,7 +82,7 @@ These rules apply across authoring and review scenarios:
 8. **API and resource topics must keep the standard section order** for their file type.
 9. **Tables must preserve required ordering rules**, including alphabetical ordering where the detailed guidance requires it.
 10. **Enum changes must be checked across all exposed documentation surfaces**, not only the enum definition itself.
-11. **Customer-visible API changes require changelog review and may require What's New updates.**
+11. **Schema changes — additions, updates, deprecations, and retirements of any property, resource, method, or enum member — require a changelog entry and What's New update. Omit either only with explicit author confirmation.**
 
 ## Core standards
 
@@ -113,7 +114,7 @@ Use the linked prompt files for the full standards. The rules below are the most
 
 ## Common change patterns
 
-- **New schema in beta:** update affected API/resource docs, enum docs, changelog, TOC, and What's New if the change is customer-visible.
+- **Schema changes (additions, updates, deprecations, retirements):** update affected API/resource docs, enum docs, changelog, TOC, and What's New. Omit changelog or What's New only with explicit author confirmation.
 - **Promotion to v1.0:** use the GA workflow, keep beta and v1.0 aligned where intended, remove beta-only content, update changelog, and add a What's New entry.
 - **Enum member additions:** update the enum definition, any inline value listings, and every API/resource page that enumerates supported values.
 - **Deprecation or retirement:** update banners and table entries, related references, changelog, What's New, redirects, and TOC as applicable.

api-reference/beta/api/todotask-delete.md

@@ -5,7 +5,7 @@ author: "avijityadav"
 ms.localizationpriority: medium
 ms.subservice: "outlook"
 doc_type: apiPageType
-ms.date: 04/05/2024
+ms.date: 05/18/2026
 ---
 
 # Delete todoTask
@@ -17,19 +17,35 @@ Deletes a [todoTask](../resources/todotask.md) object.
 [!INCLUDE [national-cloud-support](../../includes/global-us.md)]
 
 ## Permissions
-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).
+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).
+
+### Permissions acting on self
 
 <!-- { "blockType": "permissions", "name": "todotask_delete" } -->
 [!INCLUDE [permissions-table](../includes/permissions/todotask-delete-permissions.md)]
 
+### Permissions acting on other users
+
+<!-- { "blockType": "permissions", "name": "todotask_delete_2" } -->
+[!INCLUDE [permissions-table](../includes/permissions/todotask-delete-2-permissions.md)]
+
 ## HTTP request
 
+Permissions to delete a task of the signed-in user:
 <!-- {
   "blockType": "ignored"
 }
 -->
 ```http
 DELETE /me/todo/lists/{todoTaskListId}/tasks/{taskId}
+```
+
+Permissions to delete a task of another user:
+<!-- {
+  "blockType": "ignored"
+}
+-->
+```http
 DELETE /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{taskId}
 ```
 

api-reference/beta/api/todotask-list-linkedresources.md

@@ -5,7 +5,7 @@ author: "avijityadav"
 ms.localizationpriority: medium
 ms.subservice: "outlook"
 doc_type: apiPageType
-ms.date: 04/05/2024
+ms.date: 05/18/2026
 ---
 
 # List linkedResources
@@ -17,19 +17,35 @@ Get information of one or more items in a partner application, based on which a
 [!INCLUDE [national-cloud-support](../../includes/global-us.md)]
 
 ## Permissions
-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).
+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).
+
+### Permissions acting on self
 
 <!-- { "blockType": "permissions", "name": "todotask_list_linkedresources" } -->
 [!INCLUDE [permissions-table](../includes/permissions/todotask-list-linkedresources-permissions.md)]
 
+### Permissions acting on other users
+
+<!-- { "blockType": "permissions", "name": "todotask_list_linkedresources_2" } -->
+[!INCLUDE [permissions-table](../includes/permissions/todotask-list-linkedresources-2-permissions.md)]
+
 ## HTTP request
 
+Permissions to list linkedResources of a task of the signed-in user:
 <!-- {
   "blockType": "ignored"
 }
 -->
 ```http
 GET /me/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources
+```
+
+Permissions to list linkedResources of a task of another user:
+<!-- {
+  "blockType": "ignored"
+}
+-->
+```http
 GET /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources
 ```
 

api-reference/beta/api/todotask-post-checklistitems.md

@@ -5,7 +5,7 @@ author: "avijityadav"
 ms.localizationpriority: medium
 ms.subservice: "outlook"
 doc_type: apiPageType
-ms.date: 04/05/2024
+ms.date: 05/18/2026
 ---
 
 # Create checklistItem
@@ -18,19 +18,35 @@ Create a new [checklistItem](../resources/checklistitem.md) object as a subtask
 [!INCLUDE [national-cloud-support](../../includes/global-us.md)]
 
 ## Permissions
-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).
+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).
+
+### Permissions acting on self
 
 <!-- { "blockType": "permissions", "name": "todotask_post_checklistitems" } -->
 [!INCLUDE [permissions-table](../includes/permissions/todotask-post-checklistitems-permissions.md)]
 
+### Permissions acting on other users
+
+<!-- { "blockType": "permissions", "name": "todotask_post_checklistitems_2" } -->
+[!INCLUDE [permissions-table](../includes/permissions/todotask-post-checklistitems-2-permissions.md)]
+
 ## HTTP request
 
+Permissions to create a checklistItem in a task of the signed-in user:
 <!-- {
   "blockType": "ignored"
 }
 -->
 ```http
 POST /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems
+```
+
+Permissions to create a checklistItem in a task of another user:
+<!-- {
+  "blockType": "ignored"
+}
+-->
+```http
 POST /users/{id | userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems
 ```
 

api-reference/beta/api/todotask-post-linkedresources.md

@@ -5,7 +5,7 @@ author: "avijityadav"
 ms.localizationpriority: medium
 ms.subservice: "outlook"
 doc_type: apiPageType
-ms.date: 07/09/2024
+ms.date: 05/18/2026
 ---
 
 # Create linkedResource
@@ -19,19 +19,35 @@ You can also create a **linkedResource** object while [creating a todoTask](/gra
 [!INCLUDE [national-cloud-support](../../includes/global-us.md)]
 
 ## Permissions
-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).
+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).
+
+### Permissions acting on self
 
 <!-- { "blockType": "permissions", "name": "todotask_post_linkedresources" } -->
 [!INCLUDE [permissions-table](../includes/permissions/todotask-post-linkedresources-permissions.md)]
 
+### Permissions acting on other users
+
+<!-- { "blockType": "permissions", "name": "todotask_post_linkedresources_2" } -->
+[!INCLUDE [permissions-table](../includes/permissions/todotask-post-linkedresources-2-permissions.md)]
+
 ## HTTP request
 
+Permissions to create a linkedResource in a task of the signed-in user:
 <!-- {
   "blockType": "ignored"
 }
 -->
 ```http
 POST /me/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources
+```
+
+Permissions to create a linkedResource in a task of another user:
+<!-- {
+  "blockType": "ignored"
+}
+-->
+```http
 POST /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{taskId}/linkedResources
 ```
 

api-reference/beta/api/todotasklist-delete.md

@@ -5,7 +5,7 @@ author: "avijityadav"
 ms.localizationpriority: medium
 ms.subservice: "outlook"
 doc_type: apiPageType
-ms.date: 04/05/2024
+ms.date: 05/18/2026
 ---
 
 # Delete todoTaskList
@@ -17,19 +17,35 @@ Deletes a [todoTaskList](../resources/todotasklist.md) object.
 [!INCLUDE [national-cloud-support](../../includes/global-us.md)]
 
 ## Permissions
-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).
+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).
+
+### Permissions acting on self
 
 <!-- { "blockType": "permissions", "name": "todotasklist_delete" } -->
 [!INCLUDE [permissions-table](../includes/permissions/todotasklist-delete-permissions.md)]
 
+### Permissions acting on other users
+
+<!-- { "blockType": "permissions", "name": "todotasklist_delete_2" } -->
+[!INCLUDE [permissions-table](../includes/permissions/todotasklist-delete-2-permissions.md)]
+
 ## HTTP request
 
+Permissions to delete a task list of the signed-in user:
 <!-- {
   "blockType": "ignored"
 }
 -->
 ```http
 DELETE /me/todo/lists/{todoTaskListId}
+```
+
+Permissions to delete a task list of another user:
+<!-- {
+  "blockType": "ignored"
+}
+-->
+```http
 DELETE /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}
 ```
 

api-reference/beta/api/todotasklist-post-tasks.md

@@ -5,7 +5,7 @@ author: "avijityadav"
 ms.localizationpriority: medium
 ms.subservice: "outlook"
 doc_type: apiPageType
-ms.date: 04/05/2024
+ms.date: 05/18/2026
 ---
 
 # Create todoTask
@@ -17,19 +17,35 @@ Create a new task object in a specified [todoTaskList](../resources/todotasklist
 [!INCLUDE [national-cloud-support](../../includes/global-us.md)]
 
 ## Permissions
-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).
+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).
+
+### Permissions acting on self
 
 <!-- { "blockType": "permissions", "name": "todotasklist_post_tasks" } -->
 [!INCLUDE [permissions-table](../includes/permissions/todotasklist-post-tasks-permissions.md)]
 
+### Permissions acting on other users
+
+<!-- { "blockType": "permissions", "name": "todotasklist_post_tasks_2" } -->
+[!INCLUDE [permissions-table](../includes/permissions/todotasklist-post-tasks-2-permissions.md)]
+
 ## HTTP request
 
+Permissions to create a task for the signed-in user:
 <!-- {
   "blockType": "ignored"
 }
 -->
 ```http
 POST /me/todo/lists/{todoTaskListId}/tasks
+```
+
+Permissions to create a task for another user:
+<!-- {
+  "blockType": "ignored"
+}
+-->
+```http
 POST /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks
 ```
 

api-reference/beta/api/todotasklist-update.md

@@ -5,7 +5,7 @@ author: "avijityadav"
 ms.localizationpriority: medium
 ms.subservice: "outlook"
 doc_type: apiPageType
-ms.date: 04/05/2024
+ms.date: 05/18/2026
 ---
 
 # Update todoTaskList
@@ -17,20 +17,36 @@ Update the properties of a [todoTaskList](../resources/todotasklist.md) object.
 [!INCLUDE [national-cloud-support](../../includes/global-us.md)]
 
 ## Permissions
-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).
+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).
+
+### Permissions acting on self
 
 <!-- { "blockType": "permissions", "name": "todotasklist_update" } -->
 [!INCLUDE [permissions-table](../includes/permissions/todotasklist-update-permissions.md)]
 
+### Permissions acting on other users
+
+<!-- { "blockType": "permissions", "name": "todotasklist_update_2" } -->
+[!INCLUDE [permissions-table](../includes/permissions/todotasklist-update-2-permissions.md)]
+
 ## HTTP request
 
+Permissions to update a task list of the signed-in user:
 <!-- {
   "blockType": "ignored"
 }
 -->
 ```http
 PATCH /me/todo/lists/{todoTaskListId}
-PATCH /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks
+```
+
+Permissions to update a task list of another user:
+<!-- {
+  "blockType": "ignored"
+}
+-->
+```http
+PATCH /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}
 ```
 
 ## Request headers

api-reference/beta/includes/permissions/todotask-delete-2-permissions.md

@@ -0,0 +1,11 @@
+---
+description: "Automatically generated file. DO NOT MODIFY"
+ms.topic: include
+ms.localizationpriority: medium
+---
+
+|Permission type|Least privileged permissions|Higher privileged permissions|
+|:---|:---|:---|
+|Delegated (work or school account)|Tasks.ReadWrite|Not available.|
+|Delegated (personal Microsoft account)|Not supported.|Not supported.|
+|Application|Tasks.ReadWrite.All|Not available.|

api-reference/beta/includes/permissions/todotask-list-linkedresources-2-permissions.md

@@ -0,0 +1,11 @@
+---
+description: "Automatically generated file. DO NOT MODIFY"
+ms.topic: include
+ms.localizationpriority: medium
+---
+
+|Permission type|Least privileged permissions|Higher privileged permissions|
+|:---|:---|:---|
+|Delegated (work or school account)|Tasks.Read|Tasks.ReadWrite|
+|Delegated (personal Microsoft account)|Not supported.|Not supported.|
+|Application|Tasks.Read.All|Tasks.ReadWrite.All|