Merge pull request #26324 from microsoftgraph/main

Merge main into live

Author: FaithOmbongi

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

@@ -1,13 +1,14 @@
 ---
 author: spgraph-docs-team
 description: "Get the collection of items in a list."
-title: Retrieve items from a SharePoint list
+title: "List items"
 ms.localizationpriority: medium
 ms.subservice: "sharepoint"
 doc_type: apiPageType
 ms.date: 04/05/2024
 ---
-# Enumerate items in a list
+
+# List items
 
 Namespace: microsoft.graph
 
@@ -35,6 +36,19 @@ GET /sites/{site-id}/lists/{list-id}/items?expand=fields
 GET /sites/{site-id}/lists/{list-id}/items?expand=fields(select=Column1,Column2)
 ```
 
+## Optional query parameters
+
+This method supports the `$filter` and `$expand` of the [OData query parameters](/graph/query-parameters) to help customize the response. 
+
+### Using the $filter query parameter
+
+You can apply the `$filter` (`eq`, `ne`, `lt`, `gt`, `le`, `ge`, and `startswith`) query parameter to get a subset of the [listItem](../resources/listitem.md) collection. Both **listItem** properties and fields can be filtered. When filtering on indexed fields, the service can only filter one indexed field at a time.
+
+> [!NOTE]
+> Filtering works best on indexed columns.
+
+Depending on the number of items that match the filtering condition, the results are either be returned all at once or in multiple pages. For more information, see [Paging Microsoft Graph data in your app](/graph/paging).
+
 ## Request headers
 
 | Name      |Description|
@@ -49,54 +63,85 @@ Don't supply a request body for this method.
 
 If successful, this method returns a `200 OK` response code and a collection of [listItem][item] objects in the response body.
 
-## Example
+## Examples
 
-### Request
+### Example 1: Get list items with specific fields
+
+The following example shows how to get a **listItem** collection with specific fields using the `$expand` query parameter.
+
+#### Request
 
 The following example shows a request.
 
-# [HTTP](#tab/http)
-<!-- { "blockType": "request", "name": "get-list-items" } -->
+<!-- { 
+  "blockType": "request", 
+  "name": "get-list-items",
+  "sampleKeys": ["contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE", "243bca4b-4e5e-45af-b37d-25f6135a740d"]  
+} -->
 
 ```msgraph-interactive
-GET https://graph.microsoft.com/beta/sites/{site-id}/lists/{list-id}/items?expand=fields(select=Name,Color,Quantity)
+GET https://graph.microsoft.com/beta/sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE/lists/243bca4b-4e5e-45af-b37d-25f6135a740d/items?expand=fields(select=Name,Color,Quantity)
 ```
 
-# [C#](#tab/csharp)
-[!INCLUDE [sample-code](../includes/snippets/csharp/get-list-items-csharp-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+#### Response
 
-# [CLI](#tab/cli)
-[!INCLUDE [sample-code](../includes/snippets/cli/get-list-items-cli-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+The following example shows the response.
 
-# [Go](#tab/go)
-[!INCLUDE [sample-code](../includes/snippets/go/get-list-items-go-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+<!-- { "blockType": "response", "@odata.type": "Collection(microsoft.graph.listItem)", "truncated": true } -->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
 
-# [Java](#tab/java)
-[!INCLUDE [sample-code](../includes/snippets/java/get-list-items-java-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+{
+  "value": [
+    {
+      "id": "2",
+      "fields": {
+        "Name": "Gadget",
+        "Color": "Red",
+        "Quantity": 503
+       }
+    },
+    {
+      "id": "4",
+      "fields": {
+        "Name": "Widget",
+        "Color": "Blue",
+        "Quantity": 2357
+       }
+    },
+    {
+      "id": "7",
+      "fields": {
+        "Name": "Gizmo",
+        "Color": "Green",
+        "Quantity": 92
+       }
+    }
+  ]
+}
+```
 
