Merge pull request #23760 from microsoftgraph/main

Merge to publish.

api-reference/beta/api/callrecords-callrecord-getdirectroutingcalls.md

@@ -1,7 +1,7 @@
 ---
 title: "callRecord: getDirectRoutingCalls"
 description: "Get a log of direct routing calls."
-author: "williamlooney"
+author: "saurabhjain0804"
 ms.localizationpriority: medium
 ms.prod: "cloud-communications"
 doc_type: "apiPageType"
@@ -55,14 +55,14 @@ The following table shows the parameters that can be used with this function.
 
 If successful, this function returns a `200 OK` response code and a collection of [directRoutingLogRow](../resources/callrecords-directroutinglogrow.md) entries in the response body.
 
-If there are more than 1000 entries in the date range, the body also includes an `@odata.NextLink` with a URL to query the next page of call entries. The last page in the date range doesn't have `@odata.NextLink`. For more information, see [paging Microsoft Graph data in your app](/graph/paging).
+If there are more than 1,000 entries in the date range, the body also includes an `@odata.nextLink` with a URL to query the next page of call entries. The last page in the date range doesn't have `@odata.nextLink`. For more information, see [paging Microsoft Graph data in your app](/graph/paging).
 
 ## Example
 
-The following example shows how to get a collection of records for direct routing calls that occurred in the specified date range. The response includes `"@odata.count": 1000` to enumerate the number of records in this first response, and `@odata.NextLink` to get records beyond the first 1000. For readability, the response shows only a collection of one record. Assume there are more than 1000 calls in that date range.
+The following example shows how to get a collection of records for direct routing calls that occurred in the specified date range. The response includes `"@odata.count": 1000` to enumerate the number of records in this first response, and `@odata.nextLink` to get records beyond the first 1,000. For readability, the response shows only a collection of one record. Assume there are more than 1,000 calls in that date range.
 
 ### Request
