Merge pull request #28739 from microsoftgraph/main

Auto Publish – main to live - 2026-04-25 00:30 UTC

Author: learn-build-service-prod[bot]

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

@@ -29,6 +29,11 @@ Choose the permission or permissions marked as least privileged for this API. Us
 
 [!INCLUDE [rbac-agentid-apis-write](../includes/rbac-for-apis/rbac-agentid-apis-write.md)]
 
+### Permissions for specific scenarios
+- The least privileged permission to update credential-related properties such as **keyCredentials** and **passwordCredentials** is *AgentIdentityBlueprint.AddRemoveCreds.All*.
+- The least privileged permission to update branding properties such as **displayName** and **description** is *AgentIdentityBlueprint.UpdateBranding.All*.
+- To update properties covered by both permission scopes, use the higher-privileged *AgentIdentityBlueprint.ReadWrite.All* permission.
+
 ## HTTP request
 
 <!-- {
@@ -52,7 +57,7 @@ In the request body, supply the values for relevant fields that should be update
 
 | Property | Type | Description |
 |:---------|:-----|:------------|
-| displayName | String | The display name for the agent identity blueprint. |
+| displayName | String | The display name for the agent identity blueprint. The least privileged permission to update this property is *AgentIdentityBlueprint.UpdateBranding.All*. |
 | managerApplications | Guid collection | A collection of application IDs for applications designated as managers of this agent identity blueprint. Manager applications can create agent blueprint principals, agent identities, and agent users for their managed blueprints without requiring high-privileged permissions such as `AgentIdentityBlueprintPrincipal.ReadWrite.All`. Currently, only Microsoft first-party application IDs can be set as values. Maximum of 10 values. Not nullable. |
 
 ## Response

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

@@ -14,7 +14,7 @@ Namespace: microsoft.graph
 
 [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
-Delete a [agentIdentityBlueprintPrincipal](../resources/agentidentityblueprintprincipal.md) object. When deleted, agent identity blueprint prinicpals are moved to a temporary container and can be restored within 30 days. After that time, they are permanently deleted.
+Delete a [agentIdentityBlueprintPrincipal](../resources/agentidentityblueprintprincipal.md) object. When deleted, agent identity blueprint principals are moved to a temporary container and can be restored within 30 days. After that time, they are permanently deleted.
 
 ## 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).

api-reference/beta/api/list-get.md

@@ -36,12 +36,14 @@ GET /sites/{site-id}/lists/{list-id}?expand=columns,items(expand=fields)
 
 ## Request body
 
-Do not supply a request body with this method.
+Don't supply a request body with this method.
 
-## Example
+## Examples
 
+### Example 1: Get list metadata by ID
+The following example shows how to get the metadata for a SharePoint list.
 #### Request
-
+The following examples shows a request.
 
 # [HTTP](#tab/http)
 <!-- { "blockType": "request", "name": "get-list-1" } -->
@@ -81,7 +83,7 @@ GET /sites/{site-id}/lists/{list-id}
 ---
 
 #### Response
-
+The following examples shows the response.
 <!-- { "blockType": "response", "@type": "microsoft.graph.list", "truncated": true, "scopes": "sites.read.all service.sharepoint" } -->
 
 ```http
@@ -93,17 +95,18 @@ Content-type: application/json
   "name": "MicroFeed",
   "createdDateTime": "2016-08-30T08:32:00Z",
   "lastModifiedDateTime": "2016-08-30T08:32:00Z",
+  "itemCount": 127,
   "list": {
     "hidden": false,
     "template": "genericList"
     }
 }
 ```
 
-With `select` and `expand` statements, you can retrieve list metadata, column definitions, and list items in a single request.
-
-#### Request
+### Example 2: Get list metadata by title
 The following example shows how to get a list from a SharePoint Online list title.
+#### Request
+The following example shows a request.
 
 # [HTTP](#tab/http)
 <!-- { "blockType": "request", "name": "get-list-2" } -->
@@ -143,7 +146,7 @@ GET /sites/{site-id}/lists/{list-title}
 ---
 
 #### Response
-
+The following example shows the response.
 <!-- { "blockType": "response", "@type": "microsoft.graph.list", "truncated": true, "scopes": "sites.read.all service.sharepoint" } -->
 
 ```http
@@ -155,23 +158,25 @@ Content-type: application/json
   "name": "MicroFeed",
   "createdDateTime": "2016-08-30T08:32:00Z",
   "lastModifiedDateTime": "2016-08-30T08:32:00Z",
+  "itemCount": 45,
   "list": {
     "hidden": false,
     "template": "genericList"
     }
 }
 ```
 
-With `select` and `expand` statements, you can retrieve list metadata, column definitions, and list items in a single request.
+### Example 3: Get list metadata and items with $select and $expand
+The following example shows how to use the `$select` and `$expand` OData query parameters to retrieve list metadata, column definitions, and list items in a single request.
 
 #### Request
-
+The following example shows a request.
 
 # [HTTP](#tab/http)
 <!-- { "blockType": "request", "name": "get-list-multi-expand" } -->
 
 ```msgraph-interactive
-GET /sites/{site-id}/lists/{list-id}?select=name,lastModifiedDateTime&expand=columns(select=name,description),items(expand=fields(select=Name,Color,Quantity))
+GET /sites/{site-id}/lists/{list-id}?select=name,lastModifiedDateTime,itemCount&expand=columns(select=name,description),items(expand=fields(select=Name,Color,Quantity))
 ```
 
 # [C#](#tab/csharp)
@@ -205,7 +210,7 @@ GET /sites/{site-id}/lists/{list-id}?select=name,lastModifiedDateTime&expand=col
 ---
 
 #### Response
-
+The following example shows the response.
 <!-- { "blockType": "response", "@type": "microsoft.graph.list", "truncated": true, "scopes": "sites.read.all service.sharepoint" } -->
 
 ```http
@@ -254,21 +259,24 @@ Content-type: application/json
         "Quantity": 92
        }
     }
-  ]
+  ],
+  "itemCount": 45
 }
 ```
-#### Request
 
-<!-- { "blockType": "request", "name": "get-list-multi-expand" } -->
+### Example 4: Get list metadata and items with multiple $expand parameters
+The following example shows how to get metadata and items for a list that contains three columns: *Name*, *Quantity*, and *Category*. [Managed metadata](/sharepoint/managed-metadata) columns like *Category* return values as term ID and term name pair.
+
+#### Request
+The following example shows a request.
+<!-- { "blockType": "request", "name": "get-list-multi-expand_4" } -->
 
-The following example shows how to get metadata for a list that contains three columns: Name, Quantity, and Category.
-[Managed Metadata](/sharepoint/managed-metadata) columns like ```Category``` return values as term ID and term name pair.
 ```http
 GET /sites/{site-id}/lists/{list-id}?select=name,lastModifiedDateTime&expand=columns(select=name,description),items(expand=fields(select=Name,Quantity,Category))
 ```
 
 #### Response
-
+The following example shows the response.
 <!-- { "blockType": "response", "@type": "microsoft.graph.list", "truncated": true, "scopes": "sites.read.all service.sharepoint" } -->
 
 ```http

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

@@ -108,6 +108,7 @@ Content-type: application/json
       "name": "Documents",
       "createdDateTime": "2016-08-30T08:32:00Z",
       "lastModifiedDateTime": "2016-08-30T08:32:00Z",
+      "itemCount": 312,
       "list": {
         "hidden": false,
         "template": "documentLibrary"
@@ -118,6 +119,7 @@ Content-type: application/json
       "name": "MicroFeed",
       "createdDateTime": "2016-08-30T08:32:00Z",
       "lastModifiedDateTime": "2016-08-30T08:32:00Z",
+      "itemCount": 45,
       "list": {
         "hidden": false,
         "template": "genericList"

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

@@ -20,11 +20,7 @@ Delete a [note](../resources/note.md) object. Supports optimistic concurrency co
 
 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).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "note-delete-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "note_delete" } -->
 [!INCLUDE [permissions-table](../includes/permissions/note-delete-permissions.md)]
 
 ## HTTP request

api-reference/beta/api/note-delta.md

@@ -20,11 +20,7 @@ Get a set of [note](../resources/note.md) objects that were added, updated, or d
 
 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).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "note-delta-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "note_delta" } -->
 [!INCLUDE [permissions-table](../includes/permissions/note-delta-permissions.md)]
 
 ## HTTP request

api-reference/beta/api/note-get.md

@@ -20,11 +20,7 @@ Read the properties and relationships of a [note](../resources/note.md) object.
 
 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).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "note-get-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "note_get" } -->
 [!INCLUDE [permissions-table](../includes/permissions/note-get-permissions.md)]
 
 ## HTTP request

api-reference/beta/api/note-list-attachments.md

@@ -20,11 +20,7 @@ Get the list of file attachments associated with a [note](../resources/note.md).
 
 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).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "note-list-attachments-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "note_list_attachments" } -->
 [!INCLUDE [permissions-table](../includes/permissions/note-list-attachments-permissions.md)]
 
 ## HTTP request

api-reference/beta/api/note-post-attachments.md

@@ -20,11 +20,7 @@ Create a [fileAttachment](../resources/fileattachment.md) object, which adds an
 
 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).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "note-post-attachments-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "note_post_attachments" } -->
 [!INCLUDE [permissions-table](../includes/permissions/note-post-attachments-permissions.md)]
 
 ## HTTP request

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

@@ -20,11 +20,7 @@ Update the properties of a [note](../resources/note.md) object. Supports optimis
 
 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).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "note-update-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "note_update" } -->
 [!INCLUDE [permissions-table](../includes/permissions/note-update-permissions.md)]
 
 ## HTTP request