-# [JavaScript](#tab/javascript)
-[!INCLUDE [sample-code](../includes/snippets/javascript/get-list-items-javascript-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+### Example 2: Get filtered list items with specific fields
 
-# [PHP](#tab/php)
-[!INCLUDE [sample-code](../includes/snippets/php/get-list-items-php-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+The following example shows how to get a **listItem** collection filtered by the **Quantity** field with specific fields using the `$expand` query parameter.
 
-# [PowerShell](#tab/powershell)
-[!INCLUDE [sample-code](../includes/snippets/powershell/get-list-items-powershell-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+#### Request
 
-# [Python](#tab/python)
-[!INCLUDE [sample-code](../includes/snippets/python/get-list-items-python-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+The following example shows a request.
 
----
+<!-- { 
+  "blockType": "request", 
+  "name": "get-list-items-with-filter", 
+  "scopes": "sites.read.all",
+  "sampleKeys": ["contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE", "243bca4b-4e5e-45af-b37d-25f6135a740d"] 
+} -->
+```http
+GET https://graph.microsoft.com/beta/sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE/lists/243bca4b-4e5e-45af-b37d-25f6135a740d/items?expand=fields(select=Name,Color,Quantity)&$filter=fields/Quantity lt 600
+```
 
-### Response
+#### Response
 
 The following example shows the response.
 
@@ -116,14 +161,6 @@ Content-type: application/json
         "Quantity": 503
        }
     },
-    {
-      "id": "4",
-      "fields": {
-        "Name": "Widget",
-        "Color": "Blue",
-        "Quantity": 2357
-       }
-    },
     {
       "id": "7",
       "fields": {

api-reference/beta/api/security-ediscoveryholdpolicy-list-usersources.md

@@ -21,7 +21,7 @@ Get a list of the [userSource](../resources/security-usersource.md) objects asso
 ## 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).
 
-<!-- { "blockType": "permissions", "name": "security_ediscoverycustodian_list_usersources" } -->
+<!-- { "blockType": "permissions", "name": "security_ediscoveryholdpolicy_list_usersources" } -->
 [!INCLUDE [permissions-table](../includes/permissions/security-ediscoveryholdpolicy-list-usersources-permissions.md)]
 ## HTTP request
 

api-reference/beta/api/security-ediscoveryreviewset-addtoreviewset.md

@@ -168,4 +168,4 @@ The following example shows the response.
 -->
 ``` http
 HTTP/1.1 202 Accepted
-```
+```

api-reference/beta/api/subscriptions-socketio.md

@@ -112,19 +112,29 @@ The part of the string before `/callback?` is the socket.io endpoint URL and the
 The following example shows how to use the `notificationUrl` with socket.io in JavaScript.
 
 ```javascript
-// this is the notificationUrl returned from this API
-var notificationUrl = "https://f3hb0mpua.svc.ms/zbaehwg/callback?snthgk=1ff3-2345672zz831837523";
-
-// after the split, split[0] will be everything leading up to '/callback?' and split[1] will be everything after.
-var split = notificationUrl.split("/callback?");
-
-// 'io' comes from the socket.io client library
-var socket = io(split[0], { query: split[1] });
-
-// these examples log to the console.
-// your app would provide its own callbacks
-socket.on("connect", ()=>console.log("Connected!"));
-socket.on("notification", (data)=>console.log("Notification!", data));
+<script src="https://cdnjs.cloudflare.com/ajax/libs/socket.io/4.8.1/socket.io.js"></script>
+<script>
+  // This is the notificationUrl returned from this API
+  var notificationUrl = "https://f3hb0mpua.svc.ms/zbaehwg/callback?snthgk=1ff3-2345672zz831837523";
+  
+  // 'io' comes from the socket.io client library
+  var socket = io(notificationUrl, {
+    transports: ['websocket'] // Make sure to use "websocket" instead of the default value of "polling" which isn't supported
+  });
+  
+  socket.on("connect", () => {
+    console.log(`connect`, socket.id);
+  });
+  
+  socket.on("disconnect", () => {
+    // Returns "undefined" on disconnect
+    console.log(`disconnect`, socket.id);
+  });
+  
+  socket.on("notification", (data) => {
+    console.log(`Notification received:`, data);
+  });
+</script>
 ```
 
 <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 

api-reference/beta/includes/permissions/onlinemeeting-getalltranscripts-permissions.md

@@ -6,7 +6,7 @@ ms.localizationpriority: medium
 
 |Permission type|Least privileged permissions|Higher privileged permissions|
 |:---|:---|:---|
-|Delegated (work or school account)|OnlineMeetings.Read|OnlineMeetings.ReadWrite|
+|Delegated (work or school account)|Not supported.|Not supported.|
 |Delegated (personal Microsoft account)|Not supported.|Not supported.|
-|Application|OnlineMeetings.Read.All|OnlineMeetings.ReadWrite.All|
+|Application|OnlineMeetings.Read.All|Not available.|
 

api-reference/beta/includes/permissions/security-ediscoveryholdpolicy-delete-usersources-permissions.md

@@ -9,3 +9,4 @@ ms.localizationpriority: medium
 |Delegated (work or school account)|eDiscovery.Read.All|eDiscovery.ReadWrite.All|
 |Delegated (personal Microsoft account)|Not supported.|Not supported.|
 |Application|eDiscovery.Read.All|eDiscovery.ReadWrite.All|
+

api-reference/beta/includes/permissions/security-ediscoveryholdpolicy-list-usersources-permissions.md

@@ -27,6 +27,7 @@ All examples are relative to a **[list][]**; for example, `https://graph.microso
 
 | Method                                                                   | Return Type                        | Description                                                               |
 |:-------------------------------------------------------------------------|:-----------------------------------|:--------------------------------------------------------------------------|
+| [List](../api/listitem-list.md)                                          | listItem collection                | Get the collection of items in a list.                                    |
 | [Create][]                                                               | listItem                           | Create a new listItem in a list.                                          |
 | [Get][]                                                                  | listItem                           | Get an item in a list.                                                    |
 | [Update][]                                                               | [fieldValueSet][]                  | Update the properties on a listItem.                                      |

api-reference/beta/resources/listitem.md

@@ -26,7 +26,7 @@ Effective December 1, 2023, the **lastSuccessfulSignInDateTime** property is ava
 |lastNonInteractiveSignInRequestId|String|Request identifier of the last non-interactive sign-in performed by this user.|
 |lastSignInDateTime|DateTimeOffset|The last interactive sign-in date and time for a specific user. You can use this field to calculate the last time a user attempted (either successfully or unsuccessfully) to sign in to the directory the directory with an interactive authentication method. This field can be used to build reports, such as inactive users. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Microsoft Entra ID maintains interactive sign-ins going back to April 2020. For more information about using the value of this property, see [Manage inactive user accounts in Microsoft Entra ID](/azure/active-directory/reports-monitoring/howto-manage-inactive-user-accounts).|
 |lastSignInRequestId|String|Request identifier of the last interactive sign-in performed by this user.|
-|lastSuccessfulSignInDateTime|DateTimeOffset|The date and time of the user's most recent successful sign-in activity. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.|
+|lastSuccessfulSignInDateTime|DateTimeOffset|The date and time of the user's most recent successful interactive or non-interactive sign-in. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.|
 |lastSuccessfulSignInRequestId|String|The request ID of the last successful sign-in.|
 
 ## JSON representation

api-reference/beta/resources/signinactivity.md

@@ -152,6 +152,8 @@ items:
   items:
   - name: List item
     href: ../../resources/listitem.md
+  - name: List
+    href: ../../api/listitem-list.md
   - name: Create
     href: ../../api/listitem-create.md
   - name: Get