-
+The following example shows a request.
 # [HTTP](#tab/http)
 <!-- {
   "blockType": "request",
@@ -105,13 +105,12 @@ GET https://graph.microsoft.com/beta/communications/callRecords/getDirectRouting
 ---
 
 ### Response
-
-**Note:** The response object shown here might be shortened for readability.
+The following example shows the response.
+>**Note:** The response object shown here might be shortened for readability.
 <!-- {
   "blockType": "response",
   "truncated": true,
-  "@odata.type": "microsoft.graph.callRecords.directRoutingLogRow",
-  "isCollection": true
+  "@odata.type": "Collection(microsoft.graph.callRecords.directRoutingLogRow)"
 }
 -->
 
@@ -156,7 +155,7 @@ HTTP/1.1 200 OK
 
 - [Microsoft Teams direct routing usage report](/microsoftteams/teams-analytics-and-reports/pstn-usage-report#direct-routing) in the Microsoft Teams admin center.
 - [Health dashboard for direct routing](/MicrosoftTeams/direct-routing-health-dashboard) in the Microsoft Teams admin center.
-- [Get log of PSTN calls](callrecords-callrecord-getpstncalls.md)
-- [Get aggregated report of the audio conferencing dial-out](callrecords-callrecord-getpstnonlinemeetingdialoutreport.md)
-- [Get log of users who are blocked from making PSTN calls](callrecords-callrecord-getpstnblockeduserslog.md)
-- [Get log of sent/received SMS](callrecords-callrecord-getsmslog.md)
+- [Get log of PSTN calls](callrecords-callrecord-getpstncalls.md).
+- [Get aggregated report of the audio conferencing dial-out](callrecords-callrecord-getpstnonlinemeetingdialoutreport.md).
+- [Get log of users who are blocked from making PSTN calls](callrecords-callrecord-getpstnblockeduserslog.md).
+- [Get log of sent/received SMS](callrecords-callrecord-getsmslog.md).

api-reference/beta/api/callrecords-callrecord-getpstnblockeduserslog.md

@@ -1,7 +1,7 @@
 ---
 title: "callRecord: getPstnBlockedUsersLog"
 description: "Get the log of users who are blocked/unblocked from making public switched telephone network (PSTN) calls in Microsoft Teams as a collection of pstnBlockedUsersLogRow entries."
-author: "radoslag" 
+author: "saurabhjain0804" 
 ms.localizationpriority: medium
 ms.prod: "cloud-communications"
 doc_type: apiPageType
@@ -60,15 +60,15 @@ Don't supply a request body for this method.
 
 If successful, this function returns a `200 OK` response code and a collection of [microsoft.graph.callRecords.pstnBlockedUsersLogRow](../resources/callrecords-pstnblockeduserslogrow.md) entries in the response body.
 
-If the function returns more than 1000 entries for the specified date range, the body also includes an `@odata.nextLink` with a URL to query the next page of entries. The last page in the date range doesn't have an `@odata.nextLink`. For more information, see [paging Microsoft Graph data in your app](/graph/paging).
+If the function returns more than 1,000 entries for the specified date range, the body also includes an `@odata.nextLink` with a URL to query the next page of entries. The last page in the date range doesn't have an `@odata.nextLink`. For more information, see [paging Microsoft Graph data in your app](/graph/paging).
 
 ## Example
 
-The following example shows how to get a collection of records for PSTN blocked users that occurred in the specified date range. The response includes `"@odata.count": 1000` to enumerate the number of records in the first response, and an `@odata.nextLink` to get records beyond the first 1000. For readability, the response object contains only a collection of two records.
+The following example shows how to get a collection of records for PSTN blocked users that occurred in the specified date range. The response includes `"@odata.count": 1000` to enumerate the number of records in the first response, and an `@odata.nextLink` to get records beyond the first 1,000. For readability, the response object contains only a collection of two records.
 
 ### Request
 
-The following is an example of a request.
+The following example shows a request.
 
 # [HTTP](#tab/http)
 <!-- {

api-reference/beta/api/callrecords-callrecord-getpstncalls.md

@@ -1,7 +1,7 @@
 ---
 title: "callRecord: getPstnCalls"
 description: "Get log of PSTN calls."
-author: "williamlooney"
+author: "saurabhjain0804"
 ms.localizationpriority: medium
 ms.prod: "cloud-communications"
 doc_type: "apiPageType"
@@ -58,14 +58,14 @@ The following table shows the parameters that can be used with this function.
 
 If successful, this function returns a `200 OK` response code and a collection of [pstnCallLogRow](../resources/callrecords-pstncalllogrow.md) entries in the response body.
 
-If there are more than 1000 entries in the date range, the body also includes an `@odata.NextLink` with a URL to query the next page of call entries. The last page in the date range does not have `@odata.NextLink`. For more information, see [paging Microsoft Graph data in your app](/graph/paging).
+If there are more than 1,000 entries in the date range, the body also includes an `@odata.nextLink` with a URL to query the next page of call entries. The last page in the date range doesn't have `@odata.nextLink`. For more information, see [paging Microsoft Graph data in your app](/graph/paging).
 
 ## Example
 
-The following example shows how to get a collection of records for PSTN calls that occurred in the specified date range. The response includes `"@odata.count": 1000` to enumerate the number of records in this first response, and `@odata.NextLink` to get records beyond the first 1000. For readability, the response shows only a collection of 1 record. Please assume there are more than 1000 calls in that date range.
+The following example shows how to get a collection of records for PSTN calls that occurred in the specified date range. The response includes `"@odata.count": 1000` to enumerate the number of records in this first response, and `@odata.nextLink` to get records beyond the first 1,000. For readability, the response shows only a collection of 1 record. Please assume there are more than 1,000 calls in that date range.
 
 ### Request
-The following is an example of a request.
+The following example shows a request.
 # [HTTP](#tab/http)
 <!-- {
   "blockType": "request",

api-reference/beta/api/callrecords-callrecord-getpstnonlinemeetingdialoutreport.md

@@ -1,7 +1,7 @@
 ---
 title: "callRecord: getPstnOnlineMeetingDialoutReport"
 description: "Get aggregated report of the usage and money spent for the audio conferencing dial-out service as a collection of pstnOnlineMeetingDialoutReport entries."
-author: "radoslag"
+author: "saurabhjain0804"
 ms.localizationpriority: medium
 ms.prod: "cloud-communications"
 doc_type: apiPageType
@@ -67,15 +67,15 @@ Don't supply a request body for this method.
 
 If successful, this function returns a `200 OK` response code and a collection of [microsoft.graph.callRecords.pstnOnlineMeetingDialoutReport](../resources/callrecords-pstnonlinemeetingdialoutreport.md) entries in the response body.
 
-If the function returns more than 1000 entries for the specified date range, the body also includes an `@odata.nextLink` with a URL to query the next page of entries. The last page in the date range doesn't have an `@odata.nextLink`. For more information, see [paging Microsoft Graph data in your app](/graph/paging).
+If the function returns more than 1,000 entries for the specified date range, the body also includes an `@odata.nextLink` with a URL to query the next page of entries. The last page in the date range doesn't have an `@odata.nextLink`. For more information, see [paging Microsoft Graph data in your app](/graph/paging).
 
 ## Example
 
-The following example shows how to get the aggregated report for the audio conferencing dial-out service over a specified date range. The response includes `"@odata.count": 1000` to enumerate the number of records in this first response, and an `@odata.nextLink` to get records beyond the first 1000. For readability, the response object contains only a collection of one record.
+The following example shows how to get the aggregated report for the audio conferencing dial-out service over a specified date range. The response includes `"@odata.count": 1000` to enumerate the number of records in this first response, and an `@odata.nextLink` to get records beyond the first 1,000. For readability, the response object contains only a collection of one record.
 
 ### Request
 
-The following is an example of a request.
+The following example shows a request.
 # [HTTP](#tab/http)
 <!-- {
   "blockType": "request",

api-reference/beta/api/callrecords-callrecord-getsmslog.md

@@ -1,7 +1,7 @@
 ---
 title: "callRecord: getSmsLog"
 description: "Get the log of a sent/received SMS as a collection of smsLogRow entries."
-author: "radoslag"
+author: "saurabhjain0804"
 ms.localizationpriority: medium
 ms.prod: "cloud-communications"
 doc_type: apiPageType
@@ -60,15 +60,15 @@ Don't supply a request body for this method.
 
 If successful, this function returns a `200 OK` response code and a collection of [microsoft.graph.callRecords.smsLogRow](../resources/callrecords-smslogrow.md) entries in the response body.
 
-If the function returns more than 1000 entries for the specified date range, the body also includes an `@odata.nextLink` with a URL to query the next page of entries. The last page in the date range doesn't have an `@odata.nextLink`. For more information, see [paging Microsoft Graph data in your app](/graph/paging).
+If the function returns more than 1,000 entries for the specified date range, the body also includes an `@odata.nextLink` with a URL to query the next page of entries. The last page in the date range doesn't have an `@odata.nextLink`. For more information, see [paging Microsoft Graph data in your app](/graph/paging).
 
 ## Example
 
-The following example shows how to get the log of sent/received SMS that occurred in the specified date range. The response includes `"@odata.count": 1000` to enumerate the number of records in this first response, and an `@odata.nextLink` to get records beyond the first 1000. For readability, the response object contains only a collection of one record.
+The following example shows how to get the log of sent/received SMS that occurred in the specified date range. The response includes `"@odata.count": 1000` to enumerate the number of records in this first response, and an `@odata.nextLink` to get records beyond the first 1,000. For readability, the response object contains only a collection of one record.
 
 ### Request
 
-The following is an example of a request.
+The following example shows a request.
 # [HTTP](#tab/http)
 <!-- {
   "blockType": "request",

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

@@ -22,6 +22,8 @@ Choose the permission or permissions marked as least privileged for this API. Us
 <!-- { "blockType": "permissions", "name": "rbacapplication_list_roleassignmentscheduleinstances" } -->
 [!INCLUDE [permissions-table](../includes/permissions/rbacapplication-list-roleassignmentscheduleinstances-permissions.md)]
 
+[!INCLUDE [rbac-pim-entra-roles-apis](../includes/rbac-for-apis/rbac-pim-entra-roles-apis.md)]
+
 ## HTTP request
 
 <!-- {

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

@@ -22,6 +22,8 @@ Choose the permission or permissions marked as least privileged for this API. Us
 <!-- { "blockType": "permissions", "name": "rbacapplication_list_roleassignmentschedules" } -->
 [!INCLUDE [permissions-table](../includes/permissions/rbacapplication-list-roleassignmentschedules-permissions.md)]
 
+[!INCLUDE [rbac-pim-entra-roles-apis](../includes/rbac-for-apis/rbac-pim-entra-roles-apis.md)]
+
 ## HTTP request
 
 <!-- {

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

@@ -22,6 +22,8 @@ Choose the permission or permissions marked as least privileged for this API. Us
 <!-- { "blockType": "permissions", "name": "rbacapplication_list_roleeligibilityscheduleinstances" } -->
 [!INCLUDE [permissions-table](../includes/permissions/rbacapplication-list-roleeligibilityscheduleinstances-permissions.md)]
 
+[!INCLUDE [rbac-pim-entra-roles-apis](../includes/rbac-for-apis/rbac-pim-entra-roles-apis.md)]
+
 ## HTTP request
 
 <!-- {

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

@@ -22,6 +22,8 @@ Choose the permission or permissions marked as least privileged for this API. Us
 <!-- { "blockType": "permissions", "name": "rbacapplication_list_roleeligibilityschedules" } -->
 [!INCLUDE [permissions-table](../includes/permissions/rbacapplication-list-roleeligibilityschedules-permissions.md)]
 
+[!INCLUDE [rbac-pim-entra-roles-apis](../includes/rbac-for-apis/rbac-pim-entra-roles-apis.md)]
+
 ## HTTP request
 
 <!-- {

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

@@ -1,7 +1,7 @@
 ---
 author: "vanshisingh"
-title: "List items in recycleBin"
-description: "Get a list of recycleBinItems under the specified site."
+title: "List items"
+description: "Get a collection of recycleBinItem resources in the recycleBin of the specified SharePoint site."
 ms.localizationpriority: "medium"
 ms.prod: "sharepoint"
 doc_type: apiPageType
@@ -13,7 +13,7 @@ Namespace: microsoft.graph
 
 [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
-Get a collection of [recycleBinItem](../resources/recyclebinitem.md) resources in the [recyleBin](../resources/recyclebin.md) of the specified SharePoint [site](../resources/site.md).
+Get a collection of [recycleBinItem](../resources/recyclebinitem.md) resources in the [recycleBin](../resources/recyclebin.md) of the specified SharePoint [site](../resources/site.md).
 
 [!INCLUDE [national-cloud-support](../../includes/global-only.md)]
 
@@ -53,7 +53,7 @@ If successful, this method returns a `200 OK` response code and a collection of
 
 ### Request
 
-The following example shows a request to list all **recycleBinItems** under a specific site.
+The following example shows a request to list all **recycleBinItem** resources under a specific site.
 
 # [HTTP](#tab/http)
 <!-- {

api-reference/beta/resources/callrecords-directroutinglogrow.md

@@ -1,7 +1,7 @@
 ---
 title: "directRoutingLogRow resource type"
 description: "Represents a row of data in the direct routing call log."
-author: "mcm223"
+author: "saurabhjain0804"
 ms.localizationpriority: medium
 ms.prod: "cloud-communications"
 doc_type: "resourcePageType"
@@ -25,26 +25,26 @@ Represents a row of data in the direct routing call log. Each row maps to one ca
 
 |Property|Type|Description|
 |:---|:---|:---|
-|calleeNumber|String|Number of the user or bot who received the call ([E.164](https://en.wikipedia.org/wiki/E.164) format, but may include more data).|
+|calleeNumber|String|Number of the user or bot who received the call ([E.164](https://en.wikipedia.org/wiki/E.164) format, but might include more data).|
 |callEndSubReason|Int32|In addition to the SIP codes, Microsoft has own subcodes that indicate the specific issue.|
-|callerNumber|String|Number of the user or bot who made the call ([E.164](https://en.wikipedia.org/wiki/E.164) format, but may include more data).|
+|callerNumber|String|Number of the user or bot who made the call ([E.164](https://en.wikipedia.org/wiki/E.164) format, but might include more data).|
 |callType|String|Call type and direction.|
 |correlationId|String|Identifier (GUID) for the call that you can use when calling Microsoft Support.|
 |duration|Int32|Duration of the call in seconds.|
 |endDateTime|DateTimeOffset|Only exists for successful (fully established) calls. Time when call ended.|
 |failureDateTime|DateTimeOffset|Only exists for failed (not fully established) calls.|
-|finalSipCode|Int32|The code with which the call ended ([RFC 3261](https://tools.ietf.org/html/rfc3261)).|
+|finalSipCode|Int32|The final response code with which the call ended ([RFC 3261](https://tools.ietf.org/html/rfc3261)).|
 |finalSipCodePhrase|String|Description of the SIP code and Microsoft subcode.|
 |id|String|Unique call identifier (GUID).|
 |inviteDateTime|DateTimeOffset|The date and time when the initial invite was sent.|
 |mediaBypassEnabled|Boolean|Indicates if the trunk was enabled for media bypass or not.|
 |mediaPathLocation|String|The data center used for media path in non-bypass call.|
-|otherPartyCountryCode|String|Country code of the caller for an incoming call, or callee for an outgoing call. For details, see [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).|
+|otherPartyCountryCode|String|Country/region code of the caller for an incoming call, or callee for an outgoing call. For details, see [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).|
 |signalingLocation|String|The data center used for signaling for both bypass and non-bypass calls.|
-|startDateTime|DateTimeOffset|Call start time.<br/>For failed and unanswered calls, this can be equal to invite or failure time.|
+|startDateTime|DateTimeOffset|Call start time.<br/>For failed and unanswered calls, this value can be equal to invite or failure time.|
 |successfulCall|Boolean|Success or attempt.|
 |trunkFullyQualifiedDomainName|String|Fully qualified domain name of the session border controller.|
-|userCountryCode|String|Country code of the user. For details, see [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).|
+|userCountryCode|String|Country/region code of the user. For details, see [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).|
 |userDisplayName|String|Display name of the user.|
 |userId|String|The unique identifier (GUID) of the user in Microsoft Entra ID. This and other user info is null/empty for bot call types.|
 |userPrincipalName|String|The user principal name (sign-in name) in Microsoft Entra ID, is usually the same as the user's SIP address, and can be same as the user's e-mail address.|

api-reference/beta/resources/callrecords-pstnblockeduserslogrow.md

@@ -1,7 +1,7 @@
 ---
 title: "pstnBlockedUsersLogRow resource type"
 description: "Represents a row of data in the public switched telephone network (PSTN) blocked users log."
-author: "radoslag"
+author: "saurabhjain0804"
 ms.localizationpriority: medium
 ms.prod: "cloud-communications"
 doc_type: resourcePageType

api-reference/beta/resources/callrecords-pstncalllogrow.md

@@ -1,7 +1,7 @@
 ---
 title: "pstnCallLogRow resource type"
 description: "Represents a row of data in the public switched telephone network (PSTN) call log."
-author: "mcm223"
+author: "saurabhjain0804"
 ms.localizationpriority: medium
 ms.prod: "cloud-communications"
 doc_type: "resourcePageType"

api-reference/beta/resources/callrecords-pstnonlinemeetingdialoutreport.md

@@ -1,7 +1,7 @@
 ---
 title: "pstnOnlineMeetingDialoutReport resource type"
 description: "Represents a report of usage and money spent for the audio conferencing dial-out service over a selected period."
-author: "radoslag"
+author: "saurabhjain0804"
 ms.localizationpriority: medium
 ms.prod: "cloud-communications"
 doc_type: resourcePageType