Updates from: 09/13/2024 01:09:21
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Accesspackageassignmentrequest Resume https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/accesspackageassignmentrequest-resume.md
Title: "accessPackageAssignmentRequest: resume"
-description: "Resume accessPackageAssignmentRequest objects."
+description: "Resume a user's access package request after waiting for a callback from a custom extension."
ms.localizationpriority: medium
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-In [Microsoft Entra entitlement management](../resources/entitlementmanagement-overview.md), when an access package policy has been enabled to call out a custom extension and the request processing is waiting for the callback from the customer, the customer can initiate a resume action. It is performed on an [accessPackageAssignmentRequest](../resources/accesspackageassignmentrequest.md) object whose **requestStatus** is in a `WaitingForCallback` state.
+Resume a user's access package request after waiting for a callback from a custom extension.
+
+In [Microsoft Entra entitlement management](../resources/entitlementmanagement-overview.md), when an access package policy has been enabled to call out a custom extension and the request processing is waiting for the callback from the customer, the customer can initiate a resume action. It's performed on an [accessPackageAssignmentRequest](../resources/accesspackageassignmentrequest.md) object whose **requestStatus** is in a `WaitingForCallback` state.
[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
Choose the permission or permissions marked as least privileged for this API. Us
<!-- { "blockType": "permissions", "name": "accesspackageassignmentrequest_resume" } --> [!INCLUDE [permissions-table](../includes/permissions/accesspackageassignmentrequest-resume-permissions.md)]
+> [!IMPORTANT]
+> App-only access can be authorized *without* granting the `EntitlementManagement.ReadWrite.All` application permission to the caller. Instead, assign the caller an [Entitlement Management role](/entr#example-4-create-a-role-assignment-with-access-package-catalog-scope) or [Delegate access governance to access package managers in entitlement management](/entra/id-governance/entitlement-management-delegate-managers#as-a-catalog-owner-delegate-to-an-access-package-manager).
+ ## HTTP request > [!NOTE]
v1.0 Adminreportsettings Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/adminreportsettings-get.md
Choose the permission or permissions marked as least privileged for this API. Us
<!-- { "blockType": "permissions", "name": "adminreportsettings_get" } --> [!INCLUDE [permissions-table](../includes/permissions/adminreportsettings-get-permissions.md)]
-> **Note:** For delegated permissions to allow apps to get report settings on behalf of a user, the tenant administrator must have assigned the user the appropriate Microsoft Entra ID limited administrator role. For more details, see [Authorization for APIs to read Microsoft 365 usage reports](/graph/reportroot-authorization).
+> **Note:** For delegated permissions to allow apps to get report settings on behalf of a user, the tenant administrator must have assigned the user the appropriate Microsoft Entra ID limited administrator role. For more information, see [Authorization for APIs to read Microsoft 365 usage reports](/graph/reportroot-authorization).
## HTTP request
Choose the permission or permissions marked as least privileged for this API. Us
GET /admin/reportSettings ```
+## Optional query parameters
+
+This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response.
+ ## Request headers | Name | Description |
v1.0 Adminreportsettings Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/adminreportsettings-update.md
Choose the permission or permissions marked as least privileged for this API. Us
<!-- { "blockType": "permissions", "name": "adminreportsettings_update" } --> [!INCLUDE [permissions-table](../includes/permissions/adminreportsettings-update-permissions.md)]
-> **Note:** For delegated permissions to allow apps to update report settings on behalf of a user, the tenant administrator must have assigned the user the appropriate Microsoft Entra ID limited administrator role. For more details, see [Authorization for APIs to read Microsoft 365 usage reports](/graph/reportroot-authorization).
+> **Note:** For delegated permissions to allow apps to update report settings on behalf of a user, the tenant administrator must have assigned the user the appropriate Microsoft Entra ID limited administrator role. For more information, see [Authorization for APIs to read Microsoft 365 usage reports](/graph/reportroot-authorization).
## HTTP request <!-- { "blockType": "ignored" } -->
PATCH /admin/reportSettings
| Property | Type | Description | | -- | -- | - |
-| displayConcealedNames | Boolean | If set to `true`, all reports will conceal user information such as usernames, groups, and sites. If `false`, all reports will show identifiable information. This property represents a setting in the Microsoft 365 admin center. Required. |
+| displayConcealedNames | Boolean | If set to `true`, all reports conceal user information such as usernames, groups, and sites. If `false`, all reports show identifiable information. This property represents a setting in the Microsoft 365 admin center. Required. |
## Response
v1.0 Alert Updatealerts https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/alert-updatealerts.md
POST /security/alerts/updateAlerts
| Name | Description | |:--|:--|
-| Authorization | Bearer {code} |
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Appcatalogs List Teamsapps https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/appcatalogs-list-teamsapps.md
Title: "List teamsApp" description: "List apps from the Microsoft Teams app catalog."-+ ms.localizationpriority: medium doc_type: apiPageType
Content-Type: application/json
{ "id": "YTUyMjhjMjYtYTlhZS00NzAyLTkwZTAtNzlhNTI0NmQyZjdkIyMxLjAuMCMjUHVibGlzaGVk", "authorization": {
+ "clientAppId": "6ed63604-0ba7-4a28-bb3a-dda03ea18d54",
"requiredPermissionSet": { "resourceSpecificPermissions": [ {
Content-Type: application/json
"serializedInternalDefinition": null, "createdBy": null, "authorization": {
+ "clientAppId": null,
"requiredPermissionSet": { "resourceSpecificPermissions": [] }
Content-Type: application/json
"serializedInternalDefinition": null, "createdBy": null, "authorization": {
+ "clientAppId": null,
"requiredPermissionSet": { "resourceSpecificPermissions": [] }
v1.0 Application List Owners https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/application-list-owners.md
Title: "List owners"
-description: "Retrieve a list of owners (directoryObject objects) for an application."
+ Title: "List owners of an application"
+description: "Retrieve a list of owners for an application."
ms.localizationpriority: medium doc_type: apiPageType
-# List owners
+# List owners of an application
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve a list of owners for an application that are [directoryObject](../resources/directoryobject.md) objects.
+Retrieve a list of owners for an application that are [directoryObject](../resources/directoryobject.md) types.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
Choose the permission or permissions marked as least privileged for this API. Us
[!INCLUDE [limited-info](../../includes/limited-info.md)] -- ## HTTP request You can address the application using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in app registrations in the Microsoft Entra admin center.
GET /applications(appId='{appId}')/owners
``` ## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+This method supports the `$count`, `$expand`, `$filter`, `$orderby`, `$search`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. Some queries are supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on directory objects](/graph/aad-advanced-queries).
## Request headers | Name | Description |
Don't supply a request body for this method.
If successful, this method returns a `200 OK` response code and collection of [directoryObject](../resources/directoryobject.md) objects in the response body. ## Example
-##### Request
-The following example shows a request.
+### Request
+The following example shows a request that uses the **appId** alternate key to query the owners of an application.
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "application_get_owners" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/applications/{id}/owners
+GET https://graph.microsoft.com/beta/applications(appId='bbec3106-565f-4907-941e-96b4dbfef21c')/owners
```
-# [C#](#tab/csharp)
-
-# [CLI](#tab/cli)
-
-# [Go](#tab/go)
-
-# [Java](#tab/java)
-
-# [JavaScript](#tab/javascript)
-
-# [PHP](#tab/php)
-
-# [PowerShell](#tab/powershell)
-
-# [Python](#tab/python)
---
-##### Response
-The following example shows the response. Note: The response object shown here might be shortened for readability.
+### Response
+The following example shows the response. It shows only the **id** property as populated while other properties as `null`. This is because the caller did not have permissions to read users in the tenant.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
HTTP/1.1 200 OK
Content-type: application/json {
- "value": [
- {
- "id": "id-value"
- }
- ]
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#directoryObjects",
+ "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET applications(appId=<key>)/owners?$select=deletedDateTime",
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.user",
+ "id": "ce4770b3-70b2-4a38-a242-76631e9f7408",
+ "businessPhones": [],
+ "displayName": null,
+ "givenName": null,
+ "jobTitle": null,
+ "mail": null,
+ "mobilePhone": null,
+ "officeLocation": null,
+ "preferredLanguage": null,
+ "surname": null,
+ "userPrincipalName": null
+ },
+ {
+ "@odata.type": "#microsoft.graph.user",
+ "id": "858a9c90-38b3-4e78-b915-234aece712c4",
+ },
+ {
+ "@odata.type": "#microsoft.graph.user",
+ "id": "7585d967-f300-43de-b817-7119a6404c5e",
+ }
+ ]
} ```
v1.0 Application Post Calls https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/application-post-calls.md
Namespace: microsoft.graph
Create [call](../resources/call.md) enables your bot to create a new outgoing peer-to-peer or group call, or join an existing meeting. You need to [register the calling bot](/microsoftteams/platform/concepts/calls-and-meetings/registering-calling-bot) and go through the list of permissions needed.
+This API supports the following PSTN scenarios:
+++ Incoming call to bot's PSTN number and then bot invites another PSTN.++ Incoming call to bot's PSTN number and then bot transfer to another PSTN.++ Incoming call to bot's PSTN number and then bot redirects to another PSTN.++ Incoming call to bot's instance identifier and then bot invites another PSTN.++ Incoming call to bot's instance identifier and then bot transfer to another PSTN.++ Incoming call to bot's instance identifier and then bot redirects to another PSTN.++ Incoming call to bot's instance identifier from Scheduled Meeting and then bot invites PSTN.++ Outgoing call from bot (with instance identifier) to a PSTN.++ P2P call between bot and another peer (Teams user, PSTN), bot invites another PSTN.++ P2P call between bot and another peer (Teams user, PSTN), bot invites another Teams user.++ Bot join the scheduled meeting and then invite PSTN.+ [!INCLUDE [national-cloud-support](../../includes/global-only.md)] ## Permissions
If successful, this method returns a `201 Created` response code and a [call](..
The following example shows a request that makes a peer-to-peer call between the bot and the specified user. In this example, the media is hosted by the service. The values of authorization token, callback URL, application ID, application name, user ID, user name, and tenant ID must be replaced with actual values to make the example work.
-# [HTTP](#tab/http)
- <!-- { "blockType": "request", "name": "create-call-service-hosted-media-1",
Content-Type: application/json
], "callOptions": { "@odata.type": "#microsoft.graph.outgoingCallOptions",
- "isContentSharingNotificationEnabled": true
+ "isContentSharingNotificationEnabled": true,
+ "isDeltaRosterEnabled": true
}, "mediaConfig": { "@odata.type": "#microsoft.graph.serviceHostedMediaConfig"
Content-Type: application/json
} ```
-# [C#](#tab/csharp)
-
-# [CLI](#tab/cli)
-
-# [Go](#tab/go)
-
-# [Java](#tab/java)
-
-# [JavaScript](#tab/javascript)
-
-# [PHP](#tab/php)
-
-# [PowerShell](#tab/powershell)
-
-# [Python](#tab/python)
--- #### Response > **Note:** The response object shown here might be shortened for readability.
Content-Type: application/json
"chatInfo": null, "meetingInfo": null, "transcription": null,
+ "callOptions": {
+ "@odata.type": "#microsoft.graph.outgoingCallOptions",
+ "isContentSharingNotificationEnabled": true,
+ "isDeltaRosterEnabled": true
+ },
"meetingCapability": null, "toneInfo": null }
v1.0 Application Upsert https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/application-upsert.md
Create a new [application](../resources/application.md) object if it doesn't exi
> [!IMPORTANT] > Using PATCH to set [**passwordCredential**](../resources/passwordcredential.md) is not supported. Use the [addPassword](./application-addpassword.md) and [removePassword](./application-removepassword.md) methods to update the password or secret for an application. ## 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).
v1.0 Applicationsignindetailedsummary Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/applicationsignindetailedsummary-get.md
This method supports the [OData query parameters](/graph/query-parameters) to he
| Name |Description| |:-|:-|
-| Authorization | Bearer {code} |
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Applicationtemplate Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/applicationtemplate-get.md
For general information, see [OData query parameters](/graph/query-parameters).
| Name |Description| |:-|:-|
-| Authorization | Bearer {code} |
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Applicationtemplate Instantiate https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/applicationtemplate-instantiate.md
To instantiate non-gallery apps, use the `8adf8e6e-67b2-4cf2-a259-e3dc5476c621`
| Name | Description | |:--|:--|
-| Authorization | Bearer {code} |
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Applicationtemplate List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/applicationtemplate-list.md
For general information, see [OData query parameters](/graph/query-parameters).
| Name |Description| |:-|:-|
-| Authorization | Bearer {code} |
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Approvalitem Cancel https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalitem-cancel.md
Namespace: microsoft.graph
Cancel the [approval item](../resources/approvalitem.md). The owner of the approval can trigger this endpoint. + ## 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": "approvalitem-cancel-permissions"
-}
>
+<!-- { "blockType": "permissions", "name": "approvalitem_cancel" } -->
[!INCLUDE [permissions-table](../includes/permissions/approvalitem-cancel-permissions.md)] ## HTTP request
If successful, this method returns a `202 Accepted` response code with the opera
### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "approvalitemthis.cancel"
The following example shows a request.
POST https://graph.microsoft.com/beta/solutions/approval/approvalItems/ad65e077-4920-4bbd-a57e-b7f152958b83/cancel ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
++ ### Response
v1.0 Approvalitem Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalitem-get.md
Namespace: microsoft.graph
Read the properties and relationships of an [approvalItem](../resources/approvalitem.md) object. + ## 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": "approvalitem-get-permissions"
-}
>-
+<!-- { "blockType": "permissions", "name": "approvalitem_get" } -->
[!INCLUDE [permissions-table](../includes/permissions/approvalitem-get-permissions.md)] ## HTTP request
GET /solutions/approval/approvalItems/{approvalItemId}
## Optional query parameters
-This method doesn't support the OData query parameters to customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response.
## Request headers
If successful, this method returns a `200 OK` response code and an [approvalItem
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_approvalitem" } -->
-```http
+```msgraph-interactive
GET https://graph.microsoft.com/beta/solutions/approval/approvalItems/d3a7405e-452a-47e0-9c35-9335225ba55d ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
+++ ### Response The following example shows the response.
v1.0 Approvalitem List Requests https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalitem-list-requests.md
Namespace: microsoft.graph
Get a list of [approvalItemRequest](../resources/approvalitemrequest.md) objects. + ## 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": "approvalitem-list-requests-permissions"
-}
>
+<!-- { "blockType": "permissions", "name": "approvalitem_list_requests" } -->
[!INCLUDE [permissions-table](../includes/permissions/approvalitem-list-requests-permissions.md)] ## HTTP request
GET /solutions/approval/approvalItems/{approvalItemId}/requests
## Optional query parameters
-This method doesn't support the OData query parameters to customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+This method supports the `$filter`, `$orderby`, `$count` and `$select` [OData query parameters](/graph/query-parameters) to help customize the response.
## Request headers
If successful, this method returns a `200 OK` response code and a collection of
### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_approvalitemrequest"
The following example shows a request.
GET https://graph.microsoft.com/beta/solutions/approval/approvalItems/d3a7405e-452a-47e0-9c35-9335225ba55d/requests ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
++ ### Response
v1.0 Approvalitem List Responses https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalitem-list-responses.md
Namespace: microsoft.graph
Get a list of [approvalItemResponse](../resources/approvalitemresponse.md) objects. + ## 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": "approvalitem-list-responses-permissions"
-}
>
+<!-- { "blockType": "permissions", "name": "approvalitem_list_responses" } -->
[!INCLUDE [permissions-table](../includes/permissions/approvalitem-list-responses-permissions.md)] ## HTTP request
GET /solutions/approval/approvalItems/{approvalItemId}/responses
## Optional query parameters
-This method doesn't support the OData query parameters to customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+This method supports the `$filter`, `$orderby`, `$count` and `$select` [OData query parameters](/graph/query-parameters) to help customize the response.
## Request headers
If successful, this method returns a `200 OK` response code and a collection of
### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_approvalitemresponse"
The following example shows a request.
GET https://graph.microsoft.com/beta/solutions/approval/approvalItems/d3a7405e-452a-47e0-9c35-9335225ba55d/responses ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
++ ### Response
Content-Type: application/json
"id": "f4d6b152-d3c6-4c27-9bc6-1cd5cdcb8473" } },
- "createdDateTime":"2022-04-12T20:51:19Z",
- "onBehalfOf":[
- {
- "user":{
- "id":"39d1a7fb-5f54-4c89-b513-241683718c9b",
- "displayName":"Lilli Allik"
- }
- }
- ]
+ "createdDateTime":"2022-04-12T20:51:19Z"
}, { "id": "d3a7405e-452a-47e0-9c35-9335225ba55d",
Content-Type: application/json
"displayName": "Lilli Allik" } },
- "createdDateTime":"2022-04-12T20:51:19Z",
- "onBehalfOf":[
- {
- "user":{
- "id":"f4d6b152-d3c6-4c27-9bc6-1cd5cdcb8473",
- "displayName":"Jana Pihlak"
- }
- },
- {
- "group":{
- "id":"da9fe780-a3de-48cc-a571-82faa05c8463",
- "displayName":"Microsoft Executive"
- }
- }
- ]
+ "createdDateTime":"2022-04-12T20:51:19Z"
} ] }
v1.0 Approvalitem Post Responses https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalitem-post-responses.md
Namespace: microsoft.graph
Create a new [approvalItemResponse](../resources/approvalitemresponse.md) object. + ## 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": "approvalitem-post-responses-permissions"
-}
>
+<!-- { "blockType": "permissions", "name": "approvalitem_post_responses" } -->
[!INCLUDE [permissions-table](../includes/permissions/approvalitem-post-responses-permissions.md)] ## HTTP request
If successful, this method returns a `202 Accepted` response code with the opera
### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_approvalitemresponse_from_"
Content-Type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
++ ### Response
v1.0 Approvalitemrequest Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalitemrequest-get.md
Namespace: microsoft.graph
Read the properties and relationships of an [approvalItemRequest](../resources/approvalitemrequest.md) object. + ## 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": "approvalitemrequest-get-permissions"
-}
>
+<!-- { "blockType": "permissions", "name": "approvalitemrequest_get" } -->
[!INCLUDE [permissions-table](../includes/permissions/approvalitemrequest-get-permissions.md)] ## HTTP request
GET /solutions/approval/approvalItems/{approvalItemId}/requests/{approvalItemReq
## Optional query parameters
-This method doesn't support the OData query parameters to customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response.
## Request headers
If successful, this method returns a `200 OK` response code and an [approvalItem
### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_approvalitemrequest"
The following example shows a request.
GET https://graph.microsoft.com/beta/solutions/approval/approvalItems/7d096f68-c4fe-4967-99dc-df0248c33a77/requests/817d2849-c546-47f0-9c38-1a1a38ac6648 ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
++ ### Response
v1.0 Approvalitemresponse Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalitemresponse-get.md
Namespace: microsoft.graph
Read the properties and relationships of an [approvalItemResponse](../resources/approvalitemresponse.md) object. + ## 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": "approvalitemresponse-get-permissions"
-}
>
+<!-- { "blockType": "permissions", "name": "approvalitemresponse_get" } -->
[!INCLUDE [permissions-table](../includes/permissions/approvalitemresponse-get-permissions.md)] ## HTTP request
GET /solutions/approval/approvalItems/{approvalItemId}/responses/{approvalItemRe
## Optional query parameters
-This method doesn't support the OData query parameters to customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response.
## Request headers
If successful, this method returns a `200 OK` response code and an [approvalItem
### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_approvalitemresponse"
The following example shows a request.
GET https://graph.microsoft.com/beta/solutions/approval/approvalItems/7d096f68-c4fe-4967-99dc-df0248c33a77/responses/9d4c5640-1da7-4739-924f-d10b70c734c1 ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
++ ### Response
v1.0 Approvaloperation Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvaloperation-get.md
Namespace: microsoft.graph
Read the properties and relationships of an [approvalOperation](../resources/approvaloperation.md) object. + ## 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": "approvaloperation-get-permissions"
-}
>
+<!-- { "blockType": "permissions", "name": "approvaloperation_get" } -->
[!INCLUDE [permissions-table](../includes/permissions/approvaloperation-get-permissions.md)] ## HTTP request
GET /solutions/approval/operations/{approvalOperationId}
## Optional query parameters
-This method doesn't support the OData query parameters to customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+This method supports the `$filter`, `$orderby`, `$count` and `$select` [OData query parameters](/graph/query-parameters) to help customize the response.
## Request headers
If successful, this method returns a `200 OK` response code and an [approvalOper
### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_approvaloperation"
The following example shows a request.
GET https://graph.microsoft.com/beta/solutions/approval/operations/1c281a99-f105-4f88-86fa-52d797323908 ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
++ ### Response
v1.0 Approvalsolution Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalsolution-get.md
Namespace: microsoft.graph
Read the properties of an [approvalSolution](../resources/approvalsolution.md) object to determine the [provisioning](../api/approvalsolution-provision.md) state for a tenant. + ## 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": "approvalsolution-get-permissions"
-}
>
+<!-- { "blockType": "permissions", "name": "approvalsolution_get" } -->
[!INCLUDE [permissions-table](../includes/permissions/approvalsolution-get-permissions.md)] ## HTTP request
GET /solutions/approval
## Optional query parameters
-This method doesn't support the OData query parameters to customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response.
## Request headers
If successful, this method returns a `200 OK` response code and an [approvalSolu
### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_approvalsolution"
The following example shows a request.
GET https://graph.microsoft.com/beta/solutions/approval ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
++ ### Response
v1.0 Approvalsolution List Approvalitems https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalsolution-list-approvalitems.md
Namespace: microsoft.graph
Get a list of the [approvalItem](../resources/approvalitem.md) objects and their properties. + ## 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": "approvalsolution-list-approvalitems-permissions"
-}
>
+<!-- { "blockType": "permissions", "name": "approvalsolution_list_approvalitems" } -->
[!INCLUDE [permissions-table](../includes/permissions/approvalsolution-list-approvalitems-permissions.md)] ## HTTP request
GET /solutions/approval/approvalItems
## Optional query parameters
-This method supports the `$filter`, `$orderby`, `$top`, and `$select` [OData query parameters](/graph/query-parameters) to help customize the response.
+This method supports the `$filter`, `$orderby`, `$top`, `$count`, and `$select` [OData query parameters](/graph/query-parameters) to help customize the response.
If the result set spans multiple pages, the response body contains an `@odata.nextLink` that you can use to page through the result set. ## Request headers
If successful, this method returns a `200 OK` response code and a collection of
### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_approvalitem"
The following example shows a request.
GET https://graph.microsoft.com/beta/solutions/approval/approvalItems ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
++ ### Response
v1.0 Approvalsolution Post Approvalitems https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalsolution-post-approvalitems.md
Namespace: microsoft.graph
Create a new [approvalItem](../resources/approvalitem.md) object. + ## 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": "approvalsolution-post-approvalitems-permissions"
-}
>
+<!-- { "blockType": "permissions", "name": "approvalsolution_post_approvalitems" } -->
[!INCLUDE [permissions-table](../includes/permissions/approvalsolution-post-approvalitems-permissions.md)] ## HTTP request
If successful, this method returns a `202 Accepted` response code with the opera
### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_approvalitem_from_"
Content-Type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
++ ### Response
v1.0 Approvalsolution Provision https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalsolution-provision.md
Namespace: microsoft.graph
Provision an [approvalSolution](../resources/approvalsolution.md) on behalf of a tenant. + ## 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": "approvalsolution-provision-permissions"
-}
>
+<!-- { "blockType": "permissions", "name": "approvalsolution_provision" } -->
[!INCLUDE [permissions-table](../includes/permissions/approvalsolution-provision-permissions.md)] ## HTTP request
If successful, this action returns a `204 No Content` response code.
### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "approvalsolutionthis.provision"
The following example shows a request.
POST https://graph.microsoft.com/beta/solutions/approval/provision ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
++ ### Response
v1.0 Attachment Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/attachment-delete.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] - Delete an attachment from a user calendar [event](../resources/event.md), [message](../resources/message.md), [Outlook task](../resources/outlooktask.md), or [post](../resources/post.md). + [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions
v1.0 Attachment Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/attachment-get.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] - Read the properties, relationships, or raw contents of an attachment that is attached to a user [event](../resources/event.md), [message](../resources/message.md), [Outlook task](../resources/outlooktask.md), or group [post](../resources/post.md). + An attachment can be one of the following types: * A file. Programmatically, this is a [fileAttachment](../resources/fileattachment.md) resource. See [example 1](#example-1-get-the-properties-of-a-file-attachment).
v1.0 Authentication Post Fido2methods https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/authentication-post-fido2methods.md
Create a new [fido2AuthenticationMethod](../resources/fido2authenticationmethod.
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": "authentication-post-fido2methods-permissions"
-}
>
+<!-- { "blockType": "permissions", "name": "authentication_post_fido2methods" } -->
[!INCLUDE [permissions-table](../includes/permissions/authentication-post-fido2methods-permissions.md)] ## HTTP request
v1.0 Authentication Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/authentication-update.md
Choose the permission or permissions marked as least privileged for this API. Us
#### Permissions acting on self
-<!-- { "blockType": "permissions", "name": "authentication_get_2" } -->
+<!-- { "blockType": "permissions", "name": "authentication_update_2" } -->
[!INCLUDE [permissions-table](../includes/permissions/authentication-update-2-permissions.md)] #### Permissions acting on others
-<!-- { "blockType": "permissions", "name": "authentication_get_3" } -->
+<!-- { "blockType": "permissions", "name": "authentication_update_3" } -->
[!INCLUDE [permissions-table](../includes/permissions/authentication-update-3-permissions.md)] [!INCLUDE [rbac-authentication-methods-policy-apis-write](../includes/rbac-for-apis/rbac-authentication-methods-policy-apis-write.md)]
v1.0 Authenticationeventsflow Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/authenticationeventsflow-update.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Update the properties of an [authenticationEventsFlow](../resources/authenticationeventsflow.md) object. Only the [externalUsersSelfServiceSignupEventsFlow](../resources/externalusersselfservicesignupeventsflow.md) object type is supported.
+Update the properties of an [authenticationEventsFlow](../resources/authenticationeventsflow.md) object by ID. You must specify the **@odata.type** property and the value of the [authenticationEventsFlow](../resources/authenticationeventsflow.md) object type to update. The following derived subtypes are supported:
+- [externalUsersSelfServiceSignupEventsFlow](../resources/externalusersselfservicesignupeventsflow.md)
[!INCLUDE [national-cloud-support](../../includes/global-china.md)]
You must include the **@odata.type** property with a value of the specific user
|priority|Int32|The priority to use for each individual event of the events policy. If multiple competing listeners for an event have the same priority, one is chosen and an error is silently logged. | |onInteractiveAuthFlowStart|[onInteractiveAuthFlowStartHandler](../resources/oninteractiveauthflowstarthandler.md)|The configuration for what to invoke for the onInteractiveAuthFlowStart event. | |onAuthenticationMethodLoadStart|[onAuthenticationMethodLoadStartHandler](../resources/onauthenticationmethodloadstarthandler.md)|The configuration for what to invoke for the onAuthenticationMethodLoadStart event. Must have at least one identity provider linked.|
-|onAttributeCollection|[onAttributeCollectionHandler](../resources/onattributecollectionhandler.md)|The configuration for what to invoke for the onAttributeCollection event. You can only update this property if it was configured during user flow creation. If it wasn't, call the [Add attributes to a user flow](../api/onattributecollectionexternalusersselfservicesignup-post-attributes.md) API instead.|
+|onAttributeCollection|[onAttributeCollectionHandler](../resources/onattributecollectionhandler.md)|The configuration for what to invoke for the onAttributeCollection event. <br/><br/><li> You can only update this property if it was configured during user flow creation. If it wasn't, call the [Add attributes to a user flow](../api/onattributecollectionexternalusersselfservicesignup-post-attributes.md) API first. </li><li> You can't add or remove attributes by updating the **attributeCollectionPage** > **views** > **inputs** and **attributes** objects. Use the [Add attribute to user flow](../api/onattributecollectionexternalusersselfservicesignup-post-attributes.md) or [Remove attribute from user flow](../api/onattributecollectionexternalusersselfservicesignup-post-attributes.md) APIs instead to update both objects.</li><li> To update the **attributeCollectionPage** > **views** > **inputs** collection, you must include all objects in the collection, not only the changed objects. <li> The order of objects in the **attributeCollectionPage** > **views** > **inputs** collection corresponds to the order in which the attributes are displayed on the app's sign-up UI. |
|onUserCreateStart|[onUserCreateStartHandler](../resources/onusercreatestarthandler.md)|The configuration for what to invoke for the onUserCreateStart event.| ## Response
If successful, this method returns a `204 No Content` response code. If unsucces
### Example 1: Update the display name and priority of an authenticationEventsFlow #### Request
-The following example shows a request that updates the display name of a specific external identities user flow (an authentication event type), as well as the priority for all the listeners associated with the policy.
+The following example shows a request that updates the display name of a specific external identities user flow, as well as the priority for all the listeners associated with the policy.
# [HTTP](#tab/http) <!-- {
The following example shows the response.
HTTP/1.1 204 No Content ```
-### Example 2: Update the onAttributeCollection event of a self-service sign up user flow
+### Example 2: Update the page layout of a self-service sign up user flow
-Add city (built-in attribute) as an attribute to be collected during the attribute collection step of a self-service sign up user flow. You must specify in the **inputs** object all attributes that you want to retain, otherwise they are removed from the user flow.
+The following request updates the configuration of some of the attributes. All the attributes are marked as required; the email attribute is marked as hidden; the input type of the custom attribute is also updated to a radio button with two options.
#### Request
Content-Type: application/json
"hidden": false, "editable": true, "writeToDirectory": true,
- "required": false,
+ "required": true,
"validationRegEx": "^[a-zA-Z_][0-9a-zA-Z_ ]*[0-9a-zA-Z_]+$", "options": [] },
Content-Type: application/json
"hidden": false, "editable": true, "writeToDirectory": true,
- "required": false,
+ "required": true,
"validationRegEx": "^[a-zA-Z_][0-9a-zA-Z_ ]*[0-9a-zA-Z_]+$", "options": [] }, {
- "attribute": "extension_6ea3bc85aec24b1c92ff4a117afb6621_Favoritecolor",
- "label": "Favorite color",
- "inputType": "text",
+ "attribute": "extension_331d514c0c18477583ea7dd5a79feda2_RockorCountry",
+ "label": "Rock music or Country",
+ "inputType": "radioSingleSelect",
"defaultValue": null, "hidden": false, "editable": true, "writeToDirectory": true,
- "required": false,
+ "required": true,
"validationRegEx": "^.*",
- "options": []
+ "options": [
+ {
+ "label": "Rock music",
+ "value": "Rock"
+ },
+ {
+ "label": "Country music",
+ "value": "Country"
+ }
+ ]
} ] }
The following example shows the response.
``` http HTTP/1.1 204 No Content ```-
-### Example 3: Remove an attribute collected during a self-service sign up user flow
-
-Remove city as an attribute to be collected during the attribute collection step of a self-service sign up user flow. By excluding the city attribute from the request body, the attribute is removed from the user flow.
-
-#### Request
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "update_authenticationeventsflow_onattributecollection_beta_e3"
-}
>
-``` http
-PATCH https://graph.microsoft.com/beta/identity/authenticationEventsFlows/0313cc37-d421-421d-857b-87804d61e33e
-Content-Type: application/json
-
-{
- "@odata.type": "#microsoft.graph.externalUsersSelfServiceSignUpEventsFlow",
- "onAttributeCollection": {
- "@odata.type": "#microsoft.graph.onAttributeCollectionExternalUsersSelfServiceSignUp",
- "attributeCollectionPage": {
- "customStringsFileId": null,
- "views": [
- {
- "title": null,
- "description": null,
- "inputs": [
- {
- "attribute": "email",
- "label": "Email Address",
- "inputType": "text",
- "defaultValue": null,
- "hidden": true,
- "editable": false,
- "writeToDirectory": true,
- "required": true,
- "validationRegEx": "^[a-zA-Z0-9.!#$%&amp;&#8217;'*+/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:.[a-zA-Z0-9-]+)*$",
- "options": []
- },
- {
- "attribute": "displayName",
- "label": "Display Name",
- "inputType": "text",
- "defaultValue": null,
- "hidden": false,
- "editable": true,
- "writeToDirectory": true,
- "required": false,
- "validationRegEx": "^[a-zA-Z_][0-9a-zA-Z_ ]*[0-9a-zA-Z_]+$",
- "options": []
- },
- {
- "attribute": "extension_6ea3bc85aec24b1c92ff4a117afb6621_Favoritecolor",
- "label": "Favorite color",
- "inputType": "text",
- "defaultValue": null,
- "hidden": false,
- "editable": true,
- "writeToDirectory": true,
- "required": false,
- "validationRegEx": "^.*",
- "options": []
- }
- ]
- }
- ]
- }
- }
-}
-```
-
-# [C#](#tab/csharp)
-
-# [CLI](#tab/cli)
-
-# [Go](#tab/go)
-
-# [Java](#tab/java)
-
-# [JavaScript](#tab/javascript)
-
-# [PHP](#tab/php)
-
-# [PowerShell](#tab/powershell)
-
-# [Python](#tab/python)
---
-#### Response
-
-The following example shows the response.
-<!-- {
- "blockType": "response",
- "truncated": true
-}
>
-``` http
-HTTP/1.1 204 No Content
-```
-
v1.0 Authenticationmethod Resetpassword https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/authenticationmethod-resetpassword.md
In the request body, provide a JSON object with the following parameters.
## Response
-If successful, this method returns a `202 Accepted` response code and a **Location** header with a URL to check the status of the reset operation.
+If the caller provided a password in the request body, this method returns a `202 Accepted` response code and no response body. The response might also include a **Location** header with a URL to check the status of the [reset operation](longrunningoperation-get.md).
-If the caller did not submit a password, a Microsoft-generated password is provided in a JSON object in the response body.
+If the caller used the system-generated password option, this method returns a `202 Accepted` response code and a [passwordResetResponse](../resources/passwordresetresponse.md) object in the response body which contains a Microsoft-generated password. The response might also include a **Location** header with a URL to check the status of the [reset operation](longrunningoperation-get.md).
### Response headers
The following example shows the response.
<!-- { "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.entity"
+ "truncated": true
} --> ```http
HTTP/1.1 202 Accepted
Content-type: application/json Location: https://graph.microsoft.com/beta/users/6ea91a8d-e32e-41a1-b7bd-d2d185eed0e0/authentication/operations/88e7560c-9ebf-435c-8089-c3998ac1ec51?aadgdc=DUB02P&aadgsu=ssprprod-a
-{}
``` <!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
The following example shows the response.
<!-- { "blockType": "response", "truncated": true,
- "@odata.type": "microsoft.graph.entity"
+ "@odata.type": "microsoft.graph.passwordResetResponse"
} --> ```http
v1.0 Backuprestoreroot Enable https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-enable.md
Namespace: microsoft.graph
Enable the [Microsoft 365 Backup Storage](../resources/backuprestoreroot.md) service for a tenant.
+Before you call this API, call [List protection policies](../api/backuprestoreroot-list-protectionpolicies.md) to initialize the data store in the tenant. Data store initialization takes about 5 minutes. If you call this API before the data store is initialized, the call results in an error.
+ [!INCLUDE [national-cloud-support](../../includes/global-only.md)] ## Permissions
v1.0 Backuprestoreroot List Driveprotectionunits https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-list-driveprotectionunits.md
Don't supply a request body for this method.
If successful, this method returns a `200 OK` response code and a collection of [driveProtectionUnit](../resources/driveprotectionunit.md) in the response body.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Example 1: List all the driveProtectionUnits in a tenant
v1.0 Backuprestoreroot List Mailboxprotectionunits https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-list-mailboxprotectionunits.md
Don't supply a request body for this method.
If successful, this method returns a `200 OK` response code and a [mailboxProtectionUnit](../resources/mailboxprotectionunit.md) in the response body.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Example 1: List all mailboxProtectionUnits in a tenant
v1.0 Backuprestoreroot List Restorepoints https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-list-restorepoints.md
Title: "List restorePoints"
-description: "Get a list of the restorePoint objects and their properties."
+description: "Get a list of restorePoint objects and their properties."
ms.localizationpriority: medium
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get a list of the [restorePoint](../resources/restorepoint.md) objects and their properties.
+Get a list of [restorePoint](../resources/restorepoint.md) objects and their properties.
+
+> **Note:** This API returns a maximum of five **restorePoint** objects. If you don't include the `orderBy` parameter, the five most recent restore points are returned.
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
Choose the permission or permissions marked as least privileged for this API. Us
|Delegated (personal Microsoft account)|Not supported.|Not supported.| |Application|BackupRestore-Restore.Read.All|BackupRestore-Restore.ReadWrite.All| - ## HTTP request <!-- {
GET /solutions/backupRestore/restorePoints?$expand=protectionUnit($filter=id eq
``` ## Optional query parameters
-This method supports the `$expand` and `$filter` [OData puery parameters](/graph/query-parameters), as shown in the following [example](../api/backuprestoreroot-list-restorepoints.md#request).
-The two query parameters are required.
+This method supports the `$expand`, `$filter` and `orderBy` [OData query parameters](/graph/query-parameters), as shown in the [example](../api/backuprestoreroot-list-restorepoints.md#request) later in this topic.
+
+The `$expand` and `$filter` query parameters are required.
## Request headers
Don't supply a request body for this method.
If successful, this method returns a `200 OK` response code and a collection of [restorePoint](../resources/restorepoint.md) object in the response body.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Request
v1.0 Backuprestoreroot List Siteprotectionunits https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-list-siteprotectionunits.md
Don't supply a request body for this method.
If successful, this method returns a `200 OK` response code and a [siteProtectionUnit](../resources/siteprotectionunit.md) in the response body.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Example 1: List all the siteProtectionUnits in a tenant
v1.0 Backuprestoreroot Post Exchangeprotectionpolicies https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-post-exchangeprotectionpolicies.md
In the request body, include a JSON representation of the [exchangeProtectionPol
If successful, this method returns a `201 Created` response code and an [exchangeProtectionPolicy](../resources/exchangeprotectionpolicy.md) object in the response body.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Request
v1.0 Backuprestoreroot Post Exchangerestoresessions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-post-exchangerestoresessions.md
You can specify the following properties when you create an **exchangeRestoreSes
If successful, this method returns a `201 Created` response code and an [exchangeRestoreSession](../resources/exchangerestoresession.md) object in the response body.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Example 1: Create exchangeRestoreSession with mailboxRestoreArtifacts
Content-Type: application/json
``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [CLI](#tab/cli) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Python](#tab/python) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-Type: application/json
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "exchangerestoresession_create_granularmailboxrestoreartifacts"
Content-Type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+++ #### Response The following example shows the response.
v1.0 Backuprestoreroot Post Onedriveforbusinessprotectionpolicies https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-post-onedriveforbusinessprotectionpolicies.md
You can specify the following properties when creating a **oneDriveForBusinessPr
If successful, this method returns a `201 Created` response code and a [oneDriveForBusinessProtectionPolicy](../resources/onedriveforbusinessprotectionpolicy.md) object in the response body.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Request
v1.0 Backuprestoreroot Post Onedriveforbusinessrestoresessions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-post-onedriveforbusinessrestoresessions.md
You can specify the following properties when you create a **oneDriveForBusiness
If successful, this method returns a `201 Created` response code and a [oneDriveForBusinessRestoreSession](../resources/onedriveforbusinessrestoresession.md) object in the response body.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Request
v1.0 Backuprestoreroot Post Sharepointprotectionpolicies https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-post-sharepointprotectionpolicies.md
You can specify the following properties when creating a **sharePointProtectionP
If successful, this method returns a `201 Created` response code and a [sharePointProtectionPolicy](../resources/sharepointprotectionpolicy.md) object in the response body.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Request
v1.0 Backuprestoreroot Post Sharepointrestoresessions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-post-sharepointrestoresessions.md
You can specify the following properties when you create a **sharePointRestoreSe
If successful, this method returns a `201 Created` response code and a [sharePointRestoreSession](../resources/sharepointrestoresession.md) object in the response body.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Request
v1.0 Bookingappointment Cancel https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingappointment-cancel.md
POST /solutions/bookingBusinesses/{id}/appointments/{id}/cancel
| Name | Description| |:|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Bookingappointment Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingappointment-delete.md
DELETE /solutions/bookingBusinesses/{id}/appointments/{id}
| Name | Description| |:|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Bookingappointment Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingappointment-get.md
This method supports the [OData query parameters](/graph/query-parameters) to he
| Name |Description| |:-|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Bookingbusiness Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-delete.md
DELETE /solutions/bookingBusinesses/{id}
## Request headers | Name | Description| |:|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Bookingbusiness Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-get.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
| Name |Description| |:-|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Bookingbusiness List Calendarview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-list-calendarview.md
This method also supports some of the [OData query parameters](/graph/query-para
| Name | Description| |:|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Bookingbusiness List Customers https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-list-customers.md
This method supports the [OData query parameters](/graph/query-parameters) to he
## Request headers | Name |Description| |:-|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Bookingbusiness List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-list.md
This method also supports the `query` parameter which accepts a string value. Th
## Request headers | Name |Description| |:-|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Bookingbusiness Post Bookingbusinesses https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-post-bookingbusinesses.md
POST /solutions/bookingbusinesses
## Request headers | Name | Description| |:|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body In the request body, supply a JSON representation of [bookingBusiness](../resources/bookingbusiness.md) object.
v1.0 Bookingbusiness Publish https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-publish.md
POST /solutions/bookingbusinesses/{id}/publish
## Request headers | Name | Description| |:|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Bookingbusiness Unpublish https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-unpublish.md
POST /solutions/bookingbusinesses/{id}/unpublish
## Request headers | Name | Description| |:|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Bookingbusiness Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-update.md
PATCH /solutions/bookingbusinesses/{id}
## Optional request headers | Name | Description| |:--|:--|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintains their previous values or are recalculated based on changes to other property values. For best performance, you shouldn't include existing values that haven't changed.
v1.0 Bookingcurrency Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingcurrency-get.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name |Description| |:-|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Bookingcurrency List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingcurrency-list.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name |Description| |:-|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Bookingcustomer Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingcustomer-delete.md
DELETE /solutions/bookingbusinesses/{id}/customers/{id}
| Name | Description| |:|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Bookingcustomer Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingcustomer-get.md
This method supports the [OData query parameters](/graph/query-parameters) to he
## Request headers | Name |Description| |:-|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Bookingcustomer Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingcustomer-update.md
PATCH /solutions/bookingbusinesses/{id}/customers/{id}
| Name | Description| |:--|:--|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body [!INCLUDE [table-intro](../../includes/update-property-table-intro.md)]
v1.0 Bookingservice Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingservice-delete.md
DELETE /solutions/bookingbusinesses/{id}/services/{id}
## Request headers | Name | Description| |:|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Bookingstaffmember Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingstaffmember-delete.md
DELETE /solutions/bookingbusinesses/{id}/staffMembers/{id}
## Request headers | Name | Description| |:|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Bookingstaffmember Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingstaffmember-get.md
This method supports the [OData query parameters](/graph/query-parameters) to he
| Name |Description| |:-|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Calendar Permanentdelete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/calendar-permanentdelete.md
+
+ Title: "calendar: permanentDelete"
+description: "Permanently delete a calendar folder and the events that it contains and remove them from the mailbox."
+
+ms.localizationpriority: high
+++
+# calendar: permanentDelete
+
+Namespace: microsoft.graph
++
+Permanently delete a calendar folder and the events that it contains and remove them from the mailbox. For more information about item retention, see [Configure Deleted Item retention and Recoverable Items quotas](/exchange/configure-deleted-item-retention-and-recoverable-items-quotas-exchange-2013-help).
+
+>**Note:** Folders aren't placed in the Purges folder when they are permanently deleted. Permanently deleted folders are removed from the mailbox.
++
+## 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": "calendar_permanentdelete" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /users/{usersId}/calendar/permanentDelete
+POST /groups/{groupsId}/calendar/permanentDelete
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this action returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "calendarthis.permanentdelete"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/users/{usersId}/calendar/permanentDelete
+```
+
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
++++
+### Response
+
+The following example shows the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Call Answer https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/call-answer.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Enable a bot to answer an incoming [call](../resources/call.md). The incoming call request can be an invite from a participant in a group call or a peer-to-peer call. If an invite to a group call is received, the notification contains the [chatInfo](../resources/chatinfo.md) and [meetingInfo](../resources/meetinginfo.md) parameters.
+Enable a bot to answer an incoming [call](../resources/call.md). The incoming call request can be an invitation from a participant in a group call or a peer-to-peer call. If an invitation to a group call is received, the notification contains the [chatInfo](../resources/chatinfo.md) and [meetingInfo](../resources/meetinginfo.md) parameters.
The bot is expected to answer, [reject](./call-reject.md) or [redirect](./call-redirect.md) the call before the call times out. The current timeout value is 15 seconds. The current timeout value is 15 seconds for regular scenarios, and 5 seconds for policy-based recording scenarios.
+This API supports the following PSTN scenarios:
+++ Incoming call to bot's PSTN number and then bot invites another PSTN.++ Incoming call to bot's PSTN number and then bot transfer to another PSTN.++ Incoming call to bot's PSTN number and then bot redirects to another PSTN.++ Incoming call to bot's instance identifier and then bot invites another PSTN.++ Incoming call to bot's instance identifier and then bot transfer to another PSTN.++ Incoming call to bot's instance identifier and then bot redirects to another PSTN.++ Incoming call to bot's instance identifier from Scheduled Meeting and then bot invites PSTN.++ Outgoing call from bot (with instance identifier) to a PSTN.++ P2P call between bot and another peer (Teams user, PSTN), bot invites another PSTN.++ P2P call between bot and another peer (Teams user, PSTN), bot invites another Teams user.++ Bot join the scheduled meeting and then invite PSTN.+ [!INCLUDE [national-cloud-support](../../includes/global-only.md)] ## Permissions
The following example shows how to call this API.
#### Request The following example shows the request.
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "call-answer"
Content-Length: 211
], "callOptions": { "@odata.type": "#microsoft.graph.incomingCallOptions",
- "isContentSharingNotificationEnabled": true
+ "isContentSharingNotificationEnabled": true,
+ "isDeltaRosterEnabled": true
}, "participantCapacity": 200 } ```
-# [C#](#tab/csharp)
-
-# [CLI](#tab/cli)
-
-# [Go](#tab/go)
-
-# [Java](#tab/java)
-
-# [JavaScript](#tab/javascript)
-
-# [PHP](#tab/php)
-
-# [PowerShell](#tab/powershell)
-
-# [Python](#tab/python)
--- #### Response The following example shows the response.
v1.0 Callrecording Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/callrecording-delta.md
Namespace: microsoft.graph
Get a set of [callRecording](../resources/callrecording.md) resources added for [onlineMeeting](../resources/onlinemeeting.md) instances organized by the specified user.
-Delta query supports both full synchronization that gets all the recordings for online meetings organized by the user, and incremental synchronization that gets recordings added since the last synchronization. Typically, you would do an initial full synchronization, and then get incremental changes to that recording view periodically.
+Delta query supports both full synchronization that gets all the recordings for online meetings organized by the user, and incremental synchronization that gets recordings added since the last synchronization. Typically, you do an initial full synchronization, and then get incremental changes to that recording view periodically.
-A GET request with the delta function returns either:
+A GET request with the delta function returns one of the following:
-- A `@odata.nextLink` (that contains a URL with a **delta** function call and a `skipToken`), or-- A `@odata.deltaLink` (that contains a URL with a **delta** function call and `deltaToken`).
+- An **@odata.nextLink** that contains a URL with a **delta** function call and a `skipToken`.
+- An **@odata.deltaLink** that contains a URL with a **delta** function call and a `deltaToken`.
-State tokens are opaque to the client. To proceed with a round of change tracking, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL returned from the last GET request to the next **delta** function call for that same recording view. A `@odata.deltaLink` returned in a response signifies that the current round of change tracking is complete. You can save and use the `@odata.deltaLink` URL when you start the next round of synchronization to get the new recordings added after acquiring `@odata.deltaLink`.
+State tokens are opaque to the client. To proceed with a round of change tracking, copy and apply the **@odata.nextLink** or **@odata.deltaLink** URL returned from the last GET request to the next **delta** function call for that same recording view. An **@odata.deltaLink** returned in a response signifies that the current round of change tracking is complete. You can save and use the **@odata.deltaLink** URL when you start the next round of synchronization to get the new recordings added after you acquire **@odata.deltaLink**.
For more information, see the [delta query](/graph/delta-query-overview) documentation.
For more information, see the [delta query](/graph/delta-query-overview) documen
The following known issues are associated with this API: -- [Using the `$top` query parameter might not return the @odata.nextLink](https://developer.microsoft.com/en-us/graph/known-issues/?search=22931).
+- [Using the `$top` query parameter might not return the **@odata.nextLink**](https://developer.microsoft.com/en-us/graph/known-issues/?search=22931).
- [Transcript URLs might not include any content](https://developer.microsoft.com/en-us/graph/known-issues/?search=22932). - [Recordings aren't exported for meetings that don't have transcription turned on](https://developer.microsoft.com/en-us/graph/known-issues/?search=22933). - [Delta queries might return older artifacts when meetings have unrelated changes](https://developer.microsoft.com/en-us/graph/known-issues/?search=22934).
Choose the permission or permissions marked as least privileged for this API. Us
``` http GET /users/{usersId}/onlineMeetings/getAllRecordings(meetingOrganizerUserId='{userId}',startDateTime={startDateTime})/delta ```
->**Note:** If you don't pass the function parameter **meetingOrganizerUserId**, the request fails.
+>**Note:** The request fails if you don't pass the function parameter **meetingOrganizerUserId**.
## Query parameters
-Tracking changes in call recordings incurs a round of one or more **delta** function calls. If you use any query parameter (other than `$deltatoken` and `$skiptoken`), you must specify it in the initial **delta** request. Microsoft Graph automatically encodes any specified parameters into the token portion of the `@odata.nextLink` or `@odata.deltaLink` URL provided in the response.
+Tracking changes in call recordings incurs a round of one or more **delta** function calls. If you use any query parameter (other than `$deltaToken` and `$skipToken`), you must specify it in the initial **delta** request. Microsoft Graph automatically encodes any specified parameters into the token portion of the **@odata.nextLink** or **@odata.deltaLink** URL provided in the response.
-In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL from the previous response, as that URL already includes the encoded parameters.
+In subsequent requests, copy and apply the **@odata.nextLink** or **@odata.deltaLink** URL from the previous response, as that URL already includes the encoded parameters.
| Query parameter | Type |Description| |:|:--|:-|
-| `$deltatoken` | string | A [state token](/graph/delta-query-overview) returned in the `@odata.deltaLink` URL of the previous **delta** function call, indicating the completion of that round of change tracking. Save and apply the entire `@odata.deltaLink` URL including this token in the first request of the next round of change tracking for that collection.|
-| `$skiptoken` | string | A [state token](/graph/delta-query-overview) returned in the `@odata.nextLink` URL of the previous **delta** function call, indicating that there are further changes to be tracked. |
-| `$top` | integer | Allows the caller to specify the maximum number of objects per page. |
+| `$deltaToken` | String | A [state token](/graph/delta-query-overview) returned in the **@odata.deltaLink** URL of the previous **delta** function call that indicates the completion of that round of change tracking. Save and apply the entire **@odata.deltaLink** URL including this token in the first request of the next round of change tracking for that collection.|
+| `$skipToken` | String | A [state token](/graph/delta-query-overview) returned in the **@odata.nextLink** URL of the previous **delta** function call that indicates that there are further changes to be tracked. |
+| `$top` | Integer | Allows the caller to specify the maximum number of objects per page. |
## Request headers
In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLin
## Response
-If successful, this method returns a `200 OK` response code and a collection of [callRecording](../resources/callrecording.md) objects in the response body. The response also includes an `@odata.nextLink` URL or an `@odata.deltaLink` URL.
+If successful, this method returns a `200 OK` response code and a collection of [callRecording](../resources/callrecording.md) objects in the response body. The response also includes an **@odata.nextLink** URL or an **@odata.deltaLink** URL.
## Examples
If successful, this method returns a `200 OK` response code and a collection of
The following example shows a series of three requests to synchronize the call recordings available for all the online meetings organized by the user. - Step 1: [initial request](#initial-request) and [response](#initial-response).-- Step 2: [second request](#second-request) and [response](#second-response)
+- Step 2: [second request](#second-request) and [response](#second-response).
- Step 3: [third request](#third-request) and [final response](#third-and-final-response-for-the-round).
-See also what you'll do in the [next round to get more recordings](#example-2-next-round-to-get-more-recordings).
+See also what you do in the [next round to get more recordings](#example-2-next-round-to-get-more-recordings).
#### Initial request
-In this example, the call recordings are being synchronized for the first time, so the initial sync request doesn't include any state token. This round returns all recordings available at the time.
+In this example, the call recordings synchronize for the first time and the initial sync request doesn't include any state token. This round returns all recordings available at the time.
<!-- { "blockType": "ignored" } --> ```http
GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/
#### Initial response
-The response includes two call recordings and a `@odata.nextLink` response header with a `skipToken`. The `@odata.nextLink` URL indicates there are more call recordings to retrieve.
+The response includes two call recordings and an **@odata.nextLink** response header with a `skipToken`. The **@odata.nextLink** URL indicates that more call recordings are available to retrieve.
<!-- { "blockType": "response", "truncated": true,
- "@odata.type": "microsoft.graph.callRecording",
- "isCollection": true
+ "@odata.type": "Collection(microsoft.graph.callRecording)"
} --> ```http HTTP/1.1 200 OK
Content-type: application/json
#### Second request
-The second request specifies the `@odata.nextLink` URL returned from the previous response. Notice that it no longer has to specify the same query parameters as in the initial request, as the `skipToken` in the `@odata.nextLink` URL encodes and includes them.
+The second request specifies the **@odata.nextLink** URL returned from the previous response. Notice that it no longer has to specify the same query parameters as in the initial request, as the `skipToken` in the **@odata.nextLink** URL encodes and includes them.
<!-- { "blockType": "ignored" } --> ```http
$skiptoken={skipToken1}
#### Second response
-The second response returns one or more next call recordings and a `@odata.nextLink` property with a `skipToken`, which indicates there are more recordings.
+The second response returns one or more next call recordings and an **@odata.nextLink** property with a `skipToken` that indicates that more recordings are available.
<!-- { "blockType": "response", "truncated": true,
- "@odata.type": "microsoft.graph.callRecording",
- "isCollection": true
+ "@odata.type": "Collection(microsoft.graph.callRecording)"
} --> ```http HTTP/1.1 200 OK
Content-type: application/json
#### Third request
-The third request continues to use the latest `@odata.nextLink` returned from the last sync request.
+The third request continues to use the latest **@odata.nextLink** returned from the last sync request.
<!-- { "blockType": "ignored" } --> ```http
-GET https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={skipToken2}
+GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={skipToken2}
``` #### Third and final response for the round
-The third response returns the only remaining recordings and a `@odata.deltaLink` property with a `deltaToken`, which indicates that all recordings are returned. Save and use the `@odata.deltaLink` URL to query for any new recording that is added from this point onwards.
+The third response returns the only remaining recordings and an **@odata.deltaLink** property with a `deltaToken` that indicates that all recordings are returned. Save and use the **@odata.deltaLink** URL to query for any new recording that is added from this point onwards.
<!-- { "blockType": "response", "truncated": true,
- "@odata.type": "microsoft.graph.callRecording",
- "isCollection": true
+ "@odata.type": "Collection(microsoft.graph.callRecording)"
} --> ```http HTTP/1.1 200 OK
Content-type: application/json
### Example 2: Next round to get more recordings
-Using the `@odata.deltaLink` from the last request in the last round, you can get only those recordings added since the `@odata.deltaLink` was acquired.
+Using the **@odata.deltaLink** from the last request in the last round, you can get only those recordings added since the **@odata.deltaLink** was acquired.
#### Request The following example shows a request. <!-- { "blockType": "ignored" } --> ```http
-GET https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={deltaToken1}
+GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={deltaToken1}
``` #### Response
The following example shows the response.
<!-- { "blockType": "response", "truncated": true,
- "@odata.type": "microsoft.graph.callRecording",
- "isCollection": true
+ "@odata.type": "Collection(microsoft.graph.callRecording)"
} --> ```http HTTP/1.1 200 OK
v1.0 Calltranscript Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/calltranscript-delta.md
Namespace: microsoft.graph
Get a set of [callTranscript](../resources/calltranscript.md) resources added for [onlineMeeting](../resources/onlinemeeting.md) instances organized by the specified user.
-Delta query supports both full synchronization that gets all the transcripts for online meetings organized by the user, and incremental synchronization that gets transcripts added since the last synchronization. Typically, you would do an initial full synchronization, and then get incremental changes to that transcript view periodically.
+Delta query supports both full synchronization that gets all the transcripts for online meetings organized by the user, and incremental synchronization that gets transcripts added since the last synchronization. Typically, you do an initial full synchronization, and then get incremental changes to that transcript view periodically.
-A GET request with the delta function returns either:
+A GET request with the delta function returns one of the following:
-- A `@odata.nextLink` (that contains a URL with a **delta** function call and a `skipToken`), or-- A `@odata.deltaLink` (that contains a URL with a **delta** function call and `deltaToken`).
+- An **@odata.nextLink** that contains a URL with a **delta** function call and a `skipToken`.
+- An **@odata.deltaLink** that contains a URL with a **delta** function call and a `deltaToken`.
-State tokens are opaque to the client. To proceed with a round of change tracking, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL returned from the last GET request to the next **delta** function call for that same transcript view. A `@odata.deltaLink` returned in a response signifies that the current round of change tracking is complete. You can save and use the `@odata.deltaLink` URL when you start the next round of synchronization to get the new transcripts added after acquiring `@odata.deltaLink`.
+State tokens are opaque to the client. To proceed with a round of change tracking, copy and apply the **@odata.nextLink** or **@odata.deltaLink** URL returned from the last GET request to the next **delta** function call for that same transcript view. An **@odata.deltaLink** returned in a response signifies that the current round of change tracking is complete. You can save and use the **@odata.deltaLink** URL when you start the next round of synchronization to get the new transcripts added after you acquire **@odata.deltaLink**.
For more information, see the [delta query](/graph/delta-query-overview) documentation.
For more information, see the [delta query](/graph/delta-query-overview) documen
The following known issues are associated with this API: -- [Using the `$top` query parameter might not return the @odata.nextLink](https://developer.microsoft.com/en-us/graph/known-issues/?search=22931).
+- [Using the `$top` query parameter might not return the **@odata.nextLink**](https://developer.microsoft.com/en-us/graph/known-issues/?search=22931).
- [Delta queries might return older artifacts when meetings have unrelated changes](https://developer.microsoft.com/en-us/graph/known-issues/?search=22934). ## Permissions
Choose the permission or permissions marked as least privileged for this API. Us
``` http GET /users/{usersId}/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='{userId}',startDateTime={startDateTime})/delta ```
->**Note:** If you don't pass the function parameter **meetingOrganizerUserId**, the request fails.
+>**Note:** The request fails if you don't pass the function parameter **meetingOrganizerUserId**.
## Query parameters
-Tracking changes in call transcripts incurs a round of one or more **delta** function calls. If you use any query parameter (other than `$deltatoken` and `$skiptoken`), you must specify it in the initial **delta** request. Microsoft Graph automatically encodes any specified parameters into the token portion of the `@odata.nextLink` or `@odata.deltaLink` URL provided in the response.
+Tracking changes in call transcripts incurs a round of one or more **delta** function calls. If you use any query parameter (other than `$deltaToken` and `$skipToken`), you must specify it in the initial **delta** request. Microsoft Graph automatically encodes any specified parameters into the token portion of the **@odata.nextLink** or **@odata.deltaLink** URL provided in the response.
-In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL from the previous response, as that URL already includes the encoded parameters.
+In subsequent requests, copy and apply the **@odata.nextLink** or **@odata.deltaLink** URL from the previous response, as that URL already includes the encoded parameters.
| Query parameter | Type |Description| |:|:--|:-|
-| `$deltatoken` | string | A [state token](/graph/delta-query-overview) returned in the `@odata.deltaLink` URL of the previous **delta** function call, indicating the completion of that round of change tracking. Save and apply the entire `@odata.deltaLink` URL including this token in the first request of the next round of change tracking for that collection.|
-| `$skiptoken` | string | A [state token](/graph/delta-query-overview) returned in the `@odata.nextLink` URL of the previous **delta** function call, indicating that there are further changes to be tracked. |
-| `$top` | integer | Allows the caller to specify the maximum number of objects per page. |
+| `$deltaToken` | String | A [state token](/graph/delta-query-overview) returned in the **@odata.deltaLink** URL of the previous **delta** function call that indicates the completion of that round of change tracking. Save and apply the entire **@odata.deltaLink** URL including this token in the first request of the next round of change tracking for that collection.|
+| `$skipToken` | String | A [state token](/graph/delta-query-overview) returned in the **@odata.nextLink** URL of the previous **delta** function call that indicates that there are further changes to be tracked. |
+| `$top` | Integer | Allows the caller to specify the maximum number of objects per page. |
## Request headers
In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLin
## Response
-If successful, this method returns a `200 OK` response code and a collection of [callTranscript](../resources/calltranscript.md) objects in the response body. The response also includes an `@odata.nextLink` URL or an `@odata.deltaLink` URL.
+If successful, this method returns a `200 OK` response code and a collection of [callTranscript](../resources/calltranscript.md) objects in the response body. The response also includes an **@odata.nextLink** URL or an **@odata.deltaLink** URL.
## Examples
If successful, this method returns a `200 OK` response code and a collection of
The following example shows a series of three requests to synchronize the call transcripts available for all the online meetings organized by the user. - Step 1: [initial request](#initial-request) and [response](#initial-response).-- Step 2: [second request](#second-request) and [response](#second-response)
+- Step 2: [second request](#second-request) and [response](#second-response).
- Step 3: [third request](#third-request) and [final response](#third-and-final-response-for-the-round).
-See also what you'll do in the [next round to get more transcripts](#example-2-next-round-to-get-more-transcripts).
+See also what you do in the [next round to get more transcripts](#example-2-next-round-to-get-more-transcripts).
#### Initial request
-In this example, the call transcripts are being synchronized for the first time, so the initial sync request doesn't include any state token. This round returns all transcripts available at the time.
+In this example, the call transcripts synchronize for the first time and the initial sync request doesn't include any state token. This round returns all transcripts available at the time.
<!-- { "blockType": "ignored" } --> ```http
GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/
#### Initial response
-The response includes two call transcripts and a `@odata.nextLink` response header with a `skipToken`. The `@odata.nextLink` URL indicates there are more call transcripts to retrieve.
+The response includes two call transcripts and an **@odata.nextLink** response header with a `skipToken`. The **@odata.nextLink** URL indicates that more call transcripts are available to retrieve.
<!-- { "blockType": "response", "truncated": true,
- "@odata.type": "microsoft.graph.callTranscript",
- "isCollection": true
+ "@odata.type": "Collection(microsoft.graph.callTranscript)"
} --> ```http HTTP/1.1 200 OK
Content-type: application/json
#### Second request
-The second request specifies the `@odata.nextLink` URL returned from the previous response. Notice that it no longer has to specify the same query parameters as in the initial request, as the `skipToken` in the `@odata.nextLink` URL encodes and includes them.
+The second request specifies the **@odata.nextLink** URL returned from the previous response. Notice that it no longer has to specify the same query parameters as in the initial request, as the `skipToken` in the **@odata.nextLink** URL encodes and includes them.
<!-- { "blockType": "ignored" } --> ```http
$skiptoken={skipToken1}
#### Second response
-The second response returns one or more next call transcripts and a `@odata.nextLink` property with a `skipToken`, which indicates there are more transcripts.
+The second response returns one or more next call transcripts and an **@odata.nextLink** property with a `skipToken` that indicates that more transcripts are available.
<!-- { "blockType": "response", "truncated": true,
- "@odata.type": "microsoft.graph.callTranscript",
- "isCollection": true
+ "@odata.type": "Collection(microsoft.graph.callTranscript)"
} --> ```http HTTP/1.1 200 OK
Content-type: application/json
#### Third request
-The third request continues to use the latest `@odata.nextLink` returned from the last sync request.
+The third request continues to use the latest **@odata.nextLink** returned from the last sync request.
<!-- { "blockType": "ignored" } --> ```http
-GET https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={skipToken2}
+GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={skipToken2}
``` #### Third and final response for the round
-The third response returns the only remaining transcripts and a `@odata.deltaLink` property with a `deltaToken`, which indicates that all transcripts are returned. Save and use the `@odata.deltaLink` URL to query for any new transcript that is added from this point onwards.
+The third response returns the only remaining transcripts and an **@odata.deltaLink** property with a `deltaToken` that indicates that all transcripts are returned. Save and use the **@odata.deltaLink** URL to query for any new transcript that is added from this point onwards.
<!-- { "blockType": "response", "truncated": true,
- "@odata.type": "microsoft.graph.callTranscript",
- "isCollection": true
+ "@odata.type": "Collection(microsoft.graph.callTranscript)"
} --> ```http HTTP/1.1 200 OK
Content-type: application/json
### Example 2: Next round to get more transcripts
-Using the `@odata.deltaLink` from the last request in the last round, you can get only those transcripts added since the `@odata.deltaLink` was acquired.
+Using the **@odata.deltaLink** from the last request in the last round, you can get only those transcripts added since the **@odata.deltaLink** was acquired.
#### Request The following example shows a request. <!-- { "blockType": "ignored" } --> ```http
-GET https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={deltaToken1}
+GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={deltaToken1}
``` #### Response
The following example shows the response.
<!-- { "blockType": "response", "truncated": true,
- "@odata.type": "microsoft.graph.callTranscript",
- "isCollection": true
+ "@odata.type": "Collection(microsoft.graph.callTranscript)"
} --> ```http HTTP/1.1 200 OK
v1.0 Calltranscript Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/calltranscript-get.md
The following example shows how to get a single transcript of an online meeting
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_callTranscript_using_contentCorrelationId",
The following example shows a request.
GET https://graph.microsoft.com/betFkLTRmOTUtODA4My0xYjdmOTliM2VkZWIqMCoqMTk6bWVldGluZ19OV1EwWm1GbFpEY3RORFJqTmkwMFlXRm1MV0U1WXpBdE9UZzJNMk0yTm1Nd1pERTNAdGhyZWFkLnYy/transcripts?$filter=contentcorrelationId+eq+'e87c8cf8-50f7-4252-8b9c-ad08ac0fa88d-0' ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+++ #### Response The following example shows the response.
v1.0 Channel Delete Tabs https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-delete-tabs.md
Title: "Delete tab from channel" description: "Removes (unpins) a tab from the specified channel within a team. "-+ ms.localizationpriority: medium doc_type: apiPageType
v1.0 Channel Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-delete.md
Title: "Delete channel" description: "Delete the channel."-+ ms.localizationpriority: medium doc_type: apiPageType
v1.0 Channel Get Filesfolder https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-get-filesfolder.md
Title: "Get filesFolder" description: "Retrieve the filesFolder navigation path of a channel."-+ ms.localizationpriority: high doc_type: apiPageType
v1.0 Channel Get Tabs https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-get-tabs.md
Title: "Get tab in channel" description: "Retrieve the properties and relationships of the specified tab in a channel within a team. "-+ ms.localizationpriority: medium doc_type: apiPageType
v1.0 Channel Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-get.md
Title: "Get channel" description: "Retrieve the properties and relationships of a channel."-+ doc_type: apiPageType ms.localizationpriority: medium
v1.0 Channel List Messages https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-list-messages.md
Choose the permission or permissions marked as least privileged for this API. Us
[!INCLUDE [permissions-table](../includes/permissions/channel-list-messages-permissions.md)] > [!NOTE]
-> - The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent).
-> - The Group.Read.All and Group.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward.
+> - The `ChannelMessage.Read.Group` permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent).
+> - The `Group.Read.All` and `Group.ReadWrite.All` permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward.
## HTTP request
Don't supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and a collection of [chatMessage](../resources/chatmessage.md) objects in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [chatMessage](../resources/chatmessage.md) objects in the response body. The channel messages in the response are sorted by the last modified date of the entire reply chain, including both the root channel message and its replies.
## Examples
GET https://graph.microsoft.com/beta/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/
#### Response The following response shows one channel message on the page, and includes a URL in `@odata.nextLink` for a subsequent operation to get the next message in that channel.
-The response includes replies of that channel message. In practice, this operation can return up to 1,000 replies of a channel message, and includes a URL in `replies@odata.nextLink` to get any further replies beyond the page size of 1000. This example assumes more than 1,000 replies in that channel message, but for readability, the following response shows only three replies.
+The response includes replies of that channel message. In practice, this operation can return up to 1,000 replies of a channel message, and includes a URL in `replies@odata.nextLink` to get any further replies beyond the page size of 1,000. This example assumes more than 1,000 replies in that channel message, but for readability, the following response shows only three replies.
<!-- { "blockType": "response",
v1.0 Channel List Tabs https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-list-tabs.md
Title: "List tabs in channel" description: "Retrieve the list of tabs in the specified channel within a team. "-+ ms.localizationpriority: medium doc_type: apiPageType
v1.0 Channel Patch Tabs https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-patch-tabs.md
Title: "Update tab" description: "Update the properties of the specified tab."-+ ms.localizationpriority: medium doc_type: apiPageType
v1.0 Channel Post Tabs https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-post-tabs.md
Title: "Add tab to channel" description: "Add (pin) a tab to the specified channel within a team. "-+ ms.localizationpriority: medium doc_type: apiPageType
v1.0 Chat Post Tabs https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chat-post-tabs.md
Title: "Add tab to chat" description: "Adds (pins) a tab to the specified chat. "-+ ms.localizationpriority: medium doc_type: apiPageType
v1.0 Chatmessage Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chatmessage-get.md
Content-type: application/json
"reactions": [ { "reactionType": "💯",
+ "displayName": "Hundred points",
"reactionContentUrl": null, "createdDateTime": "2024-02-14T22:07:36.3Z", "user": {
Content-type: application/json
}, { "reactionType": "custom",
+ "displayName": "microsoft_teams",
"reactionContentUrl": "https://graph.microsoft.com/beta/chats/19:bcf84b15c2994a909770f7d05bc4fe16@thread.v2/messages/1706763669648/hostedContents/aWQ9MC13dXMtZDExLTc3ZmI2NmY4MTMwMGI2OGEzYzRkOWUyNmU1YTc5ZmMyLHR5cGU9MSx1cmw9/$value", "createdDateTime": "2024-02-14T22:07:02.288Z", "user": {
v1.0 Chatmessage List Hostedcontents https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chatmessage-list-hostedcontents.md
This operation doesn't support the [OData query parameters](/graph/query-paramet
| Name |Description| |:-|:-|
-| Authorization | Bearer {code} |
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Chatmessagehostedcontent Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chatmessagehostedcontent-get.md
This operation doesn't support the [OData query parameters](/graph/query-paramet
| Name |Description| |:-|:-|
-| Authorization | Bearer {code} |
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Cloudpc Getfrontlinecloudpcaccessstate https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpc-getfrontlinecloudpcaccessstate.md
Content-Type: application/json
{ "@odata.context":"https://graph.microsoft.com/beta/$metadata#Edm.String",
- "value": "noLicensesAvailable"
+ "value": "active"
} ```
Content-Type: application/json
{ "@odata.context":"https://graph.microsoft.com/beta/$metadata#Edm.String",
- "value": "noLicensesAvailable"
+ "value": "active"
} ```
v1.0 Cloudpc Retrievecloudpcremoteactionresults https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpc-retrievecloudpcremoteactionresults.md
GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/4
[!INCLUDE [sample-code](../includes/snippets/php/cloudpc-retrievecloudpcremoteactionresults-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/cloudpc-retrievecloudpcremoteactionresults-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Cloudpcshareduseserviceplan Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpcshareduseserviceplan-get.md
- Title: "Get cloudPcSharedUseServicePlan (deprecated)"
-description: "Read the properties and relationships of a cloudPcSharedUseServicePlan object."
--
-doc_type: apiPageType
--
-# Get cloudPcSharedUseServicePlan (deprecated)
-
-Namespace: microsoft.graph
--
-> [!CAUTION]
-> The **cloudPcSharedUseServicePlan** resource is deprecated and stopped returning data on April 24, 2024. Going forward, use the [cloudPcFrontLineServicePlan](../resources/cloudpcfrontlineserviceplan.md).
-
-Read the properties and relationships of a [cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.md) object.
--
-## 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": "cloudpcshareduseserviceplan_get" } -->
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-GET /deviceManagement/virtualEndpoint/sharedUseServicePlans/{cloudPcSharedUseServicePlanId}
-```
-
-## Optional query parameters
-
-This method supports the `$select` OData query parameter to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
-
-## Request body
-
-Don't supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and a [cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.md) object in the response body.
-
-## Examples
-
-### Request
-
-The following example shows a request.
-
-<!-- {
- "blockType": "request",
- "name": "get_cloudpcshareduseserviceplan"
-}
>
-``` http
-GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/sharedUseServicePlans/613a8d85-6c33-1268-9f55-b96a6540017c
-```
-
-### Response
-
-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.cloudPcSharedUseServicePlan"
-}
>
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "value": {
- "@odata.type": "#microsoft.graph.cloudPcSharedUseServicePlan",
- "id": "613a8d85-6c33-1268-9f55-b96a6540017c",
- "displayName": "Display Name Value",
- "usedCount": "10",
- "totalCount": "20"
- }
-}
-```
v1.0 Community Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/community-delete.md
Title: "Delete community"
-description: "Delete a community in Viva Engage."
+description: "Delete a Viva Engage community along with all associated Microsoft 365 content, including the connected Microsoft 365 group, OneNote notebook, and Planner plans."
ms.localizationpriority: medium
v1.0 Contact Permanentdelete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/contact-permanentdelete.md
+
+ Title: "contact: permanentDelete"
+description: "Permanently delete a contact and place it in the Purges folder in the user's mailbox."
+
+ms.localizationpriority: high
+++
+# contact: permanentDelete
+
+Namespace: microsoft.graph
++
+Permanently delete a contact and place it in the Purges folder in the dumpster in the user's mailbox. Email clients such as Outlook or Outlook on the web can't access permanently deleted items. Unless there's a hold set on the mailbox, the items are permanently deleted after a set period of time.
+
+For more information about item retention, see [Configure Deleted Item retention and Recoverable Items quotas](/exchange/configure-deleted-item-retention-and-recoverable-items-quotas-exchange-2013-help).
++
+## 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": "contact_permanentdelete" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /users/{usersId}/contacts/{contactId}/permanentDelete
+POST /users/{usersId}/contactFolders/{contactFolderId}/contacts/{contactId}/permanentDelete
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this action returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "contactthis.permanentdelete"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/users/{usersId}/contacts/{contactId}/permanentDelete
+```
+
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
++++
+### Response
+
+The following example shows the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Contactfolder Permanentdelete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/contactfolder-permanentdelete.md
+
+ Title: "contactFolder: permanentDelete"
+description: "Permanently delete a contact folder and remove its items from the user's mailbox."
+
+ms.localizationpriority: high
+++
+# contactFolder: permanentDelete
+
+Namespace: microsoft.graph
++
+Permanently delete a contact folder and remove its items from the user's mailbox. For more information about item retention, see [Configure Deleted Item retention and Recoverable Items quotas](/exchange/configure-deleted-item-retention-and-recoverable-items-quotas-exchange-2013-help).
+
+>**Note:** Folders aren't placed in the Purges folder when they are permanently deleted. Permanently deleted folders are removed from the mailbox.
++
+## 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": "contactfolder_permanentdelete" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /users/{usersId}/contactFolders/{contactFolderId}/permanentDelete
+POST /users/{usersId}/contactFolders/{contactFolderId}/childFolders/{contactFolderId}/permanentDelete
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this action returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "contactfolderthis.permanentdelete"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/users/{usersId}/contactFolders/{contactFolderId}/permanentDelete
+```
+
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
++++
+### Response
+
+The following example shows the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Contentmodel Addtodrive https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/contentmodel-addtodrive.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/contentmodelthisaddtodrive-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/contentmodelthisaddtodrive-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Contentmodel Getapplieddrives https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/contentmodel-getapplieddrives.md
GET https://graph.microsoft.com/beta/sites/ede4bb84-6c94-4c39-8acf-3d9dbb667fba/
[!INCLUDE [sample-code](../includes/snippets/php/contentmodelthisgetapplieddrives-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/contentmodelthisgetapplieddrives-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Contentmodel Removefromdrive https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/contentmodel-removefromdrive.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/contentmodelthisremovefromdrive-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/contentmodelthisremovefromdrive-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Conversationmembers Add https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/conversationmembers-add.md
Title: "conversationMember: add" description: "Add members in bulk to a team."-+ doc_type: "apiPageType" ms.localizationpriority: high
v1.0 Daynote Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/daynote-delete.md
Delete a [day note](../resources/daynote.md) object.
## 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": "daynote_delete" } -->
[!INCLUDE [permissions-table](../includes/permissions/daynote-delete-permissions.md)] ## HTTP request
v1.0 Daynote Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/daynote-get.md
Read the properties and relationships of a [day note](../resources/daynote.md) o
## 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": "daynote_get" } -->
[!INCLUDE [permissions-table](../includes/permissions/daynote-get-permissions.md)] ## HTTP request
v1.0 Daynote List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/daynote-list.md
Retrieve the properties and relationships of all [day notes](../resources/daynot
## 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": "daynote_list" } -->
[!INCLUDE [permissions-table](../includes/permissions/daynote-list-permissions.md)] ## HTTP request
v1.0 Devicelocalcredentialinfo Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/devicelocalcredentialinfo-get.md
To access the actual passwords on the device, done by including `$select=credent
## HTTP request To get the device local credential for a specific device object:
-> [!CAUTION]
-> The `GET /deviceLocalCredentials` endpoint will be deprecated on December 31, 2023. Use the `GET /directory/deviceLocalCredentials` endpoint instead.
->
- <!-- { "blockType": "ignored" } --> ``` http GET /directory/deviceLocalCredentials/{deviceId}
-GET /deviceLocalCredentials/{deviceId}
``` ## Request headers
v1.0 Directory List Devicelocalcredentials https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/directory-list-devicelocalcredentials.md
Choose the permission or permissions marked as least privileged for this API. Us
## HTTP request To get a list of deviceLocalCredentialInfo within the tenant:
-> [!CAUTION]
-> The `GET /deviceLocalCredentials` endpoint will be deprecated on December 31, 2023. Use the `GET /directory/deviceLocalCredentials` endpoint instead.
-
<!-- { "blockType": "ignored" } --> ``` http GET /directory/deviceLocalCredentials
-GET /deviceLocalCredentials
``` ## Optional query parameters
v1.0 Directoryaudit Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/directoryaudit-get.md
This method doesn't support any OData query parameters to help customize the res
| Name |Description| |:-|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Directoryaudit List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/directoryaudit-list.md
This method supports the `$filter` (`eq`, `ge`, `le`, `startswith`), `$top`, `$o
| Name |Description| |:-|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Domain List Rootdomain https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/domain-list-rootdomain.md
GET https://graph.microsoft.com/beta/domains/sub.contoso.com/rootDomain
[!INCLUDE [sample-code](../includes/snippets/php/get-rootdomain-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-rootdomain-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Driveitem Discardcheckout https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/driveitem-discardcheckout.md
POST https://graph.microsoft.com/beta/drives/{drive-id}/items/{item-id}/discardC
[!INCLUDE [sample-code](../includes/snippets/php/driveitemthisdiscardcheckout-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/driveitemthisdiscardcheckout-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Driveitem Getretentionlabel https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/driveitem-getretentionlabel.md
For information about retention labels from an administrator's perspective, see
## Permissions
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+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).
-| Permission type | Permissions (from least to most privileged) |
-|:|:-|
-| Delegated (work or school account) | Files.Read.All, Sites.Read.All |
-| Delegated (personal Microsoft account) | Not supported. |
-| Application | Files.Read.All, Sites.Read.All |
+<!-- { "blockType": "permissions", "name": "driveitem_getretentionlabel" } -->
## HTTP request
v1.0 Driveitem Lockorunlockrecord https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/driveitem-lockorunlockrecord.md
For more information about how you can lock and unlock retention labels, see [Us
## Permissions
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+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).
-| Permission type | Permissions (from least to most privileged) |
-|:|:--|
-| Delegated (work or school account) | Files.ReadWrite.All, Sites.ReadWrite.All |
-| Delegated (personal Microsoft account) | Not supported. |
-| Application | Files.ReadWrite.All, Sites.ReadWrite.All |
+<!-- { "blockType": "permissions", "name": "driveitem_lockorunlockrecord" } -->
## HTTP request
v1.0 Driveitem Removeretentionlabel https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/driveitem-removeretentionlabel.md
For information about retention labels from an administrator's perspective, see
## Permissions
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+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).
-| Permission type | Permissions (from least to most privileged) |
-|:|:--|
-| Delegated (work or school account) | Files.Read.All, Files.ReadWrite.All, Sites.ReadWrite.All, Sites.FullControl.All |
-| Delegated (personal Microsoft account) | Not supported. |
-| Application | Files.Read.All, Files.ReadWrite.All, Sites.ReadWrite.All |
+<!-- { "blockType": "permissions", "name": "driveitem_removeretentionlabel" } -->
>**Note:** `Sites.FullControl.All` is the least privileged permission required to remove retention labels that classify the content as records.
v1.0 Driveitem Setretentionlabel https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/driveitem-setretentionlabel.md
When a retention label is applied to a folder, all the items in the folder are t
## Permissions
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+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).
-| Permission type | Permissions (from least to most privileged) |
-|:|:--|
-| Delegated (work or school account) | Files.Read.All, Files.ReadWrite.All, Sites.ReadWrite.All |
-| Delegated (personal Microsoft account) | Not supported. |
-| Application | Files.Read.All, Files.ReadWrite.All, Sites.ReadWrite.All |
+<!-- { "blockType": "permissions", "name": "driveitem_setretentionlabel" } -->
>**Note:** `Sites.FullControl.All` is the least privileged permission required to change retention labels that classify the content as records.
v1.0 Educationassignment Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationassignment-get.md
Choose the permission or permissions marked as least privileged for this API. Us
GET /education/classes/{id}/assignments/{id} ``` ## Optional query parameters
-This method supports the `$select` and `$expand` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+This method supports the `$select`, `$orderby`, and `$expand` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+You can use `$orderby` with the following properties of the [educationAssignment](../resources/educationassignment.md) resource: **assignDateTime**, **assignedDateTime**, **closeDateTime**, **createdDateTime**, **displayName**, **dueDateTime**, **lastModifiedDateTime**, **moduleUrl**, and **status**.
The following `$expand` options are available for this method: `categories`, `resources`, `rubric`, `submissions`, `gradingScheme`, `gradingCategory`, and `*`. `*` specifies all the previous options.
v1.0 Educationassignment Post Categories https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationassignment-post-categories.md
POST /education/classes/{id}/assignments/{id}/categories/$ref
| Content-Type | application/json | ## Request body
-In the request body, supply the odata.id of the existing [educationCategory](../resources/educationcategory.md) object(s) to add to this assignment.
-
+In the request body, supply the **odata.id** of an existing [educationCategory](../resources/educationcategory.md) object to add to this assignment.
## Response If successful, this method returns a `204 No Content` response code. ## Example
-##### Request
+### Request
The following example shows a request.
+# [HTTP](#tab/http)
<!-- {
- "blockType": "ignored",
- "name": "add_educationcategory_to_educationassignment",
- "sampleKeys": ["11021", "19002"]
+ "blockType": "request",
+ "name": "add_educationcategory_to_educationassignment"
}--> ```http
-POST https://graph.microsoft.com/beta/education/classes/11021/assignments/19002/categories/$ref
+POST https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignments/70b7077c-7c1c-4e56-9b3b-2365411900c6/categories/$ref
Content-type: application/json {
- "@odata.id": "https://graph.microsoft.com/v1.0/education/classes/11021/assignmentCategories/ec98f158-341d-4fea-9f8c-14a250d489ac"
+ "@odata.id": "https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignmentCategories/39e3d9dc-7244-42d7-8b4d-1071aae5eb41"
}- ```
-In the request body, supply the odata.id of the existing [educationCategory](../resources/educationcategory.md) object to add to this assignment.
-##### Response
-The following example shows the response.
->**Note:** The response object shown here might be shortened for readability.
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+++
+### Response
+The following example shows the response.
<!-- {
- "blockType": "ignored",
- "truncated": true,
- "@odata.type": "microsoft.graph.educationAssignmentResource"
+ "blockType": "response",
+ "truncated": true
} --> ```http HTTP/1.1 204 No Content ```+ <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!--
HTTP/1.1 204 No Content
"suppressions": [] } -->--
v1.0 Educationassignment Remove Category https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationassignment-remove-category.md
If successful, this method returns a `204 No Content` response code.
## Example ### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- {
- "blockType": "ignored",
- "name": "add_educationcategory_to_educationassignment",
- "sampleKeys": ["11021", "19002", "ec98f158-341d-4fea-9f8c-14a250d489ac"]
+ "blockType": "request",
+ "name": "remove_educationcategory_from_educationassignment"
}--> ```http
-DELETE https://graph.microsoft.com/beta/education/classes/11021/assignments/19002/categories/ec98f158-341d-4fea-9f8c-14a250d489ac/$ref
+DELETE https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignments/e98aaae1-7c98-4e65-bb62-1994fe410552/categories/39e3d9dc-7244-42d7-8b4d-1071aae5eb41/$ref
```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+++ ### Response The following example shows the response. <!-- {
- "blockType": "ignored",
- "truncated": true,
- "@odata.type": "microsoft.graph.educationAssignmentResource"
+ "blockType": "response",
+ "truncated": true
} --> ```http HTTP/1.1 204 No Content
v1.0 Educationcategory Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationcategory-delete.md
If successful, this method returns a `204 No Content` response code. It doesn't
The following example shows a request. - # [HTTP](#tab/http) <!-- { "blockType": "request",
- "name": "delete_educationassignment_2",
- "sampleKeys": ["11014", "19002"]
+ "name": "delete_educationassignment_2"
}--> ```http
-DELETE https://graph.microsoft.com/beta/education/classes/11014/assignmentCategories/19002
+DELETE https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignmentCategories/39e3d9dc-7244-42d7-8b4d-1071aae5eb41
``` # [C#](#tab/csharp)
v1.0 Educationcategory Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationcategory-get.md
GET /education/classes/{id}/assignmentCategories/{id}
## Optional query parameters
-This method supports the `$select` OData query parameter to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+This method supports the `$select` and `$orderby` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+You can use `$orderby` with the **displayName** property of the [educationCategory](../resources/educationcategory.md) resource.
## Request headers | Header | Value |
v1.0 Educationclass Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationclass-delta.md
GET /education/classes/delta
| Name | Description | | : | : |
-| Authorization | Bearer {code} |
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Educationclass Getrecentlymodifiedsubmissions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationclass-getrecentlymodifiedsubmissions.md
+
+ Title: "getRecentlyModifiedSubmissions: educationClass"
+description: "Retrieve recently modified submissions. A submission object represents a student's work for an assignment."
+
+ms.localizationpriority: medium
+++
+# getRecentlyModifiedSubmissions: educationClass
+
+Namespace: microsoft.graph
++
+Retrieve submissions modified in the previous seven days. Only teachers and applications with application permissions can perform this operation.
+
+A **submission** object represents a student's work for an [assignment](../resources/educationassignment.md). Resources associated with the submission represent their work.
+
+A teacher or application with application permissions has full access to all **submission** objects.
+
+The grade and feedback from a teacher are part of the [educationOutcome](../resources/educationoutcome.md) associated with this object. Only teachers or applications with application permissions can add or change grades and feedback. Students can't see the grade or feedback until the **assignment** is released.
++
+## 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": "educationclass_get_recentlymodifiedsubmissions" } -->
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+```http
+GET /education/classes/{class-id}/getRecentlyModifiedSubmissions
+```
+
+## Optional query parameters
+This method supports the `$orderby`, `$top`, `$filter`, `$select`, and `$expand` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+The `$orderby` query parameter only supports the **lastModifiedDateTime** property of the [educationSubmission](../resources/educationsubmission.md) resource.
+
+The default ordering is by descending **lastModifiedDateTime** property values.
+
+## Request headers
+| Header | Value |
+|:|:--|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+Don't supply a request body for this method.
+
+## Response
+If successful, this method returns a `200 OK` response code and a collection of [educationSubmission](../resources/educationsubmission.md) objects in the response body.
+
+If you specify an unsupported property for the `$orderby` query parameter, the method returns a `400` error message.
+
+```http
+HTTP/1.1 400 Bad Request
+Content-type: application/json
+
+{
+ "error": {
+ "code": "20143",
+ "message": "The OData query is invalid. $orderby clause is only supported for these properties : (lastModifiedDateTime).",
+ "innerError": {
+ "date": "2024-08-27T13:04:10",
+ "request-id": "218ae0dc-664c-4928-b4e1-f3b37c27c472",
+ "client-request-id": "ed8c66ed-fd50-d7ec-d989-5a92140999c1"
+ }
+ }
+}
+```
+If you specify an unsupported value for the `$filter` query parameter, the method returns a `400` error message.
+
+```http
+HTTP/1.1 400 Bad Request
+Content-type: application/json
+
+{
+ "error": {
+ "code": "BadRequest",
+ "message": "Invalid filter clause: The $filter expression must evaluate to a single boolean value.",
+ "innerError": {
+ "date": "2024-08-27T13:05:11",
+ "request-id": "31233bf3-c442-4a8d-a1ff-56c665239e25",
+ "client-request-id": "30f9e18f-f311-741b-bf48-23fd4feecdb9"
+ }
+ }
+}
+```
+
+## Examples
+### Example 1: Get recently modified submissions
+
+#### Request
+The following example shows a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_educationclass_getrecentlymodifiedsubmissions"
+}-->
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/getRecentlyModifiedSubmissions
+```
+
+#### Response
+The following example shows the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.educationSubmission)"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.educationSubmission)",
+ "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET education/classes('<guid>')/microsoft.graph.getRecentlyModifiedSubmissions?$select=excusedBy,excusedDateTime",
+ "value": [
+ {
+ "status": "returned",
+ "submittedDateTime": null,
+ "unsubmittedDateTime": "2024-08-14T05:48:30.9345815Z",
+ "returnedDateTime": "2024-08-14T05:47:41.4128921Z",
+ "reassignedDateTime": "2024-08-14T05:47:18.3007671Z",
+ "excusedDateTime": "2024-08-14T05:47:41.4128921Z",
+ "lastModifiedDateTime": "2024-08-14T06:37:17.9779374Z",
+ "resourcesFolderUrl": null,
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%22bf1f1963-05f6-4cba-903c-5892b4ce3bd7%5C%22,%5C%22assignmentIds%5C%22%3A%5B%5C%22db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%224bca096a-7de3-8675-5e86-2fa149923860%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22,%5C%22appId%5C%22%3A%5C%22de8bc8b5-d9f9-48b1-a8ad-b748da725064%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "4bca096a-7de3-8675-5e86-2fa149923860",
+ "recipient": {
+ "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"
+ },
+ "submittedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a",
+ "displayName": null
+ }
+ },
+ "unsubmittedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ },
+ "returnedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ },
+ "reassignedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ },
+ "excusedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ }
+ }
+ ]
+}
+```
+
+### Example 2: Get recently modified submissions with `$expand` option
+
+#### Request
+The following example shows a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_educationclass_getrecentlymodifiedsubmissions_expand"
+}-->
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/getRecentlyModifiedSubmissions?$expand=outcomes
+```
+
+#### Response
+The following example shows the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.educationSubmission)"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.educationSubmission)",
+ "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET education/classes('<guid>')/microsoft.graph.getRecentlyModifiedSubmissions?$select=excusedBy,excusedDateTime",
+ "value": [
+ {
+ "status": "working",
+ "submittedDateTime": null,
+ "unsubmittedDateTime": null,
+ "returnedDateTime": null,
+ "reassignedDateTime": null,
+ "excusedDateTime": null,
+ "lastModifiedDateTime": "2024-08-26T20:45:51.3485047Z",
+ "resourcesFolderUrl": null,
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%2237d99af7-cfc5-4e3b-8566-f7d40e4a2070%5C%22,%5C%22assignmentIds%5C%22%3A%5B%5C%2273b252e5-5f2c-42d6-8896-bfe924ce5fe9%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%225af42a11-37cc-c144-fa4c-7db855942011%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22,%5C%22appId%5C%22%3A%5C%22de8bc8b5-d9f9-48b1-a8ad-b748da725064%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "5af42a11-37cc-c144-fa4c-7db855942011",
+ "recipient": {
+ "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
+ "userId": "e5c17181-ad7e-4a66-86bf-b560ce0c8b29"
+ },
+ "submittedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "e5c17181-ad7e-4a66-86bf-b560ce0c8b29",
+ "displayName": null
+ }
+ },
+ "unsubmittedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": null,
+ "displayName": null
+ }
+ },
+ "returnedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": null,
+ "displayName": null
+ }
+ },
+ "reassignedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": null,
+ "displayName": null
+ }
+ },
+ "excusedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": null,
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "7254e396-868c-4bf7-96b2-6fe763590b5a",
+ "displayName": null
+ }
+ },
+ "outcomes": [
+ {
+ "@odata.type": "#microsoft.graph.educationFeedbackOutcome",
+ "lastModifiedDateTime": null,
+ "id": "ca05367a-b292-42d5-aff7-5d279feeace8",
+ "lastModifiedBy": null,
+ "feedback": null,
+ "publishedFeedback": null
+ },
+ {
+ "@odata.type": "#microsoft.graph.educationPointsOutcome",
+ "lastModifiedDateTime": null,
+ "id": "ea1351f6-ba33-4940-b2cb-6a7254af2dc8",
+ "lastModifiedBy": null,
+ "points": null,
+ "publishedPoints": null
+ }
+ ]
+ }
+ ]
+}
+```
+
+### Example 3: Get recently modified submissions with `$filter` option
+
+#### Request
+The following example shows a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_educationclass_getrecentlymodifiedsubmissions_filter"
+}-->
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/getRecentlyModifiedSubmissions?$filter=status eq 'working'
+```
+
+#### Response
+The following example shows the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.educationSubmission)"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.educationSubmission)",
+ "@odata.nextLink": "https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/getRecentlyModifiedSubmissions?$filter=status+eq+%27working%27&$skiptoken=eyJJbm5lclNraXBUb2tlbiI6Ik15WlJWa1pDVVZWR1FsRlZSa1phTVd4Q1VWVkdRbEZWUmtKU1JXeENVVlZHUWxWWFZscE9SM040U3pCc1RGWlRjM2RTTUhkNlZGVlJlRlJzUW1oa2VqQTUifQ%3d%3d",
+ "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET education/classes('<guid>')/microsoft.graph.getRecentlyModifiedSubmissions?$select=excusedBy,excusedDateTime",
+ "value": [
+ {
+ "status": "working",
+ "submittedDateTime": null,
+ "unsubmittedDateTime": null,
+ "returnedDateTime": null,
+ "reassignedDateTime": null,
+ "excusedDateTime": null,
+ "lastModifiedDateTime": "2024-08-26T15:57:23.5476513Z",
+ "resourcesFolderUrl": null,
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%2237d99af7-cfc5-4e3b-8566-f7d40e4a2070%5C%22,%5C%22assignmentIds%5C%22%3A%5B%5C%223d2fcfd4-cb6a-4e31-aa63-16ca865e9014%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%227e2e0656-2bf4-1f95-b4b0-967f516340cd%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22,%5C%22appId%5C%22%3A%5C%22de8bc8b5-d9f9-48b1-a8ad-b748da725064%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "7e2e0656-2bf4-1f95-b4b0-967f516340cd",
+ "recipient": {
+ "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
+ "userId": "80cefd93-8d88-40e2-b5d3-67898383e226"
+ },
+ "submittedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "displayName": null
+ }
+ },
+ "unsubmittedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": null,
+ "displayName": null
+ }
+ },
+ "returnedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": null,
+ "displayName": null
+ }
+ },
+ "reassignedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": null,
+ "displayName": null
+ }
+ },
+ "excusedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": null,
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "5e3ce6c0-2b1f-4285-8d4b-75ee78787346",
+ "displayName": null
+ }
+ }
+ }
+ ]
+}
+```
+
+### Example 4: Get recently modified submissions with `$orderby` and `$top` options
+
+#### Request
+The following example shows a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_educationclass_getrecentlymodifiedsubmissions_orderby_top"
+}-->
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/getRecentlyModifiedSubmissions?$orderby=lastModifiedDateTime&$top=1
+```
+
+#### Response
+The following example shows the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.educationSubmission)"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.educationSubmission)",
+ "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET education/classes('<guid>')/microsoft.graph.getRecentlyModifiedSubmissions?$select=excusedBy,excusedDateTime",
+ "value": [
+ {
+ "status": "working",
+ "submittedDateTime": null,
+ "unsubmittedDateTime": null,
+ "returnedDateTime": null,
+ "reassignedDateTime": null,
+ "excusedDateTime": null,
+ "lastModifiedDateTime": "2024-08-26T15:57:23.2992323Z",
+ "resourcesFolderUrl": null,
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%2237d99af7-cfc5-4e3b-8566-f7d40e4a2070%5C%22,%5C%22assignmentIds%5C%22%3A%5B%5C%223d2fcfd4-cb6a-4e31-aa63-16ca865e9014%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%223b03a85c-6021-8e5c-fc07-c4ac6d3506d3%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22,%5C%22appId%5C%22%3A%5C%22de8bc8b5-d9f9-48b1-a8ad-b748da725064%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "3b03a85c-6021-8e5c-fc07-c4ac6d3506d3",
+ "recipient": {
+ "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
+ "userId": "2d20b7fc-43bd-459c-81e0-5eb4aa20d5b5"
+ },
+ "submittedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "2d20b7fc-43bd-459c-81e0-5eb4aa20d5b5",
+ "displayName": null
+ }
+ },
+ "unsubmittedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": null,
+ "displayName": null
+ }
+ },
+ "returnedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": null,
+ "displayName": null
+ }
+ },
+ "reassignedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": null,
+ "displayName": null
+ }
+ },
+ "excusedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": null,
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "5e3ce6c0-2b1f-4285-8d4b-75ee78787346",
+ "displayName": null
+ }
+ }
+ }
+ ]
+}
+```
+
+### Example 5: Get recently modified submissions with `$select` option
+
+#### Request
+The following example shows a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_educationclass_getrecentlymodifiedsubmissions_select"
+}-->
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/getRecentlyModifiedSubmissions?$select=excusedDateTime
+```
+
+#### Response
+The following example shows the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.educationSubmission)"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.educationSubmission)",
+ "value": [
+ {
+ "excusedDateTime": "2024-08-26T16:00:17.535348Z"
+ },
+ {
+ "excusedDateTime": "2024-08-26T16:00:17.4698345Z"
+ },
+ {
+ "excusedDateTime": null
+ }
+ ]
+}
+```
+### Example 6: Get recently modified submissions with `$filter` option for a range on lastModifiedDateTime property
+
+#### Request
+The following example shows a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_educationclass_getrecentlymodifiedsubmissions_filter_range"
+}-->
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/getRecentlyModifiedSubmissions?$filter=lastModifiedDateTime gt 2024-08-25T20:45:51.3485047Z and lastModifiedDateTime lt 2024-08-28T20:45:51.3485047Z
+```
+
+#### Response
+The following example shows the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.educationSubmission)"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.educationSubmission)",
+ "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET education/classes('<guid>')/microsoft.graph.getRecentlyModifiedSubmissions?$select=excusedBy,excusedDateTime",
+ "value": [
+ {
+ "status": "working",
+ "submittedDateTime": null,
+ "unsubmittedDateTime": null,
+ "returnedDateTime": null,
+ "reassignedDateTime": null,
+ "excusedDateTime": null,
+ "lastModifiedDateTime": "2024-08-26T20:45:51.3485047Z",
+ "resourcesFolderUrl": null,
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%2237d99af7-cfc5-4e3b-8566-f7d40e4a2070%5C%22,%5C%22assignmentIds%5C%22%3A%5B%5C%2273b252e5-5f2c-42d6-8896-bfe924ce5fe9%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%225af42a11-37cc-c144-fa4c-7db855942011%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22,%5C%22appId%5C%22%3A%5C%22de8bc8b5-d9f9-48b1-a8ad-b748da725064%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "5af42a11-37cc-c144-fa4c-7db855942011",
+ "recipient": {
+ "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
+ "userId": "e5c17181-ad7e-4a66-86bf-b560ce0c8b29"
+ },
+ "submittedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "e5c17181-ad7e-4a66-86bf-b560ce0c8b29",
+ "displayName": null
+ }
+ },
+ "unsubmittedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": null,
+ "displayName": null
+ }
+ },
+ "returnedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": null,
+ "displayName": null
+ }
+ },
+ "reassignedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": null,
+ "displayName": null
+ }
+ },
+ "excusedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": null,
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "7254e396-868c-4bf7-96b2-6fe763590b5a",
+ "displayName": null
+ }
+ }
+ }
+ ]
+}
+```
+
+<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
+2024-08-18 14:57:30 UTC -->
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Get educationSubmission recentlymodifiedsubmission",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": []
+}
+-->
v1.0 Educationfeedbackresourceoutcome Post Outcomes https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationfeedbackresourceoutcome-post-outcomes.md
HTTP/1.1 201 Created
Content-type: application/json {
- "@odata.context": "https://graph.microsoft.com/beta/education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/assignments('a3cce0ba-2008-4c4d-bf62-079408562d96')/submissions('2185e6d7-2924-4ed1-dde1-269f89e29184')/outcomes/$entity",
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/assignments('a3cce0ba-2008-4c4d-bf62-079408562d96')/submissions('2185e6d7-2924-4ed1-dde1-269f89e29184')/outcomes/$entity",
"@odata.type": "#microsoft.graph.educationFeedbackResourceOutcome",
- "lastModifiedDateTime": "2022-05-06T00:50:30.0772434Z",
- "id": "ba12f282-2190-4958-80b3-42b8afb9626a",
+ "lastModifiedDateTime": "2024-08-14T06:50:11.6979503Z",
+ "id": "b7e92489-91b6-4734-ab5c-b1370862e4a2",
"resourceStatus": "notPublished", "lastModifiedBy": { "application": null, "device": null, "user": {
- "id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } }, "feedbackResource": { "@odata.type": "#microsoft.graph.educationWordResource", "displayName": "Document1.docx",
- "createdDateTime": "2022-05-06T00:50:30.0772177Z",
- "lastModifiedDateTime": "2022-05-06T00:50:30.0772434Z",
- "fileUrl": "https://graph.microsoft.com/beta/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F8CNZWU38SarWxPyWM7jx/items/01VANVJQZQ33I4AJBSURHZJDDQKEJ5TEMJ",
+ "createdDateTime": "2024-08-14T06:50:11.6979432Z",
+ "lastModifiedDateTime": "2024-08-14T06:50:11.6979503Z",
+ "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F8CNZWU38SarWxPyWM7jx/items/01VANVJQZ6GPYK2SPEXRDKILMSBSL5KNKM",
"createdBy": { "application": null, "device": null, "user": {
- "id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
Content-type: application/json
"application": null, "device": null, "user": {
- "id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } }
v1.0 Educationoutcome Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationoutcome-update.md
The following example shows a request to update a feedback outcome.
}--> ```http
-PATCH https://graph.microsoft.com/beta/education/classes/{id}/assignments/{id}/submissions/{id}/outcomes/{id}
+PATCH https://graph.microsoft.com/beta/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/assignments/db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a/submissions/4bca096a-7de3-8675-5e86-2fa149923860/outcomes/ca05367a-b292-42d5-aff7-5d279feeace8
Content-type: application/json {
HTTP/1.1 200 OK
Content-type: application/json {
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('bf1f1963-05f6-4cba-903c-5892b4ce3bd7')/assignments('db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a')/submissions('4bca096a-7de3-8675-5e86-2fa149923860')/outcomes/$entity",
"@odata.type": "#microsoft.graph.educationFeedbackOutcome",
+ "lastModifiedDateTime": "2024-08-14T06:37:17.7703021Z",
"id": "ca05367a-b292-42d5-aff7-5d279feeace8",
+ "publishedFeedback": null,
"lastModifiedBy": {
+ "application": null,
+ "device": null,
"user": {
- "id": "9391878d-903c-406c-bb1c-0f17d00fd878"
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
} }, "feedback": {
- "feedbackDateTime": "2019-07-31T21:10:30.3231461Z",
+ "feedbackDateTime": "2024-08-14T06:37:17.7703021Z",
"text": { "content": "This is feedback for the assignment as a whole.", "contentType": "text" }, "feedbackBy": {
+ "application": null,
+ "device": null,
"user": {
- "id": "9391878d-903c-406c-bb1c-0f17d00fd878",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
} } }
v1.0 Educationschool Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationschool-delta.md
GET /education/schools/delta
| Name | Description | | : | : |
-| Authorization | Bearer {code} |
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Educationsubmission Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsubmission-get.md
GET /education/classes/{class-id}/assignments/{assignment-id}/submissions/{submi
## Optional query parameters
-This method supports the `$select` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+This method supports the `$select` and `$orderby` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+You can use `$orderby` with the following properties of the [educationSubmission](../resources/educationsubmission.md) resource: **excusedDateTime**, **reassignedDateTime**, **returnedDateTime**, **status**, **submittedDateTime**, and **unsubmittedDateTime**.
## Request headers | Header | Value |
v1.0 Educationsubmission List Outcomes https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsubmission-list-outcomes.md
The following example shows a request.
}--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/education/classes/{id}/assignments/{id}/submissions/{id}/outcomes
+GET https://graph.microsoft.com/beta/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/assignments/db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a/submissions/4bca096a-7de3-8675-5e86-2fa149923860/outcomes
``` # [C#](#tab/csharp)
HTTP/1.1 200 OK
Content-type: application/json {
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('bf1f1963-05f6-4cba-903c-5892b4ce3bd7')/assignments('db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a')/submissions('4bca096a-7de3-8675-5e86-2fa149923860')/outcomes",
"value": [ { "@odata.type": "#microsoft.graph.educationFeedbackOutcome",
+ "lastModifiedDateTime": null,
"id": "ca05367a-b292-42d5-aff7-5d279feeace8",
- "feedback": {
- "feedbackDateTime": "2019-07-15T22:35:46.4847754Z",
- "text": {
- "content": "This is feedback for the assignment as a whole.",
- "contentType": "text"
- },
- "feedbackBy": {
- "user": {
- "id": "9391878d-903c-406c-bb1c-0f17d00fd878"
- }
+ "lastModifiedBy": null,
+ "feedback": null,
+ "publishedFeedback": null
+ },
+ {
+ "@odata.type": "#microsoft.graph.educationPointsOutcome",
+ "lastModifiedDateTime": null,
+ "id": "ea1351f6-ba33-4940-b2cb-6a7254af2dc8",
+ "lastModifiedBy": null,
+ "points": null,
+ "publishedPoints": null
+ },
+ {
+ "@odata.type": "#microsoft.graph.educationRubricOutcome",
+ "lastModifiedDateTime": "2024-08-14T05:47:41.8399565Z",
+ "id": "65a46d78-1a2b-4a7e-bcf8-78a22ac2611b",
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": null,
+ "displayName": null
} },
- "publishedFeedback": {
- "feedbackDateTime": "2019-07-15T22:35:46.4847754Z",
- "text": {
- "content": "This is feedback for the assignment as a whole.",
- "contentType": "text"
+ "rubricQualityFeedback": [
+ {
+ "qualityId": "6b9eccdd-ae31-474d-9ab5-33ba885873f9",
+ "feedback": null
},
- "feedbackBy": {
- "user": {
- "id": "9391878d-903c-406c-bb1c-0f17d00fd878"
- }
+ {
+ "qualityId": "0fdf030a-2e52-4ea4-b321-74091cef90b0",
+ "feedback": null
+ },
+ {
+ "qualityId": "8fdacfb6-0e28-4bce-9153-3196fbcc0eaa",
+ "feedback": null
}
- }
+ ],
+ "rubricQualitySelectedLevels": [
+ {
+ "qualityId": "6b9eccdd-ae31-474d-9ab5-33ba885873f9",
+ "columnId": null
+ },
+ {
+ "qualityId": "0fdf030a-2e52-4ea4-b321-74091cef90b0",
+ "columnId": null
+ },
+ {
+ "qualityId": "8fdacfb6-0e28-4bce-9153-3196fbcc0eaa",
+ "columnId": null
+ }
+ ],
+ "publishedRubricQualityFeedback": [
+ {
+ "qualityId": "6b9eccdd-ae31-474d-9ab5-33ba885873f9",
+ "feedback": null
+ },
+ {
+ "qualityId": "0fdf030a-2e52-4ea4-b321-74091cef90b0",
+ "feedback": null
+ },
+ {
+ "qualityId": "8fdacfb6-0e28-4bce-9153-3196fbcc0eaa",
+ "feedback": null
+ }
+ ],
+ "publishedRubricQualitySelectedLevels": [
+ {
+ "qualityId": "6b9eccdd-ae31-474d-9ab5-33ba885873f9",
+ "columnId": null
+ },
+ {
+ "qualityId": "0fdf030a-2e52-4ea4-b321-74091cef90b0",
+ "columnId": null
+ },
+ {
+ "qualityId": "8fdacfb6-0e28-4bce-9153-3196fbcc0eaa",
+ "columnId": null
+ }
+ ]
} ] }
Content-type: application/json
"value": [ { "@odata.type": "#microsoft.graph.educationFeedbackResourceOutcome",
- "lastModifiedDateTime": "2022-05-06T00:52:12.8318457Z",
- "id": "8fb409c5-570b-4fe5-8473-d3666e61f3a0",
+ "lastModifiedDateTime": "2022-05-06T00:52:17.3180275Z",
+ "id": "0710aeea-590d-46b4-9eb8-1c08b6549677",
"resourceStatus": "notPublished", "lastModifiedBy": { "application": null,
Content-type: application/json
}, "feedbackResource": { "@odata.type": "#microsoft.graph.educationWordResource",
- "displayName": "Document2.docx",
- "createdDateTime": "2022-05-06T00:52:12.8318064Z",
- "lastModifiedDateTime": "2022-05-06T00:52:12.8318457Z",
- "fileUrl": "https://graph.microsoft.com/beta/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F8CNZWU38SarWxPyWM7jx/items/01VANVJQ26WF6K2W2IOFAKDITG4F5GWRH5",
+ "displayName": "Document3.docx",
+ "createdDateTime": "2022-05-06T00:52:17.3180176Z",
+ "lastModifiedDateTime": "2022-05-06T00:52:17.3180275Z",
+ "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F8CNZWU38SarWxPyWM7jx/items/01VANVJQ563EMEMHRTBBH2SOZ4GDSNEUZK",
"createdBy": { "application": null, "device": null,
v1.0 Educationsubmission Reassign https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsubmission-reassign.md
The following is an example of the response when `Prefer: include-unknown-enum-m
<!-- { "blockType": "response",
+ "truncated": true,
"@odata.type": "microsoft.graph.educationSubmission" } --> ```http
Prefer: include-unknown-enum-members
The following is an example of the response when `Prefer: include-unknown-enum-members` is provided in the request header and the submission hasn't been returned before. <!-- {
- "blockType": "response",
+ "blockType": "response",
+ "truncated": true,
"@odata.type": "microsoft.graph.educationSubmission" } --> ```http
v1.0 Educationuser Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationuser-delta.md
GET /education/users/delta
| Name | Description | | : | : |
-| Authorization | Bearer {code} |
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Educationuser List Assignments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationuser-list-assignments.md
This method supports the `$top`, `$filter`, `$orderby`, and `$select` OData quer
The following `$expand` options are available for this method: `categories`, `resources`, `gradingCategory`, `rubric`, `submissions`, and `*`, which includes all the previous options.
-All [properties](../resources/educationassignment.md#properties) are supported for the query parameters `$filter` and `$orderby`.
+All [properties](../resources/educationassignment.md#properties) are supported by the `$filter` query parameter.
+
+You can use `$orderby` with the following properties of the [educationAssignment](../resources/educationassignment.md) resource: **assignDateTime**, **assignedDateTime**, **closeDateTime**, **createdDateTime**, **displayName**, **dueDateTime**, **lastModifiedDateTime**, and **status**.
## Request headers
v1.0 Event Permanentdelete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-permanentdelete.md
+
+ Title: "event: permanentDelete"
+description: "Permanently delete an event and place it in the Purges folder in the dumpster in the user's mailbox."
+
+ms.localizationpriority: high
+++
+# event: permanentDelete
+
+Namespace: microsoft.graph
++
+Permanently delete an event and place it in the Purges folder in the dumpster in the user's mailbox. Email clients such as Outlook or the Outlook on the web can't access permanently deleted items. Unless there's a hold set on the mailbox, the items are permanently deleted after a set period of time.
+
+For more information about item retention, see [Configure Deleted Item retention and Recoverable Items quotas](/exchange/configure-deleted-item-retention-and-recoverable-items-quotas-exchange-2013-help).
+
+>**Note:** Folders aren't placed in the Purges folder when they are permanently deleted. Permanently deleted folders are removed from the mailbox.
++
+## 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": "event_permanentdelete" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /users/{usersId}/events/{eventId}/permanentDelete
+POST /groups/{groupsId}/events/{eventId}/permanentDelete
+POST /users/{usersId}/calendarView/{eventId}/permanentDelete
+POST /groups/{groupsId}/calendarView/{eventId}/permanentDelete
+POST /users/{usersId}/messages/{messageId}/event/permanentDelete
+POST /users/{usersId}/messages/{messageId}/event/instances/{eventId}/permanentDelete
+POST /users/{usersId}/messages/{messageId}/event/calendar/events/{eventId}/permanentDelete
+POST /users/{usersId}/messages/{messageId}/event/exceptionOccurrences/{eventId}/permanentDelete
+POST /users/{usersId}/messages/{messageId}/event/calendar/calendarView/{eventId}/permanentDelete
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this action returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "eventthis.permanentdelete"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/users/{usersId}/events/{eventId}/permanentDelete
+```
+
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
++++
+### Response
+
+The following example shows the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Eventmessage Permanentdelete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/eventmessage-permanentdelete.md
+
+ Title: "eventMessage: permanentDelete"
+description: "Permanently delete an event message and place it in the Purges folder in the user's mailbox."
+
+ms.localizationpriority: high
+++
+# eventMessage: permanentDelete
+
+Namespace: microsoft.graph
++
+Permanently delete an event message and place it in the Purges folder in the user's mailbox. Email clients such as Outlook or the Outlook on the web can't access permanently deleted items. Unless there's a hold set on the mailbox, the items are permanently deleted after a set period of time.
+
+For more information about item retention, see [Configure Deleted Item retention and Recoverable Items quotas](/exchange/configure-deleted-item-retention-and-recoverable-items-quotas-exchange-2013-help).
+++
+## 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": "eventmessage_permanentdelete" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /me/messages/{id}/permanentDelete
+POST /users/{id | userPrincipalName}/messages/{id}/permanentDelete
+POST /me/mailFolders/{id}/messages/{id}/permanentDelete
+POST /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}/permanentDelete
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this action returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "eventmessagethis.permanentdelete"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/me/messages/{id}/permanentDelete
+```
+
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
++++
+### Response
+
+The following example shows the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Exchangeprotectionpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/exchangeprotectionpolicy-update.md
To remove a **mailboxProtectionUnit** from the policy, specify the `@removed` an
If successful, this method returns a `200 OK` response code and an updated [exchangeProtectionPolicy](../resources/exchangeprotectionpolicy.md) object in the response body.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Request
v1.0 Exchangerestoresession List Mailboxrestoreartifacts https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/exchangerestoresession-list-mailboxrestoreartifacts.md
Don't supply a request body for this method.
If successful, this method returns a `200 OK` response code and a collection of [mailboxRestoreArtifact](../resources/mailboxrestoreartifact.md) objects in the response body.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Request
v1.0 Exchangerestoresession Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/exchangerestoresession-update.md
To remove an **exchangeRestoreSession**, specify the @removed annotation in the
If successful, this method returns a `200 OK` response code and an updated [exchangeRestoreSession](../resources/exchangerestoresession.md) object in the response body.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Request
v1.0 Externalauthenticationmethodconfiguration Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externalauthenticationmethodconfiguration-delete.md
Delete an [externalAuthenticationMethodConfiguration](../resources/externalauthe
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": "externalauthenticationmethodconfiguration-delete-permissions"
-}
>
+<!-- { "blockType": "permissions", "name": "externalauthenticationmethodconfiguration_delete" } -->
[!INCLUDE [permissions-table](../includes/permissions/externalauthenticationmethodconfiguration-delete-permissions.md)] [!INCLUDE [rbac-authentication-methods-policy-apis-write](../includes/rbac-for-apis/rbac-authentication-methods-policy-apis-write.md)]
v1.0 Externalauthenticationmethodconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externalauthenticationmethodconfiguration-get.md
Read the properties and relationships of an [externalAuthenticationMethodConfigu
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": "externalauthenticationmethodconfiguration-get-permissions"
-}
>
+<!-- { "blockType": "permissions", "name": "externalauthenticationmethodconfiguration_get" } -->
[!INCLUDE [permissions-table](../includes/permissions/externalauthenticationmethodconfiguration-get-permissions.md)] [!INCLUDE [rbac-authentication-methods-policy-apis-read](../includes/rbac-for-apis/rbac-authentication-methods-policy-apis-read.md)]
v1.0 Externalauthenticationmethodconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externalauthenticationmethodconfiguration-update.md
Update the properties of an [externalAuthenticationMethodConfiguration](../resou
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": "externalauthenticationmethodconfiguration-update-permissions"
-}
>
+<!-- { "blockType": "permissions", "name": "externalauthenticationmethodconfiguration_update" } -->
[!INCLUDE [permissions-table](../includes/permissions/externalauthenticationmethodconfiguration-update-permissions.md)] [!INCLUDE [rbac-authentication-methods-policy-apis-write](../includes/rbac-for-apis/rbac-authentication-methods-policy-apis-write.md)]
v1.0 Fido2authenticationmethod Creationoptions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/fido2authenticationmethod-creationoptions.md
Retrieve creation options required to generate and register a Microsoft Entra ID
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": "fido2authenticationmethod-creationoptions-permissions"
-}
>
+<!-- { "blockType": "permissions", "name": "fido2authenticationmethod_creationoptions" } -->
[!INCLUDE [permissions-table](../includes/permissions/fido2authenticationmethod-creationoptions-permissions.md)] [!INCLUDE [rbac-authentication-methods-apis-write-others](../includes/rbac-for-apis/rbac-authentication-methods-apis-write-others.md)]
Choose the permission or permissions marked as least privileged for this API. Us
} --> ``` http
-GET /users/{usersId}/authentication/fido2Methods/creationOptions
+GET /users/{user-id}/authentication/fido2Methods/creationOptions(challengeTimeoutInMinutes={challengeTimeoutInMinutes})
``` ## Function parameters
GET https://graph.microsoft.com/beta/users/{usersId}/authentication/fido2Methods
[!INCLUDE [sample-code](../includes/snippets/javascript/fido2authenticationmethodthiscreationoptions-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ ### Response
Content-Type: application/json
{ "value": {
- "@odata.type": "microsoft.graph.webauthnCredentialCreationOptions"
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#microsoft.graph.webauthnCredentialCreationOptions",
+ "challengeTimeoutDateTime": "2024-08-14T16:29:58Z",
+ "publicKey": {
+ "challenge": "ZXlKaGJHY2lPaUpTVTBFdFQwRkZVQzB5TlRZaUxDSmxibU1pT2lKQk1qVTJSME5OSWl3aWVEVmpJanBiSWsxSlNVUmhSRU5EUVd4...",
+ "timeout": 0,
+ "attestation": "direct",
+ "rp": {
+ "id": "login.microsoft.com",
+ "name": "Microsoft"
+ },
+ "user": {
+ "id": "T0Y6Ehqp2EfQP0iExdt54DFwdWuaH7qIZbZGpOc92RGnvbXyRPvU-8AOp9r1T7Cebfc3",
+ "displayName": "Kim User",
+ "name": "kimuser@contoso.com"
+ },
+ "pubKeyCredParams": [
+ {
+ "type": "public-key",
+ "alg": -7
+ },
+ {
+ "type": "public-key",
+ "alg": -257
+ }
+ ],
+ "excludeCredentials": [
+ {
+ "id": "0S64X8KwFmCeJjHzK1oE/39T+JYhfYbhFurwOxMMjtvRWc/sLYq8AMJVuva823XQ",
+ "type": "public-key",
+ "transports": []
+ },
+ {
+ "id": "pgIfj2fnom8rJdb4/h1gKqDkq+gxHFksI+m2aR5T+PNNycBfENAM4ksEBvoXky6d",
+ "type": "public-key",
+ "transports": []
+ },
+ {
+ "id": "u5wuw6SGH0VhAz7OXCLRkCuxhm4UrCB7hcLccyMU6calP1hWexfKe5PJNM69neAM",
+ "type": "public-key",
+ "transports": []
+ },
+ {
+ "id": "6rc0zTSz2YRlaKlCjqxsNDjDe8qY8TSL95Z4WhxEaaP4XfvfSnAGMk49RSwm/uAO",
+ "type": "public-key",
+ "transports": []
+ }
+ ],
+ "authenticatorSelection": {
+ "authenticatorAttachment": "cross-platform",
+ "requireResidentKey": true,
+ "userVerification": "required"
+ },
+ "extensions": {
+ "hmacCreateSecret": true,
+ "enforceCredentialProtectionPolicy": true,
+ "credentialProtectionPolicy": "userVerificationOptional"
+ }
+ }
} } ```
v1.0 Governanceresource Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/governanceresource-get.md
This method **only** supports `$select` and `$expand` [OData Query Parameters](
## Request headers | Name |Description| |:-|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Governanceresource List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/governanceresource-list.md
This method supports the [OData query parameters](/graph/query-parameters) to he
## Request headers | Name |Description| |:-|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Governanceroleassignment Export https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/governanceroleassignment-export.md
This method supports the [OData query parameters](/graph/query-parameters) to he
## Request headers | Name |Description| |:-|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Governanceroleassignment Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/governanceroleassignment-get.md
This method does **not** supports [OData Query Parameters](/graph/query-paramete
## Request headers | Name |Description| |:-|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Governanceroleassignment List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/governanceroleassignment-list.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name |Description| |:-|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Governanceroleassignmentrequest Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/governanceroleassignmentrequest-get.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name |Description| |:-|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Governanceroleassignmentrequest List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/governanceroleassignmentrequest-list.md
This method supports the [OData query parameters](/graph/query-parameters) to he
## Request headers | Name |Description| |:-|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Governanceroleassignmentrequest Post https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/governanceroleassignmentrequest-post.md
POST /privilegedAccess/azureResources/roleAssignmentRequests
| Name | Description | |:--|:--|
-| Authorization | Bearer {code} |
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-type | application/json | ## Request body
v1.0 Governanceroleassignmentrequest Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/governanceroleassignmentrequest-update.md
POST /privilegedAccess/azureResources/roleAssignmentRequests/{id}/updateRequest
## Request headers | Name | Description| |:|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-type | application/json| ## Request body
v1.0 Governanceroledefinition Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/governanceroledefinition-get.md
This method does **not** support the [OData Query Parameters](/graph/query-param
## Request headers | Name |Description| |:-|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Governanceroledefinition List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/governanceroledefinition-list.md
This method supports the [OData query parameters](/graph/query-parameters) to he
## Request headers | Name |Description| |:-|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Governancerolesetting Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/governancerolesetting-get.md
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request headers | Name |Description| |:-|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Governancerolesetting List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/governancerolesetting-list.md
This method supports the [OData query parameters](/graph/query-parameters) to he
## Request headers | Name |Description| |:-|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Group Assignlicense https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-assignlicense.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Add or remove licenses on the group. Licenses assigned to the group will be assigned to all users in the group. To learn more about group-based licensing, see [What is group-based licensing in Microsoft Entra ID](/azure/active-directory/fundamentals/active-directory-licensing-whatis-azure-portal).
+Add or remove licenses on the group. Licenses assigned to the group will be assigned to all users in the group. Group-based licensing is an alternative to [direct user licensing](../api/user-assignlicense.md). To learn more about group-based licensing, see [What is group-based licensing in Microsoft Entra ID](/azure/active-directory/fundamentals/active-directory-licensing-whatis-azure-portal).
To get the subscriptions available in the directory, perform a [GET subscribedSkus request](subscribedsku-list.md).
v1.0 Group Post Groups https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-post-groups.md
The following table lists the properties that are required when you create the [
> [!IMPORTANT] >
-> - Creating a group using the **Group.Create** application permission without specifying owners will create the group anonymously and the group will not be modifiable. Add owners to the group while creating it to specify owners who can modify the group.
+> - Creating a group using the **Group.Create** application permission without specifying owners creates the group anonymously and the group isn't modifiable. Add owners to the group while creating it so the owners can manage the group.
>
-> - Creating a Microsoft 365 group programmatically with an app-only context and without specifying owners will create the group anonymously. Doing so can result in the associated SharePoint Online site not being created automatically until further manual action is taken.
+> - Creating a Microsoft 365 group in an app-only context and without specifying owners creates the group anonymously. Doing so can result in the associated SharePoint Online site not being created automatically until further manual action is taken.
+>
+> - Creating a Microsoft 365 or security group in a delegated context, signed in as a non-admin user, and without specifying owners automatically adds the calling user as the group owner. An admin user is automatically added as the group owner of a Microsoft 365 group they create but not of a security group.
> > - To following properties can't be set in the initial POST request and must be set in a subsequent PATCH request: **allowExternalSenders**, **autoSubscribeNewMembers**, **hideFromAddressLists**, **hideFromOutlookClients**, **isSubscribedByMail**, **unseenCount**.
v1.0 Group Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-update.md
The following table specifies the properties that can be updated.
| Property | Type | Description | | :- | : | :- | | allowExternalSenders | Boolean | Default is `false`. Indicates whether people external to the organization can send messages to the group. |
-| assignedLabels | [assignedLabel](../resources/assignedlabel.md) collection | The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group.|
+| assignedLabels | [assignedLabel](../resources/assignedlabel.md) collection | The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and [a supported administrator role](/purview/get-started-with-sensitivity-labels#permissions-required-to-create-and-manage-sensitivity-labels).|
| autoSubscribeNewMembers | Boolean | Default is `false`. Indicates whether new members added to the group will be auto-subscribed to receive email notifications. **autoSubscribeNewMembers** can't be `true` when **subscriptionEnabled** is set to `false` on the group. | | description | String | An optional description for the group. | | displayName | String | The display name for the group. This property is required when a group is created and it cannot be cleared during updates. |
v1.0 Group Validateproperties https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-validateproperties.md
POST /groups/{id}/validateProperties
| Name | Description | | : | : |
-| Authorization | Bearer {code} |
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-Type | application/json | ## Request body
v1.0 Identitycontainer List Identityproviders https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitycontainer-list-identityproviders.md
Content-type: application/json
#### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_identityproviderbase_CIAM"
The following example shows a request.
GET https://graph.microsoft.com/beta/identity/identityProviders ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+++ #### Response The following example shows the response.
Content-type: application/json
} ] }
-```
+```
v1.0 Identitycontainer Post Authenticationeventsflows https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitycontainer-post-authenticationeventsflows.md
You can specify the following properties when creating an **authenticationEvents
|priority|Int32|Optional. The priority to use for each individual event of the events policy. If multiple competing listeners for an event have the same priority, one is chosen and an error is silently logged. Default is 500. | |onInteractiveAuthFlowStart|[onInteractiveAuthFlowStartHandler](../resources/oninteractiveauthflowstarthandler.md)|Required. The configuration for what to invoke when an authentication flow is ready to be initiated. | |onAuthenticationMethodLoadStart|[onAuthenticationMethodLoadStartHandler](../resources/onauthenticationmethodloadstarthandler.md)|Required. The configuration for what to invoke when authentication methods are ready to be presented to the user. Must have at least one identity provider linked.|
-|onAttributeCollection|[onAttributeCollectionHandler](../resources/onattributecollectionhandler.md)|Optional. The configuration for what to invoke when attributes are ready to be collected from the user. To configure this property when it wasn't configured during user flow creation, call the [Add attributes to a user flow](../api/onattributecollectionexternalusersselfservicesignup-post-attributes.md) API.|
+|onAttributeCollection|[onAttributeCollectionHandler](../resources/onattributecollectionhandler.md)|Optional. The configuration for what to invoke when attributes are ready to be collected from the user. To configure this property, you must specify both **attributes** and **onAttributeCollectionPage** > **views** objects.|
|onUserCreateStart|[onUserCreateStartHandler](../resources/onusercreatestarthandler.md)|Optional. The configuration for what to invoke during user creation.| ## Response
v1.0 Identitygovernance Deleteditemcontainer Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitygovernance-deleteditemcontainer-delete.md
Delete a [workflow](../resources/identitygovernance-workflow.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": "identitygovernance_deletedItemcontainer_delete" } -->
+<!-- { "blockType": "permissions", "name": "identitygovernance_deleteditemcontainer_delete" } -->
[!INCLUDE [rbac-lifecycle-workflows-apis-write](../includes/rbac-for-apis/rbac-lifecycle-workflows-apis-write.md)]
v1.0 Identitygovernance Insights Toptasksprocessedsummary https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitygovernance-insights-toptasksprocessedsummary.md
Namespace: microsoft.graph.identityGovernance
Provide a summary of the most processed tasks, known as top tasks, for a specified time period in a tenant. The task definition is provided, along with numerical counts of total, successful, and failed runs. For information about workflows processed, see [insights: topWorkflowsProcessedSummary](identitygovernance-insights-topworkflowsprocessedsummary.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).
Choose the permission or permissions marked as least privileged for this API. Us
--> [!INCLUDE [permissions-table](../includes/permissions/identitygovernance-insights-toptasksprocessedsummary-permissions.md)] + ## HTTP request <!-- {
Choose the permission or permissions marked as least privileged for this API. Us
} --> ``` http
-GET /identityGovernance/lifecycleWorkflows/insights/topTasksProcessedSummary
+GET /identityGovernance/lifecycleWorkflows/insights/topTasksProcessedSummary(startDateTime={startDateTime},endDateTime={endDateTime})
``` ## Function parameters
v1.0 Identitygovernance Insights Topworkflowsprocessedsummary https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitygovernance-insights-topworkflowsprocessedsummary.md
Namespace: microsoft.graph.identityGovernance
Provide a summary of the workflows processed the most, known as top workflows, for a specified period in a tenant. Workflow basic details are given, along with run information. For information about tasks processed, see [insights: topTasksProcessedSummary](identitygovernance-insights-toptasksprocessedsummary.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).
Choose the permission or permissions marked as least privileged for this API. Us
--> [!INCLUDE [permissions-table](../includes/permissions/identitygovernance-insights-topworkflowsprocessedsummary-permissions.md)] + ## HTTP request <!-- {
Choose the permission or permissions marked as least privileged for this API. Us
} --> ``` http
-GET /identityGovernance/lifecycleWorkflows/insights/topWorkflowsProcessedSummary
+GET /identityGovernance/lifecycleWorkflows/insights/topWorkflowsProcessedSummary(startDateTime={startDateTime},endDateTime={endDateTime})
``` ## Function parameters
v1.0 Identitygovernance Insights Workflowsprocessedbycategory https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitygovernance-insights-workflowsprocessedbycategory.md
Namespace: microsoft.graph.identityGovernance
Provide a summary of workflows processed, by category, in a tenant. This allows you to quickly get category information, by numerical value, bypassing other information found in the [WorkflowsProcessedSummary](identitygovernance-insights-workflowsprocessedsummary.md) call. + ## 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).
Choose the permission or permissions marked as least privileged for this API. Us
--> [!INCLUDE [permissions-table](../includes/permissions/identitygovernance-insights-workflowsprocessedbycategory-permissions.md)] + ## HTTP request <!-- {
Choose the permission or permissions marked as least privileged for this API. Us
} --> ``` http
-GET /identityGovernance/lifecycleWorkflows/insights/workflowsProcessedByCategory
+GET /identityGovernance/lifecycleWorkflows/insights/workflowsProcessedByCategory(startDateTime={startDateTime},endDateTime={endDateTime})
``` ## Function parameters
v1.0 Identitygovernance Insights Workflowsprocessedsummary https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitygovernance-insights-workflowsprocessedsummary.md
Namespace: microsoft.graph.identityGovernance
Provide a summary of all workflows processed within a tenant for a specified period. Because the amount of results for listed workflows as returned by the [List workflows](../api/identitygovernance-lifecycleworkflowscontainer-list-workflows.md) does not tell you which workflows were processed from the list of created workflows, this summary gives you a quick overview of processed status based on counts. + ## 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).
Choose the permission or permissions marked as least privileged for this API. Us
--> [!INCLUDE [permissions-table](../includes/permissions/identitygovernance-insights-workflowsprocessedsummary-permissions.md)] + ## HTTP request <!-- {
Choose the permission or permissions marked as least privileged for this API. Us
} --> ``` http
-GET /identityGovernance/lifecycleWorkflows/insights/workflowsProcessedSummary
+GET /identityGovernance/lifecycleWorkflows/insights/workflowsProcessedSummary(startDateTime={startDateTime},endDateTime={endDateTime})
``` ## Function parameters
v1.0 Identitygovernance Lifecycleworkflowscontainer List Taskdefinitions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitygovernance-lifecycleworkflowscontainer-list-taskdefinitions.md
Title: "List taskDefinitions"
-description: "Get a list of the taskDefinition objects and their properties."
+description: "Get a list of built-in workflow tasks in Lifecycle Workflows."
ms.localizationpriority: medium
Namespace: microsoft.graph.identityGovernance
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get a list of the [taskDefinition](../resources/identitygovernance-taskdefinition.md) objects and their properties.
+Get a list of built-in workflow tasks in Lifecycle Workflows. A task is represented by the [taskDefinition](../resources/identitygovernance-taskdefinition.md) object.
[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/taskD
#### Response The following example shows the response.
+<!-- Keep the full response object for this example for other internal purposes-->
<!-- { "blockType": "response",
Content-Type: application/json
{ "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/taskDefinitions",
- "@odata.count": 25,
+ "@odata.count": 24,
+ "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET identityGovernance/lifecycleWorkflows/taskDefinitions?$select=category,continueOnError",
"value": [ { "category": "joiner,leaver,mover",
Content-Type: application/json
}, { "category": "leaver",
- "description": "Send offboarding email to userΓÇÖs manager before the last day of work",
- "displayName": "Send email before userΓÇÖs last day",
+ "description": "Send offboarding email to user's manager before the last day of work",
+ "displayName": "Send email before user's last day",
"id": "52853a3e-f4e5-4eb8-bb24-1ac09a1da935", "version": 1, "parameters": [
Content-Type: application/json
}, { "category": "leaver",
- "description": "Send offboarding email to userΓÇÖs manager on the last day of work",
- "displayName": "Send email on userΓÇÖs last day",
+ "description": "Send offboarding email to user's manager on the last day of work",
+ "displayName": "Send email on user's last day",
"id": "9c0a1eaf-5bda-4392-9d9e-6e155bb57411", "version": 1, "parameters": [
Content-Type: application/json
}, { "category": "leaver",
- "description": "Send offboarding email to userΓÇÖs manager after the last day of work",
- "displayName": "Send email after userΓÇÖs last day",
+ "description": "Send offboarding email to user's manager after the last day of work",
+ "displayName": "Send email after user's last day",
"id": "6f22ddd4-b3a5-47a4-a846-0d7c201a49ce", "version": 1, "parameters": [
Content-Type: application/json
}, { "category": "joiner",
- "description": "Send onboarding reminder email to userΓÇÖs manager",
+ "description": "Send onboarding reminder email to user's manager",
"displayName": "Send onboarding reminder email", "id": "3C860712-2D37-42A4-928F-5C93935D26A1", "version": 1,
Content-Type: application/json
}, { "category": "mover",
- "description": "Send email to notify userΓÇÖs manager of user move",
+ "description": "Send email to notify user's manager of user move",
"displayName": "Send email to notify manager of user move", "id": "aab41899-9972-422a-9d97-f626014578b7", "version": 1,
Content-Type: application/json
"valueType": "string" } ]
- },
- {
- "category": "leaver,mover",
- "description": "Transfer groups the user owned to the user's manager",
- "displayName": "Transfer group ownership to manager",
- "id": "dde2a64c-8420-447b-9075-7309449de5cd",
- "version": 1,
- "parameters": []
} ] }
v1.0 Identitygovernance Taskdefinition Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitygovernance-taskdefinition-get.md
Title: "Get taskDefinition"
-description: "Read the details of a built-in workflow task."
+description: "Read the details of a built-in workflow task in Lifecycle Workflows."
ms.localizationpriority: medium
Namespace: microsoft.graph.identityGovernance
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Read the details of a built-in workflow [task](../resources/identitygovernance-taskdefinition.md).
+Read the details of a built-in workflow [task](../resources/identitygovernance-taskdefinition.md) in Lifecycle Workflows.
[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
v1.0 Intune Chromebooksync Chromeosonboardingsettings Connect https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-chromebooksync-chromeosonboardingsettings-connect.md
Namespace: microsoft.graph
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Chromebooksync Chromeosonboardingsettings Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-chromebooksync-chromeosonboardingsettings-create.md
Namespace: microsoft.graph
Create a new [chromeOSOnboardingSettings](../resources/intune-chromebooksync-chromeosonboardingsettings.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Chromebooksync Chromeosonboardingsettings Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-chromebooksync-chromeosonboardingsettings-delete.md
Namespace: microsoft.graph
Deletes a [chromeOSOnboardingSettings](../resources/intune-chromebooksync-chromeosonboardingsettings.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Chromebooksync Chromeosonboardingsettings Disconnect https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-chromebooksync-chromeosonboardingsettings-disconnect.md
Namespace: microsoft.graph
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Chromebooksync Chromeosonboardingsettings Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-chromebooksync-chromeosonboardingsettings-get.md
Namespace: microsoft.graph
Read properties and relationships of the [chromeOSOnboardingSettings](../resources/intune-chromebooksync-chromeosonboardingsettings.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Chromebooksync Chromeosonboardingsettings List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-chromebooksync-chromeosonboardingsettings-list.md
Namespace: microsoft.graph
List properties and relationships of the [chromeOSOnboardingSettings](../resources/intune-chromebooksync-chromeosonboardingsettings.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Chromebooksync Chromeosonboardingsettings Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-chromebooksync-chromeosonboardingsettings-update.md
Namespace: microsoft.graph
Update the properties of a [chromeOSOnboardingSettings](../resources/intune-chromebooksync-chromeosonboardingsettings.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelconfiguration Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelconfiguration-create.md
Namespace: microsoft.graph
Create a new [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelconfiguration Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelconfiguration-delete.md
Namespace: microsoft.graph
Deletes a [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelconfiguration-get.md
Namespace: microsoft.graph
Read properties and relationships of the [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelconfiguration List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelconfiguration-list.md
Namespace: microsoft.graph
List properties and relationships of the [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelconfiguration-update.md
Namespace: microsoft.graph
Update the properties of a [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelhealththreshold Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelhealththreshold-create.md
Namespace: microsoft.graph
Create a new [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelhealththreshold Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelhealththreshold-delete.md
Namespace: microsoft.graph
Deletes a [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelhealththreshold Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelhealththreshold-get.md
Namespace: microsoft.graph
Read properties and relationships of the [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelhealththreshold List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelhealththreshold-list.md
Namespace: microsoft.graph
List properties and relationships of the [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelhealththreshold Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelhealththreshold-update.md
Namespace: microsoft.graph
Update the properties of a [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelserver Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserver-create.md
Namespace: microsoft.graph
Create a new [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelserver Createserverlogcollectionrequest https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserver-createserverlogcollectionrequest.md
Namespace: microsoft.graph
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelserver Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserver-delete.md
Namespace: microsoft.graph
Deletes a [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelserver Generateserverlogcollectionrequest https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserver-generateserverlogcollectionrequest.md
Namespace: microsoft.graph
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelserver Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserver-get.md
Namespace: microsoft.graph
Read properties and relationships of the [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelserver Gethealthmetrics https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserver-gethealthmetrics.md
Namespace: microsoft.graph
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelserver Gethealthmetrictimeseries https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserver-gethealthmetrictimeseries.md
Namespace: microsoft.graph
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelserver List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserver-list.md
Namespace: microsoft.graph
List properties and relationships of the [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelserver Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserver-update.md
Namespace: microsoft.graph
Update the properties of a [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelserverlogcollectionresponse Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-create.md
Namespace: microsoft.graph
Create a new [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelserverlogcollectionresponse Createdownloadurl https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-createdownloadurl.md
Namespace: microsoft.graph
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelserverlogcollectionresponse Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-delete.md
Namespace: microsoft.graph
Deletes a [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelserverlogcollectionresponse Generatedownloadurl https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-generatedownloadurl.md
Namespace: microsoft.graph
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelserverlogcollectionresponse Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-get.md
Namespace: microsoft.graph
Read properties and relationships of the [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelserverlogcollectionresponse List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-list.md
Namespace: microsoft.graph
List properties and relationships of the [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelserverlogcollectionresponse Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-update.md
Namespace: microsoft.graph
Update the properties of a [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelsite Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelsite-create.md
Namespace: microsoft.graph
Create a new [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelsite Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelsite-delete.md
Namespace: microsoft.graph
Deletes a [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelsite Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelsite-get.md
Namespace: microsoft.graph
Read properties and relationships of the [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelsite List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelsite-list.md
Namespace: microsoft.graph
List properties and relationships of the [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelsite Requestupgrade https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelsite-requestupgrade.md
Namespace: microsoft.graph
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Mstunnel Microsofttunnelsite Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelsite-update.md
Namespace: microsoft.graph
Update the properties of a [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Odj Devicemanagementdomainjoinconnector Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-odj-devicemanagementdomainjoinconnector-create.md
Namespace: microsoft.graph
Create a new [deviceManagementDomainJoinConnector](../resources/intune-odj-devicemanagementdomainjoinconnector.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Odj Devicemanagementdomainjoinconnector Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-odj-devicemanagementdomainjoinconnector-delete.md
Namespace: microsoft.graph
Deletes a [deviceManagementDomainJoinConnector](../resources/intune-odj-devicemanagementdomainjoinconnector.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Odj Devicemanagementdomainjoinconnector Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-odj-devicemanagementdomainjoinconnector-get.md
Namespace: microsoft.graph
Read properties and relationships of the [deviceManagementDomainJoinConnector](../resources/intune-odj-devicemanagementdomainjoinconnector.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Odj Devicemanagementdomainjoinconnector List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-odj-devicemanagementdomainjoinconnector-list.md
Namespace: microsoft.graph
List properties and relationships of the [deviceManagementDomainJoinConnector](../resources/intune-odj-devicemanagementdomainjoinconnector.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Odj Devicemanagementdomainjoinconnector Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-odj-devicemanagementdomainjoinconnector-update.md
Namespace: microsoft.graph
Update the properties of a [deviceManagementDomainJoinConnector](../resources/intune-odj-devicemanagementdomainjoinconnector.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Osprovisioninggraphservice Manageddevicewindowsoperatingsystemimage Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage-create.md
Namespace: microsoft.graph
Create a new [managedDeviceWindowsOperatingSystemImage](../resources/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Osprovisioninggraphservice Manageddevicewindowsoperatingsystemimage Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage-delete.md
Namespace: microsoft.graph
Deletes a [managedDeviceWindowsOperatingSystemImage](../resources/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Osprovisioninggraphservice Manageddevicewindowsoperatingsystemimage Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage-get.md
Namespace: microsoft.graph
Read properties and relationships of the [managedDeviceWindowsOperatingSystemImage](../resources/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Osprovisioninggraphservice Manageddevicewindowsoperatingsystemimage Getallmanageddevicewindowsosimages https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage-getallmanageddevicewindowsosimages.md
Namespace: microsoft.graph
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Osprovisioninggraphservice Manageddevicewindowsoperatingsystemimage List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage-list.md
Namespace: microsoft.graph
List properties and relationships of the [managedDeviceWindowsOperatingSystemImage](../resources/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Osprovisioninggraphservice Manageddevicewindowsoperatingsystemimage Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage-update.md
Namespace: microsoft.graph
Update the properties of a [managedDeviceWindowsOperatingSystemImage](../resources/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Policylistingservice Deviceconfigurationprofile Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-policylistingservice-deviceconfigurationprofile-create.md
Namespace: microsoft.graph
Create a new [deviceConfigurationProfile](../resources/intune-policylistingservice-deviceconfigurationprofile.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Policylistingservice Deviceconfigurationprofile Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-policylistingservice-deviceconfigurationprofile-delete.md
Namespace: microsoft.graph
Deletes a [deviceConfigurationProfile](../resources/intune-policylistingservice-deviceconfigurationprofile.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Policylistingservice Deviceconfigurationprofile Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-policylistingservice-deviceconfigurationprofile-get.md
Namespace: microsoft.graph
Read properties and relationships of the [deviceConfigurationProfile](../resources/intune-policylistingservice-deviceconfigurationprofile.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Policylistingservice Deviceconfigurationprofile List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-policylistingservice-deviceconfigurationprofile-list.md
Namespace: microsoft.graph
List properties and relationships of the [deviceConfigurationProfile](../resources/intune-policylistingservice-deviceconfigurationprofile.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Policylistingservice Deviceconfigurationprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-policylistingservice-deviceconfigurationprofile-update.md
Namespace: microsoft.graph
Update the properties of a [deviceConfigurationProfile](../resources/intune-policylistingservice-deviceconfigurationprofile.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicy Assign https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicy-assign.md
Namespace: microsoft.graph
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicy Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicy-create.md
Namespace: microsoft.graph
Create a new [windowsDefenderApplicationControlSupplementalPolicy](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicy.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicy Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicy-delete.md
Namespace: microsoft.graph
Deletes a [windowsDefenderApplicationControlSupplementalPolicy](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicy.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicy-get.md
Namespace: microsoft.graph
Read properties and relationships of the [windowsDefenderApplicationControlSupplementalPolicy](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicy.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicy List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicy-list.md
Namespace: microsoft.graph
List properties and relationships of the [windowsDefenderApplicationControlSupplementalPolicy](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicy.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicy-update.md
Namespace: microsoft.graph
Update the properties of a [windowsDefenderApplicationControlSupplementalPolicy](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicy.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicyassignment Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicyassignment-create.md
Namespace: microsoft.graph
Create a new [windowsDefenderApplicationControlSupplementalPolicyAssignment](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicyassignment.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicyassignment Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicyassignment-delete.md
Namespace: microsoft.graph
Deletes a [windowsDefenderApplicationControlSupplementalPolicyAssignment](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicyassignment.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicyassignment Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicyassignment-get.md
Namespace: microsoft.graph
Read properties and relationships of the [windowsDefenderApplicationControlSupplementalPolicyAssignment](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicyassignment.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicyassignment List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicyassignment-list.md
Namespace: microsoft.graph
List properties and relationships of the [windowsDefenderApplicationControlSupplementalPolicyAssignment](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicyassignment.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicyassignment Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicyassignment-update.md
Namespace: microsoft.graph
Update the properties of a [windowsDefenderApplicationControlSupplementalPolicyAssignment](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicyassignment.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus-create.md
Namespace: microsoft.graph
Create a new [windowsDefenderApplicationControlSupplementalPolicyDeploymentStatus](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus-delete.md
Namespace: microsoft.graph
Deletes a [windowsDefenderApplicationControlSupplementalPolicyDeploymentStatus](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus-get.md
Namespace: microsoft.graph
Read properties and relationships of the [windowsDefenderApplicationControlSupplementalPolicyDeploymentStatus](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus-list.md
Namespace: microsoft.graph
List properties and relationships of the [windowsDefenderApplicationControlSupplementalPolicyDeploymentStatus](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus-update.md
Namespace: microsoft.graph
Update the properties of a [windowsDefenderApplicationControlSupplementalPolicyDeploymentStatus](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentstatus.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicydeploymentsummary Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentsummary-get.md
Namespace: microsoft.graph
Read properties and relationships of the [windowsDefenderApplicationControlSupplementalPolicyDeploymentSummary](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentsummary.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Intune Unlock Windowsdefenderapplicationcontrolsupplementalpolicydeploymentsummary Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentsummary-update.md
Namespace: microsoft.graph
Update the properties of a [windowsDefenderApplicationControlSupplementalPolicyDeploymentSummary](../resources/intune-unlock-windowsdefenderapplicationcontrolsupplementalpolicydeploymentsummary.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Mailfolder Permanentdelete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/mailfolder-permanentdelete.md
+
+ Title: "mailFolder: permanentDelete"
+description: "Permanently delete a mail folder and remove its items from the user's mailbox."
+
+ms.localizationpriority: high
+++
+# mailFolder: permanentDelete
+
+Namespace: microsoft.graph
++
+Permanently delete a mail folder and remove its items from the user's mailbox. For more information about item retention, see [Configure Deleted Item retention and Recoverable Items quotas](/exchange/configure-deleted-item-retention-and-recoverable-items-quotas-exchange-2013-help).
+
+>**Note:** Folders aren't placed in the Purges folder when they are permanently deleted. Permanently deleted folders are removed from the mailbox.
+++
+## 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": "mailfolder_permanentdelete" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /users/{usersId}/mailFolders/{mailFolderId}/permanentDelete
+POST /users/{usersId}/mailFolders/{mailFolderId}/childFolders/{mailFolderId}/permanentDelete
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this action returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "mailfolderthis.permanentdelete"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/users/{usersId}/mailFolders/{mailFolderId}/permanentDelete
+```
+
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
++++
+### Response
+
+The following example shows the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Mailsearchfolder Permanentdelete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/mailsearchfolder-permanentdelete.md
+
+ Title: "mailSearchFolder: permanentDelete"
+description: "Permanently delete a mail search folder and remove its items from the user's mailbox."
+
+ms.localizationpriority: high
+++
+# mailSearchFolder: permanentDelete
+
+Namespace: microsoft.graph
++
+Permanently delete a mail search folder and remove its items from the user's mailbox. For more information about item retention, see [Configure Deleted Item retention and Recoverable Items quotas](/exchange/configure-deleted-item-retention-and-recoverable-items-quotas-exchange-2013-help).
+
+>**Note:** Folders aren't placed in the Purges folder when they are permanently deleted. Permanently deleted folders are removed from the mailbox.
+++
+## 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": "mailsearchfolder_permanentdelete" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /me/mailFolders/{id}/permanentDelete
+POST /users/{id | userPrincipalName}/mailFolders/{id}/permanentDelete
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this action returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "mailsearchfolderthis.permanentdelete"
+}
+-->
+``` http
+POST https://graph.microsoft.com/betEzM/permanentDelete
+```
+
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
++++
+### Response
+
+The following example shows the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Message Permanentdelete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/message-permanentdelete.md
+
+ Title: "message: permanentDelete"
+description: "Permanently delete a message and place it in the Purges folder in the user's mailbox."
+
+ms.localizationpriority: high
+++
+# message: permanentDelete
+
+Namespace: microsoft.graph
++
+Permanently delete a message and place it in the Purges folder in the dumpster in the user's mailbox. Email clients such as Outlook or Outlook on the web can't access permanently deleted items. Unless there's a hold set on the mailbox, the items are permanently deleted after a set period of time.
+
+For more information about item retention, see [Configure Deleted Item retention and Recoverable Items quotas](/exchange/configure-deleted-item-retention-and-recoverable-items-quotas-exchange-2013-help).
+++
+## 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": "message_permanentdelete" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /users/{usersId}/messages/{messageId}/permanentDelete
+POST /users/{usersId}/mailFolders/{mailFolderId}/messages/{messageId}/permanentDelete
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this action returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "messagethis.permanentdelete"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/users/{usersId}/messages/{messageId}/permanentDelete
+```
+
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
++++
+### Response
+
+The following example shows the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Networkaccess Branchconnectivityconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-branchconnectivityconfiguration-get.md
GET https://graph.microsoft.com/beta/networkAccess/connectivity/branches/{branch
[!INCLUDE [sample-code](../includes/snippets/php/get-branchconnectivityconfiguration-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-branchconnectivityconfiguration-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Branchsite Delete Devicelinks https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-branchsite-delete-devicelinks.md
DELETE https://graph.microsoft.com/beta/networkAccess/connectivity/branches/{bra
[!INCLUDE [sample-code](../includes/snippets/php/delete-devicelink-deprecated-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/delete-devicelink-deprecated-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Branchsite Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-branchsite-delete.md
DELETE https://graph.microsoft.com/beta/networkAccess/connectivity/branches/{bra
[!INCLUDE [sample-code](../includes/snippets/php/delete-branchsite-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/delete-branchsite-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Branchsite Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-branchsite-get.md
GET https://graph.microsoft.com/beta/networkAccess/connectivity/branches/{branch
[!INCLUDE [sample-code](../includes/snippets/php/get-branchsite-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-branchsite-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Branchsite List Devicelinks https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-branchsite-list-devicelinks.md
GET https://graph.microsoft.com/beta/networkAccess/connectivity/branches/{branch
[!INCLUDE [sample-code](../includes/snippets/php/list-devicelink-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-devicelink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Branchsite List Forwardingprofiles https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-branchsite-list-forwardingprofiles.md
GET https://graph.microsoft.com/beta/networkAccess/connectivity/branches/{branch
[!INCLUDE [sample-code](../includes/snippets/php/list-forwardingprofiles-branchsite-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-forwardingprofiles-branchsite-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Branchsite Post Devicelinks https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-branchsite-post-devicelinks.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-devicelink-from--php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/create-devicelink-from--python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Branchsite Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-branchsite-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-branchsite-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/update-branchsite-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Conditionalaccesssettings Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-conditionalaccesssettings-get.md
GET https://graph.microsoft.com/beta/networkAccess/settings/conditionalAccess
[!INCLUDE [sample-code](../includes/snippets/php/get-conditionalaccesssettings-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-conditionalaccesssettings-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Conditionalaccesssettings Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-conditionalaccesssettings-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-conditionalaccesssettings-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/update-conditionalaccesssettings-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Connectivity List Branches https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-connectivity-list-branches.md
GET https://graph.microsoft.com/beta/networkAccess/connectivity/branches
[!INCLUDE [sample-code](../includes/snippets/php/list-branchsite-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-branchsite-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Connectivity Post Branches https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-connectivity-post-branches.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-branchsite-from--php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/create-branchsite-from--python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Connectivity Post Remotenetworks https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-connectivity-post-remotenetworks.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-remotenetwork-basic-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/create-remotenetwork-basic-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-remotenetwork-with-forwardingprofile-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/create-remotenetwork-with-forwardingprofile-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-remotenetwork-with-forwardingprofile-devicelink-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/create-remotenetwork-with-forwardingprofile-devicelink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Crosstenantaccesssettings Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-crosstenantaccesssettings-get.md
GET https://graph.microsoft.com/beta/networkAccess/settings/crossTenantAccess
[!INCLUDE [sample-code](../includes/snippets/php/get-crosstenantaccesssettings-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-crosstenantaccesssettings-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Crosstenantaccesssettings Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-crosstenantaccesssettings-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-crosstenantaccesssettings-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/update-crosstenantaccesssettings-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Devicelink Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-devicelink-delete.md
DELETE https://graph.microsoft.com/beta/networkAccess/connectivity/remoteNetwork
[!INCLUDE [sample-code](../includes/snippets/php/delete-devicelink-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/delete-devicelink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Devicelink Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-devicelink-get.md
GET https://graph.microsoft.com/beta/networkAccess/connectivity/remoteNetworks/d
[!INCLUDE [sample-code](../includes/snippets/php/get-devicelink-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-devicelink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Devicelink Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-devicelink-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-devicelink-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/update-devicelink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Enrichedauditlogs Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-enrichedauditlogs-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-enrichedauditlogs-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/update-enrichedauditlogs-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Filteringpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringpolicy-get.md
GET https://graph.microsoft.com/beta/networkAccess/filteringPolicies/161760b2-70
[!INCLUDE [sample-code](../includes/snippets/php/get-filteringpolicy-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-filteringpolicy-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Filteringpolicy Post Policyrules https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringpolicy-post-policyrules.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-policyrule-from--php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/create-policyrule-from--python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Filteringpolicylink Delete Policy https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringpolicylink-delete-policy.md
DELETE https://graph.microsoft.com/beta/networkaccess/filteringPolicies/d0187e08
[!INCLUDE [sample-code](../includes/snippets/php/delete-policy-from-filteringpolicylink-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/delete-policy-from-filteringpolicylink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Filteringpolicylink Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringpolicylink-delete.md
DELETE https://graph.microsoft.com/beta/networkaccess/FilteringProfiles/c308a3af
[!INCLUDE [sample-code](../includes/snippets/php/delete-filteringpolicylink-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/delete-filteringpolicylink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Filteringpolicylink Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringpolicylink-get.md
GET https://graph.microsoft.com/beta/networkaccess/filteringPolicies/bb4e13cd-65
[!INCLUDE [sample-code](../includes/snippets/php/get-filteringpolicylink-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-filteringpolicylink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Filteringpolicylink List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringpolicylink-list.md
GET https://graph.microsoft.com/beta/networkaccess/filteringProfiles/519085fd-ef
[!INCLUDE [sample-code](../includes/snippets/php/list-filteringpolicylink-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-filteringpolicylink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Filteringpolicylink Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringpolicylink-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-filteringpolicylink-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/update-filteringpolicylink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Filteringprofile Delete Policies https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringprofile-delete-policies.md
DELETE https://graph.microsoft.com/beta/networkaccess/FilteringProfiles/9020f79d
[!INCLUDE [sample-code](../includes/snippets/php/delete-policylink-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/delete-policylink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Filteringprofile Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringprofile-get.md
GET https://graph.microsoft.com/beta/networkaccess/filteringProfiles/9020f79d-71
[!INCLUDE [sample-code](../includes/snippets/php/get-filteringprofile-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-filteringprofile-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Filteringprofile List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringprofile-list.md
GET https://graph.microsoft.com/beta/networkAccess/filteringProfiles
[!INCLUDE [sample-code](../includes/snippets/php/list-filteringprofile-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-filteringprofile-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Filteringprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringprofile-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-filteringprofile-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/update-filteringprofile-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Filteringrule Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringrule-delete.md
DELETE https://graph.microsoft.com/beta/networkaccess/filteringPolicies/bb1d249e
[!INCLUDE [sample-code](../includes/snippets/php/delete-filteringrule-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/delete-filteringrule-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Filteringrule Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringrule-get.md
GET https://graph.microsoft.com/beta/networkaccess/filteringPolicies/ac253559-37
[!INCLUDE [sample-code](../includes/snippets/php/get-filteringrule-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-filteringrule-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Filteringrule List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringrule-list.md
GET https://graph.microsoft.com/beta/networkaccess/filteringPolicies/d0187e08-04
[!INCLUDE [sample-code](../includes/snippets/php/list-filteringrule-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-filteringrule-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Filteringrule Post https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringrule-post.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-filteringrule-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/create-filteringrule-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Filteringrule Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringrule-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-filteringrule-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/update-filteringrule-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Forwardingoptions Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-forwardingoptions-get.md
GET https://graph.microsoft.com/beta/networkAccess/settings/forwardingOptions
[!INCLUDE [sample-code](../includes/snippets/php/get-forwardingoptions-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-forwardingoptions-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Forwardingoptions Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-forwardingoptions-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-forwardingoptions-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/update-forwardingoptions-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Forwardingpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-forwardingpolicy-get.md
GET https://graph.microsoft.com/beta/networkAccess/forwardingPolicies/{forwardin
[!INCLUDE [sample-code](../includes/snippets/php/get-forwardingpolicy-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-forwardingpolicy-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Forwardingpolicylink Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-forwardingpolicylink-delete.md
DELETE https://graph.microsoft.com/beta/networkaccess/forwardingProfiles/{forwar
[!INCLUDE [sample-code](../includes/snippets/php/delete-forwardingpolicylink-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/delete-forwardingpolicylink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Forwardingpolicylink Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-forwardingpolicylink-get.md
GET https://graph.microsoft.com/beta/networkAccess/forwardingProfiles/{profileId
[!INCLUDE [sample-code](../includes/snippets/php/get-forwardingpolicylink-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-forwardingpolicylink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Forwardingpolicylink Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-forwardingpolicylink-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-forwardingpolicylink-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/update-forwardingpolicylink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Forwardingprofile Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-forwardingprofile-get.md
GET https://graph.microsoft.com/beta/networkAccess/forwardingProfiles/{forwardin
[!INCLUDE [sample-code](../includes/snippets/php/get-forwardingprofile-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-forwardingprofile-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Forwardingprofile List Policies https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-forwardingprofile-list-policies.md
GET https://graph.microsoft.com/beta/networkAccess/forwardingProfiles/{forwardin
[!INCLUDE [sample-code](../includes/snippets/php/list-forwardingpolicylink-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-forwardingpolicylink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Forwardingprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-forwardingprofile-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-forwardingprofile-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/update-forwardingprofile-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Logs List Traffic https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-logs-list-traffic.md
GET https://graph.microsoft.com/beta/networkAccess/logs/traffic
[!INCLUDE [sample-code](../includes/snippets/php/list-networkaccesstraffic-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-networkaccesstraffic-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Networkaccessroot List Filteringpolicies https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-networkaccessroot-list-filteringpolicies.md
GET https://graph.microsoft.com/beta/networkAccess/filteringPolicies
[!INCLUDE [sample-code](../includes/snippets/php/list-filteringpolicy-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-filteringpolicy-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Networkaccessroot List Forwardingprofiles https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-networkaccessroot-list-forwardingprofiles.md
GET https://graph.microsoft.com/beta/networkAccess/forwardingProfiles
[!INCLUDE [sample-code](../includes/snippets/php/list-forwardingprofile-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-forwardingprofile-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Networkaccessroot Onboard https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-networkaccessroot-onboard.md
POST https://graph.microsoft.com/beta/networkAccess/microsoft.graph.networkacces
[!INCLUDE [sample-code](../includes/snippets/php/create-tenantstatus-from--php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/create-tenantstatus-from--python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Policy List Policyrules https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-policy-list-policyrules.md
GET https://graph.microsoft.com/beta/networkaccess/forwardingPolicies/{forwardin
[!INCLUDE [sample-code](../includes/snippets/php/list-policyrule-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-policyrule-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Policylink List Policy https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-policylink-list-policy.md
GET https://graph.microsoft.com/beta/networkaccess/filteringProfiles/78858adc-db
[!INCLUDE [sample-code](../includes/snippets/php/list-policy-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-policy-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Policyrule Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-policyrule-get.md
GET https://graph.microsoft.com/beta/networkaccess/forwardingPolicies/{forwardin
[!INCLUDE [sample-code](../includes/snippets/php/get-policyrule-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-policyrule-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Reports Entitiessummaries https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-reports-entitiessummaries.md
GET https://graph.microsoft.com/beta/networkAccess/reports/entitiesSummaries(sta
[!INCLUDE [sample-code](../includes/snippets/php/reportsthisentitiessummaries-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/reportsthisentitiessummaries-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Settings List Enrichedauditlogs https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-settings-list-enrichedauditlogs.md
GET https://graph.microsoft.com/beta/networkaccess/settings/enrichedAuditLogs
[!INCLUDE [sample-code](../includes/snippets/php/list-enrichedauditlogs-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-enrichedauditlogs-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Networkaccess Tenantstatus Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-tenantstatus-get.md
GET https://graph.microsoft.com/beta/networkAccess/tenantStatus
[!INCLUDE [sample-code](../includes/snippets/php/get-tenantstatus-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-tenantstatus-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Notebook Getrecentnotebooks https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/notebook-getrecentnotebooks.md
The `{id | userPrincipalName}` for the user must match the user encoded in the a
## Request headers | Name | Description| |:|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body Don't supply a request body for this method.
v1.0 Onattributecollectionexternalusersselfservicesignup Delete Attributes https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/onattributecollectionexternalusersselfservicesignup-delete-attributes.md
Namespace: microsoft.graph
Remove an attribute from an external identities self-service sign up user flow that's represented by an [externalUsersSelfServiceSignupEventsFlow](../resources/externalusersselfservicesignupeventsflow.md) object. You can add both custom and built-in attributes to a user flow.
-After this step, [PATCH the user flow](../api/authenticationeventsflow-update.md) to remove the attribute from the attribute collection step.
+The attribute is removed from both the **attributes** and **views** collections of the **attributeCollectionPage** object in the user flow.
+
+This API operation fails when you attempt to remove the last remaining attribute on the user flow.
## 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).
Don't supply a request body for this method.
## Response
-If successful, this method returns a `204 No Content` response code. If unsuccessful, a `4xx` error is returned with specific details.
+If successful, this method returns a `204 No Content` response code. If unsuccessful, a `4xx` error is returned with specific details. Attempting to remove the last remaining attribute results in a `400 Bad Request` error code.
## Examples #### Request
-The following example shows a request that removes city as an attribute from the attribute collection step of an external identities self-service sign-up user flow. After executing this step, [update the attributes collected in the userflow](../api/authenticationeventsflow-update.md).
+The following example shows a request that removes city as an attribute from the attribute collection step of an external identities self-service sign-up user flow.
+ # [HTTP](#tab/http) <!-- { "blockType": "request",
v1.0 Onattributecollectionexternalusersselfservicesignup Post Attributes https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/onattributecollectionexternalusersselfservicesignup-post-attributes.md
Namespace: microsoft.graph
Add an attribute to an external identities self-service sign up user flow that's represented by an [externalUsersSelfServiceSignupEventsFlow](../resources/externalusersselfservicesignupeventsflow.md) object. You can add both custom and built-in attributes to a user flow.
-Prior to this step, [PATCH the user flow](../api/authenticationeventsflow-update.md) to add the attribute to the attribute collection step (to determine how it will be displayed).
+The attribute is added to both the **attributeCollection**> **attributes** and **attributeCollection**> **attributeCollectionPage** > **views** collections on the user flow. In the **views** collection, the attribute is assigned the default settings. You can [PATCH the user flow](../api/authenticationeventsflow-update.md) to customize the settings of the attribute on the **views** object, for example, marking it as required or updating the allowed input types.
## 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).
If successful, this method returns a `204 No Content` response code. If unsucce
#### Request
-The following example shows a request that adds city as an attribute for attribute collection step of an external identities self-service sign-up user flow. Before you can add an attribute to the attribute collection step, you must first [add it among the attributes to be collected in the user flow](../api/authenticationeventsflow-update.md).
+The following example shows a request that adds city as an attribute for attribute collection step of an external identities self-service sign-up user flow. If the request is successful, the attribute is added to both the **attributeCollection**> **attributes** and **attributeCollection**> **attributeCollectionPage** > **views** collections on the user flow. After adding the attribute to the user flow, you can [PATCH the user flow](../api/authenticationeventsflow-update.md) to customize the settings of the attribute on the **views** object, that is, customize the page layout.
# [HTTP](#tab/http) <!-- {
v1.0 Onedriveforbusinessprotectionpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/onedriveforbusinessprotectionpolicy-update.md
To remove a **driveProtectionUnit** from the policy, specify the `@removed` anno
If successful, this method returns a `200 OK` response code and an updated [oneDriveForBusinessProtectionPolicy](../resources/onedriveforbusinessprotectionpolicy.md) in the response body.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Request
v1.0 Onedriveforbusinessrestoresession List Driverestoreartifacts https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/onedriveforbusinessrestoresession-list-driverestoreartifacts.md
Don't supply a request body for this method.
If successful, this method returns a `200 OK` response code and a collection of [driveRestoreArtifact](../resources/driverestoreartifact.md) objects in the response body.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Request
v1.0 Onedriveforbusinessrestoresession Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/onedriveforbusinessrestoresession-update.md
To remove a drive restore artifact, specify the `@removed` annotation in the req
If successful, this method returns a `200 OK` response code and an updated [oneDriveForBusinessRestoreSession](../resources/driverestoreartifact.md) object in the response body.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Request
v1.0 Onlinemeeting Getallrecordings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/onlinemeeting-getallrecordings.md
Get all recordings from scheduled [onlineMeeting](../resources/onlinemeeting.md)
You can apply the [delta](callrecording-delta.md) function on **getAllRecordings** to synchronize and get [callRecording](../resources/callrecording.md) resources as they're added for **onlineMeeting** instances organized by the specified user.
-The delta query supports both full synchronization and incremental synchronization. Full synchronization gets all the recordings for online meetings organized by the user. Incremental synchronization gets recordings that are added since the last synchronization. Typically, you would do an initial full synchronization, and then get incremental changes to that recording view periodically.
+The delta query supports both full synchronization and incremental synchronization. Full synchronization gets all the recordings for online meetings organized by the user. Incremental synchronization gets recordings that are added since the last synchronization. Typically, you do an initial full synchronization, and then get incremental changes to that recording view periodically.
Find more information in the [delta query](/graph/delta-query-overview) documentation. For more examples, see [callRecording: delta](callrecording-delta.md).
To learn more about using the Microsoft Teams export APIs to export content, see
The following known issues are associated with this API: -- [Using the `$top` query parameter might not return the @odata.nextLink](https://developer.microsoft.com/en-us/graph/known-issues/?search=22931).
+- [Using the `$top` query parameter might not return the **@odata.nextLink**](https://developer.microsoft.com/en-us/graph/known-issues/?search=22931).
- [Recordings aren't exported for meetings that don't have transcription turned on](https://developer.microsoft.com/en-us/graph/known-issues/?search=22933). ## Permissions
Choose the permission or permissions marked as least privileged for this API. Us
``` http GET /users/{usersId}/onlineMeetings/getAllRecordings(meetingOrganizerUserId='{userId}',startDateTime={startDateTime},endDateTime={endDateTime}) ```
->**Note:** If you don't pass the function parameter **meetingOrganizerUserId**, the request fails.
+>**Note:** The request fails if you don't pass the function parameter **meetingOrganizerUserId**.
## Function parameters In the request URL, provide the following query parameters with values. |Parameter|Type|Description| |:|:|:|
+|endDateTime|DateTimeOffset|Optional parameter to filter for artifacts created before the given end date. 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`.|
|meetingOrganizerUserId|String|The user identifier of the meeting organizer to filter for artifacts for meetings organized by the given user identifier.|
-|startDateTime|DateTimeOffset|Optional parameter to filter for artifacts created after the given start date.|
-|endDateTime|DateTimeOffset|Optional parameter to filter for artifacts created before the given end date.|
+|startDateTime|DateTimeOffset|Optional parameter to filter for artifacts created after the given start date. 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`.|
-## Supported query patterns
+## Optional query parameters
-| Pattern | Supported | Syntax | Notes |
-| - | :-: | - | |
-| Page size | Γ£ô | `top` | Allows caller to specify max number of objects per page. |
+This method supports the following OData query parameter to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+| Name | Description |
+| :- | :-- |
+| `$top` | Allows the caller to specify the max number of objects per page as the page size. |
## Request headers
In the request URL, provide the following query parameters with values.
## Response
-If successful, this method returns a `200 OK` response code and a list of [callRecording](../resources/callrecording.md) objects in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [callRecording](../resources/callrecording.md) objects in the response body.
## Examples
The following example shows a request to get all the recordings of a given meeti
#### Request
+The following example shows a request.
+ # [HTTP](#tab/http) <!-- { "blockType": "request",
GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/
-- #### Response
+The following example shows the response.
+ >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", "truncated": true, "name": "get_allrecordings",
- "@odata.type": "microsoft.graph.callRecording",
- "isCollection": true
+ "@odata.type": "Collection(microsoft.graph.callRecording)"
} --> ```http HTTP/1.1 200 OK
Content-type: application/json
} ```
-### Example 2: Get all recordings of a given meeting organizer with date range filter
+### Example 2: Get all recordings of a given meeting organizer using a date range filter
The following example shows a request to get all recordings of a given meeting organizer, that are created between a given start date and an end date. #### Request
+The following example shows a request.
+ # [HTTP](#tab/http) <!-- { "blockType": "request",
GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/
-- #### Response
+The following example shows the response.
+ >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", "truncated": true, "name": "get_allrecordings_with_dates",
- "@odata.type": "microsoft.graph.callRecording",
- "isCollection": true
+ "@odata.type": "Collection(microsoft.graph.callRecording)"
} --> ```http HTTP/1.1 200 OK
Content-type: application/json
## Related content
-[Microsoft Graph service-specific throttling limits](/graph/throttling-limits#microsoft-teams-service-limits)
-
-[Delta query overview](/graph/delta-query-overview)
-
-[Export content with the Microsoft Teams export APIs](/microsoftteams/export-teams-content)
+- [Microsoft Graph service-specific throttling limits](/graph/throttling-limits#microsoft-teams-service-limits)
+- [Delta query overview](/graph/delta-query-overview)
+- [Export content with the Microsoft Teams export APIs](/microsoftteams/export-teams-content)
v1.0 Onlinemeeting Getalltranscripts https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/onlinemeeting-getalltranscripts.md
Get all transcripts from scheduled [onlineMeeting](../resources/onlinemeeting.md
You can apply the [delta](calltranscript-delta.md) function on **getAllTranscripts** to synchronize and get [callTranscript](../resources/calltranscript.md) resources as they're added for **onlineMeeting** instances organized by the specified user.
-Delta query supports both full synchronization and incremental synchronization. Full synchronization gets all the transcripts for online meetings organized by the user. Incremental synchronization gets transcripts that are added since the last synchronization. Typically, you would do an initial full synchronization, and then get incremental changes to that recording view periodically.
+Delta query supports both full synchronization and incremental synchronization. Full synchronization gets all the transcripts for online meetings organized by the user. Incremental synchronization gets transcripts that are added since the last synchronization. Typically, you do an initial full synchronization, and then get incremental changes to that recording view periodically.
For more information, see [delta query](/graph/delta-query-overview). For more examples, see [callTranscript: delta](calltranscript-delta.md).
To learn more about using the Microsoft Teams export APIs to export content, see
The following known issues are associated with this API: -- [Using the `$top` query parameter might not return the @odata.nextLink](https://developer.microsoft.com/en-us/graph/known-issues/?search=22931).
+- [Using the `$top` query parameter might not return the **@odata.nextLink**](https://developer.microsoft.com/en-us/graph/known-issues/?search=22931).
- [Transcript URLs might not include any content](https://developer.microsoft.com/en-us/graph/known-issues/?search=22932). ## Permissions
Choose the permission or permissions marked as least privileged for this API. Us
``` http GET /users/{usersId}/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='{userId}',startDateTime={startDateTime},endDateTime={endDateTime}) ```
->**Note:** If you don't pass the function parameter **meetingOrganizerUserId**, the request fails.
+>**Note:** The request fails if you don't pass the function parameter **meetingOrganizerUserId**.
## Function parameters In the request URL, provide the following query parameters with values. |Parameter|Type|Description| |:|:|:|
-|meetingOrganizerUserId|String|The user identifier of the meeting organizer. To filter for artifacts for meetings organized by the given user identifier.|
-|startDateTime|DateTimeOffset|Optional parameter to filter for artifacts created after the given start date.|
-|endDateTime|DateTimeOffset|Optional parameter to filter for artifacts created before the given end date.|
+|endDateTime|DateTimeOffset|Optional parameter to filter for artifacts created before the given end date. 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`.|
+|meetingOrganizerUserId|String|The user identifier of the meeting organizer that is used to filter artifacts for meetings organized by that specific user.|
+|startDateTime|DateTimeOffset|Optional parameter to filter for artifacts created after the given start date. 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`.|
-## Supported query patterns
-
-| Pattern | Supported | Syntax | Notes |
-| - | :-: | - | |
-| Page size | Γ£ô | `top` | Allows the caller to specify the maximum number of objects per page. |
+This method supports the following OData query parameter to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+| Name | Description |
+| :- | :-- |
+| `$top` | Allows the caller to specify the max number of objects per page as the page size. |
## Request headers
In the request URL, provide the following query parameters with values.
## Response
-If successful, this method returns a `200 OK` response code and a list of [callTranscript](../resources/calltranscript.md) objects in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [callTranscript](../resources/calltranscript.md) objects in the response body.
## Examples
The following example shows a request to get all the transcripts of a given meet
#### Request
+The following example shows a request.
+ # [HTTP](#tab/http) <!-- { "blockType": "request",
GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/
-- #### Response
+The following example shows the response.
+ >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", "truncated": true, "name": "get_alltranscripts",
- "@odata.type": "microsoft.graph.callTranscript",
- "isCollection": true
+ "@odata.type": "Collection(microsoft.graph.callTranscript)"
} --> ```http HTTP/1.1 200 OK
Content-type: application/json
} ```
-### Example 2: Get all transcripts of a given meeting organizer with date range filter
+### Example 2: Get all transcripts of a given meeting organizer using a date range filter
The following example shows a request to get all transcripts of a given meeting organizer, that are created between a given start date and an end date. #### Request
+The following example shows a request.
+ # [HTTP](#tab/http) <!-- { "blockType": "request",
GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/
-- #### Response
+The following example shows the response.
+ >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", "truncated": true, "name": "get_alltranscripts_with_dates",
- "@odata.type": "microsoft.graph.callTranscript",
- "isCollection": true
+ "@odata.type": "Collection(microsoft.graph.callTranscript)"
} --> ```http HTTP/1.1 200 OK
Content-type: application/json
## Related content
-[Microsoft Graph service-specific throttling limits](/graph/throttling-limits#microsoft-teams-service-limits)
-[Delta query overview](/graph/delta-query-overview)
-[Export content with the Microsoft Teams export APIs](/microsoftteams/export-teams-content)
+- [Microsoft Graph service-specific throttling limits](/graph/throttling-limits#microsoft-teams-service-limits)
+- [Delta query overview](/graph/delta-query-overview)
+- [Export content with the Microsoft Teams export APIs](/microsoftteams/export-teams-content)
v1.0 Onlinemeeting Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/onlinemeeting-update.md
Namespace: microsoft.graph
Update the properties of the specified [onlineMeeting](../resources/onlinemeeting.md) object.
-Please see [Request body](#request-body) section for the list of properties that support updating.
+For the list of properties that support updating, see the [Request body](#request-body) section.
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
PATCH /users/{userId}/onlineMeetings/{meetingId}
> [!NOTE] >
-> - **userId** is the object ID of a user in [Microsoft Entra admin center > user management page](https://entra.microsoft.com/#blade/Microsoft_AAD_IAM/UsersManagementMenuBlade). For more details, see [application access policy](/graph/cloud-communication-online-meeting-application-access-policy).
+> - **userId** is the object ID of a user in [Microsoft Entra admin center > user management page](https://entra.microsoft.com/#blade/Microsoft_AAD_IAM/UsersManagementMenuBlade). For more information, see [application access policy](/graph/cloud-communication-online-meeting-application-access-policy).
> - `meetingId` is the **id** of an [onlineMeeting](../resources/onlinemeeting.md) object. ## Request headers
PATCH /users/{userId}/onlineMeetings/{meetingId}
## Request body
-The following table lists the properties that can be updated. In the request body, include only the properties that need updating, with the following exceptions:
+The following table lists the properties that can be updated. In the request body, supply *only* the values for properties that should be updated, with the following exceptions:
-- Updating the start or end date/time of an online meeting always requires both **startDateTime** and **endDateTime** properties in the request body.-- The **organizer** field of the **participants** property cannot be updated. The organizer of the meeting cannot be modified after the meeting is created.-- Updating the **attendees** field of the **participants** property, such as adding or removing an attendee to the meeting, always requires the full list of attendees in the request body.
+- If you update the start or end date/time of an online meeting, you must always include both **startDateTime** and **endDateTime** properties in the request body.
+- The **organizer** field of the **participants** property can't be updated. The organizer of the meeting can't be modified after the meeting is created.
+- If you update the **attendees** field of the **participants** property, such as adding or removing an attendee to the meeting, you must always include the full list of attendees in the request body.
-The last column indicates whether updating this property will take effect for an in-progress meeting.
+The last column indicates whether updating this property takes effect for an in-progress meeting.
| Property | Type | Description | Applies to in-progress meetings? |
-|--||-||
-| startDateTime | DateTime | The meeting start time in UTC. | No |
-| endDateTime | DateTime | The meeting end time in UTC. | No |
-| subject | String | The subject of the online meeting. | No |
-| participants | [meetingParticipants](../resources/meetingparticipants.md) | The participants associated with the online meeting. Only attendees can be updated. | No |
-| isEntryExitAnnounced | Boolean | Whether or not to announce when callers join or leave. | Yes |
-| lobbyBypassSettings | [lobbyBypassSettings](../resources/lobbyBypassSettings.md) | Specifies which participants can bypass the meeting lobby. | Yes |
-| allowedPresenters | onlineMeetingPresenters | Specifies who can be a presenter in a meeting. | Yes |
-| allowAttendeeToEnableCamera | Boolean | Indicates whether attendees can turn on their camera. | Yes |
-| allowAttendeeToEnableMic | Boolean | Indicates whether attendees can turn on their microphone. | Yes |
-| allowMeetingChat | meetingChatMode | Specifies the mode of meeting chat. | Yes |
-| allowTeamworkReactions | Boolean | Indicates whether Teams reactions are enabled for the meeting. | Yes |
-| recordAutomatically | Boolean | Indicates whether to record the meeting automatically. | No |
+|--||-| |
+| allowAttendeeToEnableCamera | Boolean | Indicates whether attendees can turn on their camera. | Yes |
+| allowAttendeeToEnableMic | Boolean | Indicates whether attendees can turn on their microphone. | Yes |
+| allowBreakoutRooms | Boolean | Indicates whether breakout rooms are enabled for the meeting. | No |
+| allowedPresenters | onlineMeetingPresenters | Specifies who can be a presenter in a meeting. | Yes |
+| allowLiveShare | Boolean | Indicates whether live share is enabled for the meeting. | No |
+| allowMeetingChat | meetingChatMode | Specifies the mode of meeting chat. | Yes |
+| allowPowerPointSharing | Boolean | Indicates whether PowerPoint live is enabled for the meeting. | No |
+| allowTeamworkReactions | Boolean | Indicates whether Teams reactions are enabled for the meeting. | Yes |
+| allowWhiteboard | Boolean | Indicates whether whiteboard is enabled for the meeting. | No |
+| endDateTime | DateTime | The meeting end time in UTC. | No |
+| isEntryExitAnnounced | Boolean | Whether or not to announce when callers join or leave. | Yes |
+| lobbyBypassSettings | [lobbyBypassSettings](../resources/lobbyBypassSettings.md) | Specifies which participants can bypass the meeting lobby. | Yes |
+| participants | [meetingParticipants](../resources/meetingparticipants.md) | The participants associated with the online meeting. Only attendees can be updated. | No |
+| recordAutomatically | Boolean | Indicates whether to record the meeting automatically. | No |
+| startDateTime | DateTime | The meeting start time in UTC. | No |
+| subject | String | The subject of the online meeting. | No |
> [!NOTE] >
v1.0 Outlooktask Permanentdelete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/outlooktask-permanentdelete.md
+
+ Title: "outlookTask: permanentDelete"
+description: "Permanently delete an Outlook task and place it in the Purges folder in the user's mailbox."
+
+ms.localizationpriority: high
+++
+# outlookTask: permanentDelete
+
+Namespace: microsoft.graph
++
+Permanently delete an Outlook task and place it in the Purges folder in the user's mailbox. Email clients such as Outlook or the Outlook on the web can't access permanently deleted items. Unless there's a hold set on the mailbox, the items are permanently deleted after a set period of time.
+
+For more information about item retention, see [Configure Deleted Item retention and Recoverable Items quotas](/exchange/configure-deleted-item-retention-and-recoverable-items-quotas-exchange-2013-help).
++
+## 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": "outlooktask_permanentdelete" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /users/{usersId}/outlook/tasks/{outlookTaskId}/permanentDelete
+POST /users/{usersId}/outlook/taskGroups/{outlookTaskGroupId}/taskFolders/{outlookTaskFolderId}/tasks/{outlookTaskId}/permanentDelete
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this action returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "outlooktaskthis.permanentdelete"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/users/{usersId}/outlook/tasks/{outlookTaskId}/permanentDelete
+```
+
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
++++
+### Response
+
+The following example shows the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Update checklistItem",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": [
+ "Error: microsoft.graph.microsoft.graph/users:
+ /users/{var}/outlook/tasks/{var}/permanentDelete
+ Uri path requires navigating into unknown object hierarchy: missing property 'tasks' on 'outlookUser'. Possible issues:
+ 1) Doc bug where 'tasks' isn't defined on the resource.
+ 2) Doc bug where 'tasks' is an example key and should instead be replaced with a placeholder like {item-id} or declared in the sampleKeys annotation.
+ 3) Doc bug where 'outlookUser' is supposed to be an entity type, but is being treated as a complex because it (and its ancestors) are missing the keyProperty annotation."
+ ]
+}
+-->
v1.0 Outlooktaskfolder Permanentdelete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/outlooktaskfolder-permanentdelete.md
+
+ Title: "outlookTaskFolder: permanentDelete"
+description: "Permanently delete an outlook task folder and remove its items from the user's mailbox."
+
+ms.localizationpriority: high
+++
+# outlookTaskFolder: permanentDelete
+
+Namespace: microsoft.graph
++
+Permanently delete an outlook task folder and remove its items from the user's mailbox. For more information about item retention, see [Configure Deleted Item retention and Recoverable Items quotas](/exchange/configure-deleted-item-retention-and-recoverable-items-quotas-exchange-2013-help).
+
+>**Note:** Folders aren't placed in the Purges folder when they are permanently deleted. Permanently deleted folders are removed from the mailbox.
+++
+## 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": "outlooktaskfolder_permanentdelete" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /users/{usersId}/outlook/taskFolders/{outlookTaskFolderId}/permanentDelete
+POST /users/{usersId}/outlook/taskGroups/{outlookTaskGroupId}/taskFolders/{outlookTaskFolderId}/permanentDelete
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this action returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "outlooktaskfolderthis.permanentdelete"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/users/{usersId}/outlook/taskFolders/{outlookTaskFolderId}/permanentDelete
+```
+
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
++++
+### Response
+
+The following example shows the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Update checklistItem",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": [
+ "Error: microsoft.graph.microsoft.graph/users:
+ /users/{var}/outlook/taskFolders/{var}/permanentDelete
+ Uri path requires navigating into unknown object hierarchy: missing property 'taskFolders' on 'outlookUser'. Possible issues:
+ 1) Doc bug where 'taskFolders' isn't defined on the resource.
+ 2) Doc bug where 'taskFolders' is an example key and should instead be replaced with a placeholder like {item-id} or declared in the sampleKeys annotation.
+ 3) Doc bug where 'outlookUser' is supposed to be an entity type, but is being treated as a complex because it (and its ancestors) are missing the keyProperty annotation."
+ ]
+}
+-->
v1.0 Partner Security Partnersecurityscore Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/partner-security-partnersecurityscore-get.md
+
+ Title: "Get partnerSecurityScore"
+description: "Read the properties and relationships of a partnerSecurityScore object."
+
+ms.localizationpriority: medium
+++
+# Get partnerSecurityScore
+
+Namespace: microsoft.graph.partner.security
++
+Read the properties and relationships of a [partnerSecurityScore](../resources/partner-security-partnersecurityscore.md) object.
++
+## 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": "partner_security_partnersecurityscore_get" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /security/partner/securityScore
+```
+
+## Optional query parameters
+
+This method supports OData query parameters to customize the response. For example, the `$expand` parameter is useful to retrieve optional properties like **requirements** or **history**. For more information and examples, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [microsoft.graph.partner.security.partnerSecurityScore](../resources/partner-security-partnersecurityscore.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_partnersecurityscore"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/security/partner/securityScore
+```
+
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
++++
+### Response
+
+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.partner.security.partnerSecurityScore"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": {
+ "@odata.type": "#microsoft.graph.partner.security.partnerSecurityScore",
+ "id": "9021efeb-af08-e3dd-9c11-ac69f92e43b8",
+ "updatedDateTime": "2024-01-17T00:00:00Z",
+ "lastRefreshDateTime":"2024-02-28T00:00:00Z",
+ "currentScore": 14.29,
+ "maxScore": 100.0
+ }
+}
+```
+
v1.0 Partner Security Partnersecurityscore List Customerinsights https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/partner-security-partnersecurityscore-list-customerinsights.md
+
+ Title: "List customerInsights"
+description: "Get a list of the customerInsight data and their properties."
+
+ms.localizationpriority: medium
+++
+# List customerInsights
+
+Namespace: microsoft.graph.partner.security
++
+Get a list of the [customerInsight](../resources/partner-security-customerinsight.md) objects and their properties.
++
+## 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": "partner_security_partnersecurityscore_list_customerinsights" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /security/partner/securityScore/customerInsights
+```
+
+## Optional query parameters
+
+This method supports OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+Server-side pagination is supported by following the `nextLink` provided in the API response when you use the `$skipToken` OData query parameter. Using client-side pagination with `$skip` and `$top` isn't supported.
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [microsoft.graph.partner.security.customerInsight](../resources/partner-security-customerinsight.md) objects in the response body.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "list_customerinsight"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/security/partner/securityScore/customerInsights
+```
+
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
++++
+### Response
+
+The following example shows the response.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.partner.security.customerInsight)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.partner.security.customerInsight",
+ "tenantId": "d90cb160-123d-0608-3fd6-c53551dcc20c",
+ "mfa": {
+ "@odata.type": "microsoft.graph.partner.security.customerMfaInsight",
+ "compliantAdminsCount": 1,
+ "compliantNonAdminsCount": 2,
+ "totalUsersCount": 5,
+ "securityDefaultsStatus": "enabled",
+ "mfaConditionalAccessPolicyStatus": "disabled",
+ "legacyPerUserMfaStatus": "disabled"
+ }
+ }
+ ]
+}
+```
+
v1.0 Partner Security Partnersecurityscore List History https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/partner-security-partnersecurityscore-list-history.md
+
+ Title: "List securityScoreHistory"
+description: "Lists the history of security score changes for the partner."
+
+ms.localizationpriority: medium
+++
+# List securityScoreHistory
+
+Namespace: microsoft.graph.partner.security
++
+Get a list of [securityScoreHistory](../resources/partner-security-securityscorehistory.md) entries.
++
+## 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": "partner_security_partnersecurityscore_list_history" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /security/partner/securityScore/history
+```
+
+## Optional query parameters
+
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [microsoft.graph.partner.security.securityScoreHistory](../resources/partner-security-securityscorehistory.md) objects in the response body.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "list_securityscorehistory"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/security/partner/securityScore/history
+```
+
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
++++
+### Response
+
+The following example shows the response.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.partner.security.securityScoreHistory)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.partner.security.securityScoreHistory",
+ "id": "a368fa06-ba31-2d7e-3b0c-2ded0b0c093e",
+ "createdDateTime": "2024-01-17T00:00:00Z",
+ "score": 14.29,
+ "compliantRequirementsCount": 4,
+ "totalRequirementsCount": 5
+ }
+ ]
+}
+```
+
v1.0 Partner Security Partnersecurityscore List Requirements https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/partner-security-partnersecurityscore-list-requirements.md
+
+ Title: "List requirements"
+description: "Get a list of the security requirements to understand if the requirement is compliant and how to improve the score."
+
+ms.localizationpriority: medium
+++
+# List requirements
+
+Namespace: microsoft.graph.partner.security
++
+Get a list of [securityRequirement](../resources/partner-security-securityrequirement.md) objects and their properties.
++
+## 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": "partner-security-partnersecurityscore-list-requirements"
+}
+-->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /security/partner/securityScore/requirements
+```
+
+## Optional query parameters
+
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [microsoft.graph.partner.security.securityRequirement](../resources/partner-security-securityrequirement.md) objects in the response body.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "list_securityrequirement"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/security/partner/securityScore/requirements
+```
+
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
++++
+### Response
+
+The following example shows the response.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.partner.security.securityRequirement)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.partner.security.securityRequirement",
+ "id": "adc3e54c-8dde-f1cb-b92e-ffb989948282",
+ "requirementType": "securityContactProvided",
+ "complianceStatus": "compliant",
+ "actionUrl": "https://aka.ms/partner-center-security-contact",
+ "helpUrl": "https://aka.ms/partner-center-security-dashboard-security-contact",
+ "score": 20,
+ "maxScore": 20,
+ "state": "active",
+ "updatedDateTime": "2023-09-26T04:04:01.4261872Z"
+ }
+ ]
+}
+```
+
v1.0 Partner Security Securityrequirement Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/partner-security-securityrequirement-get.md
+
+ Title: "Get securityRequirement"
+description: "Read the properties and relationships of a ecurityRequirement object."
+
+ms.localizationpriority: medium
+++
+# Get securityRequirement
+
+Namespace: microsoft.graph.partner.security
++
+Read the properties and relationships of a [securityRequirement](../resources/partner-security-securityrequirement.md) object.
++
+## 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": "partner-security-securityrequirement-get"
+}
+-->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /security/partner/securityScore/requirements/{securityRequirementId}
+```
+
+## Optional query parameters
+
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [microsoft.graph.partner.security.securityRequirement](../resources/partner-security-securityrequirement.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_securityrequirement"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/security/partner/securityScore/requirements/{securityRequirementId}
+```
+
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
++++
+### Response
+
+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.partner.security.securityRequirement"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": {
+ "@odata.type": "#microsoft.graph.partner.security.securityRequirement",
+ "id": "adc3e54c-8dde-f1cb-b92e-ffb989948282",
+ "requirementType": "securityContactProvided",
+ "complianceStatus": "compliant",
+ "actionUrl": "https://aka.ms/partner-center-security-contact",
+ "helpUrl": "https://aka.ms/partner-center-security-dashboard-security-contact",
+ "score": "20",
+ "maxScore": "20",
+ "state": "active",
+ "updatedDateTime": "2023-09-26T04:04:01.4261872Z"
+ }
+}
+```
+
v1.0 Partner Security Securityscorehistory Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/partner-security-securityscorehistory-get.md
+
+ Title: "Get securityScoreHistory"
+description: "Read the properties and relationships of a securityScoreHistory object."
+
+ms.localizationpriority: medium
+++
+# Get securityScoreHistory
+
+Namespace: microsoft.graph.partner.security
++
+Read the properties and relationships of a [securityScoreHistory](../resources/partner-security-securityscorehistory.md) object.
++
+## 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": "partner_security_securityscorehistory_get" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /security/partner/securityScore/history/{securityScoreHistoryId}
+```
+
+## Optional query parameters
+
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [microsoft.graph.partner.security.securityScoreHistory](../resources/partner-security-securityscorehistory.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_securityscorehistory"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/security/partner/securityScore/history/{securityScoreHistoryId}
+```
+
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
++++
+### Response
+
+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.partner.security.securityScoreHistory"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": {
+ "@odata.type": "#microsoft.graph.partner.security.securityScoreHistory",
+ "id": "a368fa06-ba31-2d7e-3b0c-2ded0b0c093e",
+ "createdDateTime": "2024-01-17T00:00:00Z",
+ "score": 80.0,
+ "compliantRequirementsCount": 4,
+ "totalRequirementsCount": 5
+ }
+}
+```
+
v1.0 Payload Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/payload-get.md
Choose the permission or permissions marked as least privileged for this API. Us
--> ``` http GET /security/attackSimulation/payloads/{payloadId}
+GET /security/attackSimulation/simulations/{simulationId}/payload
``` ## Optional query parameters
v1.0 Peopleadminsettings Delete Photoupdatesettings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/peopleadminsettings-delete-photoupdatesettings.md
Delete a [photoUpdateSettings](../resources/photoupdatesettings.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": "peopleadminsettings-delete-photoupdatesettings-permissions"
-}
>
+<!-- { "blockType": "permissions", "name": "peopleadminsettings_delete_photoupdatesettings" } -->
[!INCLUDE [permissions-table](../includes/permissions/peopleadminsettings-delete-photoupdatesettings-permissions.md)] ## HTTP request
v1.0 Peopleadminsettings List Photoupdatesettings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/peopleadminsettings-list-photoupdatesettings.md
Get a list of the [photoUpdateSettings](../resources/photoupdatesettings.md) obj
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": "peopleadminsettings-list-photoupdatesettings-permissions"
-}
>
+<!-- { "blockType": "permissions", "name": "peopleadminsettings_list_photoupdatesettings" } -->
## HTTP request
Content-Type: application/json
} ] }
-```
+```
v1.0 Photoupdatesettings Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/photoupdatesettings-get.md
Read the properties and relationships of a [photoUpdateSettings](../resources/ph
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": "photoupdatesettings-get-permissions"
-}
>
+<!-- { "blockType": "permissions", "name": "photoupdatesettings_get" } -->
[!INCLUDE [permissions-table](../includes/permissions/photoupdatesettings-get-permissions.md)] ## HTTP request
v1.0 Photoupdatesettings Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/photoupdatesettings-update.md
Update the properties of a [photoUpdateSettings](../resources/photoupdatesetting
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": "photoupdatesettings-update-permissions"
-}
>
+<!-- { "blockType": "permissions", "name": "photoupdatesettings_update" } -->
[!INCLUDE [permissions-table](../includes/permissions/photoupdatesettings-update-permissions.md)] ## HTTP request
v1.0 Plannerplanconfiguration Delete Localizations https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/plannerplanconfiguration-delete-localizations.md
- Title: "Delete plannerPlanConfigurationLocalization"
-description: "Delete a plannerPlanConfigurationLocalization object."
--
-doc_type: apiPageType
--
-# Delete plannerPlanConfigurationLocalization
-
-Namespace: microsoft.graph
--
-Delete a [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object.
--
-## 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": "plannerplanconfiguration_delete_localizations" } -->
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-For a specific localization based on a business scenario ID and a localization ID:
-
-``` http
-DELETE /solutions/businessScenarios/{businessScenarioId}/planner/planConfiguration/localizations/{plannerPlanConfigurationLocalizationId}
-```
-
-For a specific localization based on the unique name of a business scenario and a localization ID:
-
-``` http
-DELETE /solutions/businessScenarios(uniqueName='{uniqueName}')/planner/planConfiguration/localizations/{plannerPlanConfigurationLocalizationId}
-```
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
-
-## Request body
-
-Don't supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `204 No Content` response code.
-
-## Examples
-
-### Request
-
-The following example shows a request.
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "delete_plannerplanconfigurationlocalization",
- "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d", "en-us"]
-}
>
-``` http
-DELETE https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/planConfiguration/localizations/en-us
-```
-
-# [C#](#tab/csharp)
-
-# [CLI](#tab/cli)
-
-# [Go](#tab/go)
-
-# [Java](#tab/java)
-
-# [JavaScript](#tab/javascript)
-
-# [PHP](#tab/php)
-
-# [PowerShell](#tab/powershell)
-
-# [Python](#tab/python)
---
-### Response
-
-The following example shows the response.
-<!-- {
- "blockType": "response",
- "truncated": true
-}
>
-``` http
-HTTP/1.1 204 No Content
-```
v1.0 Plannerplanconfiguration Post Localizations https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/plannerplanconfiguration-post-localizations.md
- Title: "Create plannerPlanConfigurationLocalization"
-description: "Create a new plannerPlanConfigurationLocalization object."
--
-doc_type: apiPageType
--
-# Create plannerPlanConfigurationLocalization
-
-Namespace: microsoft.graph
--
-Create a new [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object.
--
-## 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": "plannerplanconfiguration_post_localizations" } -->
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-For a specific localization based on a business scenario ID:
-
-``` http
-POST /solutions/businessScenarios/{businessScenarioId}/planner/planConfiguration/localizations
-```
-
-For a specific localization based on the unique name of a business scenario:
-
-``` http
-POST /solutions/businessScenarios(uniqueName='{uniqueName}')/planner/planConfiguration/localizations
-```
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
-|Content-Type|application/json. Required.|
-
-## Request body
-
-In the request body, supply a JSON representation of the [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object.
-
-You can specify the following properties when you create a **plannerPlanConfigurationLocalization**.
-
-|Property|Type|Description|
-|:|:|:|
-|buckets|[plannerPlanConfigurationBucketLocalization](../resources/plannerplanconfigurationbucketlocalization.md) collection|Localizations for buckets specified in the [plannerPlanConfiguration](../resources/plannerplanconfiguration.md). Required.|
-|languageTag|String|The code for the language the localized data is intended for. Required.|
-|planTitle|String|Localized title of the plan. Required.|
-
-## Response
-
-If successful, this method returns a `201 Created` response code and a [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object in the response body.
-
-## Examples
-
-### Request
-
-The following example shows a request.
--
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "create_plannerplanconfigurationlocalization_from_",
- "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d"]
-}
>
-``` http
-POST https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/planConfiguration/localizations
-Content-Type: application/json
-
-{
- "@odata.type": "#microsoft.graph.plannerPlanConfigurationLocalization",
- "languageTag": "en-us",
- "planTitle": "Order Tracking",
- "buckets": [
- {
- "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",
- "externalBucketId": "deliveryBucket",
- "name": "Deliveries"
- },
- {
- "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",
- "externalBucketId": "storePickupBucket",
- "name": "Pickup"
- },
- {
- "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",
- "externalBucketId": "specialOrdersBucket",
- "name": "Special Orders"
- },
- {
- "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",
- "externalBucketId": "returnProcessingBucket",
- "name": "Customer Returns"
- }
- ]
-}
-```
-
-# [C#](#tab/csharp)
-
-# [CLI](#tab/cli)
-
-# [Go](#tab/go)
-
-# [Java](#tab/java)
-
-# [JavaScript](#tab/javascript)
-
-# [PHP](#tab/php)
-
-# [PowerShell](#tab/powershell)
-
-# [Python](#tab/python)
---
-### Response
-
-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.plannerPlanConfigurationLocalization"
-}
>
-``` http
-HTTP/1.1 201 Created
-Content-Type: application/json
-
-{
- "@odata.type": "#microsoft.graph.plannerPlanConfigurationLocalization",
- "id": "en-us",
- "languageTag": "en-us",
- "planTitle": "Order Tracking",
- "buckets": [
- {
- "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",
- "externalBucketId": "deliveryBucket",
- "name": "Deliveries"
- },
- {
- "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",
- "externalBucketId": "storePickupBucket",
- "name": "Pickup"
- },
- {
- "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",
- "externalBucketId": "specialOrdersBucket",
- "name": "Special Orders"
- },
- {
- "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",
- "externalBucketId": "returnProcessingBucket",
- "name": "Customer Returns"
- }
- ]
-}
-```
v1.0 Plannerplanconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/plannerplanconfiguration-update.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Update the properties of a [plannerPlanConfiguration](../resources/plannerplanconfiguration.md) object for a [businessScenario](../resources/businessscenario.md).
+Update the properties of a [plannerPlanConfiguration](../resources/plannerplanconfiguration.md) object and its [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) collection for a [businessScenario](../resources/businessscenario.md).
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
PATCH /solutions/businessScenarios(uniqueName='{uniqueName}')/planner/planConfig
|Property|Type|Description| |:|:|:|
-|defaultLanguage|String|The language that should be used for creating plans when no language has been specified. Required.|
-|buckets|[plannerPlanConfigurationBucketDefinition](../resources/plannerplanconfigurationbucketdefinition.md) collection|Buckets that will be available in the plan. Required.|
+|defaultLanguage|String|The language that should be used for creating plans when no language has been specified.|
+|buckets|[plannerPlanConfigurationBucketDefinition](../resources/plannerplanconfigurationbucketdefinition.md) collection|Buckets available in the plan.|
+|localizations|[plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) collection|Localized names for the plan configuration.|
## Response
PATCH https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864
Content-Type: application/json {
- "@odata.type": "#microsoft.graph.plannerPlanConfiguration",
"defaultLanguage": "en-us", "buckets": [ {
Content-Type: application/json
{ "externalBucketId": "returnProcessingBucket" }
+ ],
+ "localizations": [
+ {
+ "id": "en-us",
+ "languageTag": "en-us",
+ "planTitle": "Order Tracking",
+ "buckets": [
+ {
+ "externalBucketId": "deliveryBucket",
+ "name": "Deliveries"
+ },
+ {
+ "externalBucketId": "storePickupBucket",
+ "name": "Pickup"
+ },
+ {
+ "externalBucketId": "specialOrdersBucket",
+ "name": "Special Orders"
+ },
+ {
+ "externalBucketId": "returnProcessingBucket",
+ "name": "Customer Returns"
+ }
+ ]
+ },
+ {
+ "id": "es-es",
+ "languageTag": "es-es",
+ "planTitle": "Seguimiento de pedidos",
+ "buckets": [
+ {
+ "externalBucketId": "deliveryBucket",
+ "name": "Entregas"
+ },
+ {
+ "externalBucketId": "storePickupBucket",
+ "name": "Recogida"
+ },
+ {
+ "externalBucketId": "specialOrdersBucket",
+ "name": "Pedidos especiales"
+ },
+ {
+ "externalBucketId": "specialOrdersBucket",
+ "name": "Devoluciones de clientes"
+ }
+ ]
+ }
] } ```
Content-Type: application/json
{ "externalBucketId": "returnProcessingBucket" }
+ ],
+ "localizations": [
+ {
+ "id": "en-us",
+ "languageTag": "en-us",
+ "planTitle": "Order Tracking",
+ "buckets": [
+ {
+ "externalBucketId": "deliveryBucket",
+ "name": "Deliveries"
+ },
+ {
+ "externalBucketId": "storePickupBucket",
+ "name": "Pickup"
+ },
+ {
+ "externalBucketId": "specialOrdersBucket",
+ "name": "Special Orders"
+ },
+ {
+ "externalBucketId": "returnProcessingBucket",
+ "name": "Customer Returns"
+ }
+ ]
+ },
+ {
+ "id": "es-es",
+ "languageTag": "es-es",
+ "planTitle": "Seguimiento de pedidos",
+ "buckets": [
+ {
+ "externalBucketId": "deliveryBucket",
+ "name": "Entregas"
+ },
+ {
+ "externalBucketId": "storePickupBucket",
+ "name": "Recogida"
+ },
+ {
+ "externalBucketId": "specialOrdersBucket",
+ "name": "Pedidos especiales"
+ },
+ {
+ "externalBucketId": "specialOrdersBucket",
+ "name": "Devoluciones de clientes"
+ }
+ ]
+ }
] } ```
v1.0 Plannerplanconfigurationlocalization Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/plannerplanconfigurationlocalization-get.md
- Title: "Get plannerPlanConfigurationLocalization"
-description: "Read the properties and relationships of a plannerPlanConfigurationLocalization object."
--
-doc_type: apiPageType
--
-# Get plannerPlanConfigurationLocalization
-
-Namespace: microsoft.graph
--
-Read the properties and relationships of a [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object.
--
-## 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": "plannerplanconfigurationlocalization_get" } -->
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-For a specific localization based on a business scenario ID and a localization ID:
-
-``` http
-GET /solutions/businessScenarios/{businessScenarioId}/planner/planConfiguration/localizations/{plannerPlanConfigurationLocalizationId}
-```
-
-For a specific localization based on the unique name of a business scenario and a localization ID:
-
-``` http
-GET /solutions/businessScenarios(uniqueName='{uniqueName}')/planner/planConfiguration/localizations/{plannerPlanConfigurationLocalizationId}
-```
-
-## Optional query parameters
-
-This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
-
-## Request body
-
-Don't supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and a [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object in the response body.
-
-## Examples
-
-### Request
-
-The following example shows a request.
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "get_plannerplanconfigurationlocalization",
- "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d", "en-us"]
-}
>
-``` http
-GET https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/planConfiguration/localizations/en-us
-```
-
-# [C#](#tab/csharp)
-
-# [CLI](#tab/cli)
-
-# [Go](#tab/go)
-
-# [Java](#tab/java)
-
-# [JavaScript](#tab/javascript)
-
-# [PHP](#tab/php)
-
-# [PowerShell](#tab/powershell)
-
-# [Python](#tab/python)
---
-### Response
-
-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.plannerPlanConfigurationLocalization"
-}
>
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "@odata.type": "#microsoft.graph.plannerPlanConfigurationLocalization",
- "id": "en-us",
- "languageTag": "en-us",
- "planTitle": "Order Tracking",
- "buckets": [
- {
- "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",
- "externalBucketId": "deliveryBucket",
- "name": "Deliveries"
- },
- {
- "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",
- "externalBucketId": "storePickupBucket",
- "name": "Pickup"
- },
- {
- "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",
- "externalBucketId": "specialOrdersBucket",
- "name": "Special Orders"
- },
- {
- "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization",
- "externalBucketId": "returnProcessingBucket",
- "name": "Customer Returns"
- }
- ]
-}
-```
v1.0 Plannerplanconfigurationlocalization Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/plannerplanconfigurationlocalization-update.md
- Title: "Update plannerPlanConfigurationLocalization"
-description: "Update the properties of a plannerPlanConfigurationLocalization object."
--
-doc_type: apiPageType
--
-# Update plannerPlanConfigurationLocalization
-
-Namespace: microsoft.graph
--
-Update the properties of a [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object.
--
-## 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": "plannerplanconfigurationlocalization_update" } -->
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-For a specific localization based on a business scenario ID and a localization ID:
-
-``` http
-PATCH /solutions/businessScenarios/{businessScenarioId}/planner/planConfiguration/localizations/{plannerPlanConfigurationLocalizationId}
-```
-
-For a specific localization based on the unique name of a business scenario and a localization ID:
-
-``` http
-PATCH /solutions/businessScenarios(uniqueName='{uniqueName}')/planner/planConfiguration/localizations/{plannerPlanConfigurationLocalizationId}
-```
-
-## Request headers
-
-|Name|Description|
-|:|:|
-|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
-|Content-Type|application/json. Required.|
-
-## Request body
--
-|Property|Type|Description|
-|:|:|:|
-|buckets|[plannerPlanConfigurationBucketLocalization](../resources/plannerplanconfigurationbucketlocalization.md) collection|Localizations for buckets specified in the [plannerPlanConfiguration](../resources/plannerplanconfiguration.md). Optional.|
-|planTitle|String|Localized title of the plan. Optional.|
-
-## Response
-
-If successful, this method returns a `200 OK` response code and an updated [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object in the response body.
-
-## Examples
-
-### Request
-
-The following example shows a request.
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "update_plannerplanconfigurationlocalization",
- "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d", "en-us"]
-}
>
-``` http
-PATCH https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/planConfiguration/localizations/en-us
-Content-Type: application/json
-
-{
- "@odata.type": "#microsoft.graph.plannerPlanConfigurationLocalization",
- "planTitle": "Order Tracking",
- "buckets": [
- {
- "externalBucketId": "deliveryBucket",
- "name": "Deliveries"
- },
- {
- "externalBucketId": "storePickupBucket",
- "name": "Pickup"
- },
- {
- "externalBucketId": "specialOrdersBucket",
- "name": "Special Orders"
- },
- {
- "externalBucketId": "returnProcessingBucket",
- "name": "Customer Returns"
- }
- ]
-}
-```
-
-# [C#](#tab/csharp)
-
-# [CLI](#tab/cli)
-
-# [Go](#tab/go)
-
-# [Java](#tab/java)
-
-# [JavaScript](#tab/javascript)
-
-# [PHP](#tab/php)
-
-# [PowerShell](#tab/powershell)
-
-# [Python](#tab/python)
---
-### Response
-
-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.plannerPlanConfigurationLocalization"
-}
>
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "@odata.type": "#microsoft.graph.plannerPlanConfigurationLocalization",
- "id": "en-us",
- "languageTag": "en-us",
- "planTitle": "Order Tracking",
- "buckets": [
- {
- "externalBucketId": "deliveryBucket",
- "name": "Deliveries"
- },
- {
- "externalBucketId": "storePickupBucket",
- "name": "Pickup"
- },
- {
- "externalBucketId": "specialOrdersBucket",
- "name": "Special Orders"
- },
- {
- "externalBucketId": "returnProcessingBucket",
- "name": "Customer Returns"
- }
- ]
-}
-```
v1.0 Protectionpolicybase Activate https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/protectionpolicybase-activate.md
Namespace: microsoft.graph
Activate a [protectionPolicyBase](../resources/protectionpolicybase.md).
+Currently, only one active backup policy per underlying service is supported (that is, one for OneDrive accounts, one for SharePoint sites, and one for Exchange Online users). You can add or remove artifacts (sites or user accounts) to or from each active policy.
+ [!INCLUDE [national-cloud-support](../../includes/global-only.md)] ## Permissions
Don't supply a request body for this method.
If successful, this action returns a `202 Accepted` response code and a [protectionPolicyBase](../resources/protectionpolicybase.md) object in the response body.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples
-### Example 1 : Activate an inactive protection policy
+### Example 1: Activate an inactive protection policy
-Activate an inactive protection policy.
+The following example shows a request to activate an inactive protection policy.
#### Request
Content-Location: https://graph.microsoft.com/beta/solutions/backupRestore/prote
} ```
-### Example 2 : Activate an active protection policy
+### Example 2: Activate an active protection policy
-Activate an already active protection policy.
+The following example shows a request to activate a protection policy that's already active. This request results in an error.
#### Request
v1.0 Protectionpolicybase Deactivate https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/protectionpolicybase-deactivate.md
Don't supply a request body for this method.
If successful, this action returns a `202 Accepted` response code and a [protectionPolicyBase](../resources/protectionpolicybase.md) object in the response body.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Example 1: Deactivate an active protection policy
v1.0 Protectionpolicybase Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/protectionpolicybase-delete.md
Don't supply a request body for this method.
If successful, this method returns a `204 No Content` response code.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Request
v1.0 Protectionpolicybase Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/protectionpolicybase-get.md
Don't supply a request body for this method.
If successful, this method returns a `200 OK` response code and a [protectionPolicyBase](../resources/protectionpolicybase.md) object in the response body.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Request
v1.0 Protectionrulebase Post https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/protectionrulebase-post.md
You can specify the following properties when you create a **mailboxInclusionRul
If successful, this method returns a `201 Created` response code and a [protectionRuleBase](../resources/protectionRuleBase.md) object in the response body.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Example 1: Create a new siteInclusionRule associated with a SharePoint protection policy
v1.0 Protectionunitbase Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/protectionunitbase-get.md
Don't supply a request body for this method.
If successful, this method returns a `200 OK` response code and a [protectionUnitBase](../resources/protectionunitbase.md) object in the response body.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Request
v1.0 Range Clear https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/range-clear.md
Namespace: microsoft.graph
Clear range values such as format, fill, and border. + ## 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).
Here is an example of how to call this API.
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "range_clear"
Content-type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
+++ ##### Response The following example shows the response. <!-- {
v1.0 Range Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/range-delete.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Deletes the cells associated with the range.++ ## 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).
Here is an example of how to call this API.
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "range_delete"
Content-type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
+++ ##### Response The following example shows the response. <!-- {
v1.0 Range Entirecolumn https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/range-entirecolumn.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Gets an object that represents the entire column of the range.++ ## 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).
Here is an example of how to call this API.
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "range_entirecolumn"
The following example shows a request.
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/names/{name}/range/EntireColumn ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
v1.0 Range Entirerow https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/range-entirerow.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Gets an object that represents the entire row of the range.++ ## 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).
Here is an example of how to call this API.
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "range_entirerow"
The following example shows a request.
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/names/{name}/range/EntireRow ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
v1.0 Range Insert https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/range-insert.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Inserts a cell or a range of cells into the worksheet in place of this range, and shifts the other cells to make space. Returns a new Range object at the now blank space.++ ## 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).
Here is an example of how to call this API.
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "range_insert"
Content-type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
v1.0 Range Lastcell https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/range-lastcell.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Gets the last cell within the range. For example, the last cell of "B2:D5" is "D5".++ ## 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).
Here's an example of how to call this API.
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "range_lastcell"
The following example shows a request.
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/names/{name}/range/LastCell ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
v1.0 Range Lastcolumn https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/range-lastcolumn.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Gets the last column within the range. For example, the last column of "B2:D5" is "D2:D5".++ ## 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).
Here's an example of how to call this API.
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "range_lastcolumn"
The following example shows a request.
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/names/{name}/range/LastColumn ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
v1.0 Range Lastrow https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/range-lastrow.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Gets the last row within the range. For example, the last row of "B2:D5" is "B5:D5".++ ## 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).
Here's an example of how to call this API.
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "range_lastrow"
The following example shows a request.
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/names/{name}/range/LastRow ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
v1.0 Range Merge https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/range-merge.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Merge the range cells into one region in the worksheet.++ ## 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).
Here is an example of how to call this API.
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "range_merge"
Content-type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
+++ ##### Response The following example shows the response. <!-- {
v1.0 Range Unmerge https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/range-unmerge.md
Namespace: microsoft.graph
Unmerge the range cells into separate cells. + ## 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).
If successful, this method returns a `204 No Content` response code. It doesn't
### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "range_unmerge"
The following example shows a request.
POST https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/names/{name}/range/unmerge ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
+++ ### Response The following example shows the response. <!-- {
v1.0 Range Usedrange https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/range-usedrange.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Returns the used range of the given range object.++ ## 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).
Here is an example of how to call this API.
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "range_usedrange"
Content-type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
v1.0 Rangeborder Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/rangeborder-get.md
If successful, this method returns a `200 OK` response code and [workbookRangeBo
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_rangeborder"
The following example shows a request.
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/names/{name}/range/format/borders/{sideIndex} ```
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
v1.0 Rangeborder List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/rangeborder-list.md
If successful, this method returns a `200 OK` response code and collection of [w
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_rangebordercollection"
The following example shows a request.
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/names/{name}/range/format/borders ```
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
v1.0 Rangeborder Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/rangeborder-update.md
If successful, this method returns a `200 OK` response code and updated [workboo
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_rangeborder"
Content-type: application/json
} ```
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
v1.0 Rangebordercollection Itemat https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/rangebordercollection-itemat.md
Here is an example of how to call this API.
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "rangebordercollection_itemat"
The following example shows a request.
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/names/{name}/range/format/borders/ItemAt(index=8) ```
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
v1.0 Rangefill Clear https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/rangefill-clear.md
Here's an example of how to call this API.
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "rangefill_clear"
The following example shows a request.
POST https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/names/{name}/range/format/fill/clear ```
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. <!-- {
v1.0 Rangefill Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/rangefill-get.md
If successful, this method returns a `200 OK` response code and [workbookRangeFi
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_rangefill"
The following example shows a request.
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/names/{name}/range/format/fill ```
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
v1.0 Rangefill Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/rangefill-update.md
If successful, this method returns a `200 OK` response code and updated [workboo
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_rangefill"
Content-type: application/json
} ```
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
v1.0 Rangefont Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/rangefont-get.md
If successful, this method returns a `200 OK` response code and [workbookRangeFo
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_rangefont"
The following example shows a request.
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/names/{name}/range/format/font ```
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
v1.0 Rangefont Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/rangefont-update.md
If successful, this method returns a `200 OK` response code and updated [workboo
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_rangefont"
Content-type: application/json
} ```
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
v1.0 Rangeformat Autofitcolumns https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/rangeformat-autofitcolumns.md
Here is an example of how to call this API.
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "rangeformat_autofitcolumns"
The following example shows a request.
POST https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/names/{name}/range/format/autofitColumns ```
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. <!-- {
v1.0 Rangeformat Autofitrows https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/rangeformat-autofitrows.md
Here is an example of how to call this API.
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "rangeformat_autofitrows"
The following example shows a request.
POST https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/names/{name}/range/format/autofitRows ```
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. <!-- {
v1.0 Rangeformat Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/rangeformat-get.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Retrieve the properties and relationships of rangeformat object.++ ## 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).
If successful, this method returns a `200 OK` response code and [workbookRangeFo
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_rangeformat"
The following example shows a request.
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/names/{name}/range/format ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
v1.0 Rangeformat List Borders https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/rangeformat-list-borders.md
If successful, this method returns a `200 OK` response code and collection of [w
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_borders"
The following example shows a request.
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/names/{name}/range/format/borders ```
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
v1.0 Rangeformat Post Borders https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/rangeformat-post-borders.md
If successful, this method returns `201 Created` response code and [workbookRang
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_rangeborder_from_rangeformat"
Content-type: application/json
} ```
+# [JavaScript](#tab/javascript)
+++ In the request body, supply a JSON representation of [workbookRangeBorder](../resources/workbookrangeborder.md) object. ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability.
v1.0 Rangeformat Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/rangeformat-update.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Update the properties of rangeformat object.++ ## 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 result of this set of requests is a table with three cells formatted like th
This request updates the vertical alignment, row height, and column height of the first cell.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_rangeformat",
Content-type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
Content-type: application/json
This request updates the font style, size, and color of the first cell.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_rangeformat_font",
Content-type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
Content-type: application/json
This request updates the background color of the first cell.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_rangeformat_fill",
Content-type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
Content-type: application/json
This request updates the vertical alignment, horizontal alignment, row height, and column height of the second cell.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_rangeformat_two",
Content-type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
Content-type: application/json
This request updates the font style and size of the second cell.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_rangeformat_font_two",
Content-type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
Content-type: application/json
This request updates the background color of the second cell.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_rangeformat_fill_two",
Content-type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
Content-type: application/json
This request updates the horizontal alignment, vertical alignment, row height, and column height of the third cell.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_rangeformat_three",
Content-type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
Content-type: application/json
This request updates the font style, size, and color of the third cell. The underline property takes **Single** or **Double** as values.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_rangeformat_font_three",
Content-type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
Content-type: application/json
This request updates the background color of the third cell.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_rangeformat_fill_three",
Content-type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
v1.0 Rangesort Apply https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/rangesort-apply.md
Here's an example of how to call this API.
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "rangesort_apply"
Content-type: application/json
} ```
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. <!-- {
v1.0 Reflectcheckinresponse Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/reflectcheckinresponse-get.md
Read the properties and relationships of a [reflectCheckInResponse](../resources
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": "reflectcheckinresponse-get-permissions"
-}
>
+<!-- { "blockType": "permissions", "name": "reflectcheckinresponse_get" } -->
[!INCLUDE [permissions-table](../includes/permissions/reflectcheckinresponse-get-permissions.md)] ## HTTP request
v1.0 Reportroot Getmicrosoft365copilotusageuserdetail https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/reportroot-getmicrosoft365copilotusageuserdetail.md
+
+ Title: "reportRoot: getMicrosoft365CopilotUsageUserDetail"
+description: "Get the most recent activity data for enabled users of Copilot for Microsoft 365 apps."
+
+ms.localizationpriority: medium
+++
+# reportRoot: getMicrosoft365CopilotUsageUserDetail
+
+Namespace: microsoft.graph
++
+Get the most recent activity data for enabled users of Copilot for Microsoft 365 apps.
++
+## 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": "reportroot_getmicrosoft365copilotusageuserdetail" } -->
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /reports/getMicrosoft365CopilotUsageUserDetail(period='{period_value}')
+```
+
+## Function parameters
+In the request URL, provide the following query parameters with values.
+
+|Parameter|Type|Description|
+|:|:|:|
+|period|String|The number of previous days over which to report aggregated usage. The supported values are: `D7`, `D30`, `D90`, `D180`, `ALL`. The first four values follow the format Dn where n represents the number of previous days over which to aggregate data. `ALL` indicates to report usage for 7, 30, 90, and 180 days.|
+
+## Optional query parameters
+
+This method supports the `$format` [OData query parameter](/graph/query-parameters) to customize the response. The default output type is `application/json`. However, if you want to specify the output type, you can use the OData `$format` query parameter to set the default output to `text/csv` or `application/json`.
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+### CSV
+
+If successful, this method returns a `302 Found` response that redirects to a preauthenticated download URL for the report. That URL can be found in the `Location` header in the response.
+
+Preauthenticated download URLs are only valid for a short period of time (a few minutes) and don't require an `Authorization` header.
+
+The CSV file has the following headers for columns.
+
+- Report Refresh Date
+- Report Period
+- User Principal Name
+- Display Name
+- Last Activity Date
+- Microsoft Teams Copilot Last Activity Date
+- Word Copilot Last Activity Date
+- Excel Copilot Last Activity Date
+- PowerPoint Copilot Last Activity Date
+- Outlook Copilot Last Activity Date
+- OneNote Copilot Last Activity Date
+- Loop Copilot Last Activity Date
+- Copilot Chat Last Activity Date
+
+### JSON
+
+If successful, this method returns a `200 OK` response code and a JSON object in the response body.
+
+## Examples
+
+### Example 1: CSV output
+
+The following example returns a URL for a CSV file.
+
+#### Request
+
+The following example shows a request.
+<!-- {
+ "blockType": "request",
+ "name": "reportroot_getmicrosoft365copilotusageuserdetail_csv"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/reports/getMicrosoft365CopilotUsageUserDetail(period='D7')?$format=text/csv
+```
+
+#### Response
+
+The following example shows the response.
+
+<!-- { "blockType": "response" } -->
+``` http
+HTTP/1.1 302 Found
+Content-Type: text/plain
+Location: https://reports.office.com/data/download/JDFKdf2_eJXKS034dbc7e0t__XDe
+```
+
+The CSV file in the `Location` header of the 302 response has the following schema.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Edm.Stream"
+}
+-->
+```http
+HTTP/1.1 200 OK
+Content-Type: application/octet-stream
+
+Report Refresh Date,Report Period,User Principal Name,Display Name,Last Activity Date,Microsoft Teams Copilot Last Activity Date,Word Copilot Last Activity Date,Excel Copilot Last Activity Date,PowerPoint Copilot Last Activity Date,Outlook Copilot Last Activity Date,OneNote Copilot Last Activity Date,Loop Copilot Last Activity Date,Copilot Chat Last Activity Date
+```
+
+### Example 2: JSON output
+
+The following example returns JSON data.
+
+#### Request
+
+The following example shows a request.
+<!-- {
+ "blockType": "request",
+ "name": "reportroot_getmicrosoft365copilotusageuserdetail_json"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/reports/getMicrosoft365CopilotUsageUserDetail(period='D7')?$format=application/json
+```
+
+#### Response
+
+The following example shows the response.
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Edm.Stream"
+}
+-->
+```http
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 10747
+
+{
+ "@odata.nextLink": "https://graph.microsoft.com/betoyOg",
+ "value": [
+ {
+ "reportRefreshDate": "2024-08-20",
+ "userPrincipalName": "DC8C64D6EC3A3AA17481D7E5EB5B68A6",
+ "displayName": "C65E8D8AFA0DAB9639EDFAAEA94AFE66",
+ "lastActivityDate": "2024-08-20",
+ "copilotChatLastActivityDate": "2024-08-16",
+ "microsoftTeamsCopilotLastActivityDate": "2024-08-20",
+ "wordCopilotLastActivityDate": "2024-08-06",
+ "excelCopilotLastActivityDate": "",
+ "powerPointCopilotLastActivityDate": "2024-03-26",
+ "outlookCopilotLastActivityDate": "",
+ "oneNoteCopilotLastActivityDate": "",
+ "loopCopilotLastActivityDate": "",
+ "copilotActivityUserDetailsByPeriod": [
+ {
+ "reportPeriod": 7
+ }
+ ]
+ }
+ ]
+}
+```
v1.0 Reportroot Getmicrosoft365copilotusercountsummary https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/reportroot-getmicrosoft365copilotusercountsummary.md
+
+ Title: "reportRoot: getMicrosoft365CopilotUserCountSummary"
+description: "Get the aggregated number of active and enabled users of Copilot for Microsoft 365 for a specified time period."
+
+ms.localizationpriority: medium
+++
+# reportRoot: getMicrosoft365CopilotUserCountSummary
+
+Namespace: microsoft.graph
++
+Get the aggregated number of active and enabled users of Copilot for Microsoft 365 for a specified time period.
++
+## 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": "reportroot_getmicrosoft365copilotusercountsummary" } -->
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /reports/getMicrosoft365CopilotUserCountSummary(period='{period_value}')
+```
+
+## Function parameters
+In the request URL, provide the following query parameters with values.
+
+|Parameter|Type|Description|
+|:|:|:|
+|period|String|The number of previous days over which to report aggregated usage. The supported values are: `D7`, `D30`, `D90`, `D180`, `ALL`. The first four values follow the format Dn where n represents the number of days over which to aggregate data. `ALL` indicates to report usage for 7, 30, 90, and 180 days.|
+
+## Optional query parameters
+
+This method supports the `$format` [OData query parameter](/graph/query-parameters) to customize the response. The default output type is `application/json`. However, if you want to specify the output type, you can use the OData `$format` query parameter to set the default output to `text/csv` or `application/json`.
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+### CSV
+
+If successful, this method returns a `302 Found` response that redirects to a preauthenticated download URL for the report. That URL can be found in the `Location` header in the response.
+
+Preauthenticated download URLs are only valid for a short period of time (a few minutes) and don't require an `Authorization` header.
+
+The CSV file has the following headers for columns.
+
+- Report Refresh Date
+- Report Period
+- Any App Enabled Users
+- Any App Active Users
+- Microsoft Teams Enabled Users
+- Microsoft Teams Active Users
+- Word Enabled Users
+- Word Active Users
+- PowerPoint Enabled Users
+- PowerPoint Active Users
+- Outlook Enabled Users
+- Outlook Active Users
+- Excel Enabled Users
+- Excel Active Users
+- OneNote Enabled Users
+- OneNote Active Users
+- Loop Enabled Users
+- Loop Active Users
+- Copilot Chat Enabled Users
+- Copilot Chat Active Users
+
+### JSON
+
+If successful, this method returns a `200 OK` response code and a JSON object in the response body.
+
+## Examples
+
+### Example 1: CSV output
+
+The following example outputs a URL for a CSV file.
+
+#### Request
+
+The following example shows a request.
+<!-- {
+ "blockType": "request",
+ "name": "reportroot_getmicrosoft365copilotusercountsummary_csv"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/reports/getMicrosoft365CopilotUserCountSummary(period='D7')?$format=text/csv
+```
+
+#### Response
+
+The following example shows the response.
+
+<!-- { "blockType": "response" } -->
+``` http
+HTTP/1.1 302 Found
+Content-Type: text/plain
+Location: https://reports.office.com/data/download/JDFKdf2_eJXKS034dbc7e0t__XDe
+```
+
+The CSV file in the `Location` header of the 302 response has the following schema.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Edm.Stream"
+}
+-->
+```http
+HTTP/1.1 200 OK
+Content-Type: application/octet-stream
+
+Report Refresh Date,Report Period,Any App Enabled Users,Any App Active Users,Microsoft Teams Enabled Users,Microsoft Teams Active Users ,Word Enabled Users,Word Active Users,PowerPoint Enabled Users,PowerPoint Active Users,Outlook Enabled Users,Outlook Active Users,Excel Enabled Users,Excel Active Users,OneNote Enabled Users,OneNote Active Users,Loop Enabled Users,Loop Active Users,Copilot Chat Enabled Users,Copilot Chat Active Users
+```
+
+### Example 2: JSON output
+
+The following example returns JSON data.
+
+#### Request
+
+The following example shows a request.
+<!-- {
+ "blockType": "request",
+ "name": "reportroot_getmicrosoft365copilotusercountsummary_json"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/reports/getMicrosoft365CopilotUserCountSummary(period='D7')?$format=application/json
+```
+
+#### Response
+
+The following example shows the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Edm.Stream"
+}
+-->
+```http
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 537
+
+{
+ "value": [
+ {
+ "reportRefreshDate": "2024-08-20",
+ "adoptionByProduct": [
+ {
+ "reportPeriod": 7,
+ "anyAppEnabledUsers": 359229,
+ "anyAppActiveUsers": 165115,
+ "microsoftTeamsEnabledUsers": 359096,
+ "microsoftTeamsActiveUsers": 123341,
+ "wordEnabledUsers": 359096,
+ "wordActiveUsers": 21459,
+ "powerPointEnabledUsers": 359096,
+ "powerPointActiveUsers": 8530,
+ "outlookEnabledUsers": 359096,
+ "outlookActiveUsers": 37270,
+ "excelEnabledUsers": 359096,
+ "excelActiveUsers": 6709,
+ "oneNoteEnabledUsers": 359096,
+ "oneNoteActiveUsers": 1660,
+ "loopEnabledUsers": 359096,
+ "loopActiveUsers": 1345,
+ "copilotChatEnabledUsers": 359096,
+ "copilotChatActiveUsers": 65480
+ }
+ ]
+ }
+ ]
+}
+```
v1.0 Reportroot Getmicrosoft365copilotusercounttrend https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/reportroot-getmicrosoft365copilotusercounttrend.md
+
+ Title: "reportRoot: getMicrosoft365CopilotUserCountTrend"
+description: "Get the trend in the daily number of active and enabled users of Copilot for Microsoft 365 for a specified time period."
+
+ms.localizationpriority: medium
+++
+# reportRoot: getMicrosoft365CopilotUserCountTrend
+
+Namespace: microsoft.graph
++
+Get the trend in the daily number of active and enabled users of Copilot for Microsoft 365 for a specified time period.
++
+## 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": "reportroot_getmicrosoft365copilotusercounttrend" } -->
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /reports/getMicrosoft365CopilotUserCountTrend(period='{period_value}')
+```
+
+## Function parameters
+In the request URL, provide the following query parameters with values.
+
+|Parameter|Type|Description|
+|:|:|:|
+|period|String|The number of previous days over which to report aggregated usage. The supported values are: `D7`, `D30`, `D90`, `D180`, `ALL`. The first four values follow the format Dn where n represents the number of days over which to aggregate data. `ALL` indicates to report usage for 7, 30, 90, and 180 days.|
+
+## Optional query parameters
+
+This method supports the `$format` [OData query parameter](/graph/query-parameters) to customize the response. The default output type is `application/json`. However, if you want to specify the output type, you can use the OData `$format` query parameter to set the default output to `text/csv` or `application/json`.
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+### CSV
+
+If successful, this method returns a `302 Found` response that redirects to a preauthenticated download URL for the report. That URL can be found in the `Location` header in the response.
+
+Preauthenticated download URLs are only valid for a short period of time (a few minutes) and don't require an `Authorization` header.
+
+The CSV file has the following headers for columns.
+
+- Report Refresh Date
+- Report Period
+- Report Date
+- Any App Enabled Users
+- Any App Active Users
+- Microsoft Teams Enabled Users
+- Microsoft Teams Active Users
+- Word Enabled Users
+- Word Active Users
+- PowerPoint Enabled Users
+- PowerPoint Active Users
+- Outlook Enabled Users
+- Outlook Active Users
+- Excel Enabled Users
+- Excel Active Users
+- OneNote Enabled Users
+- OneNote Active Users
+- Loop Enabled Users
+- Loop Active Users
+- Copilot Chat Enabled Users
+- Copilot Chat Active Users
+
+### JSON
+
+If successful, this method returns a `200 OK` response code and a JSON object in the response body.
+
+## Examples
+
+### Example 1: CSV output
+
+The following example outputs a URL to a CSV file.
+
+#### Request
+
+The following example shows a request.
+<!-- {
+ "blockType": "request",
+ "name": "reportroot_getmicrosoft365copilotusercounttrend_csv"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/reports/getMicrosoft365CopilotUserCountTrend(period='D7')?$format=text/csv
+```
+
+#### Response
+
+The following example shows the response.
+
+<!-- { "blockType": "response" } -->
+``` http
+HTTP/1.1 302 Found
+Content-Type: text/plain
+Location: https://reports.office.com/data/download/JDFKdf2_eJXKS034dbc7e0t__XDe
+```
+
+The CSV file in the `Location` header of the 302 response has the following schema.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Edm.Stream"
+}
+-->
+```http
+HTTP/1.1 200 OK
+Content-Type: application/octet-stream
+
+Report Refresh Date,Report Period,Report Date,Any App Enabled Users,Any App Active Users,Microsoft Teams Enabled Users,Microsoft Teams Active Users,Word Enabled Users,Word Active Users,PowerPoint Enabled Users,PowerPoint Active Users,Outlook Enabled Users,Outlook Active Users,Excel Enabled Users,Excel Active Users,OneNote Enabled Users,OneNote Active Users,Loop Enabled Users,Loop Active Users,Copilot Chat Enabled Users,Copilot Chat Active Users
+```
+
+### Example 2: JSON output
+
+The following example returns JSON data.
+
+#### Request
+
+The following example shows a request.
+<!-- {
+ "blockType": "request",
+ "name": "reportroot_getmicrosoft365copilotusercounttrend_json"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/reports/getMicrosoft365CopilotUserCountTrend(period='D7')?$format=application/json
+```
+
+#### Response
+
+The following example shows the response.
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Edm.Stream"
+}
+-->
+```http
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 10747
+
+{
+ "value": [
+ {
+ "reportRefreshDate": "2024-08-20",
+ "reportPeriod": 7,
+ "adoptionByDate": [
+ {
+ "reportDate": "2024-08-20",
+ "anyAppEnabledUsers": 357584,
+ "anyAppActiveUsers": 94745,
+ "microsoftTeamsEnabledUsers": 357451,
+ "microsoftTeamsActiveUsers": 72272,
+ "wordEnabledUsers": 357451,
+ "wordActiveUsers": 6602,
+ "powerPointEnabledUsers": 357451,
+ "powerPointActiveUsers": 2231,
+ "outlookEnabledUsers": 357451,
+ "outlookActiveUsers": 11786,
+ "excelEnabledUsers": 357451,
+ "excelActiveUsers": 1712,
+ "oneNoteEnabledUsers": 357451,
+ "oneNoteActiveUsers": 492,
+ "loopEnabledUsers": 357451,
+ "loopActiveUsers": 340,
+ "copilotChatEnabledUsers": 357451,
+ "copilotChatActiveUsers": 26609
+ },
+ ]
+ }
+ ]
+}
+```
v1.0 Restorepoint Search https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/restorepoint-search.md
In the request body, supply a JSON representation of the following parameters.
If successful, this action returns a `200 OK` response code and a [restorePointSearchResponse](../resources/restorepointsearchresponse.md) object in the response body.
+> [!NOTE]
+> - Calls return a maximum of five restore points.
+> - You can include a maximum of 20 protection units in one request and the response won't be paginated.
+
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Example 1: Search request
Content-Type: application/json
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "restorepoint_search_artifactquery"
Content-Type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+++ #### Response The following example shows the response.
v1.0 Restoresessionbase Activate https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/restoresessionbase-activate.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Activate a draft [restoreSessionBase](../resources/restoresessionbase.md) object.
+Activate a draft [restoreSessionBase](../resources/restoresessionbase.md) object to restore a [protection unit](../resources/protectionunitbase.md).
+
+The following points apply to restoring a protection unit:
+
+- The SharePoint sites and OneDrive accounts being restored aren't locked in a ready-only state.
+- For SharePoint and OneDrive sites restored to new URLs, users don't have the same permissions they had to the original site. Only the global admin or SharePoint admin has permission to the restored site. However, for in-place or restores to the same URL, the permissions from the original site at the time of restoration are preserved.
+- Restoration of SharePoint site and OneDrive user content that was removed from the recycle bin isn't supported.
+- Mailboxes, OneDrive accounts, and SharePoint sites that are under legal or in-place holds can't be restored unless the legal hold is removes. To restore a SharePoint site under legal hold, you need to restore the site to a new URL.
+- Mailbox draft items aren't backed up and can't be restored.
+- A restore isn't performed if the current state of the mailbox is the same as the point in time you're trying to restore it to.
+- SharePoint sites and OneDrive accounts that are restored to a new URL have a read-only lock on that new URL until the restore completes. The global admin can still download documents or remove the read-only lock manually.
+- The global admin, SharePoint admin, or Exchange admin can initiate a restore of up to 1,000 SharePoint sites, 1,000 OneDrive users, and 1000 mailboxes queued in parallel at a time.
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
Don't supply a request body for this method.
If successful, this action returns a `200 OK` response code and a [restoreSessionBase](../resources/restoresessionbase.md) object in the response body.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Request
v1.0 Restoresessionbase Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/restoresessionbase-delete.md
Don't supply a request body for this method.
If successful, this method returns a `204 No Content` response code.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Request
v1.0 Restoresessionbase Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/restoresessionbase-get.md
Don't supply a request body for this method.
If successful, this method returns a `200 OK` response code and a [restoreSessionBase](../resources/restoresessionbase.md) object in the response body.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Request
v1.0 Security Auditcoreroot Post Auditlogqueries https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-auditcoreroot-post-auditlogqueries.md
You can specify the following properties when creating a **auditLogQuery**.
|filterEndDateTime|DateTimeOffset|End date of the date range in the query. Optional.| |recordTypeFilters|Collection(string) of microsoft.graph.security.auditLogRecordType|The operation type or types indicated by the record. The possible values are: `exchangeAdmin`, `exchangeItem`, `exchangeItemGroup`, `sharePoint`, `syntheticProbe`, `sharePointFileOperation`, `oneDrive`, `azureActiveDirectory`, `azureActiveDirectoryAccountLogon`, `dataCenterSecurityCmdlet`, `complianceDLPSharePoint`, `sway`, `complianceDLPExchange`, `sharePointSharingOperation`, `azureActiveDirectoryStsLogon`, `skypeForBusinessPSTNUsage`, `skypeForBusinessUsersBlocked`, `securityComplianceCenterEOPCmdlet`, `exchangeAggregatedOperation`, `powerBIAudit`, `crm`, `yammer`, `skypeForBusinessCmdlets`, `discovery`, `microsoftTeams`, `threatIntelligence`, `mailSubmission`, `microsoftFlow`, `aeD`, `microsoftStream`, `complianceDLPSharePointClassification`, `threatFinder`, `project`, `sharePointListOperation`, `sharePointCommentOperation`, `dataGovernance`, `kaizala`, `securityComplianceAlerts`, `threatIntelligenceUrl`, `securityComplianceInsights`, `mipLabel`, `workplaceAnalytics`, `powerAppsApp`, `powerAppsPlan`, `threatIntelligenceAtpContent`, `labelContentExplorer`, `teamsHealthcare`, `exchangeItemAggregated`, `hygieneEvent`, `dataInsightsRestApiAudit`, `informationBarrierPolicyApplication`, `sharePointListItemOperation`, `sharePointContentTypeOperation`, `sharePointFieldOperation`, `microsoftTeamsAdmin`, `hrSignal`, `microsoftTeamsDevice`, `microsoftTeamsAnalytics`, `informationWorkerProtection`, `campaign`, `dlpEndpoint`, `airInvestigation`, `quarantine`, `microsoftForms`, `applicationAudit`, `complianceSupervisionExchange`, `customerKeyServiceEncryption`, `officeNative`, `mipAutoLabelSharePointItem`, `mipAutoLabelSharePointPolicyLocation`, `microsoftTeamsShifts`, `secureScore`, `mipAutoLabelExchangeItem`, `cortanaBriefing`, `search`, `wdatpAlerts`, `powerPlatformAdminDlp`, `powerPlatformAdminEnvironment`, `mdatpAudit`, `sensitivityLabelPolicyMatch`, `sensitivityLabelAction`, `sensitivityLabeledFileAction`, `attackSim`, `airManualInvestigation`, `securityComplianceRBAC`, `userTraining`, `airAdminActionInvestigation`, `mstic`, `physicalBadgingSignal`, `teamsEasyApprovals`, `aipDiscover`, `aipSensitivityLabelAction`, `aipProtectionAction`, `aipFileDeleted`, `aipHeartBeat`, `mcasAlerts`, `onPremisesFileShareScannerDlp`, `onPremisesSharePointScannerDlp`, `exchangeSearch`, `sharePointSearch`, `privacyDataMinimization`, `labelAnalyticsAggregate`, `myAnalyticsSettings`, `securityComplianceUserChange`, `complianceDLPExchangeClassification`, `complianceDLPEndpoint`, `mipExactDataMatch`, `msdeResponseActions`, `msdeGeneralSettings`, `msdeIndicatorsSettings`, `ms365DCustomDetection`, `msdeRolesSettings`, `mapgAlerts`, `mapgPolicy`, `mapgRemediation`, `privacyRemediationAction`, `privacyDigestEmail`, `mipAutoLabelSimulationProgress`, `mipAutoLabelSimulationCompletion`, `mipAutoLabelProgressFeedback`, `dlpSensitiveInformationType`, `mipAutoLabelSimulationStatistics`, `largeContentMetadata`, `microsoft365Group`, `cdpMlInferencingResult`, `filteringMailMetadata`, `cdpClassificationMailItem`, `cdpClassificationDocument`, `officeScriptsRunAction`, `filteringPostMailDeliveryAction`, `cdpUnifiedFeedback`, `tenantAllowBlockList`, `consumptionResource`, `healthcareSignal`, `dlpImportResult`, `cdpCompliancePolicyExecution`, `multiStageDisposition`, `privacyDataMatch`, `filteringDocMetadata`, `filteringEmailFeatures`, `powerBIDlp`, `filteringUrlInfo`, `filteringAttachmentInfo`, `coreReportingSettings`, `complianceConnector`, `powerPlatformLockboxResourceAccessRequest`, `powerPlatformLockboxResourceCommand`, `cdpPredictiveCodingLabel`, `cdpCompliancePolicyUserFeedback`, `webpageActivityEndpoint`, `omePortal`, `cmImprovementActionChange`, `filteringUrlClick`, `mipLabelAnalyticsAuditRecord`, `filteringEntityEvent`, `filteringRuleHits`, `filteringMailSubmission`, `labelExplorer`, `microsoftManagedServicePlatform`, `powerPlatformServiceActivity`, `scorePlatformGenericAuditRecord`, `filteringTimeTravelDocMetadata`, `alert`, `alertStatus`, `alertIncident`, `incidentStatus`, `case`, `caseInvestigation`, `recordsManagement`, `privacyRemediation`, `dataShareOperation`, `cdpDlpSensitive`, `ehrConnector`, `filteringMailGradingResult`, `publicFolder`, `privacyTenantAuditHistoryRecord`, `aipScannerDiscoverEvent`, `eduDataLakeDownloadOperation`, `m365ComplianceConnector`, `microsoftGraphDataConnectOperation`, `microsoftPurview`, `filteringEmailContentFeatures`, `powerPagesSite`, `powerAppsResource`, `plannerPlan`, `plannerCopyPlan`, `plannerTask`, `plannerRoster`, `plannerPlanList`, `plannerTaskList`, `plannerTenantSettings`, `projectForTheWebProject`, `projectForTheWebTask`, `projectForTheWebRoadmap`, `projectForTheWebRoadmapItem`, `projectForTheWebProjectSettings`, `projectForTheWebRoadmapSettings`, `quarantineMetadata`, `microsoftTodoAudit`, `timeTravelFilteringDocMetadata`, `teamsQuarantineMetadata`, `sharePointAppPermissionOperation`, `microsoftTeamsSensitivityLabelAction`, `filteringTeamsMetadata`, `filteringTeamsUrlInfo`, `filteringTeamsPostDeliveryAction`, `mdcAssessments`, `mdcRegulatoryComplianceStandards`, `mdcRegulatoryComplianceControls`, `mdcRegulatoryComplianceAssessments`, `mdcSecurityConnectors`, `mdaDataSecuritySignal`, `vivaGoals`, `filteringRuntimeInfo`, `attackSimAdmin`, `microsoftGraphDataConnectConsent`, `filteringAtpDetonationInfo`, `privacyPortal`, `managedTenants`, `unifiedSimulationMatchedItem`, `unifiedSimulationSummary`, `updateQuarantineMetadata`, `ms365DSuppressionRule`, `purviewDataMapOperation`, `filteringUrlPostClickAction`, `irmUserDefinedDetectionSignal`, `teamsUpdates`, `plannerRosterSensitivityLabel`, `ms365DIncident`, `filteringDelistingMetadata`, `complianceDLPSharePointClassificationExtended`, `microsoftDefenderForIdentityAudit`, `supervisoryReviewDayXInsight`, `defenderExpertsforXDRAdmin`, `cdpEdgeBlockedMessage`, `hostedRpa`, `cdpContentExplorerAggregateRecord`, `cdpHygieneAttachmentInfo`, `cdpHygieneSummary`, `cdpPostMailDeliveryAction`, `cdpEmailFeatures`, `cdpHygieneUrlInfo`, `cdpUrlClick`, `cdpPackageManagerHygieneEvent`, `filteringDocScan`, `timeTravelFilteringDocScan`, `mapgOnboard`, `unknownFutureValue`. Optional.| |keywordFilter|String|Free text field to search non-indexed properties of the audit log. Optional.|
-|serviceFilter|String|The Office 365 service where the activity occurred. Optional.|
+|serviceFilter|String|Refers to the workload property in the audit record. This is the Microsoft service where the activity occurred. Optional.|
|operationFilters|String collection|The name of the user or admin activity. For a description of the most common operations/activities, see [Search the audit log in the Office 365 Protection Center](https://go.microsoft.com/fwlink/p/?LinkId=708432). Optional.| |userPrincipalNameFilters|String collection|The UPN (user principal name) of the user who performed the action (specified in the operation property) that resulted in the record being logged; for example, _my_name@my_domain_name_. Optional.| |ipAddressFilters|String collection|The IP address of the device that was used when the activity was logged. Optional.|
v1.0 Security Incident Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-incident-update.md
PATCH /security/incidents/{incidentId}
|assignedTo|String|Owner of the incident, or null if no owner is assigned. Free editable text.| |classification|microsoft.graph.security.alertClassification|The specification for the incident. Possible values are: `unknown`, `falsePositive`, `truePositive`, `informationalExpectedActivity`, `unknownFutureValue`.| |customTags|String collection|Array of custom tags associated with an incident.|
-|determination|microsoft.graph.security.alertDetermination|Specifies the determination of the incident. Possible values are: `unknown`, `apt`, `malware`, `securityPersonnel`, `securityTesting`, `unwantedSoftware`, `other`, `multiStagedAttack`, `compromisedUser`, `phishing`, `maliciousUserActivity`, `notMalicious`, `notEnoughDataToValidate`, `confirmedUserActivity`, `lineOfBusinessApplication`, `unknownFutureValue`.|
+|determination|microsoft.graph.security.alertDetermination|Specifies the determination of the incident. Possible values are: `unknown`, `apt`, `malware`, `securityPersonnel`, `securityTesting`, `unwantedSoftware`, `other`, `multiStagedAttack`, `compromisedAccount`, `phishing`, `maliciousUserActivity`, `notMalicious`, `notEnoughDataToValidate`, `confirmedUserActivity`, `lineOfBusinessApplication`, `unknownFutureValue`.|
|status|microsoft.graph.security.incidentStatus|The status of the incident. Possible values are: `active`, `resolved`, `redirected`, `unknownFutureValue`.| |summary|String|The overview of an attack. When applicable, the summary contains details of what occurred, impacted assets, and the type of attack.|
v1.0 Securityaction Cancelsecurityaction https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/securityaction-cancelsecurityaction.md
POST /security/securityActions/{id}/cancelSecurityAction
| Name | Description | |:--|:--|
-| Authorization | Bearer {code} |
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Securityaction Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/securityaction-get.md
This method supports some of the OData query parameters to help customize the re
| Name |Description| |:-|:-|
-| Authorization | Bearer {code} |
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Securityactions List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/securityactions-list.md
This method supports some of the OData query parameters to help customize the re
| Name |Description| |:-|:-|
-| Authorization | Bearer {code} |
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Securityactions Post https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/securityactions-post.md
POST /security/securityActions
| Name | Description | |:--|:--|
-| Authorization | Bearer {code} |
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Serviceapp Activate https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceapp-activate.md
You can specify the following properties you activate a **serviceApp**.
If successful, this action returns a `202 Accepted` response code and a [serviceApp](../resources/serviceapp.md) object in the response body.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Request
v1.0 Serviceprincipal List Owners https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-list-owners.md
Title: "servicePrincipals: List owners"
+ Title: "List owners of a service principal"
description: "Retrieve a list of owners of the servicePrincipal." ms.localizationpriority: high doc_type: apiPageType
-# servicePrincipals: List owners
+# List owners of a service principal
Namespace: microsoft.graph
Choose the permission or permissions marked as least privileged for this API. Us
[!INCLUDE [limited-info](../../includes/limited-info.md)] -- ## HTTP request <!-- { "blockType": "ignored" } --> ```http GET /servicePrincipals/{id}/owners ``` ## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+This method supports the `$count`, `$expand`, `$filter`, `$orderby`, `$search`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. Some queries are supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on directory objects](/graph/aad-advanced-queries).
## Request headers | Name | Description |
If successful, this method returns a `200 OK` response code and a collection of
The following example shows a request.
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "serviceprincipal_get_owners" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/servicePrincipals/{id}/owners
+GET https://graph.microsoft.com/beta/serviceprincipals(appId='bbec3106-565f-4907-941e-96b4dbfef21c')/owners
```
-# [C#](#tab/csharp)
-
-# [CLI](#tab/cli)
-
-# [Go](#tab/go)
-
-# [Java](#tab/java)
-
-# [JavaScript](#tab/javascript)
-
-# [PHP](#tab/php)
-
-# [PowerShell](#tab/powershell)
-
-# [Python](#tab/python)
--- ### Response The following example shows the response.
HTTP/1.1 200 OK
Content-type: application/json {
- "value": [
- {
- "id": "id-value"
- }
- ]
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#directoryObjects",
+ "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET servicePrincipals(appId=<key>)/owners?$select=deletedDateTime",
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.user",
+ "id": "ce4770b3-70b2-4a38-a242-76631e9f7408",
+ "accountEnabled": null,
+ "city": null,
+ "createdDateTime": null,
+ "displayName": null,
+ "mail": null,
+ "mailNickname": null,
+ "otherMails": [],
+ "proxyAddresses": [],
+ "surname": null,
+ "userPrincipalName": null,
+ "userType": null
+ },
+ {
+ "@odata.type": "#microsoft.graph.user",
+ "id": "858a9c90-38b3-4e78-b915-234aece712c4"
+ },
+ {
+ "@odata.type": "#microsoft.graph.user",
+ "id": "7585d967-f300-43de-b817-7119a6404c5e"
+ }
+ ]
} ```
v1.0 Serviceprincipal Put Claimspolicy https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-put-claimspolicy.md
Namespace: microsoft.graph
Create a new [customClaimsPolicy](../resources/customclaimspolicy.md) object if it doesn't exist, or replace an existing one. + ## 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).
Content-Type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+ # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/create-customclaimspolicy-from--javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ ### Response
v1.0 Sharepointprotectionpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/sharepointprotectionpolicy-update.md
To remove a **siteProtectionUnit** from the policy, specify the `@removed` annot
If successful, this method returns a `200 OK` response code and an updated [sharePointProtectionPolicy](../resources/sharepointprotectionpolicy.md) in the response body.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Request
v1.0 Sharepointrestoresession List Siterestoreartifacts https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/sharepointrestoresession-list-siterestoreartifacts.md
Don't supply a request body for this method.
If successful, this method returns a `200 OK` response code and a collection of [siteRestoreArtifact](../resources/siterestoreartifact.md) objects in the response body.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Request
v1.0 Sharepointrestoresession Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/sharepointrestoresession-update.md
PATCH /solutions/backupRestore/sharePointRestoreSessions/{sharePointRestoreSessi
If successful, this method returns a `200 OK` response code and an updated [sharePointRestoreSession](../resources/sharepointrestoresession.md) object in the response body.
+For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes).
+ ## Examples ### Request
The following example shows a request.
To remove a **siteRestoreArtifact** from a site restore session, specify the @removed annotation in the request body for the respective restore point artifact together with the ID of the [siteRestoreArtifact](../resources/siterestoreartifact.md).
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "sharepointrestoresession_update"
Content-Type: application/json
} ```
-# [C#](#tab/csharp)
-
-# [CLI](#tab/cli)
-
-# [Java](#tab/java)
-
-# [JavaScript](#tab/javascript)
-
-# [PHP](#tab/php)
-
-# [PowerShell](#tab/powershell)
-
-# [Python](#tab/python)
--- ### Response The following example shows the response.
v1.0 Synchronization Serviceprincipal Put Synchronization https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/synchronization-serviceprincipal-put-synchronization.md
PUT /servicePrincipals/{id}/synchronization/secrets
## Request headers | Name | Description| |:|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body In the request body, provide a JSON object with the following parameters.
v1.0 Synchronization Synchronizationjob Validatecredentials https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/synchronization-synchronizationjob-validatecredentials.md
POST /servicePrincipals/{id}/synchronization/jobs/{id}/validateCredentials
## Request headers | Name | Description| |:|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body In the request body, provide a JSON object with the following parameters.
v1.0 Synchronization Synchronizationschema Parseexpression https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/synchronization-synchronizationschema-parseexpression.md
POST /servicePrincipals/{id}/synchronization/templates/{id}/schema/parseExpressi
## Request headers | Name | Description| |:|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body In the request body, provide a JSON object with the following parameters.
v1.0 Team Archive https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/team-archive.md
Title: "Archive team" description: "Archive the specified team. "-+ ms.localizationpriority: medium doc_type: apiPageType
v1.0 Team Clone https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/team-clone.md
Title: "team: clone" description: "Create a copy of a team. This operation also creates a copy of the corresponding group."-+ ms.localizationpriority: medium doc_type: apiPageType
v1.0 Team Delete Members https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/team-delete-members.md
Title: "Remove member from team" description: "Remove a conversationMember from a team."-+ ms.localizationpriority: high doc_type: apiPageType
v1.0 Team Get Primarychannel https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/team-get-primarychannel.md
Title: "Get primaryChannel" description: "Retrieve the navigation property of a team that allows access to its default General channel."-+ ms.localizationpriority: high doc_type: apiPageType
v1.0 Team Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/team-get.md
Title: "Get team" description: "Retrieve the properties and relationships of the specified team."-+ ms.localizationpriority: high doc_type: apiPageType
v1.0 Team Post Members https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/team-post-members.md
Title: "Add member to team" description: "Add a new member to a team."-+ ms.localizationpriority: high doc_type: apiPageType
v1.0 Team Put Teams https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/team-put-teams.md
Title: "Create team from group" description: "Create a new team from a group."-+ ms.localizationpriority: high doc_type: apiPageType
v1.0 Team Unarchive https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/team-unarchive.md
Title: "Unarchive team" description: "Restore an archived team and restores users' ability to send messages and edit the team, abiding by tenant and team settings. Teams are archived using the archive API." ms.localizationpriority: medium-+ doc_type: apiPageType
v1.0 Team Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/team-update.md
Title: "Update team" description: "Update the properties of the specified team."-+ ms.localizationpriority: medium doc_type: apiPageType
v1.0 Teamsapp Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/teamsapp-delete.md
Title: "Delete teamsApp" description: "Delete an app from an organization's app catalog (the tenant app catalog)." ms.localizationpriority: medium-+ doc_type: apiPageType
You can also use this API to remove a submitted app from the review process.
## 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).
->**Note:** Only global administrators can call this API.
+> [!NOTE]
+> - The Directory.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission and avoid using this permissions going forward.
+> - You can only use the AppCatalog.Submit permission to delete app definitions in review.
+> - Only global administrators can call this API.
+
+Permissions for the following HTTP request:
+
+<!-- { "blockType": "ignored" } -->
+```http
+DELETE /appCatalogs/teamsApps/{id}
+```
-<!-- { "blockType": "permissions", "name": "teamsapp_delete" } -->
+<!-- {
+ "blockType": "permissions",
+ "name": "teamsapp_delete",
+ "requestUrls": ["DELETE /appCatalogs/teamsApps/{id}"]
+ } -->
[!INCLUDE [permissions-table](../includes/permissions/teamsapp-delete-permissions.md)]
-> [!NOTE]
-> - The Directory.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward.
-> - You can only use the AppCatalog.Submit permission to delete app definitions in review.
+Permissions for the following HTTP request:
+
+<!-- { "blockType": "ignored" } -->
+```http
+DELETE /appCatalogs/teamsApps/{appId}/appDefinitions/{appDefinitionId}
+```
+<!-- {
+ "blockType": "permissions",
+ "name": "teamsapp_delete_2",
+ "requestUrls": ["DELETE /appCatalogs/teamsApps/{appId}/appDefinitions/{appDefinitionId}"]
+ } -->
+ ## HTTP request
v1.0 Teamsapp Publish https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/teamsapp-publish.md
Title: "Publish teamsApp" description: "Publish an app to the Microsoft Teams app catalog."-+ ms.localizationpriority: medium doc_type: apiPageType
Choose the permission or permissions marked as least privileged for this API. Us
[!INCLUDE [permissions-table](../includes/permissions/teamsapp-publish-permissions.md)] > [!NOTE]
-> The Directory.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward.
+>
+> * The `Directory.ReadWrite.All` permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward.
+> * The `AppCatalog.Submit` permission allows you to submit apps for review only, not to publish them to the catalog.
## HTTP request
Each app in the app catalog must have a unique manifest ID.
If successful, this method returns a `200 OK` response code and a [teamsApp](../resources/teamsapp.md) object. If the app manifest has any validation errors, the request returns an error response with details about the schema errors.
+### Error response
+
+If you send a request to upload an app manifest that contains missing information or errors, you receive an error message that includes the inner error code `UnableToParseTeamsAppManifest`. The **details** property of the inner error contains the error code and the error message. The following table describes the error codes that you might encounter.
+
+<br>
+<details><summary>Error response</summary>
+
+| Error code | Error message | Description |
+| :- | - | - |
+|`Serialization_FileNotValidJson`| The file couldn't be parsed as a JSON object.| The submitted file didn't comply with a valid JSON format. |
+|`Serialization_FileMissing`| The file {0} couldn't be found in the app package.| The expected file is missing in the app package.|
+|`Serialization_TrailingCommaInManifestJsonFile`| Manifest json file contains trailing comma.| The app manifest file contains a trailing comma.|
+|`SchemaError_MultipleOf`| Integer {0} isn't a multiple of {1}.| The app manifest file failed the `multipleOf` validation of the schema. Here, {0} represents the integer value and {1} indicates the required multiple. |
+|`SchemaError_Maximum`| Integer {0} exceeds maximum value of {1}.| The app manifest file failed the `maximum` validation of the schema. Here, {0} represents the value that exceeds the maximum limit and {1} represents the maximum limit. |
+|`SchemaError_Minimum`| Integer {0} is less than minimum value of {1}.|The app manifest file failed the `minimum` validation of the schema. Here, {0} represents the value that exceeds the minimum limit and {1} represents the minimum limit.|
+|`SchemaError_MaximumLength`| String {0} exceeds maximum length of {1}.| The app manifest file failed the `maximumLength` validation of the schema. Here, {0} represents the string that exceeds the maximum length and {1} represents the maximum length.|
+|`SchemaError_MinimumLength`| String {0} is less than minimum length of {1}. | The app manifest file failed the `minimumLength` validation of the schema. Here, {0} represents the string that is less than the minimum length and {1} represents the minimum.|
+|`SchemaError_Pattern`| String {0} doesn't match regex pattern "{1}". | The app manifest file failed the `pattern` validation of the schema. Here, {0} represents the value that doesn't match the pattern and {1} represents the expected pattern.|
+|`SchemaError_ContentEncoding`| String {0} doesn't validate against content encoding {1}.| The app manifest file failed the `contentEncoding` validation of the schema. Here, {0} represents the string that doesn't match content encoding and {1} represents the expected content encoding.|
+|`SchemaError_Format`| String {0} doesn't validate against format {1}.| The app manifest file failed the `format` validation of the schema. Here, {0} represents the string that isn't in the expected format and {1} represents the expected format.|
+|`SchemaError_Type`| Value {0} isn't of the expected type {1}.| The app manifest file failed the `type` validation of the schema. Here, {0} represents the string that isn't in the expected type and {1} represents the expected type.|
+|`SchemaError_AdditionalItems`| The schema doesn't allow additional items.| The app manifest file failed the `additionalItems` validation of the schema.|
+|`SchemaError_MaximumItems`| Array item count {0} exceeds maximum count of {1}.| The app manifest file failed the `maximumItems` validation of the schema. Here, {0} represents the number of elements in the array and {1} represents the maximum allowed.|
+|`SchemaError_MinimumItems`| Array item count {0} is less than minimum count of {1}.| The app manifest file failed the `minimumItems` validation of the schema. Here, {0} represents the number of elements in the array and {1} represents the minimum allowed.|
+|`SchemaError_UniqueItems`| Array contains items that aren't unique.| The app manifest file failed the `uniqueItems` validation of the schema.|
+|`SchemaError_MaximumProperties`| Object property count {0} exceeds maximum count of {1}.| The app manifest file failed the `maximumProperties` validation of the schema. Here, {0} represents the number of properties provided and {1} represents the maximum allowed properties.|
+|`SchemaError_MinimumProperties`| Object property count {0} is less than minimum count of {1}.|The app manifest file failed the `minimumProperties` validation of the schema. Here, {0} represents the number of properties provided and {1} represents the minimum allowed properties.|
+|`SchemaError_Required`| Required properties are missing from object: {0}.| The app manifest file failed the `required` validation of the schema. Here, {0} represents the required properties. |
+|`SchemaError_AdditionalProperties`| Property {0} hasn't been defined and the schema doesn't allow additional properties.| The app manifest file failed the `additionalProperties` validation of the schema. Here, {0} represents the additional property.|
+|`SchemaError_Dependencies`|Dependencies for property {0} failed. Missing required keys.| The app manifest file failed the `dependencies` validation of the schema. Here, {0} represents the property that failed.|
+|`SchemaError_Enum`| Value {0} isn't defined in the enum.| The app manifest file failed the `enum` validation of the schema. Here, {0} represents the value that isn't in the enum.|
+|`SchemaError_AllOf`| JSON doesn't match all schemas from "allOf".| The app manifest file failed the `allOf` validation of the schema.|
+|`SchemaError_AnyOf`| JSON doesn't match any schemas from "anyOf".| The app manifest file failed the `anyOf` validation of the schema.|
+|`SchemaError_OneOf`| JSON is valid against more than one schema from "oneOf".| The app manifest file failed the `oneOf` validation of the schema.|
+|`SchemaError_Not`| JSON is valid against schema from "not".| The app manifest file failed the `not` validation of the schema.|
+|`SchemaError_Id`| Duplicate schema ID {0} encountered.| The app manifest file failed the `id` validation of the schema. Here, {0} represents the `id` of the schema.|
+|`SchemaError_PatternProperties`| Couldn't test property names with regex pattern "{0}".| The app manifest file failed the `patternProperties` validation of the schema. Here, {0} represents the pattern for the properties.|
+|`SchemaError_Valid`| Schema always fails validation.| The app manifest file failed the `valid` validation of the schema.|
+|`SchemaError_Const`| Value {0} doesn't match constant {1}.| The app manifest file failed the `const` validation of the schema. Here, {0} represents the value that failed and {1} represents the correct value.|
+|`SchemaError_Contains`| Array doesn't contain a required item.| The app manifest file failed the `contains` validation of the schema.|
+|`SchemaError_Then`|JSON doesn't match schema from "then".| The app manifest file failed the `then` validation of the schema.|
+|`SchemaError_Else`| JSON doesn't match schema from "else".|The app manifest file failed the `else` validation of the schema.|
+| `SchemaError_Other`| The value doesn't conform to the schema for this property.| The app manifest file failed other unhandled validations of the schema.|
+|`ActivityGroupIdFromActivitiesTypeValidation` | ActivityGroupId field in ActivityType must be a subset of ID field in ActivityGroup.| The `ActivityGroupId` field in `ActivityType` isn't a subset of the `Id` field in `ActivityGroup` in the app manifest.|
+|`ActivityTypesMustExistWithActivitiesGroupValidation` | Manifest shouldn't contain Activity Group when Activity Types is missing.| The `ActivityGroup` property is available, but the `ActivityType` property is missing in the app manifest.|
+|`ApiSecretServiceAuthTypeComposeExtensionContainsMsftEntraConfiguration`|API-based compose extension with apiSecretServiceAuth authType have microsoftEntraConfiguration defined.| The API-based compose extension has `microsoftEntraConfiguration` defined in the app manifest.|
+|`ApiSecretServiceAuthTypeComposeExtensionContainsNoApiSecretRegistrationId`| API-based compose extension with apiSecretServiceAuth authType have no apiSecretRegistrationId defined.| The API-based compose extension with `apiSecretServiceAuth` authType without `apiSecretRegistrationId` defined in the app manifest.|
+|`ApiSecretServiceAuthTypeComposeExtensionContainsNoApiSecretServiceAuthConfiguration` | API-based compose extension with apiSecretServiceAuth authType have no apiSecretServiceConfiguration.| The API-based compose extension doesn't set `supportsSingleSignOn` to `true` in the app manifest.|
+|`ApiBasedComposeExtensionManifestCommandIdsNotIncludedInOperationIdsOnApiSpecficationFile`| Command Ids on manifest aren't included in Operation Ids on API specification file.| The error that occurs when the `Command Ids` in the app manifest aren't included in `Operation Ids` on API specification file.|
+|`ApiBasedComposeExtensionWithBotId`| API-based compose extension can't have botId defined.| The API-based compose extension has `botId` defined in the app manifest.|
+|`ApiBasedComposeExtensionWithCanUpdateConfiguration`|API-based compose extension can't have canUpdateConfiguration defined on manifest.| The API-based compose extension has `canUpdateConfiguration` defined in the app manifest.|
+|`ApiBasedComposeExtensionWithNoParameter`| API-based compose extension must have command parameters defined on manifest.| The API-based compose extension doesn't have any command parameters defined in the app manifest.|
+|`ApiBasedComposeExtensionApiResponseRenderingTemplateFileNullOrEmpty`| API-based compose extension must have apiResponseRenderingTemplateFile defined on manifest.| The API-based compose extension doesn't have the `apiResponseRenderingTemplateFile` defined in the app manifest.|
+|`ApiBasedComposeExtensionApiSpecificationFileNullOrEmpty`| API-based compose extension must have apiSpecificationFile defined on manifest. | The API-based compose extension doesn't have the `apiSpecificationFile` defined in the app manifest.|
+|`MsftEntraAuthTypeComposeExtensionContainsApiSecretServiceConfiguration`|API-based compose extension with microsoftEntra authType have apiSecretServiceConfiguration defined. |The API-based compose extension has `apiSecretServiceConfiguration` defined in the manifest.|
+|`MsftEntraAuthTypeComposeExtensionContainsNoMsftEntraConfiguration`|API-based compose extension with microsoftEntra authType have no microsoftEntraConfiguration defined.| The API-based compose extension doesn't have `microsoftEntraConfiguration` defined in the app manifest.|
+|`MsftEntraAuthTypeComposeExtensionWebApplicationInfoOrResourceNotDefined`|API-based compose extension with microsoftEntra authType have no webApplicationInfo or resource defined on manifest.| The API-based compose extension with `microsoftEntra` authType doesn't have `webApplicationInfo` or `resource` defined in the app manifest.|
+|`MsftEntraAuthTypeComposeExtensionResourceURLNotMatchServerURLOnApiSpec` |API-based compose extension with microsoftEntra authType resource URL on manifest doesn't match server URL on API specification file.| The API-based compose extension with `microsoftEntra` authType resource URL in the app manifest doesn't match server URL in the API specification file.|
+|`NoAuthTypeComposeExtensionContainsAuthConfiguration` |API-based compose extension with none authType have auth-related configuration defined.| The API-based compose extension with authType `microsoftEntraConfiguration` or `apiSecretServiceConfiguration` isn't defined in the app manifest.|
+|`ApiSpecificationFileContainUnsupportedHttpMethod`| API-based compose extension have server urls that have unsupported http method defined on apiSpecificationFile. Currently only GET and POST are supported.| The API-based compose extension has an unsupported `http` method defined in the `apiSpecificationFile`.|
+|`ApiSpecificationFileRequiredParameterContainUnsupportedLocation`| API-based compose extension have unsupported parameter location defined on apiSpecificationFile for {0}. Currently only path and query supported.| The API-based compose extension has an unsupported parameter location defined in the `apiSpecificationFile`.|
+|`ApiSpecificationFileRequestBodyContainUnsupportedMediaType`|API-based compose extension have unsupported media type defined in request body on apiSpecificationFile. Currently only application/json is supported.| The API-based compose extension has an unsupported `media` type defined in request body in the `apiSpecificationFile`.|
+|`ApiSpecificationFileRequestBodyContainUnsupportedSchemaType`| API-based compose extension have unsupported schema type defined in request body on apiSpecificationFile. Currently arrays aren't supported.| The API-based compose extension has an unsupported schema type defined in request body in the `apiSpecificationFile`.|
+|`ApiSpecificationFileRequestBodySchemaContainKeywords` | API-based compose extension have keywords.|The API-based compose extension has keywords defined in request body in the `apiSpecificationFile`.|
+|`ApiSpecificationFileRequiredParameterOrPropertyNotDefinedOnManifest`| API-based compose extension have required parameters or properties {0} not defined on manifest.| The API-based compose extension has a `required` parameter, which isn't defined in the app manifest.|
+|`ApiSpecificationFileResponseContainUnsupportedMediaType`| API-based compose extension have unsupported media type defined in response on apiSpecificationFile. Currently only application/json supported. | The API-based compose extension has an unsupported `media` type defined in response in the `apiSpecificationFile`.|
+|`ApiSpecificationFileServerUrlsContainHttp`| API-based compose extension have server urls that have http protocol defined on apiSpecificationFile.| The API-based compose extension has server urls that contain `http` protocol in the `apiSpecificationFile`.|
+|`ApiSpecificationFileServerUrlsContainInvalidUrl`| API-based compose extension have server urls that are invalid URL defined on apiSpecificationFile.| The API-based compose extension has an `invalid` URL defined in the `apiSpecificationFile`.|
+|`ServerUrlsMissingOnApiSpecificationFile`| API-based compose extension have no server urls defined on apiSpecificationFile.| The error that occurs The API-based compose extension has no server urls defined in the `apiSpecificationFile`.|
+|`BotBasedComposeExtensionApiResponseRenderingTemplateFileExists` |Bot based compose extension can't have apiResponseRenderingTemplateFile defined.|The bot-based compose extension has an `apiResponseRenderingTemplateFile` property defined in the app manifest.|
+|`BotBasedComposeExtensionApiSpecificationFileExists` |Bot based compose extension can't have apiSpecificationFile defined.|The bot-based compose extension has an API specification file defined in the app manifest.|
+|`BotBasedComposeExtensionBotIdNotGuid` |Bot based compose extension must have GUID botId.| The bot-based compose extension `botId` isn't GUID.|
+|`CommonAppIdIsNotGuid`| Field 'ID' isn't a Guid in the manifest.| The `appId` isn't GUID.|
+|`CommonAppIdIsRequiredField`| Required field 'ID' is missing in the manifest.| The `appId` isn't provided.|
+|`CommonManifestVersionIsRequiredField`|The required field in manifest 'manifest Version' is missing.| The manifest version isn't provided.|
+|`CommonSchemaUrlIsRequiredField`| Schema URL must be present.| The schema isn't provided.|
+|`DashboardCardBothIconNameAndUrlPresent`| Dashboard cards icon shouldn't contain both icon name and URL.| Dashboard cards icon mustn't contain both icon name and URL.|
+|`DashboardCardEntityIdsAreNotUnique`| Dashboard card entity IDs should be unique.| The returned entity Id for a dashboard card isn't unique within the manifest.|
+|`DeveloperNameIsRequiredField`| Required field 'developer name' is missing in the manifest.| The developer name isn't provided.|
+|`DeveloperNameLengthCheck`| Maximum character length must not exceed 32 chars.| The developer name is more than 32 characters long.|
+|`DeveloperPrivacyUrlIsRequiredField`| Required field 'privacyUrl' is missing in the manifest.| The `privacyUrl` is missing in the app manifest. |
+|`DeveloperPrivacyUrlMustBeHttps`| Privacy URL must be secured Support URL (HTTPS).| The developer privacy URL didn't use HTTPS.|
+|`DeveloperTermsOfUseUrlIsRequiredField`| Required field 'termsOfUseUrl' is missing in the manifest.| The **termsOfUseUrl** is missing from the manifest.|
+|`DeveloperTermsOfUseUrlMustBeHttps`|Terms Of Use URL must be secured Support URL (HTTPS).| The developer terms of use URL didn't use HTTPS.|
+|`DeveloperWebsiteUrlIsRequiredField`| Required field 'websiteUrl' is missing in the manifest.| The developer website URL is missing.|
+|`DeveloperWebsiteUrlMustBeHttps`| Website URL must be secured Support URL (HTTPS).| The developer website URL didn't use HTTPS.|
+|`UniqueActivityTypeInActivitiesValidation` |Manifest shouldn't contain duplicate Activity Type.| The activity type isn't unique in the app manifest.|
+|`UniqueIdInActivitiesGroupValidation` |Manifest shouldn't contain duplicate ID in Activity Groups.| The activity group ID isn't unique in the app manifest.|
+|`FullDescriptionCannotBeEmpty` |Full Description can't be empty.| The full description is empty.|
+|`FullDescriptionLengthCheck`| Maximum character length for long description must not exceed 4,000 chars.| The full description length is more than 4,000 characters.|
+|`GroupChatForBotsLessThanV13`| Please upgrade the version of manifest to V1.3 as group chat bot is supported in manifest v1.3 onwards.| The `groupChat` scope for bots isn't supported in the app manifest version 1.3 and below.|
+|`GroupChatForConfigurableTabsLessThanV13`| Please upgrade the version of manifest to V1.3 as group chat configurable tabs is supported in manifest v1.3 onwards.|The `groupChat` scope for configurable tabs isn't supported in the app manifest version 1.3 and below.|
+|`InvalidColor32x32IconHeightAndWidth`|Color 32x32 icon should be 32x32 with only white and transparent.| The color 32x32 icon doesn't have the correct dimensions.|
+|`InvalidColorIconHeightAndWidth`| Color Icon isn't as per the required dimension.| The dimensions of the color icon are incorrect.|
+|`InvalidOutlineIconHeightAndWidth` | Small icon should be 32x32 with only white and transparent.| The dimensions of the outline icon are incorrect.|
+|`ParameterOnManifestNotDefinedOnApiSpecFile` | API-based compose extension have parameters {0} on manifest not defined on API specification file.| The API-based compose extension parameters in the app manifest aren't defined in the API specification file. |
+|`ReservedActivitiesValidation`| Manifest shouldn't contain reserved Activity Type 'systemDefault'.| The `systemDefault` activity type is defined in the app manifest.|
+|`ReservedStaticTabNameShouldBeNull`| Reserved tab "Name" property shouldn't be specified.| The reserved `staticTabs` name property was specified.|
+|`ShortDescriptionCannotBeEmpty`| Short Description canΓÇÖt be empty| The short description was empty.|
+|`ShortDescriptionLengthCheck`|Maximum character length for short description must not exceed 80 chars.| The short description is more than 80 characters long.|
+|`ShortNameEqualsReservedName`|Short name of the app can't be reserved name.| The short name is a reserved name.|
+|`ShortNameIsRequiredField`| Short name of the app can't be empty.| The short name is empty.|
+|`StaticTabNameCouldNotBeEmpty`| Non-reserved staticTabs "Name" property can't be empty.| The `staticTabs` name property is empty.|
+|`BotIdIsNotGuid`| BotId isn't a Guid value.|The `BotId` value in the app manifest isn't a GUID.|
+|`VersionCannotBeEmpty`| Required field "version" is missing in the manifest.| The app package version is missing.|
+|`VersionContainsOnlyNumbersDotSeparated`| App version supports only numbers in the '#.#.#' format.| The version in the app package isn't matched by the pattern, `#.#.#`.|
+|`VersionHasMajorLessThan1`|App version shouldn't start with '0'. Ex: 0.0.1 or 0.1 aren't valid app versions and 1.0 / 1.5.1 / 1.0.0 / 2.5.0 are valid app versions. In case of new update in manifest to an existing app in store. | The app version is less than 1.0. You need to upgrade your app version. For example, if the current version of your app in the store is 1.0 and youΓÇÖre submitting an update for validation, the app version must be higher than 1.0.|
+|`ShortNameLengthCheck` |Maximum character length for Short Name must not exceed 30 chars.|The short name exceeds 30 characters.|
+|`ApiSpecificationFileParameterContainUnsupportedSchemaType` |API-based compose extension have unsupported parameter schema type defined on apiSpecificationFile.Arrays aren't supported.|The API-based compose extension has an unsupported parameter schema type defined in the `apiSpecificationFile`.|
+
+</details>
+ ## Examples ### Example 1: Publish an app to the app catalog
v1.0 Teamsapp Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/teamsapp-update.md
Title: "Update teamsApp" description: "Update an app previously published to the Microsoft Teams app catalog."-+ ms.localizationpriority: medium doc_type: apiPageType
v1.0 Tiindicator Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/tiindicator-delete.md
DELETE /security/tiIndicators/{id}
| Name | Description | |:--|:--|
-| Authorization | Bearer {code} |
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Tiindicator Deletetiindicators https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/tiindicator-deletetiindicators.md
POST /security/tiIndicators/deleteTiIndicators
| Name | Description | |:--|:--|
-| Authorization | Bearer {code} |
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Tiindicator Deletetiindicatorsbyexternalid https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/tiindicator-deletetiindicatorsbyexternalid.md
POST /security/tiIndicators/deleteTiIndicatorsByExternalId
| Name | Description | |:--|:--|
-| Authorization | Bearer {code} |
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Tiindicator Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/tiindicator-get.md
This method supports some of the OData query parameters to help customize the re
| Name |Description| |:-|:-|
-| Authorization | Bearer {code} |
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Tiindicator Submittiindicators https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/tiindicator-submittiindicators.md
POST /security/tiIndicators/submitTiIndicators
| Name | Description | |:--|:--|
-| Authorization | Bearer {code} |
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Tiindicator Updatetiindicators https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/tiindicator-updatetiindicators.md
POST /security/tiIndicators/updateTiIndicators
| Name | Description | |:--|:--|
-| Authorization | Bearer {code} |
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Tiindicators List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/tiindicators-list.md
This method supports some of the OData query parameters to help customize the re
| Name |Description| |:-|:-|
-| Authorization | Bearer {code} |
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Tiindicators Post https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/tiindicators-post.md
POST /security/tiIndicators
| Name | Description | |:--|:--|
-| Authorization | Bearer {code} |
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 User Assignlicense https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-assignlicense.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Add or remove licenses for the user to enable or disable their use of Microsoft cloud offerings that the company has licenses to. For example, an organization can have a Microsoft 365 Enterprise E3 subscription with 100 licenses, and this request assigns one of those licenses to a specific user. You can also enable and disable specific plans associated with a subscription.
+Add or remove licenses for the user to enable or disable their use of Microsoft cloud offerings that the company has licenses to. For example, an organization can have a Microsoft 365 Enterprise E3 subscription with 100 licenses, and this request assigns one of those licenses to a specific user. You can also enable and disable specific plans associated with a subscription. Direct user licensing is an alternative to [group-based licensing](../api/group-assignlicense.md).
To get the subscriptions available in the directory, perform a [GET subscribedSkus request](subscribedsku-list.md).
v1.0 User Changepassword https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-changepassword.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Enable the user to update their password. Any user can update their password without belonging to any administrator role.
+Update the signed-in [user's](../resources/user.md) password. Any user can update their password without belonging to any administrator role.
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
v1.0 User Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-delta.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get newly created, updated, or deleted users without having to perform a full read of the entire user collection. See [change tracking](/graph/delta-query-overview) for details.
+Get newly created, updated, or deleted users without having to perform a full read of the entire [user](../resources/user.md) collection. See [change tracking](/graph/delta-query-overview) for details.
> [!NOTE] > Changes to the **licenseAssignmentStates** property are currently not tracked.
You only need to specify any desired query parameters once upfront.
In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL from the previous response, as that URL already includes the encoded, desired parameters.
-| Query parameter | Type |Description|
+| Query parameter | Type |Description|
|:|:--|:-| | $deltatoken | string | A [state token](/graph/delta-query-overview) returned in the `@odata.deltaLink` URL of the previous **delta** function call for the same user collection, indicating the completion of that round of change tracking. Save and apply the entire `@odata.deltaLink` URL including this token in the first request of the next round of change tracking for that collection.| | $skiptoken | string | A [state token](/graph/delta-query-overview) returned in the `@odata.nextLink` URL of the previous **delta** function call, indicating there are further changes to be tracked in the same user collection. |
v1.0 User Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-get.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve the properties and relationships of user object.
+Retrieve the properties and relationships of [user](../resources/user.md) object.
This operation returns by default only a subset of the more commonly used properties for each user. These _default_ properties are noted in the [Properties](../resources/user.md#properties) section. To get properties that are _not_ returned by default, do a [GET operation](user-get.md) for the user and specify the properties in a `$select` OData query option. Because the **user** resource supports [extensions](/graph/extensibility-overview), you can also use the `GET` operation to get custom properties and extension data in a **user** instance.
v1.0 User List Approleassignments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-approleassignments.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve the list of [appRoleAssignments](../resources/approleassignment.md) that a user has been granted. This operation also returns app role assignments granted to groups that the user is a direct member of.
+Retrieve the list of [appRoleAssignments](../resources/approleassignment.md) that a [user](../resources/user.md) has been granted. This operation also returns app role assignments granted to groups that the user is a direct member of.
> [!IMPORTANT] > To ensure complete results for users with many indirect app role assignments, use the **ConsistencyLevel** header set to `eventual` and `$count`, as described in [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries#group-properties). For an example, see [Example 1](#example-1-list-approleassignments-granted-to-a-user).
v1.0 User List Joinedteams https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-joinedteams.md
Title: "List joinedTeams" description: "Get the teams in Microsoft Teams that the user is a direct member of."-+ ms.localizationpriority: high doc_type: apiPageType
v1.0 User List Memberof https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-memberof.md
Choose the permission or permissions marked as least privileged for this API. Us
### Permissions for the signed-in user's direct memberships
-<!-- { "blockType": "permissions", "name": "user_list_memberof_1" } -->
+<!-- { "blockType": "permissions", "name": "user_list_memberof" } -->
### Permissions for another user's direct memberships
v1.0 User List Transitivememberof https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-transitivememberof.md
Choose the permission or permissions marked as least privileged for this API. Us
### Permissions for the signed-in user's memberships
-<!-- { "blockType": "permissions", "name": "user_list_transitivememberof_1" } -->
+<!-- { "blockType": "permissions", "name": "user_list_transitivememberof" } -->
### Permissions for another user's memberships
v1.0 User Post Approleassignments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-post-approleassignments.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Use this API to assign an app role to a user. To grant an app role assignment to a user, you need three identifiers:
+Use this API to assign an [app role](../resources/approle.md) to a [user](../resources/user.md), creating an [appRoleAssignment](../resources/approleassignment.md) object. To grant an app role assignment to a user, you need three identifiers:
- `principalId`: The `id` of the user to whom you are assigning the app role. - `resourceId`: The `id` of the resource `servicePrincipal` that has defined the app role.
v1.0 User Post Messages https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-post-messages.md
POST /me/mailFolders/{id}/messages
POST /users/{id | userPrincipalName}/mailFolders/{id}/messages ``` ## Request headers
-| Name | Type | Description|
-|:|:--|:-|
-| Authorization | string | Bearer {token}.|
-| Content-Type | string | Nature of the data in the body of an entity. Required. <br/> Use `application/json` for a JSON object and `text/plain` for MIME content |
+| Name | Description|
+|:-|:-|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+| Content-Type | The nature of the data in the body of an entity. Required. <br/> Use `application/json` for a JSON object and `text/plain` for MIME content |
## Request body When using JSON format, provide a JSON representation of the [message](../resources/message.md) object.
v1.0 User Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-update.md
PATCH /users/{id | userPrincipalName}
| Property | Type |Description| |:|:--|:-| |aboutMe|String|A freeform text entry field for the user to describe themselves.|
-|accountEnabled|Boolean| `true` if the account is enabled; otherwise, `false`. This property is required when a user is created. Apart from a global administrator, a privileged authentication administrator assigned the _Directory.AccessAsUser.All_ delegated permission can update the **accountEnabled** status of all administrators in the tenant.|
+|accountEnabled|Boolean| `true` if the account is enabled; otherwise, `false`. This property is required when a user is created. A Privileged Authentication Administrator assigned the _Directory.AccessAsUser.All_ delegated permission is the least privileged role that's allowed to update the **accountEnabled** status of all administrators in the tenant.|
| ageGroup | [ageGroup](../resources/user.md#agegroup-values) | Sets the age group of the user. Allowed values: `null`, `Minor`, `NotAdult` and `Adult`. Refer to the [legal age group property definitions](../resources/user.md#legal-age-group-property-definitions) for further information. | |assignedLicenses|[assignedLicense](../resources/assignedlicense.md) collection|The licenses that are assigned to the user. Not nullable. | |birthday|DateTimeOffset|The birthday of the user. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`|
v1.0 Virtualendpoint List Shareduseserviceplans https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualendpoint-list-shareduseserviceplans.md
- Title: "List cloudPcSharedUseServicePlans (deprecated)"
-description: "Get a list of the cloudPcSharedUseServicePlan objects and their properties."
--
-doc_type: apiPageType
--
-# List cloudPcSharedUseServicePlans (deprecated)
-
-Namespace: microsoft.graph
--
-> [!CAUTION]
-> The **cloudPcSharedUseServicePlan** resource is deprecated and stopped returning data on April 24, 2024. Going forward, use the [cloudPcFrontLineServicePlan](../resources/cloudpcfrontlineserviceplan.md).
-
-Get a list of the [cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.md) objects and their properties.
--
-## 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": "virtualendpoint_list_shareduseserviceplans" } -->
-
-## HTTP request
-
-<!-- {
- "blockType": "ignored"
-}
>-
-``` http
-GET /deviceManagement/virtualEndpoint/sharedUseServicePlans
-```
-
-## Optional query parameters
-
-This method supports the `$select`, `$filter`, `$orderby`, and `$skip` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
-
-## Request headers
-
-| Name | Description |
-| : | : |
-|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
-
-## Request body
-
-Don't supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and a collection of [cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.md) objects in the response body.
-
-## Examples
-
-### Request
-
-The following example shows a request.
-
-<!-- {
- "blockType": "request",
- "name": "list_cloudpcshareduseserviceplans"
-}
>-
-``` http
-GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/sharedUseServicePlans
-```
-
-### Response
-
-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.cloudPcSharedUseServicePlan",
- "isCollection": true
-}
>-
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "value": [
- {
- "@odata.type": "#microsoft.graph.cloudPcSharedUseServicePlan",
- "id": "1d164206-bf41-4fd2-8424-a3192d39ffff",
- "displayName": "Display Name value",
- "usedCount": 5,
- "totalCount": 10
- }
- ]
-}
-```
v1.0 Virtualendpoint Retrievetenantencryptionsetting https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualendpoint-retrievetenantencryptionsetting.md
Retrieve the encryption setting of the tenant associated with the current authen
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).
-|Permission type|Least privileged permissions|Higher privileged permissions|
-|:|:|:|
-|Delegated (work or school account)|CloudPC.Read.All|CloudPC.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|Not supported.|
-|Application|Not supported.|Not supported.|
+<!-- { "blockType": "permissions", "name": "virtualendpoint_retrievetenantencryptionsetting" } -->
## HTTP request
v1.0 Virtualeventregistrationconfiguration List Questions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualeventregistrationconfiguration-list-questions.md
GET https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1c-5
[!INCLUDE [sample-code](../includes/snippets/php/list-questions-virtualeventregistration-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/list-questions-virtualeventregistration-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Virtualeventregistrationconfiguration Post Questions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualeventregistrationconfiguration-post-questions.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/post-custom-question-virtualeventregistration-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/post-custom-question-virtualeventregistration-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
POST https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1c-
[!INCLUDE [sample-code](../includes/snippets/php/post-predefined-question-virtualeventregistration-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/post-predefined-question-virtualeventregistration-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Virtualeventregistrationquestionbase Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualeventregistrationquestionbase-delete.md
DELETE https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1
[!INCLUDE [sample-code](../includes/snippets/php/delete-virtualeventregistrationquestion-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/delete-virtualeventregistrationquestion-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Workbookformatprotection Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workbookformatprotection-get.md
Retrieve the properties and relationships of formatprotection object.
## 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": "formatprotection_get" } -->
+<!-- { "blockType": "permissions", "name": "workbookformatprotection_get" } -->
## HTTP request <!-- { "blockType": "ignored" } -->
If successful, this method returns a `200 OK` response code and a [formatProtect
### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_formatprotection"
The following example shows a request.
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/names/{name}/range/format/protection ```
+# [JavaScript](#tab/javascript)
+++ ### Response The following example shows the response.
v1.0 Workbookformatprotection Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workbookformatprotection-update.md
Update the properties of formatprotection object.
## 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": "formatprotection_update" } -->
+<!-- { "blockType": "permissions", "name": "workbookformatprotection_update" } -->
## HTTP request <!-- { "blockType": "ignored" } -->
If successful, this method returns a `200 OK` response code and updated [FormatP
### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_formatprotection"
Content-type: application/json
} ```
+# [JavaScript](#tab/javascript)
+++ ### Response The following example shows the response.
v1.0 Workbookrange Columnsafter https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workbookrange-columnsafter.md
Namespace: microsoft.graph
Gets a specified number of columns to the right of the given range. + ## 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).
Here's an example of how to call this API.
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "workbookrange_columnsafter"
The following example shows a request.
GET https://graph.microsoft.com/beta/drive/root/workbook/worksheets/{id}/range/columnsAfter(count=2) ```
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
v1.0 Workbookrange Columnsbefore https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workbookrange-columnsbefore.md
Namespace: microsoft.graph
Gets a specific number of columns to the left of the given range. + ## 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).
Here's an example of how to call this API.
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "workbookrange_columnsbefore"
The following example shows a request.
GET https://graph.microsoft.com/beta/drive/root/workbook/worksheets/{id}/range/columnsBefore(count=2) ```
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
v1.0 Workbookrange Rowsabove https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workbookrange-rowsabove.md
Namespace: microsoft.graph
Gets a specified in number of rows above a given range. + ## 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).
Here's an example of how to call this API.
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "workbookrange_rowsAbove"
The following example shows a request.
GET https://graph.microsoft.com/beta/drive/root/workbook/worksheets/{id}/range/rowsAbove(count=2) ```
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
v1.0 Workbookrange Rowsbelow https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workbookrange-rowsbelow.md
Namespace: microsoft.graph
Gets certain number of rows below a given range. + ## 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).
Here is an example of how to call this API.
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "workbookrange_rowsBelow"
The following example shows a request.
GET https://graph.microsoft.com/beta/drive/root/workbook/worksheets/{id}/range/rowsBelow(count=2) ```
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
v1.0 Workbookrange Visibleview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workbookrange-visibleview.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.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).
Here is an example of how to call this API.
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "workbookrange_visibleview"
The following example shows a request.
GET https://graph.microsoft.com/beta/drive/root/workbook/worksheets/{id}/range(address='A1:Z10')/visibleView ```
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
v1.0 Workbookrangeview List Rows https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workbookrangeview-list-rows.md
If successful, this method returns a `200 OK` response code and collection of [w
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_rows"
The following example shows a request.
GET https://graph.microsoft.com/beta/drive/root/workbook/worksheets/{id}/range(address='A1:Z10')/visibleView/rows ```
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability.
v1.0 Workbookrangeview Range https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workbookrangeview-range.md
Here is an example of how to call this API.
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "workbookrangeview_range"
The following example shows a request.
GET https://graph.microsoft.com/beta/drive/root/workbook/worksheets/{id}/range(address='A1:Z10')/visibleView/range ```
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
v1.0 Workingtimeschedule Endworkingtime https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workingtimeschedule-endworkingtime.md
+
+ Title: "workingTimeSchedule: endWorkingTime"
+description: "Trigger the policies associated with the end of working hours for a specific user."
+
+ms.localizationpriority: medium
+++
+# workingTimeSchedule: endWorkingTime
+
+Namespace: microsoft.graph
++
+Trigger the policies associated with the end of working hours for a specific user.
++
+## 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": "workingtimeschedule_endworkingtime" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /users/{userId}/solutions/workingTimeSchedule/endWorkingTime
+```
+
+## Path parameters
+
+|Parameter|Type|Description|
+|:|:|:|
+|userId|String|ID of the user whose working time ended.|
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this action returns a `202 Accepted` response code.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "workingtimeschedulethis.endworkingtime"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/users/ccdf8279-8a3f-4c10-af1a-4a7f46b1489f/solutions/workingTimeSchedule/endWorkingTime
+```
+
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+++
+### Response
+
+The following example shows the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 202 Accepted
+```
v1.0 Workingtimeschedule Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workingtimeschedule-get.md
+
+ Title: "Get workingTimeSchedule"
+description: "Read the properties and relationships of a workingTimeSchedule object."
+
+ms.localizationpriority: medium
+++
+# Get workingTimeSchedule
+
+Namespace: microsoft.graph
++
+Read the properties and relationships of a [workingTimeSchedule](../resources/workingtimeschedule.md) object.
+
+## 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": "workingtimeschedule-get-permissions"
+}
+-->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /users/{usersId}/solutions/schedule
+```
+
+## Optional query parameters
+
+This method doesn't support [OData query parameters](/graph/query-parameters) to customize the response.
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [workingTimeSchedule](../resources/workingtimeschedule.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+<!-- {
+ "blockType": "request",
+ "name": "get_workingtimeschedule"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/users/ccdf8279-8a3f-4c10-af1a-4a7f46b1489f/solutions/schedule
+```
++
+### Response
+
+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.workingTimeSchedule"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": {
+ "@odata.type": "#microsoft.teams.workingTime.workingTimeSchedule",
+ "id": "da5f72af-450e-56fc-10d7-afc9acb40cc0"
+ }
+}
+```
+
v1.0 Workingtimeschedule Startworkingtime https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workingtimeschedule-startworkingtime.md
+
+ Title: "workingTimeSchedule: startWorkingTime"
+description: "Trigger the policies associated with the start of working hours for a specific user."
+
+ms.localizationpriority: medium
+++
+# workingTimeSchedule: startWorkingTime
+
+Namespace: microsoft.graph
++
+Trigger the policies associated with the start of working hours for a specific user.
++
+## 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": "workingtimeschedule_startworkingtime" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /users/{userId}/solutions/workingTimeSchedule/startWorkingTime
+```
+
+## Path parameters
+
+|Parameter|Type|Description|
+|:|:|:|
+|userId|String|ID of the user whose working hours started.|
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this action returns a `202 Accepted` response code.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "workingtimeschedulethis.startworkingtime"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/users/ccdf8279-8a3f-4c10-af1a-4a7f46b1489f/solutions/workingTimeSchedule/startWorkingTime
+```
+
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+++
+### Response
+
+The following example shows the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 202 Accepted
+```
v1.0 Accesspackageassignmentrequest https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/accesspackageassignmentrequest.md
In [Microsoft Entra Entitlement Management](entitlementmanagement-overview.md),
| [Create](../api/entitlementmanagement-post-assignmentrequests.md) | [accessPackageAssignmentRequest](accesspackageassignmentrequest.md) | Create a new **accessPackageAssignmentRequest**. | | [Get](../api/accesspackageassignmentrequest-get.md) | [accessPackageAssignmentRequest](accesspackageassignmentrequest.md) | Read properties and relationships of an **accessPackageAssignmentRequest** object. | | [Delete](../api/accesspackageassignmentrequest-delete.md) |None | Delete an **accessPackageAssignmentRequest**. |
-|[Filter by current user](../api/accesspackageassignmentrequest-filterbycurrentuser.md)|[accessPackageAssignmentRequest](../resources/accesspackageassignmentrequest.md) collection|Retrieve the list of **accessPackageAssignmentRequest** objects filtered on the signed-in user.|
|[Cancel](../api/accesspackageassignmentrequest-cancel.md)|[accessPackageAssignmentRequest](../resources/accesspackageassignmentrequest.md) collection|Cancel an **accessPackageAssignmentRequest** object that is in a cancelable state.|
+|[Filter by current user](../api/accesspackageassignmentrequest-filterbycurrentuser.md)|[accessPackageAssignmentRequest](../resources/accesspackageassignmentrequest.md) collection|Retrieve the list of **accessPackageAssignmentRequest** objects filtered on the signed-in user.|
| [Reprocess](../api/accesspackageassignmentrequest-reprocess.md) | None | Automatically retry a user's request for access to an access package.|
+| [Resume](../api/accesspackageassignmentrequest-resume.md) | None | Resume a user's access package request after waiting for a callback from a custom extension.|
| [List (deprecated)](../api/entitlementmanagement-list-accesspackageassignmentrequests.md) | [accessPackageAssignmentRequest](accesspackageassignmentrequest.md) collection | Retrieve a list of **accesspackageassignmentrequest** objects. **This API will be retired soon. Use the [List assignmentRequests](../api/entitlementmanagement-list-assignmentrequests.md) API instead.** | | [Create (deprecated)](../api/entitlementmanagement-post-accesspackageassignmentrequests.md) | [accessPackageAssignmentRequest](accesspackageassignmentrequest.md) | Create a new **accessPackageAssignmentRequest**. **This API will be retired soon. Use the [Create accessPackageAssignmentRequest](../api/entitlementmanagement-post-assignmentrequests.md) API instead.** |
v1.0 Accessreviews Root https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/accessreviews-root.md
Typical customer scenarios for access reviews of group memberships and applicati
- Customers can collect access review controls into programs that are relevant for your organization to track reviews for compliance or risk-sensitive applications.
-There's also a related capability for customers to review and certify the role assignments of administrative users who are assigned to Microsoft Entra roles such as Global Administrator or Azure subscription roles. This capability is included in [Microsoft Entra Privileged Identity Management](privilegedidentitymanagement-root.md).
+There's also a related capability for customers to review and certify the role assignments of administrative users who are assigned to [Microsoft Entra roles](/entr).
The tenant where an access review is being created or managed via the API must have sufficient purchased or trial licenses. For more information about the license requirements, see [Access reviews license requirements](/azure/active-directory/governance/access-reviews-overview#license-requirements).
v1.0 Adminreportsettings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/adminreportsettings.md
Represents the tenant-level settings for Microsoft 365 reports.
|Method|Return type|Description| |:|:|:|
-|[Get](../api/adminreportsettings-get.md)|[adminReportSettings](../resources/adminreportsettings.md)|Get the tenant-level settings for Microsoft 365 Reports.|
-|[Update](../api/adminreportsettings-update.md)|[adminReportSettings](../resources/adminreportsettings.md)|Update tenant-level settings for Microsoft 365 Reports.|
+|[Get](../api/adminreportsettings-get.md)|[adminReportSettings](../resources/adminreportsettings.md)|Get the tenant-level settings for Microsoft 365 reports.|
+|[Update](../api/adminreportsettings-update.md)|[adminReportSettings](../resources/adminreportsettings.md)|Update tenant-level settings for Microsoft 365 reports.|
## Properties | Property | Type | Description | | -- | -- | - |
-| displayConcealedNames | Boolean | If set to `true`, all reports will conceal user information such as usernames, groups, and sites. If `false`, all reports will show identifiable information. This property represents a setting in the Microsoft 365 admin center. Required. |
+| displayConcealedNames | Boolean | If set to `true`, all reports conceal user information such as usernames, groups, and sites. If `false`, all reports show identifiable information. This property represents a setting in the Microsoft 365 admin center. Required. |
## JSON representation
v1.0 Application https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/application.md
This resource supports:
| appId | String | The unique identifier for the application that is assigned by Microsoft Entra ID. Not nullable. Read-only. Alternate key. Supports `$filter` (`eq`). | |applicationTemplateId | String | Unique identifier of the [applicationTemplate](../resources/applicationtemplate.md). Supports `$filter` (`eq`, `not`, `ne`). Read-only. `null` if the app wasn't created from an application template.| | appRoles | [appRole](approle.md) collection | The collection of roles defined for the application. With [app role assignments](approleassignment.md), these roles can be assigned to users, groups, or service principals associated with other applications. Not nullable. |
-|authenticationBehaviors|[authenticationBehaviors](../resources/authenticationbehaviors.md)| The collection of authentication behaviors set for the application. Authentication behaviors are unset by default and must be explicitly enabled (or disabled). Returned only on `$select`. <br/><br/> For more information about authentication behaviors, see [Manage application authenticationBehaviors to avoid unverified use of email claims for user identification or authorization](/graph/applications-authenticationbehaviors).|
+|authenticationBehaviors|[authenticationBehaviors](../resources/authenticationbehaviors.md)| The collection of breaking change behaviors related to token issuance that are configured for the application. Authentication behaviors are unset by default (`null`) and must be explicitly enabled or disabled. Nullable. Returned only on `$select`. <br/><br/> For more information about authentication behaviors, see [Manage application authenticationBehaviors to avoid unverified use of email claims for user identification or authorization](/graph/applications-authenticationbehaviors).|
|certification|[certification](certification.md)|Specifies the certification status of the application.| | createdDateTime | DateTimeOffset | The date and time the application was registered. The DateTimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only. <br><br> Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, and `eq` on `null` values) and `$orderby`. | |defaultRedirectUri|String|The default redirect URI. If specified and there's no explicit redirect URI in the sign-in request for SAML and OIDC flows, Microsoft Entra ID sends the token to this redirect URI. Microsoft Entra ID also sends the token to this default URI in SAML IdP-initiated single sign-on. The value must match one of the configured redirect URIs for the application.|
v1.0 Approleassignment https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/approleassignment.md
Title: "appRoleAssignment resource type"
-description: "Used to record when a user, group, or service principal is assigned to an app role on an application's service principal. You can create, read and delete app role assignments."
+description: "Used to record when a user, group, or service principal is assigned to an app role on an application's service principal. You can create, read, and delete app role assignments."
ms.localizationpriority: high doc_type: resourcePageType
Used to record when a user, group, or service principal is assigned an app role
An app role assignment is a relationship between the assigned principal (a user, a group, or a service principal), a resource application (the app's service principal) and an app role defined on the resource application.
-When the [app role](approle.md) which has been assigned to a principal has a non-empty **value** property, this will be included in the **roles** claim of tokens where the subject is the assigned principal (e.g. SAML responses, ID tokens, access tokens identifying a signed-in user, or an access token identifying a service principal). Applications and APIs use these claims as part of their authorization logic.
+When the [app role](approle.md) that has been assigned to a principal has a nonempty **value** property, this is included in the **roles** claim of tokens where the subject is the assigned principal (for example, SAML responses, ID tokens, access tokens identifying a signed-in user, or an access token identifying a service principal). Applications and APIs use these claims as part of their authorization logic.
A user can be assigned an app role directly. If an app role is assigned to a group, direct members of the group are also considered to have been assigned the app role. When a user is assigned an app role for an application, a tile for that application is displayed in the user's [MyApps portal](/azure/active-directory/user-help/my-apps-portal-end-user-access) and [Microsoft 365 app launcher](https://support.office.com/article/meet-the-office-365-app-launcher-79f12104-6fed-442f-96a0-eb089a3f476a).
An app role assignment where the assigned principal is a service principal is an
## Methods |Method|Return type|Description| |:|:|:|
-|[List appRoleAssignments granted to a group](../api/group-list-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Get a list of the [appRoleAssignment](../resources/approleassignment.md) objects and their properties.|
-|[List appRoleAssignments granted to a user](../api/user-list-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Get a list of the [appRoleAssignment](../resources/approleassignment.md) objects and their properties.|
-|[List appRoleAssignments granted to a service principal](../api/serviceprincipal-list-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Get a list of the [appRoleAssignment](../resources/approleassignment.md) objects and their properties.|
-|[List appRoleAssignments granted to users, groups, and client service principals for a resource service principal](../api/serviceprincipal-list-approleassignedto.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Get a list of the [appRoleAssignment](../resources/approleassignment.md) objects and their properties.|
-|[Grant an appRole to a group](../api/group-post-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md)|Create a new [appRoleAssignment](../resources/approleassignment.md) object.|
-|[Grant an appRole to a user](../api/user-post-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md)|Create a new [appRoleAssignment](../resources/approleassignment.md) object.|
-|[Grant an appRole to a service principal](../api/serviceprincipal-post-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Create a new [appRoleAssignment](../resources/approleassignment.md) object.|
-|[Grant a user, group, or client service principal an appRoleAssignment for a resource service principal](../api/serviceprincipal-post-approleassignedto.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Create a new [appRoleAssignment](../resources/approleassignment.md) object.
-|[Get appRoleAssignment](../api/approleassignment-get.md)|[appRoleAssignment](../resources/approleassignment.md)|Get a new [appRoleAssignment](../resources/approleassignment.md) object.|
-|[Dlete an appRoleAssignment from a group](../api/group-delete-approleassignments.md)|None|Delete an [appRoleAssignment](../resources/approleassignment.md) object.|
-|[Delete an appRoleAssignment from a user](../api/user-delete-approleassignments.md)|None|Delete an [appRoleAssignment](../resources/approleassignment.md) object.|
-|[Delete an appRoleAssignment from a service principal](../api/serviceprincipal-delete-approleassignments.md)|None|Delete an [appRoleAssignment](../resources/approleassignment.md) object.|
-|[Delete an appRoleAssignment granted to a user, group, or client service principal for a resource service principal](../api/serviceprincipal-delete-approleassignedto.md)|None|Delete an [appRoleAssignment](../resources/approleassignment.md) object.|
+|[List app role assignments for a group](../api/group-list-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Get a list of the [appRoleAssignment](../resources/approleassignment.md) objects and their properties for a group.|
+|[List app role assignments for a user](../api/user-list-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Get a list of the [appRoleAssignment](../resources/approleassignment.md) objects and their properties for a user.|
+|[List app role assignments for a client service principal](../api/serviceprincipal-list-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Get a list of the [appRoleAssignment](../resources/approleassignment.md) objects and their properties for a client service principal.|
+|[List app role assignments for users, groups, and client service principals for a resource service principal](../api/serviceprincipal-list-approleassignedto.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Get a list of the [appRoleAssignment](../resources/approleassignment.md) objects and their properties for users, groups, and client service principals for a specified resource service principal.|
+|[Grant app role to a group](../api/group-post-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md)|Create a new [appRoleAssignment](../resources/approleassignment.md) object for a group.|
+|[Grant app role to a user](../api/user-post-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md)|Create a new [appRoleAssignment](../resources/approleassignment.md) object for a user.|
+|[Grant app role to a client service principal](../api/serviceprincipal-post-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Create a new [appRoleAssignment](../resources/approleassignment.md) object for a client service principal.|
+|[Grant app role assignment to user, group, or client service principal for a resource service principal](../api/serviceprincipal-post-approleassignedto.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Create a new [appRoleAssignment](../resources/approleassignment.md) object to a user, group, or client service principal for a specified resource service principal.|
+|[Get app role assignment](../api/approleassignment-get.md)|[appRoleAssignment](../resources/approleassignment.md)|Get an [appRoleAssignment](../resources/approleassignment.md) object assigned to a user, group, or client service principal for a resource service principal.|
+|[Delete app role assignment for a group](../api/group-delete-approleassignments.md)|None|Delete an [appRoleAssignment](../resources/approleassignment.md) object from a group.|
+|[Delete app role assignment for a user](../api/user-delete-approleassignments.md)|None|Delete an [appRoleAssignment](../resources/approleassignment.md) object from a user.|
+|[Delete app role assignment for a client service principal](../api/serviceprincipal-delete-approleassignments.md)|None|Delete an [appRoleAssignment](../resources/approleassignment.md) object from a client service principal.|
+|[Delete app role assignment for user, group, or client service principal to a resource service principal](../api/serviceprincipal-delete-approleassignedto.md)|None|Delete an [appRoleAssignment](../resources/approleassignment.md) object from a user, group, or client service principal for a specified resource service principal.|
## Properties
An app role assignment where the assigned principal is a service principal is an
| principalDisplayName | String |The display name of the user, group, or service principal that was granted the app role assignment. Read-only. Supports `$filter` (`eq` and `startswith`). | | resourceId | Guid |The unique identifier (**id**) for the resource [service principal](serviceprincipal.md) for which the assignment is made. Required on create. Supports `$filter` (`eq` only). | | resourceDisplayName | String | The display name of the resource app's service principal to which the assignment is made. |
-| appRoleId | Guid | The identifier (**id**) for the [app role](approle.md) which is assigned to the principal. This app role must be exposed in the **appRoles** property on the resource application's service principal (**resourceId**). If the resource application has not declared any app roles, a default app role ID of `00000000-0000-0000-0000-000000000000` can be specified to signal that the principal is assigned to the resource app without any specific app roles. Required on create. |
+| appRoleId | Guid | The identifier (**id**) for the [app role](approle.md) that is assigned to the principal. This app role must be exposed in the **appRoles** property on the resource application's service principal (**resourceId**). If the resource application hasn't declared any app roles, a default app role ID of `00000000-0000-0000-0000-000000000000` can be specified to signal that the principal is assigned to the resource app without any specific app roles. Required on create. |
## JSON representation
v1.0 Attachment https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/attachment.md
Title: "attachment resource type"
-description: "You can add related content to an event,"
+description: "The base type for several types of attachments on a user, message, task, or group post."
ms.localizationpriority: medium doc_type: resourcePageType
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
+The base type for several types of attachments on a user, message, task, or group post that serves as the base resource for the following derived types of attachments:
+
+* A file ([fileAttachment](../resources/fileattachment.md) resource)
+* An item (contact, event, or message, represented by an [itemAttachment](../resources/itemattachment.md) resource)
+* A link to a file ([referenceAttachment](../resources/referenceattachment.md) resource)
You can add related content to a user [event](../resources/event.md), [message](../resources/message.md), [Outlook task](../resources/outlooktask.md), or group [post](../resources/post.md) in the form of an attachment. + Events in group calendars do not support attachments. Outlook tasks do not support reference attachments.
-**attachment** is the base resource for the following derived types of attachments:
-
-* A file ([fileAttachment](../resources/fileattachment.md) resource)
-* An item (contact, event or message, represented by an [itemAttachment](../resources/itemattachment.md) resource)
-* A link to a file ([referenceAttachment](../resources/referenceattachment.md) resource)
- >**Note**: If you're attaching a file to a group post, or attaching an item to an event, message, or group post, limit the size of the attachment to 3 MB. > > If you're attaching a file under 3 MB, you can [add the file attachment to a user event](../api/event-post-attachments.md), [to a message](../api/message-post-attachments.md), or [to a group post](../api/post-post-attachments.md).
v1.0 Authenticationbehaviors https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/authenticationbehaviors.md
Namespace: microsoft.graph
Describes the authentication behaviors set in the context of an [application](application.md). Authentication behaviors are Boolean flags that provide applications flexibility in adopting breaking-change behaviors related to token issuance. These updated token issuance behaviors can be related to security mitigations, security improvements, or feature deprecations.
-Applications can adopt new breaking changes by enabling a behavior (set the behavior to `true`), or continue using pre-existing behavior by disabling it (by setting the behavior to `false`). For more information about managing authentication behaviors, see [Manage application authenticationBehaviors](/graph/applications-authenticationbehaviors).
+Applications can adopt new breaking changes by enabling a behavior (set the behavior to `true`), or continue using preexisting behavior by disabling it (by setting the behavior to `false`). For more information about managing authentication behaviors, see [Manage application authenticationBehaviors](/graph/applications-authenticationbehaviors).
## Properties |Property|Type|Description| |:|:|:|
-|removeUnverifiedEmailClaim|Boolean| Removes the `email` claim from tokens sent to an application when the email address's domain can't be verified. |
-|requireClientServicePrincipal|Boolean| Requires multitenant applications to have a service principal in the resource tenant as part of authorization checks before they're granted access tokens. This property is only modifiable for multi-tenant resource applications that rely on access from clients without a service principal and had this behavior as set to `false` by Microsoft. Tenant administrators should respond to security advisories sent through Azure Health Service events and the Microsoft 365 message center.|
+|blockAzureADGraphAccess|Boolean| If `false`, allows the app to have extended access to Azure AD Graph until June 30, 2025 when Azure AD Graph is fully retired. For more information on Azure AD retirement updates, see [June 2024 update on Azure AD Graph API retirement](https://techcommunity.microsoft.com/t5/microsoft-entra-blog/june-2024-update-on-azure-ad-graph-api-retirement/ba-p/4094534).|
+|removeUnverifiedEmailClaim|Boolean| If `true`, removes the `email` claim from tokens sent to an application when the email address's domain can't be verified. |
+|requireClientServicePrincipal|Boolean| If `true`, requires multitenant applications to have a service principal in the resource tenant as part of authorization checks before they're granted access tokens. This property is only modifiable for multitenant resource applications that rely on access from clients without a service principal and had this behavior as set to `false` by Microsoft. Tenant administrators should respond to security advisories sent through Azure Health Service events and the Microsoft 365 message center.|
## Relationships None.
The following JSON representation shows the resource type.
``` json { "@odata.type": "#microsoft.graph.authenticationBehaviors",
+ "blockAzureADGraphAccess": "Boolean",
"removeUnverifiedEmailClaim": "Boolean", "requireClientServicePrincipal": "Boolean" }
v1.0 Bookingschedulingpolicy https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/bookingschedulingpolicy.md
Namespace: microsoft.graph
Represents the set of policies that determine how appointments should be created in a Microsoft Bookings calendar.
+> [!NOTE]
+>
+> If the Default Scheduling Policy is enabled at the service level, the values of this resource are limited to those defined in the policy in the [List services](/graph/api/bookingbusiness-list-services) API response. In this case, the client must fall back to the Default Scheduling Policy for the business.
+ ## Properties | Property | Type |Description| |:|:--|:-|
v1.0 Businessflowtemplate https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/businessflowtemplate.md
Namespace: microsoft.graph
In the Microsoft Entra [access reviews](accessreviews-root.md) feature, the **businesFlowTemplate** represents a Microsoft Entra business flow template. The identifier of a template, such as to review guest members of a group, is supplied by the caller when creating an access review.
-The business flow template objects are automatically generated when the global administrator onboards the tenant to use the access reviews feature. The business flow templates include access reviews of assignments to an application, memberships of a group, memberships of a Microsoft Entra role, guest user memberships of a group, and guest user assignments to an application. No additional business flow templates can be created.
-
+The business flow template objects are predefined and automatically generated when an authorized administrator onboards the tenant to use the access reviews feature. They include the following access reviews workflows and scopes:
+- Assignments to an application
+- Memberships of a group
+- Memberships of a Microsoft Entra role
+- Memberships of guests to a group
+- Assignments of guests to an application.
## Methods
v1.0 Calendar https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/calendar.md
Title: "calendar resource type"
-description: "A calendar which is a container for events. It can be a calendar for a user, or the default calendar of a Microsoft 365 group."
+description: "Represents a container for events. It can be a calendar for a user, or the default calendar of a Microsoft 365 group."
ms.localizationpriority: high
Represents a container for [event](event.md) resources. It can be a calendar for
| Method | Return Type |Description| |:|:--|:-|
-|[List calendars](../api/user-list-calendars.md)|[calendar](calendar.md) collection|Get all the user's calendars, or the calendars in the default or other specific calendar group.|
-|[Create calendar](../api/user-post-calendars.md) |[calendar](calendar.md)| Create a new calendar in the default calendar group or specified calendar group for a user.|
-|[Get calendar](../api/calendar-get.md) | [calendar](calendar.md) |Get the properties and relationships of a **calendar** object. The calendar can be one for a user, or the default calendar of a Microsoft 365 group. |
-|[Update calendar](../api/calendar-update.md) | [calendar](calendar.md) |Update the properties of a **calendar** object. The calendar can be one for a user, or the default calendar of a Microsoft 365 group. |
-|[Delete calendar](../api/calendar-delete.md) | None |Delete calendar object. |
+|[List](../api/user-list-calendars.md)|[calendar](calendar.md) collection|Get all the user's calendars, or the calendars in the default or other specific calendar group.|
+|[Create](../api/user-post-calendars.md) |[calendar](calendar.md)| Create a new calendar in the default calendar group or specified calendar group for a user.|
+|[Get](../api/calendar-get.md) | [calendar](calendar.md) |Get the properties and relationships of a **calendar** object. The calendar can be one for a user, or the default calendar of a Microsoft 365 group. |
+|[Update](../api/calendar-update.md) | [calendar](calendar.md) |Update the properties of a **calendar** object. The calendar can be one for a user, or the default calendar of a Microsoft 365 group. |
+|[Delete](../api/calendar-delete.md) | None |Delete calendar object. |
+|[Permanently delete](../api/calendar-permanentdelete.md)|None|Permanently delete the **calendar** folder and remove it from the mailbox. |
|[List calendar view](../api/calendar-list-calendarview.md) |[event](event.md) collection| Get the occurrences, exceptions, and single instances of events in a calendar view defined by a time range, from the user's primary calendar `(../me/calendarView)` or from a specified calendar.| |[List events](../api/calendar-list-events.md) |[event](event.md) collection| Retrieve a list of events in a calendar. The list contains single instance meetings and series masters.|
-|[Create Event](../api/calendar-post-events.md) |[event](event.md)| Create a new event in the default or specified calendar.|
+|[Create event](../api/calendar-post-events.md) |[event](event.md)| Create a new event in the default or specified calendar.|
|[Get free/busy schedule](../api/calendar-getschedule.md) |[scheduleInformation](scheduleinformation.md) collection|Get the free/busy availability information for a collection of users, distributions lists, or resources, for a specified time period. | |[Find meeting times](../api/user-findmeetingtimes.md) |[meetingTimeSuggestionsResult](meetingtimesuggestionsresult.md) |Suggest meeting times and locations based on organizer and attendee availability, and time or location constraints. | |[Create single-value property](../api/singlevaluelegacyextendedproperty-post-singlevalueextendedproperties.md) |[calendar](calendar.md) |Create one or more single-value extended properties in a new or existing calendar. |
v1.0 Call https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/call.md
Becomes:
```http https://teams.microsoft.com/l/meetup-join/19:meeting_NTg0NmQ3NTctZDVkZC00YzRhLThmNmEtOGQ3M2E0ODdmZDZk@thread.v2/0?context={"Tid":"72f988bf-86f1-41af-91ab-2d7cd011db47","Oid":"4b444206-207c-42f8-92a6-e332b41c88a2"} ```-
+> [!NOTE]
+> The following known issues are associated with this resource:
+> - [Webhook message processing exception: System.Security.Cryptography.CryptographicException](https://developer.microsoft.com/en-us/graph/known-issues/?search=24752)
+> - [Support for multi-endpoint use case in delta roster notification mode is missing](https://developer.microsoft.com/en-us/graph/known-issues/?search=24894)
## Methods | Method | Return Type | Description | |:-|:|:--|
+| [Create](../api/application-post-calls.md) | [call](call.md) | Create **call** enables your bot to create a new outgoing peer-to-peer or group call, or join an existing meeting. |
| [Get](../api/call-get.md) | [call](call.md) | Read properties of the **call** object. | | [Delete/hang up](../api/call-delete.md) | None | Delete or Hang-up an active **call**. | | [Keep alive](../api/call-keepalive.md) | None | Ensure that the call remains active.
v1.0 Calloptions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/calloptions.md
Namespace: microsoft.graph
An abstract base class that contains the optional features for a call.
+Base type of [incomingCallOptions](../resources/incomingcalloptions.md) and [outgoingCallOptions](../resources/outgoingcalloptions.md).
+ ## Properties |Property |Type |Description | |: |: |: | | hideBotAfterEscalation | Boolean | Indicates whether to hide the app after the call is escalated. | | isContentSharingNotificationEnabled | Boolean | Indicates whether content sharing notifications should be enabled for the call. |
+| isDeltaRosterEnabled | Boolean | Indicates whether delta roster is enabled for the call. |
## JSON representation
The following JSON representation shows the resource type.
{ "@odata.type": "#microsoft.graph.callOptions", "hideBotAfterEscalation": "Boolean",
- "isContentSharingNotificationEnabled": "Boolean"
+ "isContentSharingNotificationEnabled": "Boolean",
+ "isDeltaRosterEnabled": "Boolean"
} ```
v1.0 Callrecording https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/callrecording.md
Represents a recording associated with an [online meeting](onlinemeeting.md).
|:|:--|:-| |[List](../api/onlinemeeting-list-recordings.md) | [callRecording](callrecording.md) collection | Get the list of [callRecording](../resources/callrecording.md) objects associated with a scheduled [onlineMeeting](../resources/onlinemeeting.md).| |[Get](../api/callrecording-get.md) | [callRecording](callrecording.md) | Get a [callRecording](../resources/callrecording.md) object associated with a scheduled [onlineMeeting](../resources/onlinemeeting.md).|
-|[Get delta by organizer](../api/callrecording-delta.md) | [callRecording](callrecording.md) collection | Get a set of [callRecording](../resources/callrecording.md) resources that have been added for [onlineMeeting](../resources/onlinemeeting.md) instances organized by the specified user.|
+|[Get delta by organizer](../api/callrecording-delta.md) | [callRecording](callrecording.md) collection | Get a set of [callRecording](../resources/callrecording.md) resources that were added for [onlineMeeting](../resources/onlinemeeting.md) instances organized by the specified user.|
|[List recordings by organizer](../api/onlinemeeting-getallrecordings.md) | [callRecording](callrecording.md) collection | Get the [callRecording](../resources/callrecording.md) objects for all the [onlineMeeting](../resources/onlinemeeting.md) instances organized by the specified user.| ## Properties
v1.0 Calltranscript https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/calltranscript.md
Represents a transcript associated with an [online meeting](onlinemeeting.md).
|:|:--|:-| |[List transcripts](../api/onlinemeeting-list-transcripts.md) | [callTranscript](calltranscript.md) collection | Get the list of [callTranscript](../resources/calltranscript.md) objects associated with an [onlineMeeting](../resources/onlinemeeting.md).| |[Get transcript](../api/calltranscript-get.md) | [callTranscript](calltranscript.md) | Get a [callTranscript](../resources/calltranscript.md) object associated with an [onlineMeeting](../resources/onlinemeeting.md).|
-|[Get delta by organizer](../api/calltranscript-delta.md) | [callTranscript](calltranscript.md) collection | Get a set of [callTranscript](../resources/calltranscript.md) resources that have been added for [onlineMeeting](../resources/onlinemeeting.md) instances organized by the specified user.|
+|[Get delta by organizer](../api/calltranscript-delta.md) | [callTranscript](calltranscript.md) collection | Get a set of [callTranscript](../resources/calltranscript.md) resources that were added for [onlineMeeting](../resources/onlinemeeting.md) instances organized by the specified user.|
|[List transcripts by organizer](../api/onlinemeeting-getalltranscripts.md) | [callTranscript](calltranscript.md) collection | Get the [callTranscript](../resources/calltranscript.md) objects for all the [onlineMeeting](../resources/onlinemeeting.md) instances organized by the specified user.|
v1.0 Chatmessagereaction https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/chatmessagereaction.md
An entity of type `chatMessageReaction` is returned as part of the [Get channel
| Property | Type | Description | |:-|:|:| |createdDateTime|DateTimeOffset|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`.|
+|displayName|String|The name of the reaction.|
|reactionContentUrl|String|The hosted content URL for the custom reaction type. |
-|reactionType|String|Supported values are Unicode characters and `custom`. Some backward-compatible reaction types include `like`, `angry`, `sad`, `laugh`, `heart`, and `surprised`. |
+|reactionType|String|The reaction type. Supported values include Unicode characters, `custom`, and some backward-compatible reaction types, such as `like`, `angry`, `sad`, `laugh`, `heart`, and `surprised`. |
|user|[chatMessageReactionIdentitySet](chatmessagereactionidentityset.md)|The user who reacted to the message.| ## JSON representation
The following JSON representation shows the resource type.
{ "createdDateTime": "String (timestamp)", "reactionContentUrl": "String",
+ "displayName": "String",
"reactionType": "String", "user": {"@odata.type": "microsoft.graph.chatMessageReactionIdentitySet"} }
v1.0 Clonableteamparts https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/clonableteamparts.md
description: "Describes which part of a team should be cloned. "
ms.localizationpriority: medium doc_type: enumPageType -+ # clonableTeamParts enum type
v1.0 Cloudpc https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpc.md
Represents a cloud-managed virtual desktop. This Cloud PC is also enrolled in In
|[Retry partner agent installation](../api/cloudpc-retrypartneragentinstallation.md)|None|Retry installation for the partner agents that failed to install on the Cloud PC.| |[Validate bulk resize](../api/cloudpc-validatebulkresize.md)|[cloudPcResizeValidateResult](../resources/cloudPcResizeValidationResult.md) collection|Validate that a set of Cloud PC devices meet the requirements to be bulk resized.| |[Create snapshot](../api/cloudpc-createsnapshot.md)|None|Create a snapshot for a specific Cloud PC device.|
-|[Get frontline access state](../api/cloudpc-getfrontlinecloudpcaccessstate.md)|[frontlineCloudPcAccessState](#frontlinecloudpcaccessstate-values)|Get the access state of the frontline Cloud PC. The possible values are: `unassigned`, `noLicensesAvailable`, `activationFailed`, `active`, `activating`, `standbyMode`, `unknownFutureValue`.|
+|[Get frontline access state](../api/cloudpc-getfrontlinecloudpcaccessstate.md)|[frontlineCloudPcAccessState](#frontlinecloudpcaccessstate-values)|Get the access state of the frontline Cloud PC. The possible values are: `unassigned`, `noLicensesAvailable`, `activationFailed`, `active`, `activating`, `standbyMode`, `unknownFutureValue`. The `noLicensesAvailable` member is deprecated and will stop returning on September 30, 2024.|
|[Bulk reprovision remote action (deprecated)](../api/manageddevice-bulkreprovisioncloudpc.md) |None|Bulk reprovision a set of Cloud PC devices with Intune managed device IDs. This API is deprecated and stopped returning data on September 24, 2023. Going forward, use the [cloudPcBulkReprovision](../resources/cloudpcbulkreprovision.md) resource. | |[Bulk resize (deprecated)](../api/cloudpc-bulkresize.md) |[cloudPcRemoteActionResult](../resources//cloudpcremoteactionresult.md) collection|Perform a bulk resize action to resize a group of Cloud PCs that have successfully passed validation (cloudPC: validateBulkResize). If any devices can't be resized, they're labeled as "resize failed", while the remaining devices are `provisioned` for the resize process. This API is deprecated and stopped returning data on September 24, 2023. Going forward, use the [cloudPcBulkResize](../resources/cloudpcbulkresize.md) resource.| |[Bulk restore remote action (deprecated)](../api/manageddevice-bulkrestorecloudpc.md) |[cloudPcBulkRemoteActionResult](../resources/cloudpcbulkremoteactionresult.md)|Restore multiple Cloud PC devices with a single request that includes the IDs of Intune managed devices and a restore point date and time. This API is deprecated and stopped returning data on September 24, 2023. Going forward, use the [cloudPcBulkRestore](../resources/cloudpcbulkrestore.md) resource.|
The following table lists the members of an [evolvable enumeration](/graph/best-
|Member|Description| |:|:| |unassigned|Set to unassigned if the Cloud PC doesn't consume any shared-use licenses. The default value is `unassigned`.|
-|noLicensesAvailable|Indicates that all shared-use licenses are in use.|
+|noLicensesAvailable (deprecated)|Indicates that all shared-use licenses are in use. The `noLicensesAvailable` member is deprecated and will stop returning on September 30, 2024.|
|activationFailed|Indicates that the frontline Cloud PC activation failed after the user requested a frontline Cloud PC.| |active|Indicates that the frontline Cloud PC is in an active state with a shared-use license assigned, and the user can connect to the Cloud PC.| |activating|Indicates that a user requested to connect the Cloud PC and the service is starting.|
v1.0 Cloudpccrossregiondisasterrecoverysetting