Updates from: 09/16/2024 01:09:22
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_getrecentlymodifiedsubmissions" } -->
+
+## 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 `$select` and `$filter` options on assignmentId property
+
+#### Request
+The following example shows a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_educationclass_getrecentlymodifiedsubmissions_filter_select_assignmentId"
+}-->
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/getrecentlymodifiedsubmissions?$filter=assignmentId eq 'b20d6737-f88e-4892-8174-73aa26d18784'&$select=LastModifiedDateTime,status
+```
+
+#### 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": [
+ {
+ "status": "submitted",
+ "lastModifiedDateTime": "2024-09-09T10:18:33.4052415Z"
+ },
+ {
+ "status": "working",
+ "lastModifiedDateTime": "2024-09-09T10:18:07.6464644Z"
+ },
+ {
+ "status": "working",
+ "lastModifiedDateTime": "2024-09-09T10:18:07.588738Z"
+ },
+ {
+ "status": "working",
+ "lastModifiedDateTime": "2024-09-09T10:18:07.5295878Z"
+ },
+ {
+ "status": "working",
+ "lastModifiedDateTime": "2024-09-09T10:18:07.4718648Z"
+ },
+ {
+ "status": "working",
+ "lastModifiedDateTime": "2024-09-09T10:18:07.3513158Z"
+ },
+ {
+ "status": "working",
+ "lastModifiedDateTime": "2024-09-09T10:18:07.2866527Z"
+ },
+ {
+ "status": "working",
+ "lastModifiedDateTime": "2024-09-09T10:18:07.2219998Z"
+ },
+ {
+ "status": "working",
+ "lastModifiedDateTime": "2024-09-09T10:18:07.1602788Z"
+ },
+ {
+ "status": "working",
+ "lastModifiedDateTime": "2024-09-09T10:18:07.0884058Z"
+ }
+ ]
+}
+```
+
+### Example 3: 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 4: 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 5: 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 6: 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 7: 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 M365appsinstallationoptions Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/m365appsinstallationoptions-get.md
Choose the permission or permissions marked as least privileged for this API. Us
[!INCLUDE [permissions-table](../includes/permissions/m365appsinstallationoptions-get-permissions.md)] When calling on behalf of a user, the user needs to belong to the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json):
-+ Global administrator
++ Office apps administrator (recommended) + Global reader
-+ Office apps administrator
++ Global administrator ## HTTP request
v1.0 M365appsinstallationoptions Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/m365appsinstallationoptions-update.md
Choose the permission or permissions marked as least privileged for this API. Us
[!INCLUDE [permissions-table](../includes/permissions/m365appsinstallationoptions-update-permissions.md)] When calling on behalf of a user, the user needs to belong to the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json):-++ Office apps administrator (recommended) + Global administrator
-+ Office apps administrator
## HTTP request
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 Healthissue Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-healthissue-get.md
Choose the permission or permissions marked as least privileged for this API. Us
GET /security/identities/healthIssues/{healthIssueId} ```
+## 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
Content-Type: application/json
{ "@odata.type": "#microsoft.graph.security.healthIssue",
- "ID": "b3c1b5fc-828c-45fa-a1e1-10d74f6d6e9c",
- "displayName": "Directory Services Object Auditing is not configured as required",
+ "additionalInformation": ["Descendant User Objects (Schema-Id-Guid: bf967aba-0de6-11d0-a285-00aa003049e2)"],
+ "createdDateTime": "2022-07-15T12:19:27.7211305Z",
+ "description": "Directory Services Object Auditing isn't configured as required on domain1.contoso.com",
+ "displayName": "Directory Services Object Auditing isn't configured as required",
+ "domainNames": ["domain1.contoso.com", "domain2.contoso.com"],
"healthIssueType": "Global",
+ "id": "b3c1b5fc-828c-45fa-a1e1-10d74f6d6e9c",
"issueTypeId": "1031",
- "severity": "medium",
- "status": "open",
- "createdDateTime": "2022-07-15T12:19:27.7211305Z",
"lastModifiedDateTime": "2022-07-15T12:19:27.7211305Z",
- "domainNames": [
- "domain1.contoso.com",
- "domain2.contoso.com"
- ],
- "sensorDNSNames": [
- "DC1.domain1.contoso.com",
- "DC2.domain2.contoso.com"
- ],
- "description": "Directory Services Object Auditing is not configured as required on domain1.contoso.com",
- "recommendations": [
- "Please configure the Directory Services Object Auditing events according to the guidance as described in https://aka.ms/mdi/objectauditing"
- ],
- "recommendedActionCommands": [
- "Import-Module DefenderForIdentity",
- "Set-MDIConfiguration -Configuration DomainObjectAuditing -Mode Domain -Force"
- ],
- "additionalInformation": [
- "Descendant User Objects (Schema-Id-Guid: bf967aba-0de6-11d0-a285-00aa003049e2)",
- "Descendant Group Objects (Schema-Id-Guid: bf967a9c-0de6-11d0-a285-00aa003049e2)",
- "Descendant Computer Objects (Schema-Id-Guid: bf967a86-0de6-11d0-a285-00aa003049e2)",
- "Descendant msDS-GroupManagedServiceAccount Objects (Schema-Id-Guid: 7b8b558a-93a5-4af7-adca-c017e67f1057)",
- "Descendant msDS-ManagedServiceAccount Objects (Schema-Id-Guid: ce206244-5827-4a86-ba1c-1c0c386c1b64)"
- ]
+ "recommendations": ["Please configure the Directory Services Object Auditing events according to the guidance as described in https://aka.ms/mdi/objectauditing"],
+ "recommendedActionCommands": ["Import-Module DefenderForIdentity"],
+ "sensorDNSNames": ["DC1.domain1.contoso.com", "DC2.domain2.contoso.com"],
+ "severity": "medium",
+ "status": "open"
} ```
v1.0 Security Identitycontainer List Healthissues https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-identitycontainer-list-healthissues.md
GET /security/identities/healthIssues
## Optional query parameters
-This method supports the following OData query parameters to help customize the response: `$count`, `$filter`, `$skip`, `$top`. For general information, see [OData query parameters](/graph/query-parameters).
+This method supports the `$count`, `$filter`, `$skip`, `$top`, and `$select` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
The following examples show how to use optional query parameters.
GET /security/identities/healthIssues?$filter=Status eq 'open' and severity eq '
GET /security/identities/healthIssues?$filter=Status eq 'open' and severity eq 'low' ```
-See open global health alerts that domain name \ sensor DNS name ends with spesific value (name=contoso.com)
+### Get open global health alerts where the domain name or sensor DNS name ends with a specific value
+
+The following example shows how to get global health alerts where the domain name or sensor DNS name ends with a specific value, for example, `contoso.com`.
+ <!-- { "blockType": "ignored" }
Don't supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and a collection of [healthIssue](../resources/security-healthissue.md) objects in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [microsoft.graph.security.healthIssue](../resources/security-healthissue.md) objects in the response body.
## Examples
Content-Type: application/json
"value": [ { "@odata.type": "#microsoft.graph.security.healthIssue",
- "ID": "b3c1b5fc-828c-45fa-a1e1-10d74f6d6e9c",
- "displayName": "Directory Services Object Auditing is not configured as required",
+ "additionalInformation": ["Descendant User Objects (Schema-Id-Guid: bf967aba-0de6-11d0-a285-00aa003049e2)"],
+ "createdDateTime": "2022-07-15T12:19:27.7211305Z",
+ "description": "Directory Services Object Auditing isn't configured as required on domain1.contoso.com",
+ "displayName": "Directory Services Object Auditing isn't configured as required",
+ "domainNames": ["domain1.contoso.com", "domain2.contoso.com"],
"healthIssueType": "Global",
+ "id": "b3c1b5fc-828c-45fa-a1e1-10d74f6d6e9c",
"issueTypeId": "1031",
- "severity": "medium",
- "status": "open",
- "createdDateTime": "2022-07-15T12:19:27.7211305Z",
"lastModifiedDateTime": "2022-07-15T12:19:27.7211305Z",
- "domainNames": [
- "domain1.contoso.com",
- "domain2.contoso.com"
- ],
- "sensorDNSNames": [
- "DC1.domain1.contoso.com",
- "DC2.domain2.contoso.com"
- ],
- "description": "Directory Services Object Auditing is not configured as required on domain1.contoso.com",
- "recommendations": [
- "Please configure the Directory Services Object Auditing events according to the guidance as described in https://aka.ms/mdi/objectauditing"
- ],
- "recommendedActionCommands": [
- "Import-Module DefenderForIdentity",
- "Set-MDIConfiguration -Configuration DomainObjectAuditing -Mode Domain -Force"
- ],
- "additionalInformation": [
- "Descendant User Objects (Schema-Id-Guid: bf967aba-0de6-11d0-a285-00aa003049e2)",
- "Descendant Group Objects (Schema-Id-Guid: bf967a9c-0de6-11d0-a285-00aa003049e2)",
- "Descendant Computer Objects (Schema-Id-Guid: bf967a86-0de6-11d0-a285-00aa003049e2)",
- "Descendant msDS-GroupManagedServiceAccount Objects (Schema-Id-Guid: 7b8b558a-93a5-4af7-adca-c017e67f1057)",
- "Descendant msDS-ManagedServiceAccount Objects (Schema-Id-Guid: ce206244-5827-4a86-ba1c-1c0c386c1b64)"
- ]
+ "recommendations": ["Please configure the Directory Services Object Auditing events according to the guidance as described in https://aka.ms/mdi/objectauditing"],
+ "recommendedActionCommands": ["Import-Module DefenderForIdentity"],
+ "sensorDNSNames": ["DC1.domain1.contoso.com", "DC2.domain2.contoso.com"],
+ "severity": "medium",
+ "status": "open"
} ] }
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 https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpccrossregiondisasterrecoverysetting.md
+
+ Title: "cloudPcCrossRegionDisasterRecoverySetting resource type"
+description: "Represents the settings for cross-region disaster recovery on a Cloud PC."
+
+ms.localizationpriority: medium
+
+toc. Title: Cloud PC cross-region disaster recovery setting
++
+# cloudPcCrossRegionDisasterRecoverySetting resource type
+
+Namespace: microsoft.graph
++
+Represents the settings for cross-region disaster recovery on a Cloud PC.
+
+## Properties
+
+|Property|Type|Description|
+|:|:|:|
+|crossRegionDisasterRecoveryEnabled|Boolean|`True` if an end user is allowed to set up cross-region disaster recovery for Cloud PC; otherwise, `false`. The default value is `false`.|
+|disasterRecoveryNetworkSetting|[cloudPcDisasterRecoveryNetworkSetting](../resources/cloudpcdisasterrecoverynetworksetting.md)|Indicates the network settings of the Cloud PC during a cross-region disaster recovery operation.|
+|maintainCrossRegionRestorePointEnabled|Boolean|Indicates whether Windows 365 maintain the cross-region disaster recovery function generated restore points. If `true`, the Windows 365 stored restore points; `false` indicates that Windows 365 doesn't generate or keep the restore point from the original Cloud PC. If a disaster occurs, the new Cloud PC can only be provisioned using the initial image. This limitation can result in the loss of some user data on the original Cloud PC. The default value is `false`.|
+
+## Relationships
+
+None.
+
+## JSON representation
+
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.cloudPcCrossRegionDisasterRecoverySetting"
+}
+-->
+
+``` json
+{
+ "@odata.type": "#microsoft.graph.cloudPcRestorePointSetting",
+ "crossRegionDisasterRecoveryEnabled": "Boolean",
+ "disasterRecoveryNetworkSetting": {"@odata.type": "microsoft.graph.cloudPcDisasterRecoveryNetworkSetting"},
+ "maintainCrossRegionRestorePointEnabled": "Boolean"
+}
+```
v1.0 Cloudpcdisasterrecoveryazureconnectionsetting https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcdisasterrecoveryazureconnectionsetting.md
+
+ Title: "cloudPcDisasterRecoveryAzureConnectionSetting resource type"
+description: "Represents the Azure network connection configuration of backup Cloud PCs provisioned for cross-region disaster recovery."
+
+ms.localizationpriority: medium
+++
+# cloudPcDisasterRecoveryAzureConnectionSetting resource type
+
+Namespace: microsoft.graph
++
+Represents the Azure network connection configuration of backup Cloud PCs provisioned for cross-region disaster recovery.
+
+Inherits from [cloudPcDisasterRecoveryNetworkSetting](../resources/cloudpcdisasterrecoverynetworksetting.md).
+
+## Properties
+
+|Property|Type|Description|
+|:|:|:|
+|onPremisesConnectionId|String|Indicates the unique ID of the virtual network that the new Cloud PC joins.|
+
+## Relationships
+
+None.
+
+## JSON representation
+
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.cloudPcDisasterRecoveryAzureConnectionSetting"
+}
+-->
+
+``` json
+{
+ "@odata.type": "#microsoft.graph.cloudPcDisasterRecoveryAzureConnectionSetting",
+ "onPremisesConnectionId": "String"
+}
+```
v1.0 Cloudpcdisasterrecoverymicrosofthostednetworksetting https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcdisasterrecoverymicrosofthostednetworksetting.md
+
+ Title: "cloudPcDisasterRecoveryMicrosoftHostedNetworkSetting resource type"
+description: "Represents the configuration of Microsoft-hosted network for backup Cloud PCs provisioned for cross-region disaster recovery."
+
+ms.localizationpriority: medium
+++
+# cloudPcDisasterRecoveryMicrosoftHostedNetworkSetting resource type
+
+Namespace: microsoft.graph
++
+Represents the configuration of Microsoft-hosted network for backup Cloud PCs provisioned for cross-region disaster recovery.
+
+Inherits from [cloudPcDisasterRecoveryNetworkSetting](../resources/cloudpcdisasterrecoverynetworksetting.md).
+
+## Properties
+
+|Property|Type|Description|
+|:|:|:|
+|regionGroup|[cloudPcRegionGroup](../resources/cloudpcsupportedregion.md#cloudpcregiongroup-values)|Indicates the logic geographic group this region belongs to. Multiple regions can belong to one region group. When a region group is configured for disaster recovery, the new Cloud PC is assigned to one of the regions within the group based on resource availability. For example, the `europeUnion` region group contains the North Europe and West Europe regions. Possible values are: `default`, `australia`, `canada`, `usCentral`, `usEast`, `usWest`, `france`, `germany`, `europeUnion`, `unitedKingdom`, `japan`, `asia`, `india`, `southAmerica`, `euap`, `usGovernment`, `usGovernmentDOD`, `unknownFutureValue`, `norway`, `switzerland`,`southKorea`. You must use the `Prefer: include-unknown-enum-members` request header to get the following values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `norway`, `switzerland`,`southKorea`.|
+|regionName|String|Indicates the Azure region that the new Cloud PC is assigned to. The Windows 365 service creates and manages the underlying virtual network.|
+
+## Relationships
+
+None.
+
+## JSON representation
+
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.cloudPcDisasterRecoveryMicrosoftHostedNetworkSetting"
+}
+-->
+
+``` json
+{
+ "@odata.type": "#microsoft.graph.cloudPcDisasterRecoveryMicrosoftHostedNetworkSetting",
+ "regionGroup": "String",
+ "regionName": "String"
+}
+```
v1.0 Cloudpcdisasterrecoverynetworksetting https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcdisasterrecoverynetworksetting.md
+
+ Title: "cloudPcDisasterRecoveryNetworkSetting resource type"
+description: "An abstract type that represents the network configuration of backup Cloud PCs provisioned for cross-region disaster recovery."
+
+ms.localizationpriority: medium
+++
+# cloudPcDisasterRecoveryNetworkSetting resource type
+
+Namespace: microsoft.graph
++
+An abstract type that represents the network configuration of backup Cloud PCs provisioned for cross-region disaster recovery.
+
+Base type of [cloudPcDisasterRecoveryAzureConnectionSetting](../resources/cloudpcdisasterrecoveryazureconnectionsetting.md) and [cloudPcDisasterRecoveryMicrosoftHostedNetworkSetting](../resources/cloudpcdisasterrecoverymicrosofthostednetworksetting.md)
+
+## Properties
+
+None.
+
+## Relationships
+
+None.
+
+## JSON representation
+
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.cloudPcDisasterRecoveryNetworkSetting"
+}
+-->
+
+``` json
+{
+ "@odata.type": "#microsoft.graph.cloudPcDisasterRecoveryNetworkSetting"
+}
+```
v1.0 Cloudpcshareduseserviceplan https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcshareduseserviceplan.md
- Title: "cloudPcSharedUseServicePlan resource type (deprecated)"
-description: "Represents a shared-use service plan available for use by up to three Cloud PCs."
--
-doc_type: resourcePageType
--
-# cloudPcSharedUseServicePlan resource type (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).
-
-Represents a shared-use service plan available for use by up to three Cloud PCs.
-
-## Methods
-
-|Method|Return type|Description|
-|:|:|:|
-|[List](../api/virtualendpoint-list-shareduseserviceplans.md)|[cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.md) collection|Get a list of the [cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.md) objects and their properties.|
-|[Get](../api/cloudpcshareduseserviceplan-get.md)|[cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.md)|Read the properties and relationships of a [cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.md) object.|
-
-## Properties
-
-| Property | Type | Description |
-|:|:-|:--|
-| displayName | String | The display name of the shared-use service plan. |
-| id | String | The unique identifier for the shared-use service plan. |
-| totalCount | Int32 | Total number of shared-use service plans purchased by the customer. |
-| usedCount | Int32 | The number of service plans that the account uses. |
-
-## Relationships
-
-None.
-
-## JSON representation
-
-The following JSON representation shows the resource type.
-
-<!-- {
- "blockType": "resource",
- "keyProperty": "id",
- "@odata.type": "microsoft.graph.cloudPcSharedUseServicePlan",
- "baseType": "microsoft.graph.entity",
- "openType": false
-}
>
-``` json
-{
- "@odata.type": "#microsoft.graph.cloudPcSharedUseServicePlan",
- "displayName": "String",
- "id": "String (identifier)",
- "usedCount": "Int32",
- "totalCount": "Int32"
-}
-```
v1.0 Cloudpcusersetting https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcusersetting.md
Represents a Cloud PC user setting.
|Property|Type|Description| |:|:|:| |createdDateTime|DateTimeOffset|The date and time the setting was created. The timestamp type represents the date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 looks like this: '2014-01-01T00:00:00Z'.ΓÇ»|
+|crossRegionDisasterRecoverySetting|[cloudPcCrossRegionDisasterRecoverySetting](../resources/cloudpccrossregiondisasterrecoverysetting.md)|Defines whether the user's Cloud PC enables cross-region disaster recovery and specifies the network for the disaster recovery.|
|displayName|String|The setting name displayed in the user interface. | |id|String|Unique identifier for the Cloud PC user setting. Read-only.| |lastModifiedDateTime|DateTimeOffset|The last date and time the setting was modified. The timestamp type represents the date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 looks like this:ΓÇ»'2014-01-01T00:00:00Z'.ΓÇ»| |localAdminEnabled|Boolean|Indicates whether the local admin option is enabled. Default value is `false`. To enable the local admin option, change the setting to `true`. If the local admin option is enabled, the end user can be an admin of the Cloud PC device. |
-|resetEnabled|Boolean|Indicates whether an end user is allowed to reset their Cloud PC. When `true`, the user is allowed to reset their Cloud PC. When `false`, end-user initiated reset is not allowed. The default value is `false`. |
+|resetEnabled|Boolean|Indicates whether an end user is allowed to reset their Cloud PC. When `true`, the user is allowed to reset their Cloud PC. When `false`, end-user initiated reset isn't allowed. The default value is `false`. |
|restorePointSetting|[cloudPcRestorePointSetting](../resources/cloudpcrestorepointsetting.md)|Defines how frequently a restore point is created that is, a snapshot is taken) for users' provisioned Cloud PCs (default is 12 hours), and whether the user is allowed to restore their own Cloud PCs to a backup made at a specific point in time.| |selfServiceEnabled (deprecated)|Boolean|Indicates whether the self-service option is enabled. Default value is `false`. To enable the self-service option, change the setting to `true`. If the self-service option is enabled, the end user is allowed to perform some self-service operations, such as upgrading the Cloud PC through the end user portal. The **selfServiceEnabled** property is deprecated and will stop returning data on December 1, 2023.|
The following JSON representation shows the resource type.
{ "@odata.type": "#microsoft.graph.cloudPcUserSetting", "createdDateTime": "String (timestamp)",
+ "crossRegionDisasterRecoverySetting": {"@odata.type": "microsoft.graph.cloudPcCrossRegionDisasterRecoverySetting"},
"displayName": "String", "id": "String (identifier)", "lastModifiedDateTime": "String (timestamp)",
v1.0 Cloudpcwindowssetting https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcwindowssetting.md
ms.localizationpriority: medium doc_type: resourcePageType
+toc. Title: Cloud PC Windows setting
# cloudPcWindowsSetting resource type
v1.0 Cloudpcwindowssettings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpcwindowssettings.md
ms.localizationpriority: medium doc_type: resourcePageType
+toc. Title: Cloud PC Windows settings
# cloudPcWindowsSettings resource type
v1.0 Community https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/community.md
Inherits from [entity](../resources/entity.md).
|[Create](../api/employeeexperience-post-communities.md)|[engagementAsyncOperation](../resources/engagementasyncoperation.md)|Create a new [community](../resources/community.md) in Viva Engage.| |[Get](../api/community-get.md)|[community](../resources/community.md)|Read the properties and relationships of a [community](../resources/community.md) object.| |[Update](../api/community-update.md)|None|Update the properties of an existing Viva Engage [community](../resources/community.md).|
-|[Delete](../api/community-delete.md)|None|Delete a [community](../resources/community.md) in Viva Engage.|
+|[Delete](../api/community-delete.md)|None|Delete a Viva Engage [community](../resources/community.md) along with all associated Microsoft 365 content, including the connected Microsoft 365 group, OneNote notebook, and Planner plans.|
## Properties |Property|Type|Description| |:|:|:|
-| description | String | The description of the community. The maximum length is 1024 characters. |
+| description | String | The description of the community. The maximum length is 1,024 characters. |
| displayName | String | The name of the community. The maximum length is 255 characters. | | groupId | String | The ID of the [Microsoft 365 group](../resources/group.md) that manages the membership of this community. |
-| id | String | The unique identifier of the community. Read only. Inherited from [entity](../resources/entity.md). |
+| id | String | The unique identifier of the community. Read-only. Inherited from [entity](../resources/entity.md). |
| privacy | [communityPrivacy](../resources/community.md#communityprivacy-values) | Defines the privacy level of the community. The possible values are: `public`, `private`, `unknownFutureValue`. | ### communityPrivacy values
v1.0 Companydetail https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/companydetail.md
Represents information about companies related to entities within their [profile
|displayName |String | Company name. | |officeLocation |String | Office Location of the person referred to. | |pronunciation |String | Pronunciation guide for the company name. |
+|secondaryDepartment|String | Secondary Department Name within a company. |
|webUrl |String | Link to the company home page. | ## JSON representation
The following JSON representation shows the resource type.
"displayName": "String", "officeLocation": "String", "pronunciation": "String",
+ "secondaryDepartment": "String",
"webUrl": "String" } ```
v1.0 Contact https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/contact.md
by providing a [delta](../api/contact-delta.md) function.
## Methods | Method | Return Type |Description| |:|:--|:-|
-|[Get contact](../api/contact-get.md) | [contact](contact.md) |Read properties and relationships of contact object.|
-|[Create contact](../api/user-post-contacts.md) | [contact](contact.md) |Add a contact to the root Contacts folder or to the contacts endpoint of another contact folder.|
-|[Update contact](../api/contact-update.md) | [contact](contact.md) |Update contact object. |
-|[Delete contact](../api/contact-delete.md) | None |Delete contact object. |
+|[Get](../api/contact-get.md) | [contact](contact.md) |Read properties and relationships of contact object.|
+|[Create](../api/user-post-contacts.md) | [contact](contact.md) |Add a contact to the root Contacts folder or to the contacts endpoint of another contact folder.|
+|[Update](../api/contact-update.md) | [contact](contact.md) |Update contact object. |
+|[Delete](../api/contact-delete.md) | None |Delete contact object. |
+|[Permanently delete](../api/contact-permanentdelete.md)|None|Permanently delete a contact and place it in the Purges folder in the Recoverable Items folder in the user's mailbox.|
|[Get contact delta](../api/contact-delta.md)|[contact](contact.md) collection| Get a set of contacts that have been added, deleted, or updated in a specified folder.| |**Open extensions**| | | |[Create open extension](../api/opentypeextension-post-opentypeextension.md) |[openTypeExtension](opentypeextension.md)| Create an open extension and add custom properties to a new or existing resource.|
by providing a [delta](../api/contact-delta.md) function.
|assistantName|String|The name of the contact's assistant.| |birthday|DateTimeOffset|The contact's birthday. 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`| |categories|String collection|The categories associated with the contact. Each category corresponds to the **displayName** property of an [outlookCategory](outlookcategory.md) defined for the user.|
-|changeKey|String|Identifies the version of the contact. Every time the contact is changed, ChangeKey changes as well. This allows Exchange to apply changes to the correct version of the object.|
+|changeKey|String|Identifies the version of the contact. Every time the contact is changed, **changeKey** changes as well, which allows Exchange to apply changes to the correct version of the object.|
|children|String collection|The names of the contact's children.| |companyName|String|The name of the contact's company.| |createdDateTime|DateTimeOffset|The time the contact was created. 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`| |department|String|The contact's department.|
-|displayName|String|The contact's display name. You can specify the display name in a [create](../api/user-post-contacts.md) or [update](../api/contact-update.md) operation. Note that later updates to other properties may cause an automatically generated value to overwrite the displayName value you have specified. To preserve a pre-existing value, always include it as displayName in an [update](../api/contact-update.md) operation.|
+|displayName|String|The contact's display name. You can specify the display name in a [create](../api/user-post-contacts.md) or [update](../api/contact-update.md) operation. Later updates to other properties might cause an automatically generated value to overwrite the displayName value you specified. To preserve a pre-existing value, always include it as displayName in an [update](../api/contact-update.md) operation.|
|emailAddresses|[typedEmailAddress](typedemailaddress.md) collection|The contact's email addresses.| |fileAs|String|The name the contact is filed under.| |flag|[followupFlag](followupflag.md)|The flag value that indicates the status, start date, due date, or completion date for the contact. |
v1.0 Contactfolder https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/contactfolder.md
by providing a [delta](../api/contactfolder-delta.md) function.
| Method | Return Type |Description| |:|:--|:-|
-|[Get contact folder](../api/contactfolder-get.md) | [contactFolder](contactfolder.md) |Get a contact folder by using the contact folder ID.|
-|[Update contact folder](../api/contactfolder-update.md) | [contactFolder](contactfolder.md) |Update **contactFolder** object. |
-|[Delete contact folder](../api/contactfolder-delete.md) | None |Delete a **contactFolder** object. |
+|[Get](../api/contactfolder-get.md) | [contactFolder](contactfolder.md) |Get a contact folder by using the contact folder ID.|
+|[Update](../api/contactfolder-update.md) | [contactFolder](contactfolder.md) |Update **contactFolder** object. |
+|[Delete](../api/contactfolder-delete.md) | None |Delete a **contactFolder** object. |
+|[Permanently delete](../api/contactfolder-permanentdelete.md)|None|Permanently delete a contact folder and remove its items from the user's mailbox.|
|[List child folders](../api/contactfolder-list-childfolders.md) |[contactFolder](contactfolder.md) collection| Get a collection of child folders under the specified contact folder.| |[Create child folder](../api/contactfolder-post-childfolders.md) |[contactFolder](contactfolder.md)| Create a new **contactFolder** as a child of a specified folder.|
-|[Get contact delta](../api/contact-delta.md)|[contact](contact.md) collection| Get a set of contact folders that have been added, deleted, or removed from the user's mailbox.|
+|[Get contact delta](../api/contact-delta.md)|[contact](contact.md) collection| Get a set of contact folders that were added, deleted, or removed from the user's mailbox.|
|[List contacts in folder](../api/contactfolder-list-contacts.md) |[contact](contact.md) collection| Get a contact collection from the default contacts folder of the signed-in user (`.../me/contacts`), or from the specified contact folder.| |[Create contact in folder](../api/contactfolder-post-contacts.md) |[contact](contact.md)| Add a contact to the root contacts folder or to the `contacts` endpoint of another contact folder.| |**Extended properties**| | |
v1.0 Devicedetail https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/devicedetail.md
doc_type: resourcePageType
# deviceDetail resource type Namespace: microsoft.graph
-Indicates device details associated with a device used for signing in. Includes information like device browser and OS info, if device is Microsoft Entra ID managed.
-
+Indicates details of the device used in a sign-in activity. Includes information like device browser and OS info and if the device is Microsoft Entra ID-managed.
## Properties | Property | Type |Description| |:|:--|:-|
-|browser|String|Indicates the browser information of the used for signing-in.|
-|deviceId|String|Refers to the UniqueID of the device used for signing-in.|
-|displayName|String|Refers to the name of the device used for signing-in.|
+|browser|String|Indicates the browser information of the used in the sign-in. Populated for devices registered in Microsoft Entra.|
+|deviceId|String|Refers to the unique ID of the device used in the sign-in. Populated for devices registered in Microsoft Entra.|
+|displayName|String|Refers to the name of the device used in the sign-in. Populated for devices registered in Microsoft Entra.|
|isCompliant|Boolean|Indicates whether the device is compliant or not.| |isManaged|Boolean|Indicates if the device is managed or not.|
-|operatingSystem|String|Indicates the OS name and version used for signing-in.|
-|trustType|String|Indicates information on whether the signed-in device is Workplace Joined, AzureAD Joined, Domain Joined. |
+|operatingSystem|String|Indicates the OS name and version used in the sign-in.|
+|trustType|String|Indicates information on whether the device used in the sign-in is workplace-joined, Microsoft Entra-joined, domain-joined.|
## JSON representation
v1.0 Education Overview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/education-overview.md
Title: "Working with education APIs in Microsoft Graph"
-description: "The education APIs in Microsoft Graph enhance Microsoft 365 resources and data with information that is relevant for education scenarios, including schools, students, teachers, classes, enrollments, and assignments. This makes it easy for you to build solutions that integrate with educational resources."
+description: "The education APIs in Microsoft Graph enhance Microsoft 365 resources and data with information that is relevant for education scenarios, including schools, students, teachers, classes, enrollments, and assignments."
ms.localizationpriority: medium
The education APIs include rostering resources and assignments resources that yo
## Authorization
-To call the education APIs in Microsoft Graph, your app will need to acquire an access token. For details about access tokens, see [Get access tokens to call Microsoft Graph](/graph/auth/). Your app will also need the appropriate permissions. For more information, see [Education permissions](/graph/permissions-reference#education-permissions).
+To call the education APIs in Microsoft Graph, your app needs to acquire an access token. For details about access tokens, see [Get access tokens to call Microsoft Graph](/graph/auth/). Your app also needs the appropriate permissions. For more information, see [Education permissions](/graph/permissions-reference#education-permissions).
### App permissions to enable school IT admins to consent
The rostering APIs provide the following key resources:
- [educationSchool](educationschool.md) - Represents the school. - [educationClass](educationclass.md) - Represents a class within a school. - [educationTerm](educationterm.md) - Represents a designated portion of the academic year.-- [educationTeacher](educationteacher.md) - Represents a users with the primary role of 'Teacher'.-- [educationStudent](educationstudent.md) - Represents a users with the primary role of 'student'.
+- [educationTeacher](educationteacher.md) - Represents a user with the primary role of 'Teacher'.
+- [educationStudent](educationstudent.md) - Represents a user with the primary role of 'student'.
The rostering APIs support the following scenarios:
The following are some common use cases for the assignment-related education API
| Read assignment information | An analytics application can get information about assignments and student submissions, including dates and grades. | [Get assignment](../api/educationassignment-get.md) | | Track student submissions | Your app can provide a teacher dashboard that shows how many submissions from students need to be graded. | [Submission resource](educationsubmission.md) |
+## Classwork
+
+You can use Classwork as a one-stop shop to create and organize class resources, including assignments, OneNote Class Notebook pages, web links, files, and Teams channels. This means you no longer have to navigate multiple apps and platforms to find what you need. With Classwork, you can curate a view of content and resources that helps your students navigate the class and see everything in one place.
+
+The Classwork API provides the following key resources:
+
+- [educationModule](educationmodule.md) - A module is associated with a class. Represents a group of individual learning resources that are organized in a systematic way.
+- [educationModuleResource](educationmoduleresource.md) - A wrapper object that stores the resources associated with a module. The student is unable to update this resource, which is a handout from the teacher to the student with nothing to be turned in.
+
+The following lists show the scenarios supported by the Classwork API.
+
+### Modules
+
+The **educationModule** resource supports the following scenarios:
+
+- [List modules](../api/educationclass-list-modules.md)
+- [Create module](../api/educationclass-post-module.md)
+- [Get module](../api/educationmodule-get.md)
+- [Update module](../api/educationmodule-update.md)
+- [Delete module](../api/educationmodule-delete.md)
+- [Pin module](../api/educationmodule-pin.md)
+- [Unpin module](../api/educationmodule-unpin.md)
+- [Publish module](../api/educationmodule-publish.md)
+- [Set up module resources folder](../api/educationmodule-setupresourcesfolder.md)
+
+### Module resources
+
+The **educationModuleResource** resource supports the following scenarios:
+
+- [List module resources](../api/educationmodule-list-resources.md)
+- [Create module resource](../api/educationmodule-post-resources.md)
+- [Get module resource](../api/educationmoduleresource-get.md)
+- [Update module resource](../api/educationmoduleresource-update.md)
+- [Delete resource from module](../api/educationmoduleresource-delete.md)
+
+### Common use cases
+
+The following table shows some common use cases for the module-related education APIs.
+
+| Use case | Description | See also |
+|:|:--|:-|
+| Create a module | Only teachers in a class can create a module. Modules start in the draft state, which means that students don't see the modules until publication. | [Create educationModule](../api/educationclass-post-module.md) |
+| List modules | A teacher or an application with application permissions can see all module objects for the class. Students can only see published modules. | [List class modules](../api/educationclass-list-modules.md) |
+| Publish a module | Changes the state of an **educationModule** from its original `draft` status to the `published` status. | [educationModule: publish](../api/educationmodule-publish.md) |
+| Create a resource in a module | Only teachers can perform this operation. | [Create educationModuleResource](../api/educationmodule-post-resources.md) |
+| List module resources | Get all the **educationModuleResource** objects associated with a module. Only teachers, students, and applications with application permissions can perform this operation. | [List module resources](../api/educationmodule-list-resources.md) |
+ ## School data sync management [School Data Sync](https://sds.microsoft.com/) helps to automate the process of importing and synchronizing roster data from student information systems with Microsoft Entra ID and Microsoft 365. You can use the school data sync management APIs in Microsoft Graph to set up synchronization from either a CSV file or a supported SIS API connector.
v1.0 Educationclass https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/educationclass.md
Students are regular members of the class, and Teachers are owners and have appr
## Methods
-| Method | Return Type | Description |
-| :- | : | :- |
-| [Get class](../api/educationclass-get.md) | [educationClass] | Read properties and relationships of an **educationClass** object. |
-| [Add member](../api/educationclass-post-members.md) | [educationUser] | Add a new **educationUser** for the class by posting to the members navigation property. |
-| [List members](../api/educationclass-list-members.md) | [educationUser] collection | Get an **educationUser** object collection. |
-| [Remove member](../api/educationclass-delete-members.md) | [educationUser] | Remove an **educationUser** from the class through the members navigation property. |
-| [List schools](../api/educationclass-list-schools.md) | [educationSchool] collection | Get an **educationSchool** object collection. |
-| [Add teacher](../api/educationclass-post-teachers.md) | [educationUser] | Add a new **educationUser** for the class by posting to the teachers navigation property. |
-| [List teachers](../api/educationclass-list-teachers.md) | [educationUser] collection | Get a list of teachers for the class. |
-| [Remove teacher](../api/educationclass-delete-teachers.md) | [educationUser] | Remove an **educationUser** from the class through the teachers navigation property. |
-| [Create](../api/educationclass-post-assignments.md) | [educationAssignment] | Create a new **educationAssignment** by posting to the assignments collection. |
-| [List assignments](../api/educationclass-list-assignments.md) | [educationAssignment]collection | Get an **educationAssignment** object collection. |
-| [List modules](../api/educationclass-list-modules.md) | [educationModule]collection | Get an **educationModule** object collection. |
-| [Get group](../api/educationclass-get-group.md) | [group] | Get the Microsoft 365 **group** that corresponds to this **educationClass**. |
-| [Create category](../api/educationclass-post-category.md) | [educationCategory] | Create a new **educationCategory** for this class. |
-| [List categories](../api/educationclass-list-categories.md) | [educationCategory] collection | Get a list of **educationCategory** objects that belong to this class. |
-| [Update class](../api/educationclass-update.md) | [educationClass] | Update **educationClass** object. |
-| [Delete class](../api/educationclass-delete.md) | None | Delete **educationClass** object. |
-| [Get delta](../api/educationclass-delta.md) | [educationClass](educationclass.md) collection | Get incremental changes for **educationClasses**. |
+|Method|Return Type|Description|
+|:--|:-|:-|
+|[Get class](../api/educationclass-get.md)|[educationClass]|Read properties and relationships of an **educationClass** object.|
+|[Add member](../api/educationclass-post-members.md)|[educationUser]|Add a new **educationUser** for the class by posting to the members navigation property.|
+|[List members](../api/educationclass-list-members.md)|[educationUser] collection|Get an **educationUser** object collection.|
+|[Remove member](../api/educationclass-delete-members.md)|[educationUser]|Remove an **educationUser** from the class through the members navigation property.|
+|[List schools](../api/educationclass-list-schools.md)|[educationSchool] collection|Get an **educationSchool** object collection.|
+|[Add teacher](../api/educationclass-post-teachers.md)|[educationUser]|Add a new **educationUser** for the class by posting to the teachers navigation property.|
+|[List teachers](../api/educationclass-list-teachers.md)|[educationUser] collection|Get a list of teachers for the class.|
+|[Remove teacher](../api/educationclass-delete-teachers.md)|[educationUser]|Remove an **educationUser** from the class through the teachers navigation property.|
+|[Create](../api/educationclass-post-assignments.md)|[educationAssignment]|Create a new **educationAssignment** by posting to the assignments collection.|
+|[List assignments](../api/educationclass-list-assignments.md)|[educationAssignment] collection|Get an **educationAssignment** object collection.|
+|[List modules](../api/educationclass-list-modules.md)|[educationModule] collection|Get an **educationModule** object collection.|
+|[Get group](../api/educationclass-get-group.md)|[group]|Get the Microsoft 365 **group** that corresponds to this **educationClass**.|
+|[Create category](../api/educationclass-post-category.md)|[educationCategory]|Create a new **educationCategory** for this class.|
+|[List categories](../api/educationclass-list-categories.md)|[educationCategory] collection|Get a list of **educationCategory** objects that belong to this class.|
+|[Update class](../api/educationclass-update.md)|[educationClass]|Update **educationClass** object.|
+|[Delete class](../api/educationclass-delete.md)|None|Delete **educationClass** object.|
+|[Get delta](../api/educationclass-delta.md)|[educationClass](educationclass.md) collection|Get incremental changes for **educationClasses**.|
+|[Get recently modified submissions](../api/educationclass-getrecentlymodifiedsubmissions.md)|[educationSubmission](../resources/educationsubmission.md) collection|Retrieve submissions modified in the previous seven days.|
## Properties
-| Property | Type | Description |
-| :- | : | :- |
-| id | String | Unique identifier for the class. |
-| classCode | String | Class code used by the school to identify the class. |
-| course | [educationCourse](educationcourse.md) | Course information for the class. |
-| createdBy | [identitySet] | Entity who created the class. |
-| description | String | Description of the class. |
-| displayName | String | Name of the class. |
-| externalId | String | ID of the class from the syncing system. |
-| externalName | String | Name of the class in the syncing system. |
-| externalSource | String | The type of external source this resource was generated from (automatically determined from `externalSourceDetail`). Possible values are: `sis`, `lms`, or `manual`. |
-| externalSourceDetail | String | The name of the external source this resources was generated from. |
-| grade | String | Grade level of the class. |
-| mailNickname | String | Mail name for sending email to all members, if this is enabled. |
-| term | [educationTerm] | Term for the class. |
+|Property|Type|Description|
+|:-|:|:-|
+|id|String|Unique identifier for the class.|
+|classCode|String|Class code used by the school to identify the class.|
+|course|[educationCourse](educationcourse.md)|Course information for the class.|
+|createdBy|[identitySet]|Entity who created the class.|
+|description|String|Description of the class.|
+|displayName|String|Name of the class.|
+|externalId|String|ID of the class from the syncing system.|
+|externalName|String|Name of the class in the syncing system.|
+|externalSource|String|The type of external source this resource was generated from (automatically determined from `externalSourceDetail`). Possible values are: `sis`, `lms`, or `manual`.|
+|externalSourceDetail|String|The name of the external source from which this resource was generated.|
+|grade|String|Grade level of the class.|
+|mailNickname|String|Mail name for sending email to all members, if this is enabled.|
+|term|[educationTerm]|Term for the class.|
## Relationships
-| Relationship | Type | Description |
-| :-- | :- | :-- |
-| assignments | [educationAssignment] collection | All assignments associated with this class. Nullable. |
-| members | [educationUser] collection | All users in the class. Nullable. |
-| modules | [educationModule] collection | All modules in the class. Nullable. |
-| schools | [educationSchool] collection | All schools that this class is associated with. Nullable. |
-| teachers | [educationUser] collection | All teachers in the class. Nullable. |
-|assignmentCategories| [educationCategory](educationcategory.md) collection | All categories associated with this class. Nullable. |
-|assignmentDefaults| [educationAssignmentDefaults](educationassignmentdefaults.md) collection | Specifies class-level defaults respected by new assignments created in the class. |
-|assignmentSettings| [educationAssignmentSettings](educationassignmentsettings.md) collection | Specifies class-level assignments settings. |
+|Relationship|Type|Description|
+|:--|:|:-|
+|assignments|[educationAssignment] collection|All assignments associated with this class. Nullable.|
+|members|[educationUser] collection|All users in the class. Nullable.|
+|modules|[educationModule] collection|All modules in the class. Nullable.|
+|schools|[educationSchool] collection|All schools that this class is associated with. Nullable.|
+|teachers|[educationUser] collection|All teachers in the class. Nullable.|
+|assignmentCategories|[educationCategory](educationcategory.md) collection|All categories associated with this class. Nullable.|
+|assignmentDefaults|[educationAssignmentDefaults](educationassignmentdefaults.md) collection|Specifies class-level defaults respected by new assignments created in the class.|
+|assignmentSettings|[educationAssignmentSettings](educationassignmentsettings.md) collection|Specifies class-level assignments settings.|
## JSON representation
v1.0 Educationsubmission https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/educationsubmission.md
If [setUpResourcesFolder](../api/educationsubmission-setupResourcesFolder.md) ha
## Methods
-| Method | Return Type |Description|
-|:|:--|:-|
-|[Get submission](../api/educationsubmission-get.md) | [educationSubmission](educationsubmission.md) |Read properties and relationships of an **educationSubmission** object.|
-|[List submission resources](../api/educationsubmission-list-resources.md) |[educationSubmissionResource](educationsubmissionresource.md) collection| Get an **educationSubmissionResource** object collection.|
-|[List submitted resources](../api/educationsubmission-list-submittedresources.md) |[educationSubmissionResource](educationsubmissionresource.md) collection| Get an **educationSubmissionResource** object collection.|
-|[List outcomes](../api/educationsubmission-list-outcomes.md) |[educationOutcome](educationoutcome.md) collection| Get an **educationOutcome** object collection.|
+|Method|Return Type|Description|
+|:--|:-|:-|
+|[Get submission](../api/educationsubmission-get.md)|[educationSubmission](educationsubmission.md)|Read properties and relationships of an **educationSubmission** object.|
+|[List submission resources](../api/educationsubmission-list-resources.md)|[educationSubmissionResource](educationsubmissionresource.md) collection|Get an **educationSubmissionResource** object collection.|
+|[List submitted resources](../api/educationsubmission-list-submittedresources.md)|[educationSubmissionResource](educationsubmissionresource.md) collection|Get an **educationSubmissionResource** object collection.|
+|[List outcomes](../api/educationsubmission-list-outcomes.md)|[educationOutcome](educationoutcome.md) collection|Get an **educationOutcome** object collection.|
|[Excuse submission](../api/educationsubmission-excuse.md)|[educationSubmission](educationsubmission.md)|Indicates that the submission has no further action for the student and isn't included in average grade calculations.| |[Return submission](../api/educationsubmission-return.md)|[educationSubmission](educationsubmission.md)|A teacher uses return to indicate that the grades/feedback can be shown to the student.| |[Reassign submission](../api/educationsubmission-reassign.md)|[educationSubmission](educationsubmission.md)|Reassign the submission to the student with feedback for review.|
-|[Set up submission resources folder](../api/educationsubmission-setupresourcesfolder.md) |[educationSubmission](educationsubmission.md) | Create a SharePoint folder (under pre-defined location) to upload files as submission resources. |
+|[Set up submission resources folder](../api/educationsubmission-setupresourcesfolder.md)|[educationSubmission](educationsubmission.md)|Create a SharePoint folder (under a predefined location) to upload files as submission resources.|
|[Submit submission](../api/educationsubmission-submit.md)|[educationSubmission](educationsubmission.md)|A student uses submit to turn in the **assignment**. This operation copies the resources into the **submittedResources** folder for grading and updates the status.| |[Unsubmit submission](../api/educationsubmission-unsubmit.md)|[educationSubmission](educationsubmission.md)|A student uses the unsubmit to move the state of the submission from submitted back to working. This operation copies the resources into the **workingResources** folder for grading and updates the status.| ## Properties
-| Property | Type |Description|
-|:|:--|:-|
+|Property|Type|Description|
+|:-|:|:-|
+|assignmentId|String|The unique identifier for the assignment with which this submission is associated. A submission is always associated with one and only one assignment.|
+|excusedBy|[identitySet](identityset.md)|The user that marked the submission as excused.|
+|excusedDateTime|DateTimeOffset|Moment in time when the submission was moved to the excused state. 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`.|
|id|String|Unique identifier for the submission.|
+|lastModifiedBy|[identitySet](../resources/intune-rbac-identityset.md)|The identities of those who modified the submission.|
+|lastModifiedDateTime|DateTimeOffset|The date and time the submission was modified.|
+|reassignedBy|[identitySet](identityset.md)|User who moved the status of this submission to reassigned.|
+|reassignedDateTime|DateTimeOffset|Moment in time when the submission was reassigned. 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`.|
|recipient|[educationSubmissionRecipient](educationsubmissionrecipient.md)|Who this submission is assigned to.|
+|resourcesFolderUrl|String|Folder where all file resources for this submission need to be stored.|
|returnedBy|[identitySet](identityset.md)|User who moved the status of this submission to returned.| |returnedDateTime|DateTimeOffset|Moment in time when the submission was returned. 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`.|
-|resourcesFolderUrl|String|Folder where all file resources for this submission need to be stored.|
-|status|educationSubmissionStatus| Read-only. Possible values are: `working`, `submitted`, `returned`, `unknownFutureValue`, `reassigned`, and `excused`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `reassigned`, and `excused`.|
+|status|educationSubmissionStatus|Read-only. Possible values are: `working`, `submitted`, `returned`, `unknownFutureValue`, `reassigned`, and `excused`. You must use the `Prefer: include-unknown-enum-members` request header to get the following values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `reassigned`, and `excused`.|
|submittedBy|[identitySet](identityset.md)|User who moved the resource into the submitted state.| |submittedDateTime|DateTimeOffset|Moment in time when the submission was moved into the submitted state. 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`.| |unsubmittedBy|[identitySet](identityset.md)|User who moved the resource from submitted into the working state.| |unsubmittedDateTime|DateTimeOffset|Moment in time when the submission was moved from submitted into the working state. 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`.|
-|reassignedBy|[identitySet](identityset.md)|User who moved the status of this submission to reassigned.|
-|reassignedDateTime|DateTimeOffset|Moment in time when the submission was reassigned. 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`.|
-|webUrl|String| The deep link URL for the given submission.|
+|webUrl|String|The deep link URL for the given submission.|
## Relationships
-| Relationship | Type |Description|
-|:|:--|:-|
-|resources|[educationSubmissionResource](educationsubmissionresource.md) collection| Nullable.|
-|submittedResources|[educationSubmissionResource](educationsubmissionresource.md) collection| Read-only. Nullable.|
+|Relationship|Type|Description|
+|:--|:|:-|
|outcomes|[educationOutcome](educationOutcome.md) collection. Holds grades, feedback and/or rubrics information the teacher assigns to this submission|Read-Write. Nullable.|
+|resources|[educationSubmissionResource](educationsubmissionresource.md) collection|Nullable.|
+|submittedResources|[educationSubmissionResource](educationsubmissionresource.md) collection|Read-only. Nullable.|
## JSON representation
The following JSON representation shows the resource type.
```json {
+ "excusedBy": {"@odata.type":"microsoft.graph.identitySet"},
+ "excusedDateTime": "String (timestamp)",
"id": "String (identifier)", "reassignedBy": {"@odata.type":"microsoft.graph.identitySet"}, "reassignedDateTime": "String (timestamp)",
v1.0 Employeeexperience https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/employeeexperience.md
Represents a container that exposes navigation properties for employee experienc
|Method|Return type|Description| |:|:|:|
+|[List communities](../api/employeeexperience-list-communities.md)|[community](../resources/community.md) collection|Get a list of the Viva Engage [community](../resources/community.md) objects and their properties.|
|[Create community](../api/employeeexperience-post-communities.md)|[community](../resources/community.md)|Create a new [community](../resources/community.md) in Viva Engage.|
-|[Get community](../api/community-get.md)|[community](../resources/community.md)|Read the properties and relationships of a [community](../resources/community.md) object.|
|[List learningProviders](../api/employeeexperience-list-learningproviders.md)|[learningProvider](../resources/learningprovider.md) collection|Get a list of the [learningProvider](../resources/learningprovider.md) resources registered in Viva Learning for a tenant.| |[Create learningProvider](../api/employeeexperience-post-learningproviders.md)|[learningProvider](../resources/learningprovider.md)|Create a new [learningProvider](../resources/learningprovider.md) object and register it with Viva Learning using the specified display name and logos for different themes.|
v1.0 Employeeorgdata https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/employeeorgdata.md
description: "Represents organization data associated with a user."
ms.localizationpriority: medium doc_type: resourcePageType -+ # employeeOrgData resource type
v1.0 Engagement Api Overview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/engagement-api-overview.md
Title: "Use the Microsoft Graph API to work with Viva Engage (preview)"
+ Title: "Use the Microsoft Graph API to work with Viva Engage"
description: "The Microsoft Graph API enables apps to manage communities in Viva Engage." ms.localizationpriority: medium
doc_type: conceptualPageType
-# Use the Microsoft Graph API to work with Viva Engage (preview)
+# Use the Microsoft Graph API to work with Viva Engage
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
For more information about the relationship between Viva Engage communities and
Viva Engage API calls are subject to rate limiting, allowing 10 requests per user, per app, within a 30-second time period. When you exceed the rate limit, all subsequent requests return a `429 Too Many Requests` response code.
-For guidance for how to handle throttling in Microsoft Graph, see [Microsoft Graph throttling guidance](/graph/throttling).
+For guidance on how to handle throttling in Microsoft Graph, see [Microsoft Graph throttling guidance](/graph/throttling).
## Next steps
v1.0 Engagementasyncoperation https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/engagementasyncoperation.md
Namespace: microsoft.graph
Represents the status of a Viva Engage async operation that is an operation that transcends the lifetime of a single API request. These operations are long-running or too expensive to complete within the time frame of their original request.
-When an async operation is initiated, the method returns a `202 Accepted` response code and an operation location header that contains the location of the **engagementAsyncOperation**. Periodically check the status of the operation by making a GET request to this location; wait >30 seconds between checks. When the request completes successfully, the operation **status** indicates `succeeded` and the **resourceLocation** points to the created or modified resource.
+When an async operation is initiated, the method returns a `202 Accepted` response code and an `Operation-Location` header that contains the location of the **engagementAsyncOperation**. Periodically check the status of the operation by making a GET request to this location; wait >30 seconds between checks. When the request completes successfully, the operation **status** indicates `succeeded` and the **resourceLocation** points to the created or modified resource.
Inherits from [longRunningOperation](../resources/longrunningoperation.md).
v1.0 Enums Partner Security https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/enums-partner-security.md
Namespace: microsoft.graph.partner.security
|investigating| |unknownFutureValue| +
+### complianceStatus values
+
+|Member|
+|:|
+|compliant|
+|noncomplaint|
+|unknownFutureValue|
+
+### policyStatus values
+
+|Member|
+|:|
+|enabled|
+|disabled|
+|unknownFutureValue|
+
+### securityRequirementState values
+
+|Member|
+|:|
+|active|
+|preview|
+|unknownFutureValue|
+
+### securityRequirementType values
+
+|Member|
+|:|
+|mfaEnforcedForAdmins|
+|mfaEnforcedForAdminsOfCustomers|
+|securityAlertsPromptlyResolved|
+|securityContactProvided|
+|spendingBudgetSetForCustomerAzureSubscriptions|
+|unknownFutureValue|
+ <!-- { "type": "#page.annotation",
v1.0 Enums https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/enums.md
Namespace: microsoft.graph
-# provisionState values
+### provisionState values
| Member | | -- |
Namespace: microsoft.graph
| provisioningCompleted | | unknownFutureValue |
-# approvalOperationStatus values
+### approvalOperationStatus values
| Member | | -- |
Namespace: microsoft.graph
| timeout | | unknownFutureValue |
-## approverRole values
+### approverRole values
| Member | | -- | | approver | | owner |
-## approvalItemState values
+### approvalItemState values
| Member | | -- |
Namespace: microsoft.graph
| pending | | completed |
-## approvalItemType values
+### approvalItemType values
| Member | | -- |
Namespace: microsoft.graph
| custom | | customAwaitAll |
-## responseFeedbackType values
+### responseFeedbackType values
| Member | | -- |
Namespace: microsoft.graph
| veryPleasant | | unknownFutureValue |
-## responseEmotionType values
+### responseEmotionType values
| Member | | -- |
Namespace: microsoft.graph
| sad | | unknownFutureValue |
-## virtualEventRegistrationPredefinedQuestionLabel values
+### virtualEventRegistrationPredefinedQuestionLabel values
| Member | | -- |
Namespace: microsoft.graph
| organization | | unknownFutureValue |
-## fileStorageContainerOwnershipType values
+### fileStorageContainerOwnershipType values
| Member | | -- | | tenantOwned | | unknownfuturevalue |
-## groupAccessType values
+### groupAccessType values
| Member | | -- |
Namespace: microsoft.graph
| secret | | public |
-## fileStorageContainerStatus values
+### fileStorageContainerStatus values
| Member | | -- |
Namespace: microsoft.graph
| active | | unknownfuturevalue |
-## siteLockState values
+### siteLockState values
| Value | | | | unlocked | | lockedReadOnly |
-## userDefaultAuthenticationMethod values
+### userDefaultAuthenticationMethod values
| Member | | -- |
Namespace: microsoft.graph
| none | | unknownFutureValue |
-## applicationKeyUsage values
+### applicationKeyUsage values
| Member | | -- |
Namespace: microsoft.graph
| verify | | unknownFutureValue |
-## applicationKeyType values
+### applicationKeyType values
| Member | | -- |
Namespace: microsoft.graph
| certificate | | unknownFutureValue |
-## plannerTaskCompletionRequirements values
+### plannerTaskCompletionRequirements values
| Member | | -- |
Namespace: microsoft.graph
| formCompletion | | approvalCompletion |
-## plannerApprovalStatus values
+### plannerApprovalStatus values
| Member | | -- |
Namespace: microsoft.graph
| cancelled | | unknownFutureValue |
-## applicationKeyOrigin values
+### applicationKeyOrigin values
| Member | | -- |
Namespace: microsoft.graph
| servicePrincipal | | unknownFutureValue |
-## authenticationAttributeCollectionInputType values
+### authenticationAttributeCollectionInputType values
| Member | | - |
Namespace: microsoft.graph
| boolean | | unknownFutureValue |
-## userType values
+### userType values
| Member | | - |
Namespace: microsoft.graph
| guest | | unknownFutureValue |
-## assignmentType values
+### assignmentType values
| Member | | |
Namespace: microsoft.graph
| unknownFutureValue | | peerRecommeded |
-## courseStatus values
+### courseStatus values
| Member | | - |
Namespace: microsoft.graph
| inProgress | | completed |
-## usqState values
+### usqState values
| Member | | |
Namespace: microsoft.graph
| full | | overLimit |
-## userPurpose values
+### userPurpose values
| Member | | |
Namespace: microsoft.graph
| others | | unknownFutureValue |
-## releaseType values
+### releaseType values
| Member | | - |
Namespace: microsoft.graph
| generallyAvailable | | unknownFutureValue |
-## requiredLicenses values
+### requiredLicenses values
| Member | | - |
Namespace: microsoft.graph
| microsoftEntraWorkloadId | | unknownFutureValue |
-## recommendationCategory values
+### recommendationCategory values
| Member | | -- |
Namespace: microsoft.graph
| identitySecureScore | | unknownFutureValue |
-## recommendationFeatureAreas values
+### recommendationFeatureAreas values
| Member | | |
Namespace: microsoft.graph
| governance | | unknownFutureValue |
-## recommendationPriority values
+### recommendationPriority values
| Member | | |
Namespace: microsoft.graph
| medium | | high |
-## recommendationStatus values
+### recommendationStatus values
| Member | | |
Namespace: microsoft.graph
| postponed | | unknownFutureValue |
-## recommendationType values
+### recommendationType values
| Member | | -- |
Namespace: microsoft.graph
| aadGraphDeprecationServicePrincipal | | mfaServerDeprecation |
-## layoutTemplateType values
+### layoutTemplateType values
| Member | | |
Namespace: microsoft.graph
| verticalSplit | | unknownFutureValue |
-## conditionalAccessExternalTenantsMembershipKind values
+### conditionalAccessExternalTenantsMembershipKind values
| Member | | |
Namespace: microsoft.graph
| enumerated | | unknownFutureValue |
-## conditionalAccessGuestOrExternalUserTypes values
+### conditionalAccessGuestOrExternalUserTypes values
| Member | | - |
Namespace: microsoft.graph
| serviceProvider | | unknownFutureValue |
-## teamTemplateAudience values
+### teamTemplateAudience values
| Member | | |
Namespace: microsoft.graph
| public | | unknownFutureValue |
-## decisionItemPrincipalResourceMembershipType values
+### decisionItemPrincipalResourceMembershipType values
| Member | | |
Namespace: microsoft.graph
| indirect | | unknownFutureValue |
-## signInFrequencyAuthenticationType values
+### signInFrequencyAuthenticationType values
| Member | | |
Namespace: microsoft.graph
| secondaryAuthentication | | unknownFutureValue |
-## signInFrequencyInterval values
+### signInFrequencyInterval values
| Member | | | | timeBased | | everyTime |
-## authenticationProtocol values
+### authenticationProtocol values
| Member | | |
Namespace: microsoft.graph
| saml | | unknownFutureValue |
-## federatedIdpMfaBehavior values
+### federatedIdpMfaBehavior values
| Member | | -- |
Namespace: microsoft.graph
| rejectMfaByFederatedIdp | | unknownFutureValue |
-## promptLoginBehavior values
+### promptLoginBehavior values
| Member | | -- |
Namespace: microsoft.graph
| disabled | | unknownFutureValue |
-## bookingsAvailabilityStatus values
+### bookingsAvailabilityStatus values
| Member | | |
Namespace: microsoft.graph
| outOfOffice | | unknownFutureValue |
-## accessPackageCustomExtensionHandlerStatus values
+### accessPackageCustomExtensionHandlerStatus values
| Member | | |
Namespace: microsoft.graph
| requestReceived | | unknownFutureValue |
-## accessPackageSubjectLifecycle values
+### accessPackageSubjectLifecycle values
| Member | | - |
Namespace: microsoft.graph
| governed | | unknownFutureValue |
-## customExtensionCalloutInstanceStatus values
+### customExtensionCalloutInstanceStatus values
| Member | | |
Namespace: microsoft.graph
| waitingForCallback | | unknownFutureValue |
-## accessPackageCustomExtensionStage values
+### accessPackageCustomExtensionStage values
| Member | | -- |
Namespace: microsoft.graph
| assignmentOneDayBeforeExpiration | | unknownFutureValue |
-## accessReviewHistoryStatus values
+### accessReviewHistoryStatus values
| Member | | |
Namespace: microsoft.graph
| requested | | unknownFutureValue |
-## accessReviewHistoryDecisionFilter values
+### accessReviewHistoryDecisionFilter values
| Member | | |
Namespace: microsoft.graph
| notNotified | | unknownFutureValue |
-## crossTenantAccessPolicyTargetConfigurationAccessType values
+### crossTenantAccessPolicyTargetConfigurationAccessType values
| Member | | |
Namespace: microsoft.graph
| blocked | | unknownFutureValue |
-## crossTenantAccessPolicyTargetType values
+### crossTenantAccessPolicyTargetType values
| Member | | | | user | | group |
-## multiTenantOrganizationMemberProcessingStatus values
+### multiTenantOrganizationMemberProcessingStatus values
| Member | | - |
Namespace: microsoft.graph
| failed | | unknownFutureValue |
-## multiTenantOrganizationMemberRole values
+### multiTenantOrganizationMemberRole values
| Member | | - |
Namespace: microsoft.graph
| member | | unknownFutureValue |
-## multiTenantOrganizationMemberState values
+### multiTenantOrganizationMemberState values
| Member | | - |
Namespace: microsoft.graph
| removed | | unknownFutureValue |
-## multiTenantOrganizationState values
+### multiTenantOrganizationState values
| Member | | - |
Namespace: microsoft.graph
| inactive | | unknownFutureValue |
-## templateApplicationLevel values
+### templateApplicationLevel values
| Member | | - |
Namespace: microsoft.graph
| existingPartners | | unknownFutureValue |
-## approvalFilterByCurrentUserOptions values
+### approvalFilterByCurrentUserOptions values
| Member | | |
Namespace: microsoft.graph
| approver | | unknownFutureValue |
-## accessPackageFilterByCurrentUserOptions values
+### accessPackageFilterByCurrentUserOptions values
| Member | | | | allowedRequestor | | unknownFutureValue |
-## userSignInRecommendationScope values
+### userSignInRecommendationScope values
| Member | | -- | | tenant | | application |
-## incomingTokenType values
+### incomingTokenType values
| Member | | - |
Namespace: microsoft.graph
| saml20 | | unknownFutureValue | | remoteDesktopToken |
+| refreshToken |
-## protocolType values
+### protocolType values
| Member | | |
Namespace: microsoft.graph
| authenticationTransfer | | nativeAuth |
-## accessReviewInstanceDecisionItemFilterByCurrentUserOptions values
+### accessReviewInstanceDecisionItemFilterByCurrentUserOptions values
| Member | | | | reviewer | | unknownFutureValue |
-## accessReviewStageFilterByCurrentUserOptions values
+### accessReviewStageFilterByCurrentUserOptions values
| Member | | | | reviewer | | unknownFutureValue |
-## continuousAccessEvaluationMode values
+### continuousAccessEvaluationMode values
| Member | | |
Namespace: microsoft.graph
| unknownFutureValue | | strictLocation |
-## msiType values
+### msiType values
| Member | | |
Namespace: microsoft.graph
| systemAssigned | | unknownFutureValue |
-## multiFactorAuthConfiguration values
+### multiFactorAuthConfiguration values
| Member | Value | Description | | | -- | - |
Namespace: microsoft.graph
| required | 1 | Multifactor authentication is required for a user to complete device registration. | | unknownFutureValue | 2 | Evolvable enumeration sentinel value. Don't use. |
-## policyScope values
+### policyScope values
| Member | Value | Description | | | -- | |
Namespace: microsoft.graph
| selected | 2 | The policy applies to specific users or groups in the organization. | | unknownFutureValue | 3 | Evolvable enumeration sentinel value. Don't use. |
-## appManagementRestrictionState values
+### appManagementRestrictionState values
| Member | | - |
Namespace: microsoft.graph
| disabled | | unknownFutureValue |
-## appCredentialRestrictionType values
+### appCredentialRestrictionType values
| Member | | - |
Namespace: microsoft.graph
| customPasswordAddition | | unknownFutureValue |
-## appKeyCredentialRestrictionType values
+### appKeyCredentialRestrictionType values
| Member | | |
Namespace: microsoft.graph
| trustedCertificateAuthority | | unknownFutureValue |
-## synchronizationSecret values
+### synchronizationSecret values
| Member | | - |
Namespace: microsoft.graph
| TestReferences | | ConnectionString |
-## synchronizationScheduleState values
+### synchronizationScheduleState values
| Member | | -- |
Namespace: microsoft.graph
| Disabled | | Paused |
-## synchronizationStatusCode values
+### synchronizationStatusCode values
| Member | | - |
Namespace: microsoft.graph
| Paused | | Quarantine |
-## synchronizationTaskExecutionResult values
+### synchronizationTaskExecutionResult values
| Member | | - |
Namespace: microsoft.graph
| Failed | | EntryLevelErrors |
-## quarantineReason values
+### quarantineReason values
| Member | | |
Namespace: microsoft.graph
| TooManyDeletes | | IngestionInterrupted |
-## attributeMappingSourceType values
+### attributeMappingSourceType values
| Member | | |
Namespace: microsoft.graph
| Constant | | Function |
-## filterMode values
+### filterMode values
| Member | | - | | include | | exclude |
-## lifecycleEventType values
+### lifecycleEventType values
| Member | | -- |
Namespace: microsoft.graph
| subscriptionRemoved | | reauthorizationRequired |
-## changeType values
+### changeType values
| Member | | - |
Namespace: microsoft.graph
| updated | | deleted |
-## countryLookupMethodType values
+### countryLookupMethodType values
| Member | | - | | clientIpAddress | | authenticatorAppGps |
-## approvalState values
+### approvalState values
| Member | | -- |
Namespace: microsoft.graph
| aborted | | canceled |
-## roleSummaryStatus values
+### roleSummaryStatus values
| Member | | | | ok | | bad |
-## dataPolicyOperationStatus values
+### dataPolicyOperationStatus values
| Member | | |
Namespace: microsoft.graph
| failed | | unknownFutureValue |
-## conditionalAccessClientApp values
+### conditionalAccessClientApp values
| Member | | |
Namespace: microsoft.graph
| easSupported | | other |
-## consentRequestFilterByCurrentUserOptions values
+### consentRequestFilterByCurrentUserOptions values
| Member | | | | reviewer | | unknownFutureValue |
-## attributeType values
+### attributeType values
| Member | | |
Namespace: microsoft.graph
| Boolean | | DateTime |
-## scopeOperatorType values
+### scopeOperatorType values
| Member | | | | Binary | | Unary |
-## synchronizationJobRestartScope values
+### synchronizationJobRestartScope values
| Member | | - |
Namespace: microsoft.graph
| Full | | ForceDeletes |
-## synchronizationMetadata values
+### synchronizationMetadata values
| Member | | - |
Namespace: microsoft.graph
| SynchronizationLearnMoreIbizaFwLink | | ConfigurationFields |
-## mutability values
+### mutability values
| Member | | |
Namespace: microsoft.graph
| Immutable | | WriteOnly |
-## directoryDefinitionDiscoverabilities values
+### directoryDefinitionDiscoverabilities values
| Member | | - |
Namespace: microsoft.graph
| ReferenceAttributes | | UnknownFutureValue |
-## objectDefinitionMetadata values
+### objectDefinitionMetadata values
| Member | | - |
Namespace: microsoft.graph
| Extensions | | BaseObjectName |
-## connectorGroupRegion values
+### connectorGroupRegion values
| Member | | |
Namespace: microsoft.graph
| ind | | unknownFutureValue |
-## connectorGroupType values
+### connectorGroupType values
| Member | | - | | applicationProxy |
-## onPremisesPublishingType values
+### onPremisesPublishingType values
| Member | | |
Namespace: microsoft.graph
| oflineDomainJoin | | unknownFutureValue |
-## agentStatus values
+### agentStatus values
| Member | | -- | | active | | inactive |
-## connectorStatus values
+### connectorStatus values
| Member | | -- | | active | | inactive |
-## callType values
+### callType values
| Member | | |
Namespace: microsoft.graph
| peerToPeer | | unknownFutureValue |
-## tone values
+### tone values
| Member | | |
Namespace: microsoft.graph
| d | | flash |
-## callState values
+### callState values
| Member | | - |
Namespace: microsoft.graph
| terminating | | terminated |
-## routingPolicy values
+### routingPolicy values
| Member | | - |
Namespace: microsoft.graph
| preferSkypeForBusiness | | unknownFutureValue |
-## meetingCapabilities values
+### meetingCapabilities values
| Member | | | | questionAndAnswer | | unknownFutureValue |
-## onlineMeetingRole values
+### onlineMeetingRole values
| Member | | |
Namespace: microsoft.graph
| producer | | unknownFutureValue |
-## autoAdmittedUsersType values
+### autoAdmittedUsersType values
| Member | | -- | | everyoneInCompany | | everyone |
-## mediaState values
+### mediaState values
| Member | | |
Namespace: microsoft.graph
| inactive | | unknownFutureValue |
-## callDirection values
+### callDirection values
| Member | | -- | | incoming | | outgoing |
-## modality values
+### modality values
| Member | | -- |
Namespace: microsoft.graph
| screenSharing | | unknownFutureValue |
-## endpointType values
+### endpointType values
| Member | | - |
Namespace: microsoft.graph
| skypeForBusinessVoipPhone | | unknownFutureValue |
-## kerberosSignOnMappingAttributeType values
+### kerberosSignOnMappingAttributeType values
| Member | | - |
Namespace: microsoft.graph
| onPremisesUserPrincipalUsername | | onPremisesSAMAccountName |
-## externalAuthenticationType values
+### externalAuthenticationType values
| Member | | -- | | passthru | | aadPreAuthentication |
-## recipientScopeType values
+### recipientScopeType values
| Member | | |
Namespace: microsoft.graph
| externalPartner | | externalNonPartner |
-## appliedConditionalAccessPolicyResult values
+### appliedConditionalAccessPolicyResult values
| Member | | |
Namespace: microsoft.graph
| reportOnlyNotApplied | | reportOnlyInterrupted |
-## microsoftAuthenticatorAuthenticationMode values
+### microsoftAuthenticatorAuthenticationMode values
| Member | | |
Namespace: microsoft.graph
| push | | deviceBasedPush |
-## authenticationMethodFeature values
+### authenticationMethodFeature values
| Member | | - |
Namespace: microsoft.graph
| passwordlessCapable | | mfaCapable |
-## authMethodsType values
+### authMethodsType values
| Member | | - |
Namespace: microsoft.graph
| mobilePhoneAndSMS | | unknownFutureValue |
-## defaultMfaMethodType values
+### defaultMfaMethodType values
| Member | | -- |
Namespace: microsoft.graph
| softwareOneTimePasscode | | unknownFutureValue |
-## clientCredentialType values
+### clientCredentialType values
| Member | | |
Namespace: microsoft.graph
| certificate | | unknownFutureValue |
-## azureADLicenseType values
+### azureADLicenseType values
| Member | | |
Namespace: microsoft.graph
| premiumP2 | | unknownFutureValue |
-## conditionalAccessConditions values
+### conditionalAccessConditions values
| Member | | - |
Namespace: microsoft.graph
| authenticationFlows | | insiderRisk |
-## conditionalAccessStatus values
+### conditionalAccessStatus values
| Member | | |
Namespace: microsoft.graph
| notApplied | | unknownFutureValue |
-## featureType values
+### featureType values
| Member | | |
Namespace: microsoft.graph
| reset | | unknownFutureValue |
-## groupType values
+### groupType values
| Member | | |
Namespace: microsoft.graph
| azureAD | | unknownFutureValue |
-## includedUserRoles values
+### includedUserRoles values
| Member | | |
Namespace: microsoft.graph
| user | | unknownFutureValue |
-## includedUserTypes values
+### includedUserTypes values
| Member | | |
Namespace: microsoft.graph
| guest | | unknownFutureValue |
-## initiatorType values
+### initiatorType values
| Member | | |
Namespace: microsoft.graph
| system | | unknownFutureValue |
-## migrationStatus values
+### migrationStatus values
| Member | | -- |
Namespace: microsoft.graph
| additionalStepsRequired | | unknownFutureValue |
-## networkType values
+### networkType values
| Member | | |
Namespace: microsoft.graph
| trusted | | unknownFutureValue |
-## operationResult values
+### operationResult values
| Member | | |
Namespace: microsoft.graph
| timeout | | unknownFutureValue |
-## provisioningResult values
+### provisioningResult values
| Member | | |
Namespace: microsoft.graph
| warning | | unknownFutureValue |
-## provisioningStepType values
+### provisioningStepType values
| Member | | - |
Namespace: microsoft.graph
| export | | unknownFutureValue |
-## registrationAuthMethod values
+### registrationAuthMethod values
| Member | | -- |
Namespace: microsoft.graph
| appPassword | | unknownFutureValue |
-## registrationStatusType values
+### registrationStatusType values
| Member | | |
Namespace: microsoft.graph
| mfaRegistered | | unknownFutureValue |
-## signInIdentifierType values
+### signInIdentifierType values
| Member | | |
Namespace: microsoft.graph
| onPremisesUserPrincipalName | | unknownFutureValue |
-## signInUserType values
+### signInUserType values
| Member | | |
Namespace: microsoft.graph
| guest | | unknownFutureValue |
-## requirementProvider values
+### requirementProvider values
| Member | | - |
Namespace: microsoft.graph
| scopeBasedAuthRequirementPolicy | | authenticationStrengths |
-## riskDetail values
+### riskDetail values
| Member | | -- |
Namespace: microsoft.graph
| adminConfirmedAccountSafe | <!-- maintenance comment: Do not delete enum delcaration for riskEventType until all properties of this type are marked as deleted. Dec 28, 2021: Pending eventTypes (in riskUserActivity) and riskType (in riskDetection)-->
-## riskEventType values
+### riskEventType values
| Member | | -- |
Namespace: microsoft.graph
| maliciousIPAddressValidCredentialsBlockedIP | | unknownFutureValue |
-## usageAuthMethod values
+### usageAuthMethod values
| Member | | - |
Namespace: microsoft.graph
| appPassword | | unknownFutureValue |
-## authenticationAppAdminConfiguration values
+### authenticationAppAdminConfiguration values
| Member | | |
Namespace: microsoft.graph
| disabled | | unknownFutureValue |
-## authenticationAppEvaluation values
+### authenticationAppEvaluation values
| Member | | |
Namespace: microsoft.graph
| failure | | unknownFutureValue |
-## authenticationAppPolicyStatus values
+### authenticationAppPolicyStatus values
| Member | | |
Namespace: microsoft.graph
| tamperResistantHardwareNotUsed | | unknownFutureValue |
-## authenticationMethodKeyStrength values
+### authenticationMethodKeyStrength values
| Member | | - |
Namespace: microsoft.graph
| weak | | unknown |
-## authenticationMethodPlatform values
+### authenticationMethodPlatform values
| Member | | - |
Namespace: microsoft.graph
| linux | | unknown |
-## authenticationContextDetail values
+### authenticationContextDetail values
| Member | | - |
Namespace: microsoft.graph
| notApplicable | | unknownFutureValue |
-## educationAddedStudentAction values
+### educationAddedStudentAction values
| Member | | |
Namespace: microsoft.graph
| assignIfOpen | | unknownFutureValue |
-## educationAddToCalendarOptions values
+### educationAddToCalendarOptions values
| Member | | |
Namespace: microsoft.graph
| unknownFutureValue | | studentsOnly |
-## educationModuleStatus values
+### educationModuleStatus values
| Member | | | | draft | | published |
-## educationAssignmentStatus values
+### educationAssignmentStatus values
| Member | | |
Namespace: microsoft.graph
| unknownFutureValue | | inactive |
-## educationSubmissionStatus values
+### educationSubmissionStatus values
| Member | | - |
Namespace: microsoft.graph
| reassigned | | excused |
-## educationFeedbackResourceOutcomeStatus values
+### educationFeedbackResourceOutcomeStatus values
| Member | | |
Namespace: microsoft.graph
| failedPublish | | unknownFutureValue |
-## externalEmailOtpState values
+### externalEmailOtpState values
| Member | | |
Namespace: microsoft.graph
| disabled | | unknownFutureValue |
-## expirationRequirement values
+### expirationRequirement values
| Member | | - |
Namespace: microsoft.graph
| signInFrequencyEveryTime | | unknownFutureValue |
-## replyRestriction values
+### replyRestriction values
| Member | | |
Namespace: microsoft.graph
| authorAndModerators | | unknownFutureValue |
-## userNewMessageRestriction values
+### userNewMessageRestriction values
| Member | | |
Namespace: microsoft.graph
| moderators | | unknownFutureValue |
-## volumeType values
+### volumeType values
| Member | | |
Namespace: microsoft.graph
| removableDataVolume | | unknownFutureValue |
-## allowedAudiences values
+### allowedAudiences values
| Member | | - |
Namespace: microsoft.graph
| everyone | | unknownFutureValue |
-## attestationLevel values
+### attestationLevel values
| Member | | |
Namespace: microsoft.graph
| notAttested | | unknownFutureValue |
-## emailType values
+### emailType values
| Member | | -- |
Namespace: microsoft.graph
| main | | other |
-## authenticationMethodSignInState values
+### authenticationMethodSignInState values
| Member | | -- |
Namespace: microsoft.graph
| notConfigured | | unknownFutureValue |
-## authenticationPhoneType values
+### authenticationPhoneType values
| Member | | |
Namespace: microsoft.graph
| office | | unknownFutureValue |
-## authenticationMethodTargetType values
+### authenticationMethodTargetType values
| Member | | |
Namespace: microsoft.graph
| group | | unknownFutureValue |
-## authenticationMethodState values
+### authenticationMethodState values
| Member | | -- | | enabled | | disabled |
-## fido2RestrictionEnforcementType values
+### fido2RestrictionEnforcementType values
| Member | | |
Namespace: microsoft.graph
| block | | unknownFutureValue |
-## x509CertificateAuthenticationMode values
+### x509CertificateAuthenticationMode values
| Member | | |
Namespace: microsoft.graph
| x509CertificateMultiFactor | | unknownFutureValue |
-## x509CertificateAffinityLevel values
+### x509CertificateAffinityLevel values
| Member | | |
Namespace: microsoft.graph
| high | | unknownFutureValue |
-## x509CertificateRuleType values
+### x509CertificateRuleType values
| Member | | - |
Namespace: microsoft.graph
| unknownFutureValue | | issuerSubjectAndPolicyOID |
-## x509CertificateIssuerHintsState values
+### x509CertificateIssuerHintsState values
| Member | | - |
Namespace: microsoft.graph
| enabled | | unknownFutureValue |
-## anniversaryType values
+### anniversaryType values
| Member | | |
Namespace: microsoft.graph
| wedding | | unknownFutureValue |
-## skillProficiencyLevel values
+### skillProficiencyLevel values
| Member | | -- |
Namespace: microsoft.graph
| expert | | unknownFutureValue |
-## languageProficiencyLevel values
+### languageProficiencyLevel values
| Member | | - |
Namespace: microsoft.graph
| nativeOrBilingual | | unknownFutureValue |
-## personRelationship values
+### personRelationship values
| Member | | |
Namespace: microsoft.graph
| other | | unknownFutureValue |
-## attachmentType values
+### attachmentType values
| Member | | |
Namespace: microsoft.graph
| item | | reference |
-## analyticsActivityType values
+### analyticsActivityType values
| Member | | |
Namespace: microsoft.graph
| focus | | meeting |
-## entityTypes values
+### entityTypes values
| Member | | |
Namespace: microsoft.graph
| qna | | unknownFutureValue |
-## searchAlterationType values
+### searchAlterationType values
| Member | | | | modification | | suggestion |
-## bucketAggregationSortProperty values
+### bucketAggregationSortProperty values
| Member | | -- |
Namespace: microsoft.graph
| keyAsString | | keyAsNumber |
-## contactRelationship values
+### contactRelationship values
| Member | Value | Description | | | -- | - |
Namespace: microsoft.graph
| other | 6 | An unspecified relationship to the user. | | unknownFutureValue | 7 | Marker value for future compatibility. |
-## scheduleEntityTheme values
+### scheduleEntityTheme values
| Member | | -- |
Namespace: microsoft.graph
| darkYellow | | unknownFutureValue |
-## timeOffReasonIconType values
+### timeOffReasonIconType values
| Member | | |
Namespace: microsoft.graph
| sunny | | unknownFutureValue |
-## timeCardState values
+### timeCardState values
| Member | | |
Namespace: microsoft.graph
| clockedOut | | unknownFutureValue |
-## scheduleChangeState values
+### scheduleChangeState values
| Member | | -- |
Namespace: microsoft.graph
| declined | | unknownFutureValue |
-## scheduleChangeRequestActor values
+### scheduleChangeRequestActor values
| Member | | -- |
Namespace: microsoft.graph
| system | | unknownFutureValue |
-## windowsSettingType values
+### windowsSettingType values
| Member | | |
Namespace: microsoft.graph
| backup | | unknownFutureValue |
-## workforceIntegrationEncryptionProtocol values
+### workforceIntegrationEncryptionProtocol values
| Member | | -- | | sharedSecret | | unknownFutureValue |
-## workforceIntegrationSupportedEntities values
+### workforceIntegrationSupportedEntities values
| Member | | -- |
Namespace: microsoft.graph
| timeOff | | timeOffRequest |
-## confirmedBy values
+### confirmedBy values
| Member | | |
Namespace: microsoft.graph
| manager | | unknownFutureValue |
-## timeZoneStandard values
+### timeZoneStandard values
| Member | | | | windows | | iana |
-## freeBusyStatus values
+### freeBusyStatus values
| Member | Value | | - | -- |
Namespace: microsoft.graph
| workingElsewhere | 4 | | unknown | -1 |
-## physicalAddressType values
+### physicalAddressType values
| Member | | -- |
Namespace: microsoft.graph
| business | | other |
-## attendeeType values
+### attendeeType values
| Member | | -- |
Namespace: microsoft.graph
| optional | | resource |
-## externalAudienceScope values
+### externalAudienceScope values
| Member | | -- |
Namespace: microsoft.graph
| contactsOnly | | all |
-## automaticRepliesStatus values
+### automaticRepliesStatus values
| Member | | -- |
Namespace: microsoft.graph
| alwaysEnabled | | scheduled |
-## calendarColor values
+### calendarColor values
| Member | Value | | -- | -- |
Namespace: microsoft.graph
| lightRed | 8 | | maxColor | 9 |
-## educationSynchronizationProfileState values
+### educationSynchronizationProfileState values
| Member | Value | | | -- |
Namespace: microsoft.graph
| provisioning | 7 | | unknownFutureValue | 8 |
-## educationSynchronizationStatus values
+### educationSynchronizationStatus values
| Member | | |
Namespace: microsoft.graph
| extracting | | validating |
-## educationExternalSource values
+### educationExternalSource values
| Member | | -- |
Namespace: microsoft.graph
| manual | | unknownFutureValue |
-## educationGender values
+### educationGender values
| Member | | -- |
Namespace: microsoft.graph
| other | | unknownFutureValue |
-## eventType values
+### eventType values
| Member | | -- |
Namespace: microsoft.graph
| exception | | seriesMaster |
-## sensitivity values
+### sensitivity values
| Member | | -- |
Namespace: microsoft.graph
| private | | confidential |
-## importance values
+### importance values
| Member | | -- |
Namespace: microsoft.graph
| normal | | high |
-## educationUserRole values
+### educationUserRole values
| Member | | - |
Namespace: microsoft.graph
| teacher | | faculty |
-## meetingMessageType values
+### meetingMessageType values
| Member | | |
Namespace: microsoft.graph
| meetingTentativelyAccepted | | meetingDeclined |
-## followupFlagStatus values
+### followupFlagStatus values
| Member | | -- |
Namespace: microsoft.graph
| complete | | flagged |
-## inferenceClassificationType values
+### inferenceClassificationType values
| Member | | | | focused | | other |
-## iosNotificationAlertType values
+### iosNotificationAlertType values
| Member | | -- |
Namespace: microsoft.graph
| modal | | none |
-## deviceEnrollmentFailureReason values
+### deviceEnrollmentFailureReason values
| Member | | -- |
Namespace: microsoft.graph
| enrollmentRestrictionsEnforced | | clientDisconnected |
-## bodyType values
+### bodyType values
| Member | | - | | text | | html |
-## locationType values
+### locationType values
| Member | | -- |
Namespace: microsoft.graph
| localBusiness | | postalAddress |
-## locationUniqueIdType values
+### locationUniqueIdType values
| Member | | -- |
Namespace: microsoft.graph
| private | | bing |
-## messageActionFlag values
+### messageActionFlag values
| Member | | -- |
Namespace: microsoft.graph
| replyToAll | | review |
-## onenoteUserRole values
+### onenoteUserRole values
| Member | Value | | -- | -- |
Namespace: microsoft.graph
| Reader | 2 | | None | -1 |
-## operationStatus values
+### operationStatus values
| Member | | |
Namespace: microsoft.graph
| Completed | | Failed |
-## onenotePatchActionType values
+### onenotePatchActionType values
| Member | | -- |
Namespace: microsoft.graph
| Insert | | Prepend |
-## onenotePatchInsertPosition values
+### onenotePatchInsertPosition values
| Member | | -- | | After | | Before |
-## phoneType values
+### phoneType values
| Member | | -- |
Namespace: microsoft.graph
| pager | | radio |
-## plannerPreviewType values
+### plannerPreviewType values
| Member | | -- |
Namespace: microsoft.graph
| description | | reference |
-## status values
+### status values
| Member | | |
Namespace: microsoft.graph
| ignored | | unknownFutureValue |
-## weekIndex values
+### weekIndex values
| Member | | -- |
Namespace: microsoft.graph
| fourth | | last |
-## dayOfWeek values
+### dayOfWeek values
| Member | | -- |
Namespace: microsoft.graph
| friday | | saturday |
-## recurrencePatternType values
+### recurrencePatternType values
| Member | | -- |
Namespace: microsoft.graph
| absoluteYearly | | relativeYearly |
-## recurrenceRangeType values
+### recurrenceRangeType values
| Member | | -- |
Namespace: microsoft.graph
| noEnd | | numbered |
-## onenoteSourceService values
+### onenoteSourceService values
| Member | | - |
Namespace: microsoft.graph
| OneDriveForBusiness | | OnPremOneDriveForBusiness |
-## responseType values
+### responseType values
| Member | | -- |
Namespace: microsoft.graph
| declined | | notResponded |
-## activityDomain values
+### activityDomain values
| Member | | -- |
Namespace: microsoft.graph
| personal | | unrestricted |
-## websiteType values
+### websiteType values
| Member | | -- |
Namespace: microsoft.graph
| blog | | profile |
-## categoryColor values
+### categoryColor values
| Member | Value | | -- | -- |
Namespace: microsoft.graph
| preset23 | 23 | | preset24 | 24 |
-## alertFeedback values
+### alertFeedback values
Possible feedback values on the alert provided by an analyst.
Possible feedback values on the alert provided by an analyst.
| falsePositive | 2 | Alert is false-positive. | | benignPositive | 3 | Alert is benign-positive. |
-## fileHashType values
+### fileHashType values
| Member | Value | Description | | - | -- | |
Possible feedback values on the alert provided by an analyst.
| peSha1 | 7 | PESHA1 hash type. | | peSha256 | 8 | PESHA256 hash type. |
-## connectionDirection values
+### connectionDirection values
| Member | Value | Description | | -- | -- | -- |
Possible feedback values on the alert provided by an analyst.
| inbound | 1 | Inbound connection. | | outbound | 2 | Outbound connection. |
-## connectionStatus values
+### connectionStatus values
| Member | Value | Description | | | -- | -- |
Possible feedback values on the alert provided by an analyst.
| blocked | 3 | Connection blocked. | | failed | 4 | Connection failed. |
-## processIntegrityLevel values
+### processIntegrityLevel values
| Member | Value | Description | | | -- | -- |
Possible feedback values on the alert provided by an analyst.
| high | 40 | Integrity level is High. | | system | 50 | Integrity level is System. |
-## registryHive values
+### registryHive values
Enum for registry hives as defined by [Registry Hives](/windows/desktop/sysinfo/registry-hives).
Enum for registry hives as defined by [Registry Hives](/windows/desktop/sysinfo/
| localMachineSystem | 5 | HKEY_LOCAL_MACHINE\System hive. | | usersDefault | 6 | HKEY_USERS\\.DEFAULT hive. |
-## registryOperation values
+### registryOperation values
Operation that changed the registry key name and/or value.
Operation that changed the registry key name and/or value.
| modify | 2 | Modify registry. | | delete | 3 | Delete registry. |
-## registryValueType values
+### registryValueType values
Enum for registry value types as defined by [Registry value types](/windows/desktop/sysinfo/registry-value-types).
Enum for registry value types as defined by [Registry value types](/windows/desk
| qwordlittleEndian | 10 | REG_QWORD_LITTLE_ENDIAN registry value type. | | sz | 11 | REG_SZ registry value type. |
-## alertSeverity values
+### alertSeverity values
Enum for severity of alerts.
Enum for severity of alerts.
| medium | 3 | Severity is medium. | | high | 4 | Severity is high. |
-## alertStatus values
+### alertStatus values
Possible values of an Alert lifecycle status (stage).
Possible values of an Alert lifecycle status (stage).
| inProgress | 20 | Alert is in progress. | | resolved | 30 | Alert is resolved. |
-## emailRole values
+### emailRole values
Possible values for email roles.
Possible values for email roles.
| sender | 1 | Sender of the email. | | recipient | 2 | Recipient of the email. |
-## logonType values
+### logonType values
Possible values for the method of user signin.
Possible values for the method of user signin.
| batch | 3 | Logon is batch. | | service | 4 | Logon is service. |
-## userAccountSecurityType values
+### userAccountSecurityType values
Possible values for user account types (group membership), per Windows definition.
Possible values for user account types (group membership), per Windows definitio
| power | 1 | Member of Power Users group. | | administrator | 2 | Member of Administrators group. |
-## chatMessagePolicyViolationDlpActionType values
+### chatMessagePolicyViolationDlpActionType values
| Value | | - |
Possible values for user account types (group membership), per Windows definitio
| BlockAccess | | BlockAccessExternal |
-## scopeOperatorMultiValuedComparisonType values
+### scopeOperatorMultiValuedComparisonType values
| Member | | - | | All | | Any |
-## riskLevel values
+### riskLevel values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| none | | unknownFutureValue |
-## riskState values
+### riskState values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| confirmedCompromised | | unknownFutureValue |
-## advancedConfigState values
+### advancedConfigState values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| disabled | | unknownFutureValue |
-## referenceAttachmentPermission values
+### referenceAttachmentPermission values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| organizationView | | organizationEdit |
-## referenceAttachmentProvider values
+### referenceAttachmentProvider values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| oneDriveConsumer | | dropbox |
-## exchangeIdFormat values
+### exchangeIdFormat values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| restId | | restImmutableEntryId |
-## attributeDefinitionMetadata values
+### attributeDefinitionMetadata values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| MaximumLength | | ReferencedProperty |
-## attributeFlowBehavior values
+### attributeFlowBehavior values
| Member | | - | | FlowWhenChanged | | FlowAlways |
-## attributeFlowType values
+### attributeFlowType values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| ValueAddOnly | | AttributeAddOnly |
-## objectFlowTypes values
+### objectFlowTypes values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| Update | | Delete |
-## objectMappingMetadata values
+### objectMappingMetadata values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| ExcludeFromReporting | | Unsynchronized |
-## chatMessageType values
+### chatMessageType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| unknownFutureValue | | systemEventMessage |
-## chatMessageImportance values
+### chatMessageImportance values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| high | | urgent |
-## stagedFeatureName values
+### stagedFeatureName values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| unknownFutureValue | | certificateBasedAuthentication |
-## tokenIssuerType values
+### tokenIssuerType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| ADFederationServicesMFAAdapter | | NPSExtension |
-## riskDetectionTimingType values
+### riskDetectionTimingType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| offline | | unknownFutureValue |
-## activityType values
+### activityType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| unknownFutureValue | | servicePrincipal |
-## chatMessagePolicyViolationUserActionType values
+### chatMessagePolicyViolationUserActionType values
| Member | Int value | Description | | - | | |
Possible values for user account types (group membership), per Windows definitio
| Override | 1 | Sender has overridden the message verdict and sent the message anyway. | | ReportFalsePositive | 2 | Sender has reported the message verdict to the admins as a false positive. |
-## chatMessagePolicyViolationVerdictDetailsType values
+### chatMessagePolicyViolationVerdictDetailsType values
| Member | Int value | Description | | | | |
Possible values for user account types (group membership), per Windows definitio
| AllowOverrideWithoutJustification | 2 | User is allowed to override the block and send the message. Justification text isn't required. Exclusive to `AllowOverrideWithJustification`. | | AllowOverrideWithJustification | 4 | User is allowed to override the block and send the message. Justification text is required. Exclusive to `AllowOverrideWithoutJustification`. |
-## entityType values
+### entityType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| externalFile | | externalItem |
-## onlineMeetingProviderType values
+### onlineMeetingProviderType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| skypeForConsumer | | teamsForBusiness |
-## delegateMeetingMessageDeliveryOptions values
+### delegateMeetingMessageDeliveryOptions values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| sendToDelegateAndPrincipal | | sendToDelegateOnly |
-## calendarRoleType values
+### calendarRoleType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| delegateWithPrivateEventAccess | | custom |
-## contentFormat values
+### contentFormat values
| Member | Value | Description | | - | -- | | | default | 0 | Content is a file or non-email type. | | email | 1 | Content is an email. |
-## contentState values
+### contentState values
| Member | Value | Description | | | -- | -- |
Possible values for user account types (group membership), per Windows definitio
| motion | 1 | Data is in motion. A file intercepted by a network appliance in transit. | | use | 2 | Data is in use. A file is open in a client application such as Microsoft Office. |
-## assignmentMethod values
+### assignmentMethod values
| Member | Value | Description | | - | -- | -- |
Possible values for user account types (group membership), per Windows definitio
| privileged | 1 | The label was set explicitly by a user. | | auto | 2 | Allows override of any existing label. Justification required on downgrade. Results in `standard` assignment method in metadata. |
-## actionSource values
+### actionSource values
| Member | Value | Description | | - | -- | |
Possible values for user account types (group membership), per Windows definitio
| policyDefault | 3 | The user no action and the policy-default label was applied. | | mandatory | 4 | The user chose a label after being forced to choose. |
-## contentAlignment values
+### contentAlignment values
| Member | Value | Description | | | -- | -- |
Possible values for user account types (group membership), per Windows definitio
| right | 1 | Align content marking to the right. | | center | 2 | Center content marking. |
-## watermarkLayout values
+### watermarkLayout values
| Member | Value | Description | | - | -- | | | horizontal | 0 | Use a horizontal watermark. | | diagonal | 1 | Use a diagonal watermark. |
-## conditionalAccessPolicyState values
+### conditionalAccessPolicyState values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| disabled | | enabledForReportingButNotEnforced |
-## conditionalAccessGrantControl values
+### conditionalAccessGrantControl values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| passwordChange | | unknownFutureValue |
-## perUserMfaState values
+### perUserMfaState values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| enabled | | unknownFutureValue |
-## conditionalAccessRule values
+### conditionalAccessRule values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| authenticationTransfer | | insiderRisk |
-## signInAccessType values
+### signInAccessType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| unknownFutureValue | | passthrough |
-## signinFrequencyType values
+### signinFrequencyType values
| Member | | | | days | | hours |
-## originalTransferMethods values
+### originalTransferMethods values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| authenticationTransfer | | unknownFutureValue |
-## tokenProtectionStatus values
+### tokenProtectionStatus values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| unbound | | unknownFutureValue |
-## conditionalAccessAudienceReason values
+### conditionalAccessAudienceReason values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| thirdPartyResourceDefault | | unknownFutureValue |
-## persistentBrowserSessionMode values
+### persistentBrowserSessionMode values
| Member | | | | always | | never |
-## cloudAppSecuritySessionControlType values
+### cloudAppSecuritySessionControlType values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| monitorOnly | | blockDownloads |
-## conditionalAccessDevicePlatform values
+### conditionalAccessDevicePlatform values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| all | | unknownFutureValue |
-## priority values
+### priority values
| Member | Value | | | -- |
Possible values for user account types (group membership), per Windows definitio
| High | 1 | | Low | 2 |
-## templateScenarios values
+### templateScenarios values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| emergingThreats | | unknownFutureValue |
-## threatAssessmentContentType values
+### threatAssessmentContentType values
| Member | Value | Description | | | -- | -- |
Possible values for user account types (group membership), per Windows definitio
| url | 2 | URL threat. | | file | 3 | Attachment file threat. |
-## threatExpectedAssessment values
+### threatExpectedAssessment values
| Member | Value | Description | | - | -- | -- | | block | 1 | The threat should be blocked. | | unblock | 2 | The threat shouldn't be blocked. |
-## threatCategory values
+### threatCategory values
| Member | Value | Description | | | -- | |
Possible values for user account types (group membership), per Windows definitio
| malware | 3 | Malware threat. | | unknownFutureValue | 4 | A sentinel member. |
-## threatAssessmentStatus values
+### threatAssessmentStatus values
| Member | Value | Description | | | -- | - | | pending | 1 | The threat assessment still in progress. | | completed | 2 | The threat assessment completed. |
-## threatAssessmentRequestSource values
+### threatAssessmentRequestSource values
| Member | Value | Description | | - | -- | |
Possible values for user account types (group membership), per Windows definitio
| user | 1 | User submission. | | administrator | 2 | Tenant admin submission. |
-## threatAssessmentResultType values
+### threatAssessmentResultType values
| Member | Value | Description | | | -- | - |
Possible values for user account types (group membership), per Windows definitio
| rescan | 2 | The rescan result. | | unknownFutureValue | 3 | A sentinel member. |
-## mailDestinationRoutingReason values
+### mailDestinationRoutingReason values
| Member | Value | Description | | | -- | -- |
Possible values for user account types (group membership), per Windows definitio
| junk | 14 | Blocked due to junk. | | unknownFutureValue | 15 | A sentinel member. |
-## threatAssessmentRequestPivotProperty values
+### threatAssessmentRequestPivotProperty values
| Member | Value | Description | | - | -- | - | | threatCategory | 1 | Aggregate threat assessment request by `threatCategory`. | | mailDestinationRoutingReason | 2 | Aggregate threat assessment request by `mailDestinationRoutingReason`. |
-## userFlowType values
+### userFlowType values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| resourceOwner | | unknownFutureValue |
-## openIdConnectResponseMode values
+### openIdConnectResponseMode values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| query | | unknownFutureValue |
-## wellknownListName values
+### wellknownListName values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| flaggedEmails | | unknownFutureValue |
-## taskStatus values
+### taskStatus values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| waitingOnOthers | | deferred |
-## columnTypes values
+### columnTypes values
| Member | Description | | | -- |
Possible values for user account types (group membership), per Windows definitio
| approvalStatus | Content approval status column. | | unknownFutureValue | unknownFuturevalue |
-## contentModelType values
+### contentModelType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| prebuiltReceiptModel | | unknownFutureValue |
-## documentProcessingJobStatus values
+### documentProcessingJobStatus values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| failed | | unknownFutureValue |
-## documentProcessingJobType values
+### documentProcessingJobType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| Folder | | UnknownFutureValue |
-## connectedOrganizationState values
+### connectedOrganizationState values
| Member | Value | Description | | | -- | - |
Possible values for user account types (group membership), per Windows definitio
| proposed | 1 | Connected Organizations that are automatically created by the system have this state value. They aren't included in assignment policies with requestor scope type `AllConfiguredConnectedOrganizationSubjects`. | | unknownFutureValue | 2 | A sentinel member. |
-## identityUserFlowAttributeDataType values
+### identityUserFlowAttributeDataType values
| Member | Value | Description | | | -- | |
Possible values for user account types (group membership), per Windows definitio
| dateTime | 5 | | | unknownFutureValue | 6 | A sentinel member. |
-## identityUserFlowAttributeType values
+### identityUserFlowAttributeType values
| Member | Value | Description | | | -- | |
Possible values for user account types (group membership), per Windows definitio
| required | 3 | | | unknownFutureValue | 4 | A sentinel member. |
-## permissionClassificationType values
+### permissionClassificationType values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| medium | | high |
-## permissionType values
+### permissionType values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| delegated | | delegatedUserConsentable |
-## identityUserFlowAttributeInputType values
+### identityUserFlowAttributeInputType values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| emailBox | | checkboxMultiSelect |
-## teamworkActivityTopicSource values
+### teamworkActivityTopicSource values
| Member | | - | | entityUrl | | text |
-## cloudPcProvisioningPolicyImageType values
+### cloudPcProvisioningPolicyImageType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| gallery | | unknownFutureValue |
-## cloudPcPolicySettingType values
+### cloudPcPolicySettingType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| singleSignOn | | unknownFutureValue |
-## chatType values
+### chatType values
| Member | Value | Description | | | -- | -- |
Possible values for user account types (group membership), per Windows definitio
| meeting | 2 | Indicates that the chat is a Meeting chat, which is created as a side effect of creation of an OnlineMeeting. | | unknownFutureValue | 3 | Sentinel value to indicate future values. |
-## singleSignOnMode values
+### singleSignOnMode values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| aadHeaderBased | | pingHeaderBased |
-## plannerContainerType values
+### plannerContainerType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| driveItem | | user |
-## plannerPlanContextType values
+### plannerPlanContextType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| other | | unknownFutureValue |
-## plannerContextState values
+### plannerContextState values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| delinked | | unknownFutureValue |
-## plannerExternalTaskSourceDisplayType values
+### plannerExternalTaskSourceDisplayType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| default | | unknownFutureValue |
-## plannerCreationSourceKind values
+### plannerCreationSourceKind values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| publication | | unknownFutureValue |
-## teamsAppInstallationScope values
+### teamsAppInstallationScope values
| Member | Value | Description | | | -- | |
Possible values for user account types (group membership), per Windows definitio
| groupChat | 1 | Indicates that the Teams app can be installed within a group chat and is authorized to access that group chat's data. | | personal | 2 | Indicates that the Teams app can be installed in the personal scope of a user and is authorized to access that user's data. |
-## assignmentScheduleFilterByCurrentUserOptions values
+### assignmentScheduleFilterByCurrentUserOptions values
| Member | | | | principal | | unknownFutureValue |
-## assignmentScheduleInstanceFilterByCurrentUserOptions values
+### assignmentScheduleInstanceFilterByCurrentUserOptions values
| Member | | | | principal | | unknownFutureValue |
-## assignmentScheduleRequestFilterByCurrentUserOptions values
+### assignmentScheduleRequestFilterByCurrentUserOptions values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| approver | | unknownFutureValue |
-## eligibilityScheduleFilterByCurrentUserOptions values
+### eligibilityScheduleFilterByCurrentUserOptions values
| Member | | | | principal | | unknownFutureValue |
-## eligibilityScheduleInstanceFilterByCurrentUserOptions values
+### eligibilityScheduleInstanceFilterByCurrentUserOptions values
| Member | | | | principal | | unknownFutureValue |
-## eligibilityScheduleRequestFilterByCurrentUserOptions values
+### eligibilityScheduleRequestFilterByCurrentUserOptions values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| approver | | unknownFutureValue |
-## privilegedAccessGroupAssignmentType values
+### privilegedAccessGroupAssignmentType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| activated | | unknownFutureValue |
-## privilegedAccessGroupMemberType values
+### privilegedAccessGroupMemberType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| group | | unknownFutureValue |
-## privilegedAccessGroupRelationships values
+### privilegedAccessGroupRelationships values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| member | | unknownFutureValue |
-## scheduleRequestActions values
+### scheduleRequestActions values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| selfRenew | | unknownFutureValue |
-## roleAssignmentScheduleRequestFilterByCurrentUserOptions values
+### roleAssignmentScheduleRequestFilterByCurrentUserOptions values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| approver | | unknownFutureValue |
-## roleAssignmentScheduleFilterByCurrentUserOptions values
+### roleAssignmentScheduleFilterByCurrentUserOptions values
| Member | | | | principal | | unknownFutureValue |
-## roleAssignmentScheduleInstanceFilterByCurrentUserOptions values
+### roleAssignmentScheduleInstanceFilterByCurrentUserOptions values
| Member | | | | principal | | unknownFutureValue |
-## roleEligibilityScheduleRequestFilterByCurrentUserOptions values
+### roleEligibilityScheduleRequestFilterByCurrentUserOptions values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| approver | | unknownFutureValue |
-## roleEligibilityScheduleFilterByCurrentUserOptions values
+### roleEligibilityScheduleFilterByCurrentUserOptions values
| Member | | | | principal | | unknownFutureValue |
-## roleEligibilityScheduleInstanceFilterByCurrentUserOptions values
+### roleEligibilityScheduleInstanceFilterByCurrentUserOptions values
| Member | | | | principal | | unknownFutureValue |
-## cloudPcAuditActivityOperationType values
+### cloudPcAuditActivityOperationType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| patch | | other |
-## cloudPcAuditActivityResult values
+### cloudPcAuditActivityResult values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| timeout | | other |
-## cloudPcAuditActorType values
+### cloudPcAuditActorType values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| partner | | unknown |
-## cloudPcAuditCategory values
+### cloudPcAuditCategory values
| Member | | - | | cloudPC | | other |
-## postType values
+### postType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| strategic | | unknownFutureValue |
-## serviceHealthClassificationType values
+### serviceHealthClassificationType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| incident | | unknownFutureValue |
-## serviceHealthOrigin values
+### serviceHealthOrigin values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| customer | | unknownFutureValue |
-## serviceHealthStatus values
+### serviceHealthStatus values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| reported | | unknownFutureValue |
-## serviceUpdateCategory values
+### serviceUpdateCategory values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| stayInformed | | unknownFutureValue |
-## serviceUpdateSeverity values
+### serviceUpdateSeverity values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| critical | | unknownFutureValue |
-## teamworkApplicationIdentityType values
+### teamworkApplicationIdentityType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| outgoingWebhook | | unknownFutureValue |
-## teamworkConversationIdentityType values
+### teamworkConversationIdentityType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| chat | | unknownFutureValue |
-## teamworkUserIdentityType values
+### teamworkUserIdentityType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| emailUser | | azureCommunicationServicesUser |
-## callRecordingStatus values
+### callRecordingStatus values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| chunkFinished | | unknownFutureValue |
-## payloadDeliveryPlatform values
+### payloadDeliveryPlatform values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| teams | | unknownFutureValue |
-## trainingStatus values
+### trainingStatus values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| overdue | | unknownFutureValue |
-## teamworkCallEventType values
+### teamworkCallEventType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| screenShare | | unknownFutureValue |
-## binaryOperator values
+### binaryOperator values
| Member | | | | or | | and |
-## subjectRightsRequestStage values
+### subjectRightsRequestStage values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| unknownFutureValue | | approval |
-## subjectRightsRequestStageStatus values
+### subjectRightsRequestStageStatus values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| failed | | unknownFutureValue |
-## subjectRightsRequestStatus values
+### subjectRightsRequestStatus values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| closed | | unknownFutureValue |
-## subjectRightsRequestType values
+### subjectRightsRequestType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| tagForAction | | unknownFutureValue |
-## dataSubjectType values
+### dataSubjectType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| other | | unknownFutureValue |
-## answerInputType values
+### answerInputType values
| Member | Value | Description | | | -- | - |
Possible values for user account types (group membership), per Windows definitio
| radioButton | 1 | RadioButton. | | unknownFutureValue | 2 | UnknownFutureValue. |
-## taskStatus_v2 values
+### taskStatus_v2 values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| completed | | unknownFutureValue |
-## wellKnownListName_v2 values
+### wellKnownListName_v2 values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| flaggedEmail | | unknownFutureValue |
-## bookingPriceType values
+### bookingPriceType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| notSet | | unknownFutureValue |
-## bookingStaffRole values
+### bookingStaffRole values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| scheduler | | teamMember |
-## bookingReminderRecipients values
+### bookingReminderRecipients values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| customer | | unknownFutureValue |
-## teamworkConnectionStatus values
+### teamworkConnectionStatus values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| disconnected | | unknownFutureValue |
-## teamworkDeviceActivityState values
+### teamworkDeviceActivityState values
| Member | Value | Description | | | -- | |
Possible values for user account types (group membership), per Windows definitio
| unavailable | 3 | The device is unavailable. | | unknownFutureValue | 4 | Evolvable enumeration sentinel value. Don't use. |
-## teamworkDeviceOperationType values
+### teamworkDeviceOperationType values
| Member | Value | Description | | | -- | |
Possible values for user account types (group membership), per Windows definitio
| remoteLogout | 6 | Device remote logout. | | unknownFutureValue | 7 | Evolvable enumeration sentinel value. Don't use. |
-## teamworkSoftwareFreshness values
+### teamworkSoftwareFreshness values
| Member | Value | Description | | | -- | -- |
Possible values for user account types (group membership), per Windows definitio
| updateAvailable | 2 | Indicates that a software update is available for a device component. | | unknownFutureValue | 3 | Evolvable enumeration sentinel value. Don't use. |
-## teamworkSoftwareType values
+### teamworkSoftwareType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| companyPortal | | unknownFutureValue |
-## teamworkSupportedClient values
+### teamworkSupportedClient values
| Member | Value | Description | | -- | -- | |
Possible values for user account types (group membership), per Windows definitio
| teamsOnly | 4 | Supports only `Teams`. | | unknownFutureValue | 5 | Evolvable enumeration sentinel value. Don't use. |
-## delegatedAdminAccessAssignmentStatus values
+### delegatedAdminAccessAssignmentStatus values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| error | | unknownFutureValue |
-## delegatedAdminAccessContainerType values
+### delegatedAdminAccessContainerType values
| Member | | | | securityGroup | | unknownFutureValue |
-## delegatedAdminRelationshipOperationType values
+### delegatedAdminRelationshipOperationType values
| Member | | | | delegatedAdminAccessAssignmentUpdate | | unknownFutureValue |
-## delegatedAdminRelationshipRequestAction values
+### delegatedAdminRelationshipRequestAction values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| unknownFutureValue | | reject |
-## delegatedAdminRelationshipRequestStatus values
+### delegatedAdminRelationshipRequestStatus values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| failed | | unknownFutureValue |
-## delegatedAdminRelationshipStatus values
+### delegatedAdminRelationshipStatus values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| terminationRequested | | unknownFutureValue |
-## featureTargetType values
+### featureTargetType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| role | | unknownFutureValue |
-## longRunningOperationStatus values
+### longRunningOperationStatus values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| skipped | | unknownFutureValue |
-## submissionCategory values
+### submissionCategory values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| malware | | unknownFutureValue |
-## submissionClientSource values
+### submissionClientSource values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| other | | unknownFutureValue |
-## submissionContentType values
+### submissionContentType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| app | | unknownFutureValue |
-## submissionSource values
+### submissionSource values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| administrator | | unknownFutureValue |
-## weakAlgorithms values
+### weakAlgorithms values
| Member | | | | rsaSha1 | | unknownFutureValue |
-## tenantAllowBlockListAction values
+### tenantAllowBlockListAction values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| block | | unknownFutureValue |
-## tenantAllowBlockListEntryType values
+### tenantAllowBlockListEntryType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| recipient | | unknownFutureValue |
-## outlierMemberType values
+### outlierMemberType values
| Member | | | | user | | unknownFutureValue |
-## outlierContainerType values
+### outlierContainerType values
| Member | | | | group | | unknownFutureValue |
-## browserSharedCookieSourceEnvironment values
+### browserSharedCookieSourceEnvironment values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| both | | unknownFutureValue |
-## browserSiteCompatibilityMode values
+### browserSiteCompatibilityMode values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| internetExplorer5 | | unknownFutureValue |
-## browserSiteMergeType values
+### browserSiteMergeType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| default | | unknownFutureValue |
-## browserSiteTargetEnvironment values
+### browserSiteTargetEnvironment values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| none | | unknownFutureValue |
-## browserSiteStatus values
+### browserSiteStatus values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| pendingDelete | | unknownFutureValue |
-## browserSharedCookieStatus values
+### browserSharedCookieStatus values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| pendingDelete | | unknownFutureValue |
-## browserSiteListStatus values
+### browserSiteListStatus values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| pending | | unknownFutureValue |
-## authenticationStrengthPolicyType values
+### authenticationStrengthPolicyType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| custom | | unknownFutureValue |
-## authenticationStrengthRequirements values
+### authenticationStrengthRequirements values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| mfa | | unknownFutureValue |
-## authenticationStrengthResult values
+### authenticationStrengthResult values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| cannotSatisfy | | unknownFutureValue |
-## authenticationMethodModes values
+### authenticationMethodModes values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| federatedMultiFactor | | unknownFutureValue |
-## baseAuthenticationMethod values
+### baseAuthenticationMethod values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| federation | | unknownFutureValue |
-## searchContent values
+### searchContent values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| sharedContent | | unknownFutureValue |
-## chatMessageActions values
+### chatMessageActions values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| actionUndefined | | unknownFutureValue |
-## plannerRelationshipUserRoles values
+### plannerRelationshipUserRoles values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| applications | | unknownFutureValue |
-## plannerRuleKind values
+### plannerRuleKind values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| planRule | | unknownFutureValue |
-## plannerUserRoleKind values
+### plannerUserRoleKind values
| Member | | | | relationship | | unknownFutureValue |
-## plannerTaskTargetKind values
+### plannerTaskTargetKind values
| Member | | | | group | | unknownFutureValue |
-## onPremisesDirectorySynchronizationDeletionPreventionType values
+### onPremisesDirectorySynchronizationDeletionPreventionType values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| enabledForPercentage | | unknownFutureValue |
-## authenticationMethodsPolicyMigrationState values
+### authenticationMethodsPolicyMigrationState values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| migrationComplete | | unknownFutureValue |
-## authenticationEventType values
+### authenticationEventType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| pageRenderStart | | unknownFutureValue |
-## microsoftAuthenticatorAuthenticationMethodClientAppName values
+### microsoftAuthenticatorAuthenticationMethodClientAppName values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| outlookMobile | | unknownFutureValue |
-## userDefaultAuthenticationMethodType values
+### userDefaultAuthenticationMethodType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| sms | | unknownFutureValue |
-## endUserNotificationPreference values
+### endUserNotificationPreference values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| custom | | unknownFutureValue |
-## endUserNotificationSettingType values
+### endUserNotificationSettingType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| noNotification | | unknownFutureValue |
-## endUserNotificationType values
+### endUserNotificationType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| trainingReminder | | unknownFutureValue |
-## notificationDeliveryFrequency values
+### notificationDeliveryFrequency values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| biWeekly | | unknownFutureValue |
-## notificationDeliveryPreference values
+### notificationDeliveryPreference values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| deliverAfterCampaignEnd | | unknownFutureValue |
-## oAuthAppScope values
+### oAuthAppScope values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| sendMail | | unknownFutureValue |
-## targettedUserType values
+### targettedUserType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| allUsers | | unknownFutureValue |
-## trainingAssignedTo values
+### trainingAssignedTo values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| didNothing | | unknownFutureValue |
-## trainingAvailabilityStatus values
+### trainingAvailabilityStatus values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| delete | | unknownFutureValue |
-## trainingCompletionDuration values
+### trainingCompletionDuration values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| month | | unknownFutureValue |
-## trainingSettingType values
+### trainingSettingType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| custom | | unknownFutureValue |
-## trainingType values
+### trainingType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| phishing | | unknownFutureValue |
-## verifiableCredentialPresentationStatusCode values
+### verifiableCredentialPresentationStatusCode values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| presentation_verified | | unknownFutureValue |
-## labelKind values
+### labelKind values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| enumerated | | unknownFutureValue |
-## permissionKind values
+### permissionKind values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| allPermissionsOnResourceApp | | unknownFutureValue |
-## resourceScopeType values
+### resourceScopeType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| tenant | | unknownFutureValue |
-## rootDomains values
+### rootDomains values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| allManagedAndEnumeratedFederated | | unknownFutureValue |
-## allowedRolePrincipalTypes values
+### allowedRolePrincipalTypes values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| group | | unknownFutureValue |
-## b2bIdentityProvidersType values
+### b2bIdentityProvidersType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| defaultConfiguredIdp | | unknownFutureValue |
-## authorizationSystemActionSeverity values
+### authorizationSystemActionSeverity values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| high | | unknownFutureValue |
-## authorizationSystemActionType values
+### authorizationSystemActionType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| read | | unknownFutureValue |
-## awsPolicyType values
+### awsPolicyType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| custom | | unknownFutureValue |
-## awsRoleTrustEntityType values
+### awsRoleTrustEntityType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| webIdentity | | unknownFutureValue |
-## awsRoleType values
+### awsRoleType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| custom | | unknownFutureValue |
-## awsStatementEffect values
+### awsStatementEffect values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| deny | | unknownFutureValue |
-## azureRoleDefinitionType values
+### azureRoleDefinitionType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| custom | | unknownFutureValue |
-## dataCollectionStatus values
+### dataCollectionStatus values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| offline | | unknownFutureValue |
-## gcpRoleType values
+### gcpRoleType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| custom | | unknownFutureValue |
-## permissionsDefinitionIdentityType values
+### permissionsDefinitionIdentityType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| serviceAccount | | unknownFutureValue |
-## permissionsModificationCapability values
+### permissionsModificationCapability values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| noRecentDataCollected | | unknownFutureValue |
-## permissionsRequestOccurrenceStatus values
+### permissionsRequestOccurrenceStatus values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| revokingFailed | | unknownFutureValue |
-## statusDetail values
+### statusDetail values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| rejected | | unknownFutureValue |
-## socialIdentitySourceType values
+### socialIdentitySourceType values
| Member | | - | | facebook | | unknownFutureValue |
-## authorizationSystemType values
+### authorizationSystemType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| aws | | unknownFutureValue |
-## awsAccessType values
+### awsAccessType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| private | | unknownFutureValue |
-## awsSecretInformationWebServices values
+### awsSecretInformationWebServices values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| certificateManager | | unknownFutureValue |
-## awsSecurityToolWebServices values
+### awsSecurityToolWebServices values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| guardDuty | | unknownFutureValue |
-## azureAccessType values
+### azureAccessType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| private | | unknownFutureValue |
-## azureEncryption values
+### azureEncryption values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| customer | | unknownFutureValue |
-## externalSystemAccessMethods values
+### externalSystemAccessMethods values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| roleChaining | | unknownFutureValue |
-## gcpAccessType values
+### gcpAccessType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| private | | unknownFutureValue |
-## gcpEncryption values
+### gcpEncryption values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| customer | | unknownFutureValue |
-## iamStatus values
+### iamStatus values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| disabled | | unknownFutureValue |
-## devicePlatformType values
+### devicePlatformType values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| iOSMobileApplicationManagement | | unknownFutureValue |
-## bookingPageAccessControl values
+### bookingPageAccessControl values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| restrictedToOrganization | | unknownFutureValue |
-## bookingsServiceAvailabilityType values
+### bookingsServiceAvailabilityType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| customWeeklyHours | | unknownFutureValue |
-## conditionalAccessTransferMethods values
+### conditionalAccessTransferMethods values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| authenticationTransfer | | unknownFutureValue |
-## claimConditionUserType values
+### claimConditionUserType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| externalGuests | | unknownFutureValue |
-## filterType values
+### filterType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| contains | | unknownFutureValue |
-## matchOn values
+### matchOn values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| samAccountName | | unknownFutureValue |
-## samlAttributeNameFormat values
+### samlAttributeNameFormat values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| basic | | unknownFutureValue |
-## samlNameIDFormat values
+### samlNameIDFormat values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| persistent | | unknownFutureValue |
-## samlSLOBindingType values
+### samlSLOBindingType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| httpPost | | unknownFutureValue |
-## tokenFormat values
+### tokenFormat values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| jwt | | unknownFutureValue |
-## transformationExtractType values
+### transformationExtractType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| suffix | | unknownFutureValue |
-## transformationTrimType values
+### transformationTrimType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| leadingAndTrailing | | unknownFutureValue |
-## sharingRole values
+### sharingRole values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| submitOnly | | unknownFutureValue |
-## sharingScope values
+### sharingScope values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| users | | unknownFutureValue |
-## sharingVariant values
+### sharingVariant values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| embed | | unknownFutureValue |
-## trustFrameworkKeyStatus values
+### trustFrameworkKeyStatus values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| disabled | | unknownFutureValue |
-## conditionalAccessInsiderRiskLevels values
+### conditionalAccessInsiderRiskLevels values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| elevated | | unknownFutureValue |
-## compliantNetworkType values
+### compliantNetworkType values
| Member | | - | | allTenantCompliantNetworks | | unknownFutureValue |
-## meetingRequestType values
+### meetingRequestType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| outdated | | principalWantsCopy |
-## photoUpdateSource values
+### photoUpdateSource values
| Member | | - | | cloud | | onPremises |
-## uriUsageType values
+### uriUsageType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| logoutUrl | | unknownFutureValue |
-## nativeAuthenticationApisEnabled values
+### nativeAuthenticationApisEnabled values
| Member | | - |
v1.0 Event https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/event.md
This resource supports:
| Method | Return Type |Description| |:|:--|:-|
-|[List events](../api/user-list-events.md)|[Event](event.md) collection |Retrieve a list of [event](../resources/event.md) objects in the user's mailbox. The list contains single instance meetings and series masters.|
-|[Create event](../api/user-post-events.md) |[event](event.md)| Create a new event by posting to the instances collection.|
-|[Get event](../api/event-get.md) | [event](event.md) |Read properties and relationships of event object.|
-|[Update event](../api/event-update.md) | [event](event.md) |Update event object. |
-|[Delete event](../api/event-delete.md) | None |Delete event object. |
-|[Get delta](../api/event-delta.md)|[event](event.md) collection|Get a set of events that have been added, deleted, or updated in a **calendarView** (a range of events) of the user's primary calendar.|
+|[List](../api/user-list-events.md)|[Event](event.md) collection |Retrieve a list of [event](../resources/event.md) objects in the user's mailbox. The list contains single instance meetings and series masters.|
+|[Create](../api/user-post-events.md) |[event](event.md)| Create a new event by posting to the instances collection.|
+|[Get](../api/event-get.md) | [event](event.md) |Read properties and relationships of event object.|
+|[Update](../api/event-update.md) | [event](event.md) |Update event object. |
+|[Delete](../api/event-delete.md) | None |Delete event object. |
+|[Permanently delete](../api/event-permanentdelete.md)|None|Permanently delete an event and place it in the Purges folder in the Recoverable Items folder in the user's mailbox.|
+|[Get delta](../api/event-delta.md)|[event](event.md) collection|Get a set of events that were added, deleted, or updated in a **calendarView** (a range of events) of the user's primary calendar.|
|[Forward event](../api/event-forward.md)|None|Lets the organizer or attendee of a meeting event forward the meeting request to a new recipient.| |[Cancel event](../api/event-cancel.md) | None | Send cancellation message from the organizer to all the attendees and cancel the specified meeting. | |[Accept event](../api/event-accept.md)|None|Accept the specified event in a user calendar.|
This resource supports:
|changeKey|String|Identifies the version of the event object. Every time the event is changed, ChangeKey changes as well. This allows Exchange to apply changes to the correct version of the object.| |createdDateTime|DateTimeOffset|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`| |end|[DateTimeTimeZone](datetimetimezone.md)|The date, time, and time zone that the event ends. By default, the end time is in UTC.|
-|exceptionOccurrences|[event](event.md) collection|Contains the **id** property values of the event instances that are exceptions in a recurring series.<br>Exceptions can differ from other occurrences in a recurring series, such as the subject, start or end times, or attendees. Exceptions don't include canceled occurrences.<br><br>Returned only on $select and $expand in a [GET](../api/event-get.md) operation which specifies the id of a series master event (that is, the seriesMasterId property value).|
+|exceptionOccurrences|[event](event.md) collection|Contains the **id** property values of the event instances that are exceptions in a recurring series.<br>Exceptions can differ from other occurrences in a recurring series, such as the subject, start or end times, or attendees. Exceptions don't include canceled occurrences.<br><br>Returned only on $select and $expand in a [GET](../api/event-get.md) operation that specifies the id of a series master event (that is, the **seriesMasterId** property value).|
|hasAttachments|Boolean|Set to true if the event has attachments.| |hideAttendees|Boolean|When set to `true`, each attendee only sees themselves in the meeting request and meeting **Tracking** list. Default is false.| |iCalUId|String|A unique identifier for an event across calendars. This ID is different for each occurrence in a recurring series. Read-only.|
This resource supports:
|isAllDay|Boolean|Set to true if the event lasts all day. If true, regardless of whether it's a single-day or multi-day event, start and end time must be set to midnight and be in the same time zone.| |isCancelled|Boolean|Set to true if the event has been canceled.| |isDraft|Boolean|Set to true if the user has updated the meeting in Outlook but hasn't sent the updates to attendees. Set to false if all changes have been sent, or if the event is an appointment without any attendees.|
-|isOnlineMeeting|Boolean| `True` if this event has online meeting information (that is, **onlineMeeting** points to an [onlineMeetingInfo](onlinemeetinginfo.md) resource), `false` otherwise. Default is `false` (**onlineMeeting** is `null`). Optional. <br> After you set **isOnlineMeeting** to `true`, Microsoft Graph initializes **onlineMeeting**. Subsequently Outlook ignores any further changes to **isOnlineMeeting**, and the meeting remains available online. |
+|isOnlineMeeting|Boolean| `True` if this event has online meeting information (that is, **onlineMeeting** points to an [onlineMeetingInfo](onlinemeetinginfo.md) resource), `false` otherwise. Default is `false` (**onlineMeeting** is `null`). Optional. <br> After you set **isOnlineMeeting** to `true`, Microsoft Graph initializes **onlineMeeting**. Outlook then ignores any further changes to **isOnlineMeeting**, and the meeting remains available online. |
|isOrganizer|Boolean|Set to true if the calendar owner (specified by the **owner** property of the [calendar](calendar.md)) is the organizer of the event (specified by the **organizer** property of the **event**). This also applies if a delegate organized the event on behalf of the owner.| |isReminderOn|Boolean|Set to true if an alert is set to remind the user of the event.| |lastModifiedDateTime|DateTimeOffset|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`| |location|[Location](location.md)|The location of the event.| |locations|[Location](location.md) collection|The locations where the event is held or attended from. The **location** and **locations** properties always correspond with each other. If you update the **location** property, any prior locations in the **locations** collection would be removed and replaced by the new **location** value. | |occurrenceId|String|An identifier for an occurrence in a recurring event series. Null if the event isn't part of a recurring series.<br><br>The format of the property value is OID.{seriesMasterId-value}.{occurrence-start-date}. The time zone for {occurrence-start-date} is the recurrenceTimeZone property defined for the corresponding [recurrenceRange](recurrencerange.md).<br><br>This property can identify any occurrence in a recurring series, including an occurrence that has been modified or canceled. You can use this property to perform all operations supported by occurrences in the recurring series.|
-|onlineMeeting|[OnlineMeetingInfo](onlinemeetinginfo.md)| Details for an attendee to join the meeting online. Default is null. Read-only. <br>After you set the **isOnlineMeeting** and **onlineMeetingProvider** properties to enable a meeting online, Microsoft Graph initializes **onlineMeeting**. When set, the meeting remains available online, and you cannot change the **isOnlineMeeting**, **onlineMeetingProvider**, and **onlneMeeting** properties again.|
-|onlineMeetingProvider|onlineMeetingProviderType| Represents the online meeting service provider. By default, **onlineMeetingProvider** is `unknown`. The possible values are `unknown`, `teamsForBusiness`, `skypeForBusiness`, and `skypeForConsumer`. Optional. <br> After you set **onlineMeetingProvider**, Microsoft Graph initializes **onlineMeeting**. Subsequently you cannot change **onlineMeetingProvider** again, and the meeting remains available online. |
+|onlineMeeting|[OnlineMeetingInfo](onlinemeetinginfo.md)| Details for an attendee to join the meeting online. Default is null. Read-only. <br>After you set the **isOnlineMeeting** and **onlineMeetingProvider** properties to enable a meeting online, Microsoft Graph initializes **onlineMeeting**. When set, the meeting remains available online, and you can't change the **isOnlineMeeting**, **onlineMeetingProvider**, and **onlneMeeting** properties again.|
+|onlineMeetingProvider|onlineMeetingProviderType| Represents the online meeting service provider. By default, **onlineMeetingProvider** is `unknown`. The possible values are `unknown`, `teamsForBusiness`, `skypeForBusiness`, and `skypeForConsumer`. Optional. <br> After you set **onlineMeetingProvider**, Microsoft Graph initializes **onlineMeeting**. Subsequently you can't change **onlineMeetingProvider** again, and the meeting remains available online. |
|onlineMeetingUrl|String|A URL for an online meeting. The property is set only when an organizer specifies in Outlook that an event is an online meeting such as Skype. Read-only.<br>To access the URL to join an online meeting, use **joinUrl** which is exposed via the **onlineMeeting** property of the **event**. The **onlineMeetingUrl** property will be deprecated in the future. | |organizer|[Recipient](recipient.md)|The organizer of the event.| |originalEndTimeZone|String|The end time zone that was set when the event was created. A value of `tzone://Microsoft/Custom` indicates that a legacy custom time zone was set in desktop Outlook.|
-|originalStart|DateTimeOffset|Represents the start time of an event when it is initially created as an occurrence or exception in a recurring series. This property isn't returned for events that are single instances. Its date and time information is expressed in ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`|
+|originalStart|DateTimeOffset|Represents the start time of an event when it's initially created as an occurrence or exception in a recurring series. This property isn't returned for events that are single instances. Its date and time information is expressed in ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`|
|originalStartTimeZone|String|The start time zone that was set when the event was created. A value of `tzone://Microsoft/Custom` indicates that a legacy custom time zone was set in desktop Outlook.| |recurrence|[PatternedRecurrence](patternedrecurrence.md)|The recurrence pattern for the event.| |reminderMinutesBeforeStart|Int32|The number of minutes before the event start time that the reminder alert occurs.|
This resource supports:
|showAs|String|The status to show. Possible values are: `free`, `tentative`, `busy`, `oof`, `workingElsewhere`, `unknown`.| |start|[DateTimeTimeZone](datetimetimezone.md)|The start date, time, and time zone of the event. By default, the start time is in UTC.| |subject|String|The text of the event's subject line.|
-|transactionId|String|A custom identifier specified by a client app for the server to avoid redundant [POST](../api/calendar-post-events.md) operations in case of client retries to create the same event. This is useful when low network connectivity causes the client to time out before receiving a response from the server for the client's prior create-event request. After you set **transactionId** when creating an event, you cannot change **transactionId** in a subsequent update. This property is only returned in a response payload if an app has set it. Optional.|
+|transactionId|String|A custom identifier specified by a client app for the server to avoid redundant [POST](../api/calendar-post-events.md) operations if the client retries to create the same event. This is useful when low network connectivity causes the client to time out before receiving a response from the server for the client's prior create-event request. After you set **transactionId** when creating an event, you can't change **transactionId** in a subsequent update. This property is only returned in a response payload if an app has set it. Optional.|
|type|String|The event type. Possible values are: `singleInstance`, `occurrence`, `exception`, `seriesMaster`. Read-only| |uid|String|A unique identifier for calendar events. For recurring events, the value is the same for the series master and all of its occurrences including exceptions.|
-|webLink|String|The URL to open the event in Outlook on the web.<br/><br/>Outlook on the web opens the event in the browser if you are signed in to your mailbox. Otherwise, Outlook on the web prompts you to sign in.<br/><br/>This URL cannot be accessed from within an iFrame.|
+|webLink|String|The URL to open the event in Outlook on the web.<br/><br/>Outlook on the web opens the event in the browser if you're signed in to your mailbox. Otherwise, Outlook on the web prompts you to sign in.<br/><br/>This URL can't be accessed from within an iFrame.|
> [!NOTE] > The **webLink** property specifies a URL that opens the event in only earlier versions of Outlook on the web. The following is its URL format, with _{event-id}_ being the _**URL-encoded**_ value of the **id** property:
This resource supports:
|attachments|[Attachment](attachment.md) collection|The collection of [FileAttachment](fileattachment.md), [ItemAttachment](itemattachment.md), and [referenceAttachment](referenceattachment.md) attachments for the event. Navigation property. Read-only. Nullable.| |calendar|[Calendar](calendar.md)|The calendar that contains the event. Navigation property. Read-only.| |extensions|[Extension](extension.md) collection|The collection of open extensions defined for the event. Nullable.|
-|instances|[Event](event.md) collection|The occurrences of a recurring series, if the event is a series master. This property includes occurrences that are part of the recurrence pattern, and exceptions that have been modified, but doesn't include occurrences that have been canceled from the series. Navigation property. Read-only. Nullable.|
+|instances|[Event](event.md) collection|The occurrences of a recurring series, if the event is a series master. This property includes occurrences that are part of the recurrence pattern and exceptions that have been modified. It doesn't include occurrences that have been canceled from the series. Navigation property. Read-only. Nullable.|
|multiValueExtendedProperties|[multiValueLegacyExtendedProperty](multivaluelegacyextendedproperty.md) collection| The collection of multi-value extended properties defined for the event. Read-only. Nullable.| |singleValueExtendedProperties|[singleValueLegacyExtendedProperty](singlevaluelegacyextendedproperty.md) collection| The collection of single-value extended properties defined for the event. Read-only. Nullable.|
v1.0 Eventmessage https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/eventmessage.md
Title: "eventMessage resource type"
-description: "A message that represents a meeting request, cancellation, or response (which can be one of the following: acceptance, tentative acceptance, or decline). "
+description: "A message that represents a meeting request, cancellation, or response. Can be one of the following values: acceptance, tentative acceptance, or decline."
ms.localizationpriority: medium
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-A message that represents a meeting request, cancellation, or response (which can be one of the following: acceptance, tentative acceptance, or decline).
+A message that represents a meeting request, cancellation, or response. Can be one of the following values: acceptance, tentative acceptance, or decline.
The **eventMessage** entity is derived from [message](message.md). **eventMessage** is the base type for [eventMessageRequest](eventmessagerequest.md) and [eventMessageResponse](eventmessageresponse.md). The **meetingMessageType** property identifies the type of the event message.
The following JSON representation shows the resource type.
|receivedDateTime|DateTimeOffset|The date and time the message was received.| |recurrence|[patternedRecurrence](patternedrecurrence.md)|The recurrence pattern of the requested meeting.| |replyTo|[recipient](recipient.md) collection|The email addresses to use when replying.|
-|sender|[recipient](recipient.md)|The account that is used to generate the message. In most cases, this value is the same as the **from** property. You can set this property to a different value when sending a message from a [shared mailbox](/exchange/collaboration/shared-mailboxes/shared-mailboxes), [for a shared calendar, or as a delegate](/graph/outlook-share-delegate-calendar). In any case, the value must correspond to the actual mailbox used. For more information, see [setting the from and sender properties](/graph/outlook-create-send-messages#setting-the-from-and-sender-properties).|
+|sender|[recipient](recipient.md)|The account that is used to generate the message. In most cases, this value is the same as the **from** property. You can set this property to a different value when sending a message from a [shared mailbox](/exchange/collaboration/shared-mailboxes/shared-mailboxes), [for a shared calendar, or as a delegate](/graph/outlook-share-or-delegate-calendar). In any case, the value must correspond to the actual mailbox used. For more information, see [setting the from and sender properties](/graph/outlook-create-send-messages#setting-the-from-and-sender-properties).|
|sentDateTime|DateTimeOffset|The date and time the message was sent.| |startDateTime|[dateTimeTimeZone](datetimetimezone.md)|The start time of the requested meeting.| |subject|String|The subject of the message.|
The following JSON representation shows the resource type.
| Method | Return Type |Description| |:|:--|:-|
-|[Get event message](../api/eventmessage-get.md) | [eventMessage](eventmessage.md) |Read properties and relationships of eventMessage object.|
-|[Update event message](../api/eventmessage-update.md) | [eventMessage](eventmessage.md) |Update eventMessage object.|
-|[Delete event message](../api/eventmessage-delete.md) | None |Delete eventMessage object.|
+|[Get](../api/eventmessage-get.md) | [eventMessage](eventmessage.md) |Read properties and relationships of eventMessage object.|
+|[Update](../api/eventmessage-update.md) | [eventMessage](eventmessage.md) |Update eventMessage object.|
+|[Delete](../api/eventmessage-delete.md) | None |Delete eventMessage object.|
|[Copy message](../api/message-copy.md)|[message](message.md)|Copy a message to a folder.| |[Create draft to forward message](../api/message-createforward.md)|[message](message.md)|Create a draft of the Forward message. You can then [update](../api/message-update.md) or [send](../api/message-send.md) the draft.| |[Create draft to reply](../api/message-createreply.md)|[message](message.md)|Create a draft of the Reply message. You can then [update](../api/message-update.md) or [send](../api/message-send.md) the draft.|
The following JSON representation shows the resource type.
|[Send draft message](../api/message-send.md)|None|Sends a previously created message draft. The message is then saved in the Sent Items folder.| |[Recall message](../api/message-recall.md)|[message](message.md)|Recall a message in the specified user's mailbox Sent Items folder.| |[Unsubscribe](../api/message-unsubscribe.md)|None|Send a message using the data and address specified in the first mailto command in the List-Unsubscribe header.|
+|[Permanently delete](../api/eventmessage-permanentdelete.md)|None|Permanently delete an event message and place it in the Purges folder in the Recoverable Items folder in the user's mailbox.|
|**Attachments**| | | |[List attachments](../api/eventmessage-list-attachments.md) |[attachment](attachment.md) collection| Get all attachments on an eventMessage.| |[Add attachment](../api/eventmessage-post-attachments.md) |[attachment](attachment.md)| Add a new attachment to an eventMessage by posting to the attachments collection.|
v1.0 Filestoragecontainer https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/filestoragecontainer.md
Represents a location where multiple users or a group of users can store files a
|isItemVersioningEnabled|Boolean|Indicates whether versioning is enabled for the **fileStorageContainer**. The setting is applicable to all items in the **fileStorageContainer**. Read-Write.| |itemMajorVersionLimit|Int32|Maximum number of major versions allowed for items in the **fileStorageContainer**. Read-write.| |owners|[userIdentity](../resources/useridentity.md) collection|List of users who own the **fileStorageContainer**. Read-only.|
-|ownershipType|fileStorageContainerOwnershipType|Ownership type of the **fileStorageContainer**.The possible values are: `tenantOwned`. Read-only.|
+|ownershipType|fileStorageContainerOwnershipType|Ownership type of the **fileStorageContainer**. The possible values are: `tenantOwned`. Read-only.|
|status|fileStorageContainerStatus|Status of the **fileStorageContainer**. Containers are created as inactive and require activation. Inactive containers are subjected to automatic deletion in 24 hours. The possible values are: `inactive`, `active`. Read-only.| |storageUsedInBytes|Int64|Storage used in the **fileStorageContainer**, in bytes. Read-only.| |viewpoint|[fileStorageContainerViewpoint](../resources/filestoragecontainerviewpoint.md)|Data specific to the current user. Read-only.| |lockState|siteLockState|Indicates the lock state of the **fileStorageContainer**. The possible values are `unlocked` and `lockedReadOnly`. Read-only.|
-|Settings|[fileStorageContainerSettings](../resources/filestoragecontainersettings.md)|Settings associated with a **fileStorageContainer**. Read-write.
+|settings|[fileStorageContainerSettings](../resources/filestoragecontainersettings.md)|Settings associated with a **fileStorageContainer**. Read-write.
## Relationships |Relationship|Type|Description| |:|:|:| |columns|[columnDefinition](../resources/columndefinition.md) collection|The set of custom structured metadata supported by the **fileStorageContainer**. Read-write.| |drive|[drive](../resources/drive.md)|The drive of the resource **fileStorageContainer**. Read-only.|
-|permissions|[permission](../resources/permission.md) collection|The set of permissions for users in the **fileStorageContainer**. The permission for each user is set by the **roles** property. The possible values are 'reader', 'writer', 'manager', and 'owner'. Read-write.|
+|permissions|[permission](../resources/permission.md) collection|The set of permissions for users in the **fileStorageContainer**. The permission for each user is set by the **roles** property. The possible values are `reader`, `writer`, `manager`, and `owner`. Read-write.|
|recycleBin|[recycleBin](../resources/recyclebin.md)|Recycle bin of the **fileStorageContainer**. Read-only.| ### roles property values
v1.0 Filestoragecontainersettings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/filestoragecontainersettings.md
Represents settings associated with a [fileStorageContainer](../resources/filest
|Property|Type|Description| |:|:|:|
-|isOcrEnabled|Boolean|Indicates whether OCR is enabled for a given container. If OCR is enabled on a container, OCR extraction is performed for recently added or updated documents (of supported document types) and the extracted fields are added to the metadata of the document. This enables end-user search and search-driven solutions.|
+|isOcrEnabled|Boolean|Whether optical character recognition (OCR) is enabled for a given container. When OCR is enabled on a container, OCR extraction is performed for new and updated documents of supported types. The extracted fields are added to the metadata of the document, enabling end-user search and search-driven solutions. Changing this property from `true` to `false` doesn't remove OCR metadata that was created while it was `true`. Default value is `false`.|
## Relationships
v1.0 Group https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/group.md
name. |
|--|--|--| | accessType | groupAccessType | Indicates the type of access to the group. Possible values are `none`, `private`, `secret`, and `public`. | | allowExternalSenders | Boolean | Indicates if people external to the organization can send messages to the group. The default value is `false`. <br><br>Returned only on `$select`. Supported only on the Get group API (`GET /groups/{ID}`). |
-| assignedLabels | [assignedLabel](assignedlabel.md) collection | The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. <br><br>Returned only on `$select`. |
+| assignedLabels | [assignedLabel](assignedlabel.md) collection | The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. <br><br>Returned only on `$select`. 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).|
| assignedLicenses | [assignedLicense](assignedlicense.md) collection | The licenses that are assigned to the group. <br><br>Returned only on `$select`. Supports `$filter` (`eq`). Read-only. | | autoSubscribeNewMembers | Boolean | Indicates if new members added to the group are auto-subscribed to receive email notifications. You can set this property in a PATCH request for the group; don't set it in the initial POST request that creates the group. Default value is `false`. <br><br>Returned only on `$select`. Supported only on the Get group API (`GET /groups/{ID}`). | | classification | String | Describes a classification for the group (such as low, medium or high business impact). Valid values for this property are defined by creating a ClassificationList [setting](directorysetting.md) value, based on the [template definition](directorysettingtemplate.md).<br><br>Returned by default. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `startsWith`). |
name. |
| members | [directoryObject](directoryobject.md) collection | Direct group members, who can be users, devices, other groups, or service principals. Supports the [List members](../api/group-list-members.md), [Add member](../api/group-post-members.md), and [Remove member](../api/group-delete-members.md) operations. Nullable. <br/>Supports `$expand` including nested `$select`. For example, `/groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=members($select=id,userPrincipalName,displayName)`. | | membersWithLicenseErrors | [user](user.md) collection | A list of group members with license errors from this group-based license assignment. Read-only. | | onenote | [onenote](onenote.md) | Read-only. |
-| owners | [directoryObject](directoryobject.md) collection | The owners of the group who can be users or service principals. Nullable. If this property isn't specified when creating a Microsoft 365 group, the calling user is automatically assigned as the group owner. <br/> Supports `$filter` (`/$count eq 0`, `/$count ne 0`, `/$count eq 1`, `/$count ne 1`); Supports `$expand` including nested `$select`. For example, `/groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=owners($select=id,userPrincipalName,displayName)`. |
+| owners | [directoryObject](directoryobject.md) collection | The owners of the group who can be users or service principals. Nullable. If this property isn't specified when creating a Microsoft 365 group the calling user (admin or non-admin) is automatically assigned as the group owner. For security groups, the admin caller isn't automatically added to this collection. <br/> Supports `$filter` (`/$count eq 0`, `/$count ne 0`, `/$count eq 1`, `/$count ne 1`); Supports `$expand` including nested `$select`. For example, `/groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=owners($select=id,userPrincipalName,displayName)`. |
| permissionGrants | [resourceSpecificPermissionGrant](resourcespecificpermissiongrant.md) | The permissions granted for a group to a specific application. Supports `$expand`. | | photo | [profilePhoto](profilephoto.md) | The group's profile photo. | | photos | [profilePhoto](profilephoto.md) collection | The profile photos owned by the group. Read-only. Nullable. |
v1.0 Groups Overview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/groups-overview.md
Content-type: application/json
} ```
-To learn more about Microsoft 365 groups and the administrator experiences, see [Learn about Microsoft 365 groups](https://support.office.com/article/Learn-about-Office-365-groups-b565caa1-5c40-40ef-9915-60fdb2d97fa2).
- ## Security groups and mail-enabled security groups **Security groups** are for controlling user access to resources. By checking whether a user is a member of a security group, your app can make authorization decisions when that user is trying to access some secure resources in your app. Security groups can have users, other security groups, devices, and service principals as members.
Using Microsoft Graph, you can perform the following common operations on groups
## Microsoft Entra roles for managing groups
-To manage groups in delegated scenarios, the app must be granted the appropriate permissions and the signed-in user must be in a supported [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json).
+To manage groups in delegated scenarios, the app must be granted the appropriate Microsoft Graph permissions and the signed-in user must be in a supported [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json).
-The following Microsoft Entra roles are the least privileged roles for managing all aspects of groups through Microsoft Graph, except for role-assignable groups. The least privileged role for managing role-assignable groups is **Privileged Role Administrator**.
+The following Microsoft Entra roles are the least privileged roles for all read and write operations on groups through Microsoft Graph, *except* for role-assignable groups. The least privileged role for managing role-assignable groups is **Privileged Role Administrator**.
- Directory Writers - Groups Administrator - User Administrator
+For a summary of the least privileged admin roles for different group-related tasks, see [Least privileged roles to manage groups](/entra/identity/role-based-access-control/delegate-by-task#groups).
+
+You can also create custom roles for group-related tasks. Refer to the [Microsoft Entra built-in roles reference](/entr) with the selected permissions.
+ ## Next step > [!div class="nextstepaction"]
v1.0 Identitygovernance Insights https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/identitygovernance-insights.md
Inherits from [microsoft.graph.entity](../resources/entity.md).
## Properties
-None.
+None.
## Relationships
v1.0 Incomingcalloptions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/incomingcalloptions.md
Inherits from [callOptions](calloptions.md).
|:|:--|:| | hideBotAfterEscalation | Boolean | Indicates whether to hide the app after the call is escalated. Inherited from [callOptions](calloptions.md). | | isContentSharingNotificationEnabled | Boolean | Indicates whether content sharing notifications should be enabled for the call. Inherited from [callOptions](calloptions.md). |
+| isDeltaRosterEnabled | Boolean | Indicates whether delta roster is enabled for the call. Inherited from [callOptions](calloptions.md). |
## JSON representation
The following JSON representation shows the resource type.
{ "@odata.type": "#microsoft.graph.incomingCallOptions", "hideBotAfterEscalation": "Boolean",
- "isContentSharingNotificationEnabled": "Boolean"
+ "isContentSharingNotificationEnabled": "Boolean",
+ "isDeltaRosterEnabled": "Boolean"
} ```
v1.0 Intune Devices Devicehealthscriptdevicestate https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/intune-devices-devicehealthscriptdevicestate.md
Contains properties for device run state of the device health script.
|Method|Return Type|Description| |:|:|:| |[List deviceHealthScriptDeviceStates](../api/intune-devices-devicehealthscriptdevicestate-list.md)|[deviceHealthScriptDeviceState](../resources/intune-devices-devicehealthscriptdevicestate.md) collection|List properties and relationships of the [deviceHealthScriptDeviceState](../resources/intune-devices-devicehealthscriptdevicestate.md) objects.|
-|[Get deviceHealthScriptDeviceState](../api/intune-devices-devicehealthscriptdevicestate-get.md)|[deviceHealthScriptDeviceState](../resources/intune-devices-devicehealthscriptdevicestate.md)|Read properties and relationships of the [deviceHealthScriptDeviceState](../resources/intune-devices-devicehealthscriptdevicestate.md) object.|
-|[Create deviceHealthScriptDeviceState](../api/intune-devices-devicehealthscriptdevicestate-create.md)|[deviceHealthScriptDeviceState](../resources/intune-devices-devicehealthscriptdevicestate.md)|Create a new [deviceHealthScriptDeviceState](../resources/intune-devices-devicehealthscriptdevicestate.md) object.|
-|[Delete deviceHealthScriptDeviceState](../api/intune-devices-devicehealthscriptdevicestate-delete.md)|None|Deletes a [deviceHealthScriptDeviceState](../resources/intune-devices-devicehealthscriptdevicestate.md).|
-|[Update deviceHealthScriptDeviceState](../api/intune-devices-devicehealthscriptdevicestate-update.md)|[deviceHealthScriptDeviceState](../resources/intune-devices-devicehealthscriptdevicestate.md)|Update the properties of a [deviceHealthScriptDeviceState](../resources/intune-devices-devicehealthscriptdevicestate.md) object.|
## Properties |Property|Type|Description|
v1.0 Mailfolder https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/mailfolder.md
by providing a [delta](../api/mailfolder-delta.md) function.
**Well-known folder names**
-Outlook creates certain folders for users by default. Instead of using the corresponding folder **id** value, for convenience, you can use
-the well-known folder names from the table below when accessing these folders. For example, you can get the Drafts folder using its well-known name with the following query.
+Outlook creates certain folders for users by default. Instead of using the corresponding folder **id** value, for convenience, you can use the well-known folder names from the table below when accessing these folders. For example, you can get the Drafts folder using its well-known name with the following query.
<!-- { "blockType": "ignored" } --> ```http GET /me/mailFolders/drafts ```
-Well-known names work regardless of the locale of the user's mailbox, so the above query will always return the user's Drafts folder regardless of how it's named.
+Well-known names work regardless of the locale of the user's mailbox, so the above query will always return the user's Drafts folder regardless of its name.
| Well-known folder name | Description | |:--|:|
Well-known names work regardless of the locale of the user's mailbox, so the abo
|[Copy mail folder](../api/mailfolder-copy.md)|[mailFolder](mailfolder.md)|Copy a mailFolder and its contents to another mailFolder.| |[Get folder delta](../api/mailfolder-delta.md)|[mailFolder](mailfolder.md) collection|Get a set of mail folders that have been added, deleted, or removed from the user's mailbox.| |[Move mail folder](../api/mailfolder-move.md)|[mailFolder](mailfolder.md)|Move a mailFolder and its contents to another mailFolder.|
+|[Permanently delete](../api/mailfolder-permanentdelete.md)|None|Permanently delete a mail folder and remove its items from the user's mailbox.|
|**Extended properties**| | | |[Create single-value property](../api/singlevaluelegacyextendedproperty-post-singlevalueextendedproperties.md) |[mailFolder](mailfolder.md) |Create one or more single-value extended properties in a new or existing mailFolder. | |[Get single-value property](../api/singlevaluelegacyextendedproperty-get.md) | [mailFolder](mailfolder.md) | Get mailFolders that contain a single-value extended property by using `$expand` or `$filter`. |
v1.0 Mailsearchfolder https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/mailsearchfolder.md
Namespace: microsoft.graph
A **mailSearchFolder** is a virtual folder in the user's mailbox that contains all the email items matching specified search criteria. **mailSearchFolder** inherits from [mailFolder](mailfolder.md). Search folders can be created in any folder in a user's Exchange Online mailbox. However, for a search folder to appear in Outlook, Outlook for the web, or Outlook Live, the folder must be created in the **WellKnownFolderName.SearchFolders** folder.
-## Search folder lifecycle
+### Search folder lifecycle
-Search folders created by your application can be deleted by Exchange Online for one of the following reasons:
+Exchange Online can delete search folders created by your application for one of the following reasons:
1. Search folders expire after 45 days of no usage. 2. There are limits on the number of search folders that can be created per source folder. When this limit is breached, older search folders are deleted to make way for new ones.
When a search folder is deleted, your app should create a new search folder reso
| Method | Return Type | Description | |:|:--|:-|
-| [Create mail search folder](../api/mailsearchfolder-post.md) | [mailSearchFolder](mailsearchfolder.md) | Create a search folder in this user's mailbox. |
+| [Create](../api/mailsearchfolder-post.md) | [mailSearchFolder](mailsearchfolder.md) | Create a search folder in this user's mailbox. |
+| [Get](../api/mailfolder-get.md) | [mailSearchFolder](mailsearchfolder.md) | Get the specified search folder. |
+| [Update](../api/mailsearchfolder-update.md) | [mailSearchFolder](mailsearchfolder.md) | Update the specified search folder. |
+| [Delete](../api/mailfolder-delete.md) | None | Delete the specified search folder. |
+| [Permanently delete](../api/mailsearchfolder-permanentdelete.md)|None|Permanently delete a mail search folder and remove its items from the user's mailbox.|
| [List child folders](../api/mailfolder-list-childfolders.md) | [mailFolder](mailfolder.md) collection | List all the folders in this user's mailbox, including search folders. |
-| [Get mail search folder](../api/mailfolder-get.md) | [mailSearchFolder](mailsearchfolder.md) | Get the specified search folder. |
-| [Update mail search folder](../api/mailsearchfolder-update.md) | [mailSearchFolder](mailsearchfolder.md) | Update the specified search folder. |
-| [Delete mail search folder](../api/mailfolder-delete.md) | None | Delete the specified search folder. |
| [List messages in folder](../api/mailfolder-list-messages.md) | [message](message.md) collection | List all the messages in the specified search folder. | ## Properties
v1.0 Message https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/message.md
The maximum total number of recipients included in the **toRecipients**, **ccRec
This resource supports: -- Adding your own data as custom Internet message headers. Add custom headers only when creating a message, and name them starting with "x-". After the message is sent, you cannot modify the headers. To get the headers of a message, apply the `$select` query parameter in a [get message](../api/message-get.md) operation.
+- Adding your own data as custom Internet message headers. Add custom headers only when creating a message, and name them starting with "x-". After the message is sent, you can't modify the headers. To get the headers of a message, apply the `$select` query parameter in a [get message](../api/message-get.md) operation.
- Adding your own data as custom properties as [extensions](/graph/extensibility-overview). - Subscribing to [change notifications](/graph/webhooks). - Using [delta query](/graph/delta-query-overview) to track incremental additions, deletions, and updates,
by providing a [delta](../api/message-delta.md) function.
|[Forward message](../api/message-forward.md)|None|Forward a message, add a comment or modify any updateable properties all in one **forward** call. The message is then saved in the Sent Items folder.| |[Mark as junk](../api/message-markasjunk.md)|[message](../resources/message.md)|Mark a [message](../resources/message.md) as junk. This API adds the sender to the list of blocked senders and moves the message to the **Junk Email** folder, when **moveToJunk** is `true`.| |[Mark as not junk](../api/message-markasnotjunk.md)|[message](../resources/message.md)|Mark a [message](../resources/message.md) as not junk. This API removes the sender from the list of blocked senders and moves the message to the **Inbox** folder, when **moveToInbox** is `true`.|
-|[Move message](../api/message-move.md)|[Message](message.md)|Move the message to a folder. This creates a new copy of the message in the destination folder.|
+|[Move message](../api/message-move.md)|[Message](message.md)|Move the message to a folder. This API creates a new copy of the message in the destination folder.|
|[Reply to message](../api/message-reply.md)|None|Reply to the sender of a message, add a comment or modify any updateable properties all in one **reply** call. The message is then saved in the Sent Items folder.| |[Reply-all to message](../api/message-replyall.md)|None|Reply to all the recipients of a message by specifying a comment and modifying any updateable properties for the reply, all by using the **replyAll** method. The message is then saved in the Sent Items folder.| |[Send draft message](../api/message-send.md)|None|Sends a previously created message draft. The message is then saved in the Sent Items folder.| |[Recall message](../api/message-recall.md)|[message](message.md)|Recall a message in the specified user's mailbox Sent Items folder.| |[Unsubscribe](../api/message-unsubscribe.md)|None|Send a message using the data and address specified in the first mailto command in the List-Unsubscribe header.|
+|[Permanently delete](../api/message-permanentdelete.md)|None|Permanently delete a message and place it in the Purges folder in the Recoverable Items folder in the user's mailbox.|
|**Attachments**| | | |[List attachments](../api/message-list-attachments.md) |[Attachment](attachment.md) collection| Get all attachments on a message.| |[Add attachment](../api/message-post-attachments.md) |[Attachment](attachment.md)| Add a new attachment to a message by posting to the attachments collection.|
v1.0 Onlinemeeting https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/onlinemeeting.md
Contains information about a meeting, including the URL used to join a meeting,
This resource supports subscribing to [change notifications](/graph/webhooks). For more information, see [subscribe to online meetings](/graph/changenotifications-for-onlinemeeting).
-Inherits from [onlineMeetingBase](../resources/onlineMeetingBase.md).
+Inherits from [onlineMeetingBase](../resources/onlinemeetingbase.md).
## Methods
Inherits from [onlineMeetingBase](../resources/onlineMeetingBase.md).
| Property | Type | Description | | :-- | :-- | : |
-| allowAttendeeToEnableCamera | Boolean | Indicates whether attendees can turn on their camera. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| allowAttendeeToEnableMic | Boolean | Indicates whether attendees can turn on their microphone. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| allowMeetingChat | [meetingChatMode](#meetingchatmode-values) | Specifies the mode of meeting chat. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
+| allowAttendeeToEnableCamera | Boolean | Indicates whether attendees can turn on their camera. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| allowAttendeeToEnableMic | Boolean | Indicates whether attendees can turn on their microphone. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| allowBreakoutRooms | Boolean | Indicates whether breakout rooms are enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| allowedPresenters | [onlineMeetingPresenters](#onlinemeetingpresenters-values)| Specifies who can be a presenter in a meeting. Possible values are: `everyone`, `organization`, `roleIsPresenter`, `organizer`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| allowLiveShare | [meetingLiveShareOptions](#meetingliveshareoptions-values) | Indicates whether live share is enabled for the meeting. Possible values are: `enabled`, `disabled`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| allowMeetingChat | [meetingChatMode](#meetingchatmode-values) | Specifies the mode of meeting chat. Possible values are: `enabled`, `disabled`, `limited`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
| allowParticipantsToChangeName | Boolean | Specifies if participants are allowed to rename themselves in an instance of the meeting. |
+| allowPowerPointSharing | Boolean | Indicates whether PowerPoint live is enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| allowRecording | Boolean | Indicates whether recording is enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| allowTeamworkReactions | Boolean | Indicates whether Teams reactions are enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| allowTranscription | Boolean | Indicates whether transcription is enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| allowWhiteboard | Boolean | Indicates whether whiteboard is enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| anonymizeIdentityForRoles | onlineMeetingRole collection | Specifies whose identity is anonymized in the meeting. Possible values are: `attendee`. The `attendee` value can't be removed through a PATCH operation once added. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| audioConferencing | [audioConferencing](audioconferencing.md) | The phone access (dial-in) information for an online meeting. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md).|
+| chatInfo | [chatInfo](chatinfo.md) | The chat information associated with this online meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
| chatRestrictions | [chatrestrictions](../resources/chatrestrictions.md) | Specifies the configuration for meeting chat restrictions. |
-| allowTeamworkReactions | Boolean | Indicates whether Teams reactions are enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| allowTranscription | Boolean | Indicates whether transcription is enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| allowRecording | Boolean | Indicates whether recording is enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| allowedPresenters | [onlineMeetingPresenters](#onlinemeetingpresenters-values)| Specifies who can be a presenter in a meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| anonymizeIdentityForRoles | onlineMeetingRole collection | Specifies whose identity is anonymized in the meeting. Possible values are: `attendee`. The `attendee` value can't be removed through a PATCH operation once added. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| audioConferencing | [audioConferencing](audioconferencing.md) | The phone access (dial-in) information for an online meeting. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md).|
-| chatInfo | [chatInfo](chatinfo.md) | The chat information associated with this online meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
| creationDateTime | DateTime | The meeting creation time in UTC. Read-only. | | endDateTime | DateTime | The meeting end time in UTC. Required when you create an online meeting. | | externalId | String | The external ID. A custom ID. Optional. |
-| id | String | The default ID associated with the online meeting. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| isEntryExitAnnounced | Boolean | Indicates whether to announce when callers join or leave. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| joinInformation | [itemBody](itembody.md) | The join information in the language and locale variant specified in 'Accept-Language' request HTTP header. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| joinMeetingIdSettings | [joinMeetingIdSettings](joinmeetingidsettings.md) | Specifies the **joinMeetingId**, the meeting passcode, and the requirement for the passcode. Once an **onlineMeeting** is created, the **joinMeetingIdSettings** can't be modified. To make any changes to this property, the meeting needs to be canceled and a new one needs to be created. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
+| id | String | The default ID associated with the online meeting. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| isEntryExitAnnounced | Boolean | Indicates whether to announce when callers join or leave. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| joinInformation | [itemBody](itembody.md) | The join information in the language and locale variant specified in 'Accept-Language' request HTTP header. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| joinMeetingIdSettings | [joinMeetingIdSettings](joinmeetingidsettings.md) | Specifies the **joinMeetingId**, the meeting passcode, and the requirement for the passcode. Once an **onlineMeeting** is created, the **joinMeetingIdSettings** can't be modified. To make any changes to this property, the meeting needs to be canceled and a new one needs to be created. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
| joinWebUrl | String | The join URL of the online meeting. The format of the URL may change; therefore, users shouldn't rely on any information extracted from parsing the URL. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
-| lobbyBypassSettings | [lobbyBypassSettings](lobbybypasssettings.md) | Specifies which participants can bypass the meeting lobby. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
+| lobbyBypassSettings | [lobbyBypassSettings](lobbybypasssettings.md) | Specifies which participants can bypass the meeting lobby. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
| meetingTemplateId | String | The ID of the [meeting template](/microsoftteams/create-custom-meeting-template). | | participants | [meetingParticipants](meetingparticipants.md) | The participants associated with the online meeting, including the organizer and the attendees. |
-| recordAutomatically | Boolean | Indicates whether to record the meeting automatically. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
+| recordAutomatically | Boolean | Indicates whether to record the meeting automatically. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
| startDateTime | DateTime | The meeting start time in UTC. Required when you create an online meeting. |
-| shareMeetingChatHistoryDefault | [meetingChatHistoryDefaultMode](#meetingchathistorydefaultmode-values) | Specifies whether meeting chat history is shared with participants. Possible values are: `all`, `none`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| subject | String | The subject of the online meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| videoTeleconferenceId | String | The video teleconferencing ID. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| watermarkProtection | [watermarkProtectionValues](watermarkprotectionvalues.md) | Specifies whether the client application should apply a watermark to a content type. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
+| shareMeetingChatHistoryDefault | [meetingChatHistoryDefaultMode](#meetingchathistorydefaultmode-values) | Specifies whether meeting chat history is shared with participants. Possible values are: `all`, `none`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| subject | String | The subject of the online meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| videoTeleconferenceId | String | The video teleconferencing ID. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| watermarkProtection | [watermarkProtectionValues](watermarkprotectionvalues.md) | Specifies whether the client application should apply a watermark to a content type. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
| alternativeRecording (deprecated) | Stream | The content stream of the alternative recording of a [Microsoft Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). Read-only. | | attendeeReport (deprecated) | Stream | The content stream of the attendee report of a [Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). Read-only. | | autoAdmittedUsers (deprecated) | String | The setting that specifies the type of participants that are automatically allowed into the online meeting. Possible values are: `everyone`, `everyoneInSameAndFederatedCompany`, `everyoneInCompany`, `invitedUsersInCompany`, `organizer`. Read-only. |
Inherits from [onlineMeetingBase](../resources/onlineMeetingBase.md).
>- The **autoAdmittedUsers** property is deprecated. Use the **scope** property of [lobbyBypassSettings](lobbybypasssettings.md) instead. >- The **capabilities** property is deprecated. Use the **isQuestionAndAnswerEnabled** property of [broadcastMeetingSettings](broadcastMeetingSettings.md) instead.
-### onlineMeetingPresenters values
-
-| Value | Description |
-| | - |
-| everyone | Everyone is a presenter. Default. |
-| organization | Everyone in organizerΓÇÖs organization is a presenter. |
-| roleIsPresenter | Only the participants whose role is presenter are presenters. |
-| organizer | Only the organizer is a presenter. |
-| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
+### meetingChatHistoryDefaultMode values
-> [!TIP]
->
-> When creating or updating an online meeting with **allowedPresenters** set to `roleIsPresenter`, include a full list of **attendees** with the specified attendees' **role** set to `presenter` in the request body.
+| Value | Description |
+| | - |
+| all | All meeting chat history is shared. |
+| none | No meeting chat history is shared. |
+| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
### meetingChatMode values
Inherits from [onlineMeetingBase](../resources/onlineMeetingBase.md).
| | - | | enabled | Meeting chat is enabled. | | disabled | Meeting chat is disabled. |
-| limited | Meeting chat is enabled but only during the meeting call. |
-| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
+| limited | Meeting chat is enabled but only during the meeting call. |
+| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
-### meetingChatHistoryDefaultMode values
+### meetingLiveShareOptions values
| Value | Description | | | - |
-| all | All meeting chat history is shared. |
-| none | No meeting chat history is shared. |
-| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
+| enabled | Meeting live share is enabled. |
+| disabled | Meeting live share is disabled. |
+| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
+
+### onlineMeetingPresenters values
+
+| Value | Description |
+| | - |
+| everyone | Everyone is a presenter. Default. |
+| organization | Everyone in organizerΓÇÖs organization is a presenter. |
+| roleIsPresenter | Only the participants whose role is presenter are presenters. |
+| organizer | Only the organizer is a presenter. |
+| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
+
+> [!TIP]
+>
+> When creating or updating an online meeting with **allowedPresenters** set to `roleIsPresenter`, include a full list of **attendees** with the specified attendees' **role** set to `presenter` in the request body.
## Relationships | Relationship | Type | Description | | | - | -- |
-| attendanceReports | [meetingAttendanceReport](meetingattendancereport.md) collection | The attendance reports of an online meeting. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
+| attendanceReports | [meetingAttendanceReport](meetingattendancereport.md) collection | The attendance reports of an online meeting. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
| recordings | [callRecording](callrecording.md) collection | The recordings of an online meeting. Read-only. | | transcripts | [callTranscript](calltranscript.md) collection | The transcripts of an online meeting. Read-only. | | meetingAttendanceReport (deprecated) | [meetingAttendanceReport](meetingattendancereport.md) | The attendance report of the latest online meeting session. Read-only. |
The following JSON representation shows the resource type.
{ "allowAttendeeToEnableCamera": "Boolean", "allowAttendeeToEnableMic": "Boolean",
- "allowMeetingChat": {"@odata.type": "microsoft.graph.meetingChatMode"},
- "allowTeamworkReactions": "Boolean",
+ "allowBreakoutRooms": "Boolean",
"allowedPresenters": "String",
+ "allowLiveShare": "String",
+ "allowMeetingChat": "String",
+ "allowParticipantsToChangeName": "Boolean",
+ "allowPowerPointSharing": "Boolean",
+ "allowRecording": "Boolean",
+ "allowTeamworkReactions": "Boolean",
+ "allowTranscription": "Boolean",
+ "allowWhiteboard": "Boolean",
"anonymizeIdentityForRoles": ["String"], "audioConferencing": {"@odata.type": "microsoft.graph.audioConferencing"}, "chatInfo": {"@odata.type": "microsoft.graph.chatInfo"},
The following JSON representation shows the resource type.
"meetingTemplateId": "String", "participants": {"@odata.type": "microsoft.graph.meetingParticipants"}, "recordAutomatically": "Boolean",
- "shareMeetingChatHistoryDefault": "microsoft.graph.meetingChatHistoryDefaultMode",
+ "shareMeetingChatHistoryDefault": "String",
"startDateTime": "String (timestamp)", "subject": "String", "videoTeleconferenceId": "String",
v1.0 Onlinemeetingbase https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/onlinemeetingbase.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Represents a base online meeting. The base type of [onlineMeeting](onlinemeeting.md) and [virtualEventSession](virtualEventSession.md).
+Represents a base online meeting. The base type of [onlineMeeting](onlinemeeting.md) and [virtualEventSession](virtualeventsession.md).
Inherits from [entity](../resources/entity.md). > [!TIP]
-> This is an abstract type and can't be used directly. Use the derived types [onlineMeeting](onlinemeeting.md) and [virtualEventSession](virtualEventSession.md) instead.
+> This is an abstract type and can't be used directly. Use the derived types [onlineMeeting](onlinemeeting.md) and [virtualEventSession](virtualeventsession.md) instead.
## Properties
Inherits from [entity](../resources/entity.md).
| :-- | :-- | : | | allowAttendeeToEnableCamera | Boolean | Indicates whether attendees can turn on their camera. | | allowAttendeeToEnableMic | Boolean | Indicates whether attendees can turn on their microphone. |
-| allowMeetingChat | [meetingChatMode](#meetingchatmode-values) | Specifies the mode of meeting chat. |
+| allowBreakoutRooms | Boolean | Indicates whether breakout rooms are enabled for the meeting. |
+| allowedPresenters | [onlineMeetingPresenters](#onlinemeetingpresenters-values)| Specifies who can be a presenter in a meeting. Possible values are: `everyone`, `organization`, `roleIsPresenter`, `organizer`, `unknownFutureValue`. |
+| allowLiveShare | [meetingLiveShareOptions](#meetingliveshareoptions-values) | Indicates whether live share is enabled for the meeting. Possible values are: `enabled`, `disabled`, `unknownFutureValue`. |
+| allowMeetingChat | [meetingChatMode](#meetingchatmode-values) | Specifies the mode of meeting chat. Possible values are: `enabled`, `disabled`, `limited`, `unknownFutureValue`. |
| allowParticipantsToChangeName | Boolean | Specifies if participants are allowed to rename themselves in an instance of the meeting. |
+| allowPowerPointSharing | Boolean | Indicates whether PowerPoint live is enabled for the meeting. |
+| allowRecording | Boolean | Indicates whether recording is enabled for the meeting. |
| allowTeamworkReactions | Boolean | Indicates if Teams reactions are enabled for the meeting. | | allowTranscription | Boolean | Indicates whether transcription is enabled for the meeting. |
-| allowRecording | Boolean | Indicates whether recording is enabled for the meeting. |
-| allowedPresenters | [onlineMeetingPresenters](#onlinemeetingpresenters-values)| Specifies who can be a presenter in a meeting. |
+| allowWhiteboard | Boolean | Indicates whether whiteboard is enabled for the meeting. |
| anonymizeIdentityForRoles | onlineMeetingRole collection | Specifies whose identity is anonymized in the meeting. Possible values are: `attendee`. The `attendee` value can't be removed through a PATCH operation once added.| | audioConferencing | [audioConferencing](audioconferencing.md) | The phone access (dial-in) information for an online meeting. Read-only. | | chatInfo | [chatInfo](chatinfo.md) | The chat information associated with this online meeting. |
Inherits from [entity](../resources/entity.md).
| joinInformation | [itemBody](itembody.md) | The join information in the language and locale variant specified in 'Accept-Language' request HTTP header. Read-only. | | joinMeetingIdSettings | [joinMeetingIdSettings](joinmeetingidsettings.md) | Specifies the **joinMeetingId**, the meeting passcode, and the requirement for the passcode. Once an **onlineMeeting** is created, the **joinMeetingIdSettings** can't be modified. To make any changes to this property, the meeting needs to be canceled and a new one needs to be created. | | joinWebUrl | String | The join URL of the online meeting. Read-only. |
-| lobbyBypassSettings | [lobbyBypassSettings](lobbyBypassSettings.md) | Specifies which participants can bypass the meeting lobby. |
+| lobbyBypassSettings | [lobbyBypassSettings](lobbybypasssettings.md) | Specifies which participants can bypass the meeting lobby. |
| recordAutomatically | Boolean | Indicates whether to record the meeting automatically. |
-| shareMeetingChatHistoryDefault | meetingChatHistoryDefaultMode |Specifies whether meeting chat history is shared with participants. Possible values are: `all`, `none`, `unknownFutureValue`.|
+| shareMeetingChatHistoryDefault | [meetingChatHistoryDefaultMode](#meetingchathistorydefaultmode-values) |Specifies whether meeting chat history is shared with participants. Possible values are: `all`, `none`, `unknownFutureValue`.|
| subject | String | The subject of the online meeting. | | videoTeleconferenceId | String | The video teleconferencing ID. Read-only. | | watermarkProtection | [watermarkProtectionValues](watermarkprotectionvalues.md) | Specifies whether the client application should apply a watermark to a content type. |
-### onlineMeetingPresenters values
+### meetingChatHistoryDefaultMode values
-| Value | Description |
-| | - |
-| everyone | Everyone is a presenter. Default. |
-| organization | Everyone in organizerΓÇÖs organization is a presenter. |
-| roleIsPresenter | Only the participants whose role is presenter are presenters. |
-| organizer | Only the organizer is a presenter. |
-| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
+| Value | Description |
+| | - |
+| all | All meeting chat history is shared. |
+| none | No meeting chat history is shared. |
+| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
### meetingChatMode values
Inherits from [entity](../resources/entity.md).
| limited | Meeting chat is enabled but only during the meeting call. | | unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
-### meetingChatHistoryDefaultMode values
+### meetingLiveShareOptions values
| Value | Description | | | - |
-| all | All meeting chat history is shared. |
-| none | No meeting chat history is shared. |
+| enabled | Meeting live share is enabled. |
+| disabled | Meeting live share is disabled. |
| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
+### onlineMeetingPresenters values
+
+| Value | Description |
+| | - |
+| everyone | Everyone is a presenter. Default. |
+| organization | Everyone in organizerΓÇÖs organization is a presenter. |
+| roleIsPresenter | Only the participants whose role is presenter are presenters. |
+| organizer | Only the organizer is a presenter. |
+| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
+ ## Relationships | Relationship | Type | Description |
The following JSON representation shows the resource type.
{ "allowAttendeeToEnableCamera": "Boolean", "allowAttendeeToEnableMic": "Boolean",
- "allowMeetingChat": {"@odata.type": "microsoft.graph.meetingChatMode"},
- "allowTeamworkReactions": "Boolean",
+ "allowBreakoutRooms": "Boolean",
"allowedPresenters": "String",
+ "allowLiveShare": "String",
+ "allowMeetingChat": "String",
+ "allowParticipantsToChangeName": "Boolean",
+ "allowPowerPointSharing": "Boolean",
+ "allowRecording": "Boolean",
+ "allowTeamworkReactions": "Boolean",
+ "allowTranscription": "Boolean",
+ "allowWhiteboard": "Boolean",
"anonymizeIdentityForRoles": ["String"], "audioConferencing": {"@odata.type": "microsoft.graph.audioConferencing"}, "chatInfo": {"@odata.type": "microsoft.graph.chatInfo"},
- "id": "String (identifier)",
+ "id": "String (identifier)",
"isEntryExitAnnounced": "Boolean", "joinInformation": {"@odata.type": "microsoft.graph.itemBody"}, "joinMeetingIdSettings": {"@odata.type": "microsoft.graph.joinMeetingIdSettings"}, "joinWebUrl": "String", "lobbyBypassSettings": {"@odata.type": "microsoft.graph.lobbyBypassSettings"}, "recordAutomatically": "Boolean",
- "shareMeetingChatHistoryDefault": "microsoft.graph.meetingChatHistoryDefaultMode",
+ "shareMeetingChatHistoryDefault": "String",
"subject": "String", "videoTeleconferenceId": "String", "watermarkProtection": {"@odata.type": "microsoft.graph.watermarkProtectionValues"}
v1.0 Openidconnectsetting https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/openidconnectsetting.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-A complex type that contains the settings required to perform the OIDC request to the external authentication provider for an external authentication method. External authentication methods enable Microsoft Entra ID users to satisfy the second factor of multifactor authentication requirements using an external provider.
+A complex type that contains the settings required to perform the OIDC request to the external authentication provider for an [external authentication method](../resources/externalauthenticationmethodconfiguration.md). External authentication methods enable Microsoft Entra ID users to satisfy the second factor of multifactor authentication requirements using an external provider.
## Properties |Property|Type|Description|
v1.0 Outgoingcalloptions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/outgoingcalloptions.md
Inherits from [callOptions](calloptions.md).
|:|:--|:| | hideBotAfterEscalation | Boolean | Indicates whether to hide the app after the call is escalated. Inherited from [callOptions](calloptions.md). | | isContentSharingNotificationEnabled | Boolean | Indicates whether content sharing notifications should be enabled for the call. Inherited from [callOptions](calloptions.md). |
+| isDeltaRosterEnabled | Boolean | Indicates whether delta roster is enabled for the call. Inherited from [callOptions](calloptions.md). |
## JSON representation
The following JSON representation shows the resource type.
{ "@odata.type": "#microsoft.graph.outgoingCallOptions", "hideBotAfterEscalation": "Boolean",
- "isContentSharingNotificationEnabled": "Boolean"
+ "isContentSharingNotificationEnabled": "Boolean",
+ "isDeltaRosterEnabled": "Boolean"
} ```
v1.0 Outlookcategory https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/outlookcategory.md
ms.localizationpriority: medium
doc_type: resourcePageType
+toc. Title: Outlook category (deprecated)
# outlookCategory resource type
You can also [get this master list of categories](../api/outlookuser-list-master
You can apply a category to an item by assigning the **displayName** property of the category to the **categories** collection of the item. Resources that can be assigned categories include [contact](contact.md), [event](event.md), [message](message.md), [outlookTask](outlooktask.md), [post](post.md), and [todoTask](todotask.md).
-Each category is attributed by 2 properties: **displayName** and **color**. The **displayName** value must be unique in a user's master list.
-The **color** however does not have to be unique; multiple categories in the master list can be mapped to the same color. You can map up to 25 different colors to categories in a user's master list.
+Each category is attributed by two properties: **displayName** and **color**. The **displayName** value must be unique in a user's master list.
+The **color** however doesn't have to be unique; multiple categories in the master list can be mapped to the same color. You can map up to 25 different colors to categories in a user's master list.
## Methods | Method | Return Type |Description| |:|:--|:-|
-|[List categories](../api/outlookuser-list-mastercategories.md) | [outlookCategory](../resources/outlookcategory.md) collection |Get all the categories that have been defined for the user.|
-|[Get category](../api/outlookcategory-get.md) | [outlookCategory](../resources/outlookcategory.md) |Get the properties and relationships of the specified **outlookCategory** object.|
-|[Create category](../api/outlookuser-post-mastercategories.md) | [outlookCategory](../resources/outlookcategory.md) |Create an **outlookCategory** object in the user's master list of categories.|
-|[Update category](../api/outlookcategory-update.md) | [outlookCategory](../resources/outlookcategory.md) |Update the writable property, **color**, of the specified **outlookCategory** object. |
-|[Delete category](../api/outlookcategory-delete.md) | None |Delete the specified **outlookCategory** object. |
+|[List](../api/outlookuser-list-mastercategories.md) | [outlookCategory](../resources/outlookcategory.md) collection |Get all the categories that have been defined for the user.|
+|[Get](../api/outlookcategory-get.md) | [outlookCategory](../resources/outlookcategory.md) |Get the properties and relationships of the specified **outlookCategory** object.|
+|[Create](../api/outlookuser-post-mastercategories.md) | [outlookCategory](../resources/outlookcategory.md) |Create an **outlookCategory** object in the user's master list of categories.|
+|[Update](../api/outlookcategory-update.md) | [outlookCategory](../resources/outlookcategory.md) |Update the writable property, **color**, of the specified **outlookCategory** object. |
+|[Delete](../api/outlookcategory-delete.md) | None |Delete the specified **outlookCategory** object. |
## Properties | Property | Type |Description| |:|:--|:-|
-|color|String|A pre-set color constant that characterizes a category, and that is mapped to one of 25 predefined colors. For more details, see the following note. |
-|displayName|String|A unique name that identifies a category in the user's mailbox. After a category is created, the name cannot be changed. Read-only.|
+|color|String|A preset color constant that characterizes a category, and that is mapped to one of 25 predefined colors. For more information, see the following note. |
+|displayName|String|A unique name that identifies a category in the user's mailbox. After a category is created, the name can't be changed. Read-only.|
-> **Note** The possible values for **color** are pre-set constants such as `None`, `preset0` and `preset1`. Each pre-set constant is further mapped to a color; the actual
-color is dependent on the Outlook client that the categories are being displayed in. The following table shows the colors mapped to each pre-set constant for Outlook (desktop client).
+> **Note** The possible values for **color** are preset constants such as `None`, `preset0` and `preset1`. Each preset constant is further mapped to a color; the actual
+color is dependent on the Outlook client that the categories are being displayed in. The following table shows the colors mapped to each preset constant for Outlook (desktop client).
-| Pre-set constant | Color mapped to in Outlook |
+| Preset constant | Color mapped to in Outlook |
|:|:--| | None | No color mapped | | Preset0 | Red |
v1.0 Outlooktask https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/outlooktask.md
ms.localizationpriority: high doc_type: resourcePageType
+toc. Title: Outlook task (deprecated)
# outlookTask resource type (deprecated)
Namespace: microsoft.graph
An Outlook item that can track a work item.
-You can use a task to track the start, due and actual completion dates and times, its progress or status, whether it's recurring, and requires reminding.
+You can use a task to track:
+- The start, due, and actual completion dates and times.
+- The progress or status of the task.
+- The recurrence and reminder statuses of the task.
Date-related properties in the **outlookTask** resource include the following:
Prefer: outlook.timezone="Eastern Standard Time"
|[Get](../api/outlooktask-get.md) | [outlookTask](outlooktask.md) |Get the properties and relationships of an Outlook task in the user's mailbox.| |[Update](../api/outlooktask-update.md) | [outlookTask](outlooktask.md) |Change writeable properties of an Outlook task. | |[Delete](../api/outlooktask-delete.md) | None |Delete the specified task in the user's mailbox. |
-|[Complete](../api/outlooktask-complete.md)|[outlookTask](outlooktask.md) collection|Complete an Outlook task which sets the **completedDateTime** property to the current date, and **status** property to `completed`.|
+|[Permanently delete](../api/outlooktask-permanentdelete.md)|None|Permanently delete an Outlook task and place it in the Purges folder in the Recoverable Items folder in the user's mailbox.|
+|[Complete](../api/outlooktask-complete.md)|[outlookTask](outlooktask.md) collection|Complete an Outlook task that sets the **completedDateTime** property to the current date, and **status** property to `completed`.|
|**Attachments**| | | |[List attachments](../api/outlooktask-list-attachments.md) |[attachment](attachment.md) collection| Get all attachments on an Outlook task.| |[Add attachment](../api/outlooktask-post-attachments.md) |[attachment](attachment.md)| Add a file, item (message, event or contact), or link to a file as an attachment to a task.|
Prefer: outlook.timezone="Eastern Standard Time"
| Property | Type |Description| |:|:--|:-| |assignedTo|String|The name of the person who has been assigned the task in Outlook. Read-only.|
-|body|[itemBody](itembody.md)|The task body that typically contains information about the task. Note that only HTML type is supported.|
+|body|[itemBody](itembody.md)|The task body that typically contains information about the task. Only the HTML type is supported.|
|categories|String collection|The categories associated with the task. Each category corresponds to the **displayName** property of an [outlookCategory](outlookcategory.md) that the user has defined.| |changeKey|String|The version of the task.| |completedDateTime|[dateTimeTimeZone](datetimetimezone.md)|The date in the specified time zone that the task was finished.|
Prefer: outlook.timezone="Eastern Standard Time"
## Relationships | Relationship | Type |Description| |:|:--|:-|
-|attachments|[attachment](attachment.md) collection|The collection of [fileAttachment](fileattachment.md), [itemAttachment](itemattachment.md), and [referenceAttachment](referenceattachment.md) attachments for the task. Read-only. Nullable.|
+|attachments|[attachment](attachment.md) collection|The collection of [fileAttachment](fileattachment.md), [itemAttachment](itemattachment.md), and [referenceAttachment](referenceattachment.md) attachments for the task. Read-only. Nullable.|
|multiValueExtendedProperties|[multiValueLegacyExtendedProperty](multivaluelegacyextendedproperty.md) collection|The collection of multi-value extended properties defined for the task. Read-only. Nullable.| |singleValueExtendedProperties|[singleValueLegacyExtendedProperty](singlevaluelegacyextendedproperty.md) collection|The collection of single-value extended properties defined for the task. Read-only. Nullable.|
v1.0 Outlooktaskfolder https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/outlooktaskfolder.md
ms.localizationpriority: medium doc_type: resourcePageType
+toc. Title: Outlook task folder (deprecated)
# outlookTaskFolder resource type (deprecated)
Namespace: microsoft.graph
A folder that contains Outlook tasks (collection of [outlookTask](outlooktask.md) objects). In Outlook, the default task group, `My Tasks`, contains a default task folder, `Tasks`, for the user's mailbox.
-You cannot rename or delete these default task group and folder, but you can create additional task groups and task folders.
+You can't rename or delete these default task groups or folders, but you can create new task groups and folders.
## Methods
You cannot rename or delete these default task group and folder, but you can cre
|[List task folders in group](../api/outlooktaskfolder-list-tasks.md) |[outlookTask](outlooktask.md) collection| Get all the Outlook tasks in the specified folder.| |[Update](../api/outlooktaskfolder-update.md) | [outlookTaskFolder](outlooktaskfolder.md) |Update the writable properties of an Outlook task folder. | |[Delete](../api/outlooktaskfolder-delete.md) | None |Delete the specified Outlook task folder.|
+|[Permanently delete](../api/outlooktask-permanentdelete.md)|None|Permanently delete an Outlook task and place it in the Purges folder in the Recoverable Items folder in the user's mailbox.|](../api/outlooktaskfolder-permanentdelete.md)|None|Permanently delete an Outlook task folder and remove its items from the user's mailbox.|
|**Extended properties**| | | |[Create single-value property](../api/singlevaluelegacyextendedproperty-post-singlevalueextendedproperties.md) |[outlookTaskFolder](outlooktaskfolder.md) |Create one or more single-value extended properties in a new or existing Outlook task folder. | |[Get single-value property](../api/singlevaluelegacyextendedproperty-get.md) | [outlookTaskFolder](outlooktaskfolder.md) | Get Outlook task folders that contain a single-value extended property by using `$expand` or `$filter`. |
v1.0 Outlooktaskgroup https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/outlooktaskgroup.md
ms.localizationpriority: medium doc_type: resourcePageType
+toc. Title: Outlook task group (deprecated)
# outlookTaskGroup resource type (deprecated)
v1.0 Partner Security Adminsmfaenforcedsecurityrequirement https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/partner-security-adminsmfaenforcedsecurityrequirement.md
+
+ Title: "adminsMfaEnforcedSecurityRequirement resource type"
+description: "Represents the partner admin MFA enforcement security requirement from the partner security score."
+
+ms.localizationpriority: medium
+++
+# adminsMfaEnforcedSecurityRequirement resource type
+
+Namespace: microsoft.graph.partner.security
++
+Represents the partner admin MFA enforcement security requirement. The requirement is calculated based on Entra tenant MFA usage data. Use this resource to determine whether admins are adequately protected with MFA.
+
+Inherits from [microsoft.graph.partner.security.securityRequirement](../resources/partner-security-securityrequirement.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|actionUrl|String|The link to site where the admin can take action on the requirement. Inherited from [microsoft.graph.partner.security.securityRequirement](../resources/partner-security-securityrequirement.md).|
+|adminsRequiredNotUsingMfaCount|Int64|The number of admins who are required to use MFA, but haven't completed registration.|
+|complianceStatus|microsoft.graph.partner.security.complianceStatus|Indicates whether the partner is compliant with this requirement. Inherited from [microsoft.graph.partner.security.securityRequirement](../resources/partner-security-securityrequirement.md). The possible values are: `compliant`, `noncomplaint`, `unknownFutureValue`.|
+|helpUrl|String|The link to documentation for the requirement. Inherited from [microsoft.graph.partner.security.securityRequirement](../resources/partner-security-securityrequirement.md).|
+|id|String|The unique identifier for the requirement. Inherited from [microsoft.graph.partner.security.securityRequirement](../resources/partner-security-securityrequirement.md).|
+|legacyPerUserMfaStatus|microsoft.graph.partner.security.policyStatus|The status of per-user MFA in the partner tenant. The possible values are: `enabled`, `disabled`, `unknownFutureValue`.|
+|maxScore|Int64|The maximum score possible for the requirement. Inherited from [microsoft.graph.partner.security.securityRequirement](../resources/partner-security-securityrequirement.md).|
+|mfaConditionalAccessPolicyStatus|microsoft.graph.partner.security.policyStatus|The status of conditional access policies in the partner tenant. The possible values are: `enabled`, `disabled`, `unknownFutureValue`.|
+|mfaEnabledAdminsCount|Int64|The number of admins who are using MFA.|
+|mfaEnabledUsersCount|Int64|The number of users who are using MFA.|
+|requirementType|microsoft.graph.partner.security.securityRequirementType|The type of the requirement. The value is always `mfaEnforcedForAdminsOfCustomers` for this requirement. Inherited from [microsoft.graph.partner.security.securityRequirement](../resources/partner-security-securityrequirement.md). The possible values are: `mfaEnforcedForAdmins`, `mfaEnforcedForAdminsOfCustomers`, `securityAlertsPromptlyResolved`, `securityContactProvided`, `spendingBudgetSetForCustomerAzureSubscriptions`, `unknownFutureValue`.|
+|score|Int64|The score received for this requirement. Inherited from [microsoft.graph.partner.security.securityRequirement](../resources/partner-security-securityrequirement.md).|
+|securityDefaultsStatus|microsoft.graph.partner.security.policyStatus|The status of security defaults in the partner tenant. The possible values are: `enabled`, `disabled`, `unknownFutureValue`.|
+|state|microsoft.graph.partner.security.securityRequirementState|Indicates whether the requirement is in preview or is fully released. Inherited from [microsoft.graph.partner.security.securityRequirement](../resources/partner-security-securityrequirement.md). The possible values are: `active`, `preview`, `unknownFutureValue`.|
+|totalAdminsCount|Int64|The total number of admins in the partner's tenant.|
+|totalUsersCount|Int64|The total number of users in the partner's tenant.|
+|updatedDateTime|DateTimeOffset|The date the requirement properties were last updated. Inherited from [microsoft.graph.partner.security.securityRequirement](../resources/partner-security-securityrequirement.md).|
+|usersRequiredNotUsingMfaCount|Int64|The number of users who are required to use MFA, but haven't completed registration.|
+
+## Relationships
+None.
+
+## JSON representation
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.partner.security.adminsMfaEnforcedSecurityRequirement",
+ "baseType": "microsoft.graph.partner.security.securityRequirement",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.partner.security.adminsMfaEnforcedSecurityRequirement",
+ "id": "String (identifier)",
+ "requirementType": "String",
+ "complianceStatus": "String",
+ "actionUrl": "String",
+ "helpUrl": "String",
+ "score": "Integer",
+ "maxScore": "Integer",
+ "state": "String",
+ "updatedDateTime": "String (timestamp)",
+ "totalAdminsCount": "Integer",
+ "adminsRequiredNotUsingMfaCount": "Integer",
+ "mfaEnabledAdminsCount": "Integer",
+ "totalUsersCount": "Integer",
+ "usersRequiredNotUsingMfaCount": "Integer",
+ "mfaEnabledUsersCount": "Integer",
+ "securityDefaultsStatus": "String",
+ "mfaConditionalAccessPolicyStatus": "String",
+ "legacyPerUserMfaStatus": "String"
+}
+```
+
v1.0 Partner Security Customerinsight https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/partner-security-customerinsight.md
+
+ Title: "customerInsight resource type"
+description: "Represents insights into the security score for a partner's customer."
+
+ms.localizationpriority: medium
+++
+# customerInsight resource type
+
+Namespace: microsoft.graph.partner.security
++
+Represents insights into the security score for a partner's customer.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List](../api/partner-security-partnersecurityscore-list-customerinsights.md)|[microsoft.graph.partner.security.customerInsight](../resources/partner-security-customerinsight.md) collection|Get a list of the [customerInsight](../resources/partner-security-customerinsight.md) objects and their properties.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|mfa|[microsoft.graph.partner.security.customerMfaInsight](../resources/partner-security-customermfainsight.md)|Details of the customer's Entra tenant MFA policy configuration and usage.|
+|tenantId|String|The unique identifier for the customer.|
+
+## Relationships
+None.
+
+## JSON representation
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "tenantId",
+ "@odata.type": "microsoft.graph.partner.security.customerInsight",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.partner.security.customerInsight",
+ "tenantId": "String (identifier)",
+ "mfa": {
+ "@odata.type": "microsoft.graph.partner.security.customerMfaInsight"
+ }
+}
+```
+
v1.0 Partner Security Customermfainsight https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/partner-security-customermfainsight.md
+
+ Title: "customerMfaInsight resource type"
+description: "Represents a single partner customer's MFA policy configuration and usage"
+
+ms.localizationpriority: medium
+++
+# customerMfaInsight resource type
+
+Namespace: microsoft.graph.partner.security
++
+Contains aggregate data from the customer's Entra tenant MFA policy configuration and usage.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|compliantAdminsCount|Int64|The number of admins that are compliant with the MFA requirements|
+|compliantNonAdminsCount|Int64|The number of users that are compliant with the MFA requirements|
+|legacyPerUserMfaStatus|microsoft.graph.partner.security.policyStatus|The status of per-user MFA configuration to require MFA in the tenant. The possible values are: `enabled`, `disabled`, `unknownFutureValue`.|
+|mfaConditionalAccessPolicyStatus|microsoft.graph.partner.security.policyStatus|The status of conditional access policies to require MFA in the tenant. The possible values are: `enabled`, `disabled`, `unknownFutureValue`.|
+|securityDefaultsStatus|microsoft.graph.partner.security.policyStatus|The status of security defaults in the tenant. The possible values are: `enabled`, `disabled`, `unknownFutureValue`.|
+|totalUsersCount|Int64|The total number of users in the tenant|
+
+## Relationships
+None.
+
+## JSON representation
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.partner.security.customerMfaInsight"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.partner.security.customerMfaInsight",
+ "compliantAdminsCount": "Integer",
+ "compliantNonAdminsCount": "Integer",
+ "totalUsersCount": "Integer",
+ "securityDefaultsStatus": "String",
+ "mfaConditionalAccessPolicyStatus": "String",
+ "legacyPerUserMfaStatus": "String"
+}
+```
+
v1.0 Partner Security Customersmfaenforcedsecurityrequirement https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/partner-security-customersmfaenforcedsecurityrequirement.md
+
+ Title: "customersMfaEnforcedSecurityRequirement resource type"
+description: "Represents the customer MFA-enforced security requirement in the partner security score."
+
+ms.localizationpriority: medium
+++
+# customersMfaEnforcedSecurityRequirement resource type
+
+Namespace: microsoft.graph.partner.security
++
+This resource represents the customer MFA-enforced security requirement in the partner security score based on aggregate data from the partner's customers and their mfa policy compliance.
+
+Inherits from [microsoft.graph.partner.security.securityRequirement](../resources/partner-security-securityrequirement.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|actionUrl|String|The link to the site where the admin can take action on the requirement. Inherited from [securityRequirement](../resources/partner-security-securityrequirement.md).|
+|complianceStatus|microsoft.graph.partner.security.complianceStatus|Indicates whether the partner is compliant with this requirement. Inherited from securityRequirement](../resources/partner-security-securityrequirement.md). The possible values are: `compliant`, `noncomplaint`, `unknownFutureValue`.|
+|compliantTenantCount|Int64|The number of customer tenants that are compliant.|
+|helpUrl|String|The link to documentation for the requirement. Inherited from [securityRequirement](../resources/partner-security-securityrequirement.md).|
+|id|String|The unique identifier for the requirement. Inherited from [securityRequirement](../resources/partner-security-securityrequirement.md).|
+|maxScore|Int64|The maximum score possible for the requirement. Inherited from [securityRequirement](../resources/partner-security-securityrequirement.md).|
+|requirementType|microsoft.graph.partner.security.securityRequirementType|The value of this property is always `mfaEnforcedForAdminsOfCustomers` for this resource. Inherited from [securityRequirement](../resources/partner-security-securityrequirement.md). The possible values are: `mfaEnforcedForAdmins`, `mfaEnforcedForAdminsOfCustomers`, `securityAlertsPromptlyResolved`, `securityContactProvided`, `spendingBudgetSetForCustomerAzureSubscriptions`, `unknownFutureValue`.|
+|score|Int64|The score received for this requirement. Inherited from [securityRequirement](../resources/partner-security-securityrequirement.md).|
+|state|microsoft.graph.partner.security.securityRequirementState|Indicates whether the requirement is in preview or is fully released. Inherited from [securityRequirement](../resources/partner-security-securityrequirement.md). The possible values are: `active`, `preview`, `unknownFutureValue`.|
+|totalTenantCount|Int64|The total number of customer tenants associated with this partner|
+|updatedDateTime|DateTimeOffset|The date the requirement properties were last updated. Inherited from [securityRequirement](../resources/partner-security-securityrequirement.md).|
+
+## Relationships
+None.
+
+## JSON representation
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.partner.security.customersMfaEnforcedSecurityRequirement",
+ "baseType": "microsoft.graph.partner.security.securityRequirement",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.partner.security.customersMfaEnforcedSecurityRequirement",
+ "id": "String (identifier)",
+ "requirementType": "String",
+ "complianceStatus": "String",
+ "actionUrl": "String",
+ "helpUrl": "String",
+ "score": "Integer",
+ "maxScore": "Integer",
+ "state": "String",
+ "updatedDateTime": "String (timestamp)",
+ "totalTenantCount": "Integer",
+ "compliantTenantCount": "Integer"
+}
+```
+
v1.0 Partner Security Customersspendingbudgetsecurityrequirement https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/partner-security-customersspendingbudgetsecurityrequirement.md
+
+ Title: "customersSpendingBudgetSecurityRequirement resource type"
+description: "Represents the security requirement to have a customer spending budget for all customers."
+
+ms.localizationpriority: medium
+++
+# customersSpendingBudgetSecurityRequirement resource type
+
+Namespace: microsoft.graph.partner.security
++
+Represents the security requirement to have a customer spending budget for all customers. All of a partner's customers are expected to have a spending budget set by the partner to track and control Azure spending.
+
+This requirement aggregates the partner's customers and tracks if they have an Azure spending budget.
+
+Inherits from [microsoft.graph.partner.security.securityRequirement](../resources/partner-security-securityrequirement.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|actionUrl|String|The link to the site where the admin can take action on the requirement. Inherited from [securityRequirement](../resources/partner-security-securityrequirement.md).|
+|complianceStatus|microsoft.graph.partner.security.complianceStatus|Indicates whether the partner is compliant with this requirement. Inherited from [microsoft.graph.partner.security.securityRequirement](../resources/partner-security-securityrequirement.md). The possible values are: `compliant`, `noncomplaint`, `unknownFutureValue`.|
+|customersWithSpendBudgetCount|Int64|The number of customers with a spending budget set.|
+|helpUrl|String|The link to documentation for the requirement. Inherited from [securityRequirement](../resources/partner-security-securityrequirement.md).|
+|id|String|The unique identifier for the requirement. Inherited from [securityRequirement](../resources/partner-security-securityrequirement.md).|
+|maxScore|Int64|The maximum score possible for the requirement. Inherited from [securityRequirement](../resources/partner-security-securityrequirement.md).|
+|requirementType|microsoft.graph.partner.security.securityRequirementType|The value of this property is always `spendingBudgetSetForCustomerAzureSubscriptions` for this resource. Inherited from [securityRequirement](../resources/partner-security-securityrequirement.md). The possible values are: `mfaEnforcedForAdmins`, `mfaEnforcedForAdminsOfCustomers`, `securityAlertsPromptlyResolved`, `securityContactProvided`, `spendingBudgetSetForCustomerAzureSubscriptions`, `unknownFutureValue`.|
+|score|Int64|The score received for this requirement. Inherited from [securityRequirement](../resources/partner-security-securityrequirement.md).|
+|state|microsoft.graph.partner.security.securityRequirementState|Indicates whether the requirement is in preview or is fully released. Inherited from [securityRequirement](../resources/partner-security-securityrequirement.md). The possible values are: `active`, `preview`, `unknownFutureValue`.|
+|totalCustomersCount|Int64|The total number of customers associated with the partner.|
+|updatedDateTime|DateTimeOffset|The date the requirement properties were last updated. Inherited from [securityRequirement](../resources/partner-security-securityrequirement.md).|
+
+## Relationships
+None.
+
+## JSON representation
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.partner.security.customersSpendingBudgetSecurityRequirement",
+ "baseType": "microsoft.graph.partner.security.securityRequirement",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.partner.security.customersSpendingBudgetSecurityRequirement",
+ "id": "String (identifier)",
+ "requirementType": "String",
+ "complianceStatus": "String",
+ "actionUrl": "String",
+ "helpUrl": "String",
+ "score": "Integer",
+ "maxScore": "Integer",
+ "state": "String",
+ "updatedDateTime": "String (timestamp)",
+ "totalCustomersCount": "Integer",
+ "customersWithSpendBudgetCount": "Integer"
+}
+```
+
v1.0 Partner Security Partnersecurity https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/partner-security-partnersecurity.md
Title: "partnerSecurity resource type"
-description: "Represents the root for various types of partner security entities."
+description: "Represents the root for partner security entities."
ms.localizationpriority: medium
Namespace: microsoft.graph.partner.security
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Represents the root for various types of partner security entities.
+Represents the root for partner security entities.
-Inherits from [entity](../resources/entity.md).
+
+Inherits from [microsoft.graph.entity](../resources/entity.md).
## Methods
None.
## Relationships |Relationship|Type|Description| |:|:|:|
-|securityAlerts|[microsoft.graph.partner.security.partnerSecurityAlert](../resources/partner-security-partnersecurityalert.md) collection|The security alerts or a vulnerability of a CSP partner's customer that the partner must be made aware of for further action.|
+|securityAlerts|[microsoft.graph.partner.security.partnerSecurityAlert](../resources/partner-security-partnersecurityalert.md) collection|The security alerts or a vulnerability of a Cloud Solution Provider (CSP) partner's customer that the partner must be made aware of for further action.|
+|securityScore|[microsoft.graph.partner.security.securityScore](../resources/partner-security-partnerSecurityScore.md) singleton|The security score calculated for the CSP partner and their customers.|
## JSON representation The following JSON representation shows the resource type.
v1.0 Partner Security Partnersecurityscore https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/partner-security-partnersecurityscore.md
+
+ Title: "partnerSecurityScore resource type"
+description: "Represents the security score for a partner which helps them understand their security posture"
+
+ms.localizationpriority: medium
+++
+# partnerSecurityScore resource type
+
+Namespace: microsoft.graph.partner.security
++
+Represents the security score for the partner which helps Cloud Solution Provider (CSP) partners understand their security posture and their customer's security posture. The score includes an aggregate score along with history of score changes, detailed customer insights, and requirement score information.
+
+Inherits from [microsoft.graph.entity](../resources/entity.md).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[Get](../api/partner-security-partnersecurityscore-get.md)|[microsoft.graph.partner.security.partnerSecurityScore](../resources/partner-security-partnersecurityscore.md)|Read the properties and relationships of a [partnerSecurityScore](../resources/partner-security-partnersecurityscore.md) object.|
+|[List customer insights](../api/partner-security-partnersecurityscore-list-customerinsights.md)|[microsoft.graph.partner.security.customerInsight](../resources/partner-security-customerinsight.md) collection|Get a list of the **customerInsight** data to learn more about the partner's customer security posture.|
+|[List history](../api/partner-security-partnersecurityscore-list-history.md)|[microsoft.graph.partner.security.securityScoreHistory](../resources/partner-security-securityscorehistory.md) collection|Lists the history of security score changes for the partner..|
+|[List requirements](../api/partner-security-partnersecurityscore-list-requirements.md)|[microsoft.graph.partner.security.securityRequirement](../resources/partner-security-securityrequirement.md) collection|Get the security requirement resources from the **requirements** navigation property.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|currentScore|Single|The current security score for the partner.|
+|lastRefreshDateTime|DateTimeOffset|The last time the data was checked.|
+|maxScore|Single|The maximum score possible.|
+|updatedDateTime|DateTimeOffset|The last time the security score or related properties changed.|
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|customerInsights|[microsoft.graph.partner.security.customerInsight](../resources/partner-security-customerinsight.md) collection|Contains customer-specific information for certain requirements.|
+|history|[microsoft.graph.partner.security.securityScoreHistory](../resources/partner-security-securityscorehistory.md) collection|Contains a list of recent score changes.|
+|requirements|[microsoft.graph.partner.security.securityRequirement](../resources/partner-security-securityrequirement.md) collection|Contains the list of security requirements that make up the score.|
+
+## JSON representation
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.partner.security.partnerSecurityScore",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.partner.security.partnerSecurityScore",
+ "updatedDateTime": "String (timestamp)",
+ "lastRefreshDateTime": "String (timestamp)",
+ "currentScore": "Single",
+ "maxScore": "Single"
+}
+```
+
v1.0 Partner Security Responsetimesecurityrequirement https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/partner-security-responsetimesecurityrequirement.md
+
+ Title: "responseTimeSecurityRequirement resource type"
+description: "Represents the response time security requirements for partner alerts in the partner security score."
+
+ms.localizationpriority: medium
+++
+# responseTimeSecurityRequirement resource type
+
+Namespace: microsoft.graph.partner.security
++
+Represents the response time security requirements for partner alerts in the partner security score. This requirement shows if the partner is responding quickly to address new [security alerts](../resources/security-alert.md).
++
+Inherits from [microsoft.graph.partner.security.securityRequirement](../resources/partner-security-securityrequirement.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|actionUrl|String|The link to the site where the admin can take action on the requirement. Inherited from [securityRequirement](../resources/partner-security-securityrequirement.md).|
+|averageResponseTimeInHours|Single|The average response time for alerts from the past 30 days.|
+|complianceStatus|microsoft.graph.partner.security.complianceStatus|Indicates whether the partner is compliant with this requirement. Inherited from [securityRequirement](../resources/partner-security-securityrequirement.md). The possible values are: `compliant`, `noncomplaint`, `unknownFutureValue`.|
+|helpUrl|String|The link to documentation for the requirement. Inherited from [securityRequirement](../resources/partner-security-securityrequirement.md).|
+|id|String|The unique identifier for the requirement. Inherited from [securityRequirement](../resources/partner-security-securityrequirement.md).|
+|maxScore|Int64|The maximum score possible for the requirement. Inherited from [securityRequirement](../resources/partner-security-securityrequirement.md).|
+|requirementType|microsoft.graph.partner.security.securityRequirementType|The value of this property is always `securityAlertsPromptlyResolved` for this resource. Inherited from [securityRequirement](../resources/partner-security-securityrequirement.md). The possible values are: `mfaEnforcedForAdmins`, `mfaEnforcedForAdminsOfCustomers`, `securityAlertsPromptlyResolved`, `securityContactProvided`, `spendingBudgetSetForCustomerAzureSubscriptions`, `unknownFutureValue`.|
+|score|Int64|The score received for this requirement. Inherited from [securityRequirement](../resources/partner-security-securityrequirement.md).|
+|state|microsoft.graph.partner.security.securityRequirementState|Indicates whether the requirement is in preview or is fully released. Inherited from [securityRequirement](../resources/partner-security-securityrequirement.md). The possible values are: `active`, `preview`, `unknownFutureValue`.|
+|updatedDateTime|DateTimeOffset|The date the requirement properties were last updated. Inherited from [securityRequirement](../resources/partner-security-securityrequirement.md).|
+
+## Relationships
+None.
+
+## JSON representation
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.partner.security.responseTimeSecurityRequirement",
+ "baseType": "microsoft.graph.partner.security.securityRequirement",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.partner.security.responseTimeSecurityRequirement",
+ "id": "String (identifier)",
+ "requirementType": "String",
+ "complianceStatus": "String",
+ "actionUrl": "String",
+ "helpUrl": "String",
+ "score": "Integer",
+ "maxScore": "Integer",
+ "state": "String",
+ "updatedDateTime": "String (timestamp)",
+ "averageResponseTimeInHours": "Single"
+}
+```
+
v1.0 Partner Security Score Api Overview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/partner-security-score-api-overview.md
+
+ Title: "Use the partner security score API in Microsoft Graph (preview)"
+description: "The partner security score API helps Cloud Solution Provider (CSP) partners understand their security posture and their customer's security posture."
+
+ms.localizationpriority: medium
+++
+# Use the partner security score API in Microsoft Graph (preview)
+
+Namespace: microsoft.graph.partner.security
++
+The Microsoft Partner Center ecosystem provides a security score to indirect providers or direct bill partners in the Cloud Solution Provider (CSP), Value Added Reseller, or Advisor programs. The goal of the score and requirements is to help partners understand the security posture of their tenant and their customer's tenants. The partner security score builds on the Identity and Microsoft 365 security scores to provide suggestions specific to their scenario.
+The [partner security score API](../resources/partner-security-partnersecurityscore.md) is a pivotal tool designed to empower Microsoft partners by providing a quantifiable measure of their security performance. This API facilitates partners in enhancing their security posture by offering a comprehensive security score based on their adherence to Microsoft's security requirements.
+
+The partner security score API is defined in the OData subnamespace `microsoft.graph.partners.security`.
+
+## Objectives
+
+The primary objectives of the security score API include:
+
+* __Quantifying security performance:__ Offering partners a numerical score that reflects their current security status.
+* __Guiding security enhancements with actionable insights:__ Providing actionable insights and recommendations to help partners bolster their security measures.
+* __Monitoring security evolution:__ Enabling partners to track their security improvements over time, fostering a culture of continuous security enhancement.
+
+Use the Microsoft Graph [partner security score API](../resources/partner-security-partnersecurityscore.md) to retrieve the score and insights into your customer security posture.
+
+> **Note:** In order to take actions for the security requirements, choose the action URL provisioned in the API response to go to the relevant UI.
+
+## Common use cases
+
+The following table shows common requests for working with the partner security alert API in Microsoft Graph.
+
+| Use case | REST operation | Try it in Graph Explorer |
+|:|:--|:-|
+|Get partner security score| [Get](../api/partner-security-partnersecurityscore-get.md) | [https://graph.microsoft.com/beta/security/partner/securityScore](https://developer.microsoft.com/graph/graph-explorer?request=security/partner/securityScore&method=GET&version=beta&GraphUrl=https://graph.microsoft.com) |
+|List customer security insights |[List](../api/partner-security-partnersecurityscore-list-customerinsights.md)| [https://graph.microsoft.com/beta/security/partner/securityScore/customerInsights](https://developer.microsoft.com/graph/graph-explorer?request=security/partner/securityScore/customerInsights&method=GET&version=beta&GraphUrl=https://graph.microsoft.com) |
+
+## Related content
+
+The partner security score API in Microsoft Graph provides a summary of your security posture and provides actions to improve. Follow these steps to get started:
+
+- Drill down on the requirements and properties of the [partnerSecurityScore](../resources/partner-security-partnersecurityscore.md) resource.
+- Try the API in the [Microsoft Graph Explorer](https://developer.microsoft.com/graph/graph-explorer).
v1.0 Partner Security Securityrequirement https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/partner-security-securityrequirement.md
+
+ Title: "securityRequirement resource type"
+description: "Represents the base type for security requirement objects."
+
+ms.localizationpriority: medium
+++
+# securityRequirement resource type
+
+Namespace: microsoft.graph.partner.security
++
+Represents the base type for security requirement objects.
++
+Inherits from [microsoft.graph.entity](../resources/entity.md).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List](../api/partner-security-partnersecurityscore-list-requirements.md)|[microsoft.graph.partner.security.securityRequirement](../resources/partner-security-securityrequirement.md) collection|Get a list of the [securityRequirement](../resources/partner-security-securityrequirement.md) objects and their properties.|
+|[Get](../api/partner-security-securityrequirement-get.md)|[microsoft.graph.partner.security.securityRequirement](../resources/partner-security-securityrequirement.md)|Read the properties and relationships of a [securityRequirement](../resources/partner-security-securityrequirement.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|actionUrl|String|The link to the site where the admin can take action on the requirement.|
+|complianceStatus|microsoft.graph.partner.security.complianceStatus|Indicates whether the partner is compliant with this requirement. The possible values are: `compliant`, `noncomplaint`, `unknownFutureValue`.|
+|helpUrl|String|The link to documentation for the requirement.|
+|id|String|The unique identifier for the requirement. Inherited from [microsoft.graph.entity](../resources/entity.md).|
+|maxScore|Int64|The maximum score possible for the requirement. |
+|requirementType|microsoft.graph.partner.security.securityRequirementType|The type of requirement. The possible values are: `mfaEnforcedForAdmins`, `mfaEnforcedForAdminsOfCustomers`, `securityAlertsPromptlyResolved`, `securityContactProvided`, `spendingBudgetSetForCustomerAzureSubscriptions`, `unknownFutureValue`.|
+|score|Int64|The score received for this requirement. |
+|state|microsoft.graph.partner.security.securityRequirementState|Indicates whether the requirement is in preview or is fully released. The possible values are: `active`, `preview`, `unknownFutureValue`.|
+|updatedDateTime|DateTimeOffset|The date the requirement properties were last updated.|
+
+## Relationships
+None.
+
+## JSON representation
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.partner.security.securityRequirement",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.partner.security.securityRequirement",
+ "id": "String (identifier)",
+ "requirementType": "String",
+ "complianceStatus": "String",
+ "actionUrl": "String",
+ "helpUrl": "String",
+ "score": "Integer",
+ "maxScore": "Integer",
+ "state": "String",
+ "updatedDateTime": "String (timestamp)"
+}
+```
+
v1.0 Partner Security Securityscorehistory https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/partner-security-securityscorehistory.md
+
+ Title: "securityScoreHistory resource type"
+description: "Represents a single history entry for the security score where the score or the requirements changed."
+
+ms.localizationpriority: medium
+++
+# securityScoreHistory resource type
+
+Namespace: microsoft.graph.partner.security
++
+Represents a single history entry for the security score where the score or the requirements changed.
++
+Inherits from [microsoft.graph.entity](../resources/entity.md).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List](../api/partner-security-partnersecurityscore-list-history.md)|[microsoft.graph.partner.security.securityScoreHistory](../resources/partner-security-securityscorehistory.md) collection|Get a list of [securityScoreHistory](../resources/partner-security-securityscorehistory.md) objects and their properties.|
+|[Get](../api/partner-security-securityscorehistory-get.md)|[microsoft.graph.partner.security.securityScoreHistory](../resources/partner-security-securityscorehistory.md)|Read the properties and relationships of a [securityScoreHistory](../resources/partner-security-securityscorehistory.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|compliantRequirementsCount|Int64|The number of compliant security requirements at the time.|
+|createdDateTime|DateTimeOffset|The date the history entry was created.|
+|id|String|The unique identifier for the history entry.|
+|score|Double|The score recorded at the time.|
+|totalRequirementsCount|Int64|The total number of requirements at the time.|
+
+## Relationships
+None.
+
+## JSON representation
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.partner.security.securityScoreHistory",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.partner.security.securityScoreHistory",
+ "id": "String (identifier)",
+ "createdDateTime": "String (timestamp)",
+ "score": "Double",
+ "compliantRequirementsCount": "Integer",
+ "totalRequirementsCount": "Integer"
+}
+```
+
v1.0 Passwordresetresponse https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/passwordresetresponse.md
+
+ Title: "passwordResetResponse resource type"
+description: "Represents the new system-generated password after a password reset operation."
++
+ms.localizationpriority: medium
+++
+# passwordResetResponse resource type
+
+Namespace: microsoft.graph
++
+Represents the new system-generated password after a [password reset operation](../api/authenticationmethod-resetpassword.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|newPassword|String|The Microsoft Entra ID-generated password.|
+
+## Relationships
+None.
+
+## JSON representation
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.passwordResetResponse"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.passwordResetResponse",
+ "newPassword": "String"
+}
+```
v1.0 Plannerchecklistitem https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerchecklistitem.md
The **plannerChecklistItem** resource represents an item in the checklist of a t
|:|:--|:-| |isChecked|Boolean|Value is `true` if the item is checked and `false` otherwise.| |lastModifiedBy|[identitySet](identityset.md)| Read-only. User ID by which this is last modified.|
-|lastModifiedDateTime|DateTimeOffset|Read-only. Date and time at which this is last modified. 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`|
+|lastModifiedDateTime|DateTimeOffset|Read-only. Date and time at which this is last modified. 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`.|
|orderHint|String|Used to set the relative order of items in the checklist. The format is defined as outlined [here](planner-order-hint-format.md).|
-|title|String|Title of the checklist item|
+|title|String|Title of the checklist item.|
+
+## Relationships
+
+None.
## Relationships
v1.0 Plannerchecklistitems https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerchecklistitems.md
Title: "plannerChecklistItems resource type"
-description: "The **plannerChecklistItemCollection** resource represents the collection of checklist items on a task. It's an Open Type. It's part of the task details object. The value in the property-value pair is the checklistItem object."
+description: "Represents the collection of checklist items on a task. This complex type is an open type that's part of the task details object. The value in the property-value pair is the checklistItem object."
ms.localizationpriority: medium
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-The **plannerChecklistItemCollection** resource represents the collection of checklist items on a task. It's an Open Type. It's part of the [task details](plannertaskdetails.md) object. The value in the property-value pair is the [checklistItem](plannerchecklistitem.md) object.
+Represents the collection of checklist items on a task. This complex type is an open type that's part of the [task details](plannertaskdetails.md) object. The value in the property-value pair is the [checklistItem](plannerchecklistitem.md) object.
## Properties
-Properties of an Open Type can be defined by the client. In this case, the client should provide **GUIDs** as properties and their values must be [checklistItem](plannerchecklistitem.md) objects. Example is shown below. To remove an item in the checklist, set the value of the property to `null`.
+Properties of an open type can be defined by the client. In this case, the client should provide **GUIDs** as properties and their values must be [checklistItem](plannerchecklistitem.md) objects. To remove an item in the checklist, set the value of the property to `null`.
## Relationships
The following JSON representation shows the resource type.
{ "String-value": {
+ "@odata.type": "microsoft.graph.plannerChecklistItem",
"isChecked": true,
- "lastModifiedBy": "String-value",
+ "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
"lastModifiedByDateTime": "String(timestamp)", "orderHint": "String-value", "title": "String-value" } }
-```
-// Example
-
-```json
-{
- "3a73c9dd-fb47-4230-9c0f-b80788fb0f9b": // client-generated GUID
- {
- "@odata.type": "microsoft.graph.checklistItem", // required in PATCH requests to edit the checklist on a task
- "isChecked": true,
- "lastModifiedBy": {
- "user": {
- "id": "ebf3b108-5234-4e22-b93d-656d7dae5874"
- }
- },
- "lastModifiedByDateTime": "2015-09-21T17:45:12.039Z",
- "orderHint": "0009005756397228702",
- "title": "Get stamps"
- },
- "5f36f5b2-1ec0-4c48-9c75-ed59429516c5":
- {
- "@odata.type": "microsoft.graph.checklistItem",
- "isChecked": false,
- "lastModifiedBy": {
- "user": {
- "id": "ebf3b108-5234-4e22-b93d-656d7dae5874"
- }
- },
- "lastModifiedByDateTime": "2015-09-21T17:45:12.039Z",
- "orderHint": "0004105723397228784",
- "title": "Mail card at UPS"
- }
-}
- ``` <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
v1.0 Plannerplan https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerplan.md
Represents a plan in Microsoft 365. Either a [group](group.md) or a [user](user.
| Method | Return Type |Description| |:|:--|:-|
-|[Get plan](../api/plannerplan-get.md) | [plannerPlan](plannerplan.md) |Read properties and relationships of **plannerPlan** object.|
+|[Create](../api/planner-post-plans.md) | [plannerPlan](plannerplan.md) |Create a **plannerPlan** object.|
+|[Get](../api/plannerplan-get.md) | [plannerPlan](plannerplan.md) |Read properties and relationships of **plannerPlan** object.|
+|[Update](../api/plannerplan-update.md) | [plannerPlan](plannerplan.md) |Update **plannerPlan** object. |
+|[Delete](../api/plannerplan-delete.md) | None | Delete **plannerPlan** object. |
+|[Archive plan](../api/plannerplan-archive.md) | [plannerPlan](plannerplan.md) | Archive a **plannerPlan** object.|
+|[Unarchive plan](../api/plannerplan-unarchive.md) | [plannerPlan](plannerplan.md) | Unarchive an archived **plannerPlan** object.|
+|[Move to container](../api/plannerplan-movetocontainer.md) | [plannerPlan](../resources/plannerplan.md) | Move a **plannerPlan** object from one **plannerPlanContainer** to another. |
|[List plan buckets](../api/plannerplan-list-buckets.md) |[plannerBucket](plannerbucket.md) collection| Get a **plannerBucket** object collection.| |[List plan tasks](../api/plannerplan-list-tasks.md) |[plannerTask](plannertask.md) collection| Get a **plannerTask** object collection.|
-|[Update plan](../api/plannerplan-update.md) | [plannerPlan](plannerplan.md) |Update **plannerPlan** object. |
-|[Delete plan](../api/plannerplan-delete.md) | None | Delete **plannerPlan** object. |
|[Get delta](../api/plannerplan-delta.md) | [plannerPlan](../resources/plannerplan.md) collection | Get newly created, updated, or deleted **plannerPlan** objects in either a **group** or a [plannerRoster](plannerroster.md) type container without having to perform a full read of the entire resource collection. |
-|[Move to container](../api/plannerplan-movetocontainer.md) | [plannerPlan](../resources/plannerplan.md) | Move a **plannerPlan** object from one **plannerPlanContainer** to another. |
-|[Archive plan](../api/plannerplan-archive.md) | [plannerPlan](plannerplan.md) | Archive a **plannerPlan** object.|
-|[Unarchive plan](../api/plannerplan-unarchive.md) | [plannerPlan](plannerplan.md) | Unarchive an archived **plannerPlan** object.|
## Properties | Property | Type |Description|
v1.0 Plannerplanconfiguration https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerplanconfiguration.md
Inherits from [entity](../resources/entity.md).
|:|:|:| |[Get](../api/plannerplanconfiguration-get.md)|[plannerPlanConfiguration](../resources/plannerplanconfiguration.md)|Read the properties and relationships of a [plannerPlanConfiguration](../resources/plannerplanconfiguration.md) object.| |[Update](../api/plannerplanconfiguration-update.md)|[plannerPlanConfiguration](../resources/plannerplanconfiguration.md)|Update the properties of a [plannerPlanConfiguration](../resources/plannerplanconfiguration.md) object for a [businessScenario](../resources/businessscenario.md). |
-|[List](../api/plannerplanconfiguration-list-localizations.md)|[plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) collection|Get the plannerPlanConfigurationLocalization resources from the localizations navigation property.|
-|[Create](../api/plannerplanconfiguration-post-localizations.md)|[plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md)|Create a new plannerPlanConfigurationLocalization object.|
## Properties
v1.0 Plannerplanconfigurationlocalization https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerplanconfigurationlocalization.md
Inherits from [entity](../resources/entity.md).
|Method|Return type|Description| |:|:|:| |[List](../api/plannerplanconfiguration-list-localizations.md)|[plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) collection|Get a list of the [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) objects and their properties.|
-|[Create](../api/plannerplanconfiguration-post-localizations.md)|[plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md)|Create a new [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object.|
-|[Get](../api/plannerplanconfigurationlocalization-get.md)|[plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md)|Read the properties and relationships of a [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object.|
-|[Update](../api/plannerplanconfigurationlocalization-update.md)|[plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md)|Update the properties of a [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object.|
-|[Delete](../api/plannerplanconfiguration-delete-localizations.md)|None|Delete a [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object.|
+|[Update](../api/plannerplanconfiguration-update.md)|[plannerPlanConfiguration](../resources/plannerplanconfiguration.md)|Add, remove, or update a [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) via the update of the plannerPlanConfiguration.|
## Properties |Property|Type|Description|
v1.0 Plannertask https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannertask.md
Represents a planner task in Microsoft 365. A planner task is contained in a [pl
| Method | Return Type |Description| |:|:--|:-|
-|[Get task](../api/plannertask-get.md) | [plannerTask](plannertask.md) |Read the properties and relationships of **plannerTask** object.|
-|[Update task](../api/plannertask-update.md) | [plannerTask](plannertask.md) |Update a **plannerTask** object. |
-|[Delete task](../api/plannertask-delete.md) | None |Delete a **plannerTask** object. |
+|[Create](../api/planner-post-tasks.md) | [plannerTask](plannertask.md) |Create a **plannerTask** object.|
+|[Get](../api/plannertask-get.md) | [plannerTask](plannertask.md) |Read the properties and relationships of **plannerTask** object.|
+|[Update](../api/plannertask-update.md) | [plannerTask](plannertask.md) |Update a **plannerTask** object. |
+|[Delete](../api/plannertask-delete.md) | None |Delete a **plannerTask** object. |
|[Get delta](../api/plannertask-delta.md)|[plannerTask](../resources/plannertask.md) collection| Get newly created, updated, or deleted **plannerTask** objects in either a **plannerPlan** or assigned to the signed-in user without having to perform a full read of the entire resource collection. | ## Properties
v1.0 Positiondetail https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/positiondetail.md
Represents information about positions related to entities within a user's [prof
## Properties
-| Property | Type | Description |
-|:|:|:-|
-|company |[companyDetail](companydetail.md) | Detail about the company or employer. |
-|description |String | Description of the position in question. |
-|endMonthYear |Date | When the position ended. |
-|jobTitle |String | The title held when in that position. |
-|layer |Int32 | The place where the employee is within the organizational hierarchy. |
-|level |String | The employeeΓÇÖs experience or management level. |
-|role |String | The role the position entailed. |
-|startMonthYear |Date | The start month and year of the position. |
-|summary |String | summary of the position. |
+|Property|Type|Description|
+|:-|:|:-|
+|company|[companyDetail](companydetail.md)|Information about the company or employer.|
+|description|String|A description for the position in question.|
+|endMonthYear|Date|The date when the position ended.|
+|jobTitle|String|The title of the position.|
+|layer|Int32|The place where the employee is within the organizational hierarchy.|
+|level|String|The employeeΓÇÖs experience or management level.|
+|role|String|The role the position entailed.|
+|secondaryJobTitle|String|An optional job title for the position.|
+|secondaryRole|String|An optional role for the position entailed.|
+|startMonthYear|Date|The start date of the position.|
+|summary|String|The summary of the position.|
## JSON representation
The following JSON representation shows the resource type.
"layer": "Integer", "level": "String", "role": "String",
+ "secondaryJobTitle": "String",
+ "secondaryRole": "String",
"startMonthYear": "String (timestamp)", "summary": "String" }
v1.0 Profilesourceannotation https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/profilesourceannotation.md
Represents the sources the user data comes from, such as Entra, UPA, Connector,
The following table shows the mapping between the **id** value and the source system.
-| ID | Source system |
-|:--|:|
-| 4ce763dd-9214-4eff-af7c-da491cc3782d, <br/> 0024a795-114d-4031-95c7-5fb543e00e80 | Microsoft Entra ID |
-| 7986c642-b494-4140-8df4-f5ed125e2c67 | Organizational Data in Microsoft 365 |
-| 6cdc4422-8c05-40c5-902e-8ade707725ab | SharePoint User Profile Application (UPA) |
-| 9a3e0ce2-cf4b-477e-b3b3-df246318e251 | Microsoft account (MSA) |
-| 46a57efc-33f8-4eec-a512-b90039ad6187 | User initiated edits |
-| 107a83c9-714e-4d52-9d08-c303f081323b | Photo Etag |
+| ID | Source system |
+|:|:|
+| 4ce763dd-9214-4eff-af7c-da491cc3782d, <br/> 0024a795-114d-4031-95c7-5fb543e00e80 | Microsoft Entra ID |
+| 7986c642-b494-4140-8df4-f5ed125e2c67 | Organizational Data in Microsoft 365 |
+| 6cdc4422-8c05-40c5-902e-8ade707725ab | SharePoint User Profile Application (UPA) |
+| 9a3e0ce2-cf4b-477e-b3b3-df246318e251 | Microsoft account (MSA) |
+| 46a57efc-33f8-4eec-a512-b90039ad6187 | User initiated edits |
+| 107a83c9-714e-4d52-9d08-c303f081323b | Photo Etag |
+| 75d4238e-b142-4d2d-aed9-232b830b8706 | Skills In Viva |
>**Note:** > * The two Microsoft Entra IDs result from implementation differences and might be combined into one in the future.
v1.0 Program https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/program.md
Namespace: microsoft.graph
[!INCLUDE [accessreviews-disclaimer](../../includes/accessreviews-disclaimer.md)]
-In the Microsoft Entra [access reviews](accessreviews-root.md) feature, a program is a container, holding program controls. A tenant can have one or more programs. Each control links an access review to a program, to make it easier to locate related access reviews.
+In the Microsoft Entra [access reviews](accessreviews-root.md) feature, a program is a container, holding program controls. A tenant can have one or more programs. Each control links an access review to a program, to make it easier to locate related access reviews.
-Each tenant that has on-boarded Microsoft Entra access reviews has one program, `Default program`. A global administrator can create additional programs, for example to represent compliance initiatives.
+A tenant that has onboarded Microsoft Entra access reviews has one program, the `Default program`. An authorized administrator can create more programs, for example, to represent compliance initiatives.
## Methods
v1.0 Programcontroltype https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/programcontroltype.md
Namespace: microsoft.graph
In the Microsoft Entra [access reviews](accessreviews-root.md) feature, the program control type is used when associating a control to a program, to indicate the type of access review the control is for.
-The program control type objects are automatically generated when the global administrator onboards the tenant to use the access reviews feature. No additional program control types can be created.
+The program control type objects are automatically generated when an authorized administrator onboards the tenant to use the access reviews feature. No additional program control types can be created.
## Methods
v1.0 Protectionrulebase https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/protectionrulebase.md
Title: "protectionRuleBase resource type"
-description: "Describes Protection Rule and its properties "
+description: "Represents a protection rule specified by the client as part of a protection plan applied to Microsoft 365 data in an organization. "
ms.localizationpriority: medium
Protection rules can be static or dynamic, which means that the rules can run on
This abstract type is the base type for [siteProtectionRule](../resources/siteprotectionrule.md), [mailboxProtectionRule](../resources/mailboxprotectionrule.md), and [driveProtectionRule](../resources/driveprotectionrule.md).
+The following limitations apply to this resource:
+
+- The protection rule APIs for bulk addition of sites via site names or URL in the backup policy creation workflow can accommodate a maximum of 10 keywords at a time. Each keyword can have a minimum of three characters and a maximum of 255 characters.
+- The protection rule APIs for bulk addition of user accounts via security groups or distribution lists can accommodate a maximum of three groups at a time.
+- The rules are static and applied one time only. That is, the security groups or distribution lists are flattened at the time they're added to the backup configuration policy. For example, groups or lists aren't dynamically updated in the system if users are added or removed from the original security group.
+ ## Properties |Property|Type|Description|
v1.0 Protectionunitbase https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/protectionunitbase.md
Title: "protectionUnitBase resource type"
-description: "Represents a site, drive, or mailbox that is protected by a protection policy."
+description: "Represents a site, drive, or mailbox that's protected by a protection policy."
ms.localizationpriority: medium
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Represents a site, drive, or mailbox that's protected by a [protection policy](protectionpolicybase.md).
+Represents a site, drive, or mailbox that's protected by a [protection policy](protectionpolicybase.md). All the protection units in a protection policy have the same retention period by default.
This resource is an abstract type.
v1.0 Report https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/report.md
Title: "Working with Microsoft 365 usage reports in Microsoft Graph"
-description: "With Microsoft Graph, you can access Microsoft 365 usage reports resources to get the information about how people in your business are using Microsoft 365 services. For example, you can identify who is using a service a lot and reaching quotas, or who may not need a Microsoft 365 license at all."
+description: "With Microsoft Graph, you can access Microsoft 365 usage reports resources to get the information about how people in your business are using Microsoft 365 services. For example, you can identify who is using a service a lot and reaching quotas, or who might not need a Microsoft 365 license at all."
ms.localizationpriority: high
doc_type: conceptualPageType
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-With Microsoft Graph, you can access Microsoft 365 usage reports resources to get the information about how people in your business are using Microsoft 365 services. For example, you can identify who is using a service a lot and reaching quotas, or who might not need a Microsoft 365 license at all.
+With Microsoft Graph, you can access Microsoft 365 usage reports resources to get the information about how people in your business are using Microsoft 365 services. For example, you can identify who is using a service a lot and reaching quotas, or who might not need a Microsoft 365 license at all.
For details about the settings that govern identification/de-identification of information in the Microsoft 365 usage reports data, see [Microsoft 365 Reports in the admin center](/microsoft-365/admin/activity-reports/activity-reports) .
Microsoft Graph controls access to resources via permissions. You must specify t
## Settings
-In Microsoft 365 reports, user information such as usernames, groups, and sites is concealed; actual values are not displayed. You can use the [adminReportSettings](/graph/api/resources/adminreportsettings?view=graph-rest-beta&preserve-view=true) API to control the display of user information in the reports.
+In Microsoft 365 reports, user information such as usernames, groups, and sites are concealed; actual values aren't displayed. You can use the [adminReportSettings](../resources/adminreportsettings.md) API to control the display of user information in the reports.
## Cloud deployments The following table shows the availability for each API across all cloud deployments.
-| APIs | Microsoft Graph global service | **Microsoft Cloud for US Government** | **Microsoft Cloud China operated by 21Vianet** | **Microsoft Cloud for USNat and USSec** |
-| | | - | - | |
-| [Admin Report Settings](/graph/api/resources/adminreportsettings?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ£ö |
-| [Microsoft 365 activations](/graph/api/resources/office-365-activations-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ₧û |
-| [Microsoft 365 active users](/graph/api/resources/office-365-active-users-reports?view=graph-rest-beta&preserve-view=true)| Γ£ö | Γ£ö | Γ£ö | Γ₧û |
-| [Microsoft 365 Apps usage](/graph/api/resources/microsoft-365-apps-usage-report?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ₧û |
-| [Microsoft 365 browser usage](/graph/api/resources/microsoft-365-browser-usage-report?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ₧û | Γ₧û |
-| [Microsoft 365 groups activity](/graph/api/resources/office-365-groups-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
-| [Microsoft Forms Usage](/graph/api/resources/microsoft-forms-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û |
-| [Microsoft Teams device usage](/graph/api/resources/microsoft-teams-device-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ£ö |
-| [Microsoft Teams team usage](/graph/api/resources/microsoft-teams-team-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ£ö |
-| [Microsoft Teams user activity](/graph/api/resources/microsoft-teams-user-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ£ö |
-| [Outlook activity](/graph/api/resources/email-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ£ö |
-| [Outlook app usage](/graph/api/resources/email-app-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ£ö |
-| [Outlook mailbox usage](/graph/api/resources/mailbox-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ£ö |
-| [OneDrive activity](/graph/api/resources/onedrive-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ£ö |
-| [OneDrive usage](/graph/api/resources/onedrive-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ£ö |
-| [SharePoint activity](/graph/api/resources/sharepoint-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ£ö |
-| [SharePoint site usage](/graph/api/resources/sharepoint-site-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ£ö |
-| [Skype for Business activity](/graph/api/resources/skype-for-business-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
-| [Skype for Business device usage](/graph/api/resources/skype-for-business-device-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
-| [Skype for Business organizer activity](/graph/api/resources/skype-for-business-organizer-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
-| [Skype for Business participant activity](/graph/api/resources/skype-for-business-participant-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
-| [Skype for Business peer-to-peer activity](/graph/api/resources/skype-for-business-peer-to-peer-activity?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
-| [Yammer activity](/graph/api/resources/yammer-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ₧û | Γ₧û |
-| [Yammer device usage](/graph/api/resources/yammer-device-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ₧û | Γ₧û |
-| [Yammer groups activity](/graph/api/resources/yammer-groups-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ₧û | Γ₧û |
+| APIs | Microsoft Graph global service | **Microsoft Cloud for US Government** | **Microsoft Cloud China operated by 21Vianet** | **Microsoft Cloud for USNat and USSec** |
+| | | - | - | |
+| [Admin report settings](../resources/adminreportsettings.md) | Γ£ö | Γ£ö | Γ£ö | Γ£ö |
+| [Copilot for Microsoft 365 usage](../resources/reportroot.md#copilot-for-microsoft-365-usage) | Γ£ö | Γ₧û | Γ₧û | Γ₧û |
+| [Microsoft 365 activations](../resources/reportroot.md#microsoft-365-activations) | Γ£ö | Γ£ö | Γ£ö | Γ₧û |
+| [Microsoft 365 active users](../resources/reportroot.md#microsoft-365-active-users) | Γ£ö | Γ£ö | Γ£ö | Γ₧û |
+| [Microsoft 365 Apps usage](../resources/reportroot.md#microsoft-365-apps-usage) | Γ£ö | Γ£ö | Γ£ö | Γ₧û |
+| [Microsoft 365 browser usage](../resources/reportroot.md#microsoft-365-browser-usage) | Γ£ö | Γ₧û | Γ₧û | Γ₧û |
+| [Microsoft 365 Groups activity](../resources/reportroot.md#microsoft-365-groups-activity) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
+| [Microsoft Forms Usage](../resources/reportroot.md#forms-activity) | Γ£ö | Γ₧û |
+| [Microsoft Teams device usage](../resources/reportroot.md#microsoft-teams-device-usage) | Γ£ö | Γ£ö | Γ£ö | Γ£ö |
+| [Microsoft Teams team activity](../resources/reportroot.md#microsoft-teams-team-activity) | Γ£ö | Γ£ö | Γ£ö | Γ£ö |
+| [Microsoft Teams user activity](../resources/reportroot.md#microsoft-teams-user-activity) | Γ£ö | Γ£ö | Γ£ö | Γ£ö |
+| [Outlook activity](../resources/reportroot.md#outlook-activity) | Γ£ö | Γ£ö | Γ£ö | Γ£ö |
+| [Outlook app usage](../resources/reportroot.md#outlook-app-usage) | Γ£ö | Γ£ö | Γ£ö | Γ£ö |
+| [Outlook mailbox usage](../resources/reportroot.md#outlook-mailbox-usage) | Γ£ö | Γ£ö | Γ£ö | Γ£ö |
+| [OneDrive activity](../resources/reportroot.md#onedrive-activity) | Γ£ö | Γ£ö | Γ£ö | Γ£ö |
+| [OneDrive usage](../resources/reportroot.md#onedrive-usage) | Γ£ö | Γ£ö | Γ£ö | Γ£ö |
+| [SharePoint activity](../resources/reportroot.md#sharepoint-activity) | Γ£ö | Γ£ö | Γ£ö | Γ£ö |
+| [SharePoint site usage](../resources/reportroot.md#sharepoint-site-usage) | Γ£ö | Γ£ö | Γ£ö | Γ£ö |
+| [Skype for Business activity](../resources/reportroot.md#skype-for-business-activity) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
+| [Skype for Business device usage](../resources/reportroot.md#skype-for-business-device-usage) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
+| [Skype for Business organizer activity](../resources/reportroot.md#skype-for-business-organizer-activity) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
+| [Skype for Business participant activity](../resources/reportroot.md#skype-for-business-participant-activity) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
+| [Skype for Business peer-to-peer activity](../resources/reportroot.md#skype-for-business-peer-to-peer-activity) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
+| [Viva Engage activity](../resources/reportroot.md#viva-engage-activity) | Γ£ö | Γ₧û | Γ₧û | Γ₧û |
+| [Viva Engage device usage](../resources/reportroot.md#viva-engage-device-usage) | Γ£ö | Γ₧û | Γ₧û | Γ₧û |
+| [Viva Engage groups activity](../resources/reportroot.md#viva-engage-groups-activity) | Γ£ö | Γ₧û | Γ₧û | Γ₧û |
## Next steps
v1.0 Reportroot https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/reportroot.md
Represents a container for Microsoft Entra ID and Microsoft 365 reporting resour
## Methods
+### Copilot for Microsoft 365 usage
+
+For details about report views and names, see [Microsoft 365 reports - Copilot for Microsoft 365 usage](/microsoft-365/admin/activity-reports/microsoft-365-copilot-usage).
+
+| Method | Return type | Description |
+| :- | :- | :- |
+| [Get user detail](../api/reportroot-getmicrosoft365copilotusageuserdetail.md) | Stream | Get the most recent activity data for enabled users of Copilot for Microsoft 365 apps. |
+| [Get user counts summary](../api/reportroot-getmicrosoft365copilotusercountsummary.md) | Stream | Get the aggregated number of active and enabled users of Copilot for Microsoft 365 for a specified time period. |
+| [Get user counts trend](../api/reportroot-getmicrosoft365copilotusercounttrend.md) | Stream | Get the trend in the daily number of active and enabled users of Copilot for Microsoft 365 for a specified time period. |
+ ### Forms activity For details about report views and names, see [Microsoft 365 reports - Forms activity](/microsoft-365/admin/activity-reports/forms-activity-ww).
-| Method | Return type | Description |
-|:|:|:--|
-| [Get user detail](../api/reportroot-getformsuseractivityuserdetail.md ) | Stream | Get the detailed forms usage per user. |
-| [Get user counts](../api/reportroot-getformsuseractivityusercounts.md ) | Stream | Get the trend in the number of active users for each user type. |
-| [Get activity counts](../api/reportroot-getformsuseractivitycounts.md) | Stream | Get the number of activities count by activity type over a selected period. |
+| Method | Return type | Description |
+| : | :- | :-- |
+| [Get user detail](../api/reportroot-getformsuseractivityuserdetail.md) | Stream | Get the detailed forms usage per user. |
+| [Get user counts](../api/reportroot-getformsuseractivityusercounts.md) | Stream | Get the trend in the number of active users for each user type. |
+| [Get activity counts](../api/reportroot-getformsuseractivitycounts.md) | Stream | Get the number of activities count by activity type for a specified time period. |
### Microsoft Teams device usage For details about report views and names, see [Microsoft 365 reports - Microsoft Teams device usage](/microsoft-365/admin/activity-reports/microsoft-teams-device-usage-preview).
-| Method | Return type | Description |
-|:-|:|:--|
-| [Get user detail](../api/reportroot-getteamsdeviceusageuserdetail.md) | Stream | Get details about Microsoft Teams device usage by user. |
-| [Get user counts](../api/reportroot-getteamsdeviceusageusercounts.md) | Stream | Get the number of daily unique users by device type. |
-| [Get total user counts](../api/reportroot-getteamsdeviceusagetotalusercounts.md) | Stream | Get the number of daily unique Microsoft Teams licensed or non-licensed users by device type.|
-| [Get distribution user counts](../api/reportroot-getteamsdeviceusagedistributionusercounts.md) | Stream | Get the number of unique users by device type over the selected time period. |
-| [Get distribution total user counts](../api/reportroot-getteamsdeviceusagedistributiontotalusercounts.md) | Stream | Get the number of unique Microsoft Teams licensed or non-licensed users by device type over the selected time period. |
+| Method | Return type | Description |
+| :-- | :- | :-- |
+| [Get user detail](../api/reportroot-getteamsdeviceusageuserdetail.md) | Stream | Get details about Microsoft Teams device usage by user. |
+| [Get user counts](../api/reportroot-getteamsdeviceusageusercounts.md) | Stream | Get the number of daily unique users by device type. |
+| [Get total user counts](../api/reportroot-getteamsdeviceusagetotalusercounts.md) | Stream | Get the number of daily unique Microsoft Teams licensed or nonlicensed users by device type. |
+| [Get distribution user counts](../api/reportroot-getteamsdeviceusagedistributionusercounts.md) | Stream | Get the number of unique users by device type for the selected time period. |
+| [Get distribution total user counts](../api/reportroot-getteamsdeviceusagedistributiontotalusercounts.md) | Stream | Get the number of unique Microsoft Teams licensed or nonlicensed users by device type for the selected time period. |
### Microsoft Teams user activity For details about report views and names, see [Microsoft 365 reports - Microsoft Teams user activity](/microsoft-365/admin/activity-reports/microsoft-teams-user-activity-preview).
-| Method | Return type | Description |
-|:--|:|:--|
-| [Get user detail](../api/reportroot-getteamsuseractivityuserdetail.md) | Stream | Get details about Microsoft Teams user activity by user. |
-| [Get activity counts](../api/reportroot-getteamsuseractivitycounts.md) | Stream | Get the number of Microsoft Teams activities by activity type. The activities are performed by Microsoft Teams licensed users. |
-| [Get activity total counts](../api/reportroot-getteamsuseractivitytotalcounts.md) | Stream | Get the number of Microsoft Teams activities by activity type. The activities are performed by Microsoft Teams licensed or unlicensed users. |
-| [Get user counts](../api/reportroot-getteamsuseractivityusercounts.md) | Stream | Get the number of users by activity type. The activity types are number of teams chat messages, private chat messages, calls, or meetings. |
-| [Get total user counts](../api/reportroot-getteamsuseractivitytotalusercounts.md) | Stream | Get the number of Microsoft Teams licensed or unlicensed users by activity type. The activity types are number of teams chat messages, private chat messages, calls, or meetings. |
-| [Get distribution user counts](../api/reportroot-getteamsuseractivitydistributionusercounts.md) | Stream | Get the number of Microsoft Teams licensed users by activity type over the selected period. The activity types are number of teams chat messages, private chat messages, calls, and meetings. |
-| [Get distribution total user counts](../api/reportroot-getteamsuseractivitydistributiontotalusercounts.md) | Stream | Get the number of Microsoft Teams licensed or unlicensed users by activity type over the selected period. The activity types are number of teams chat messages, private chat messages, calls, and meetings. |
+| Method | Return type | Description |
+| : | :- | :- |
+| [Get user detail](../api/reportroot-getteamsuseractivityuserdetail.md) | Stream | Get details about Microsoft Teams user activity by user. |
+| [Get activity counts](../api/reportroot-getteamsuseractivitycounts.md) | Stream | Get the number of Microsoft Teams activities by activity type. The activities are performed by Microsoft Teams licensed users. |
+| [Get activity total counts](../api/reportroot-getteamsuseractivitytotalcounts.md) | Stream | Get the number of Microsoft Teams activities by activity type. The activities are performed by Microsoft Teams licensed or unlicensed users. |
+| [Get user counts](../api/reportroot-getteamsuseractivityusercounts.md) | Stream | Get the number of users by activity type. The activity types are number of teams chat messages, private chat messages, calls, or meetings. |
+| [Get total user counts](../api/reportroot-getteamsuseractivitytotalusercounts.md) | Stream | Get the number of Microsoft Teams licensed or unlicensed users by activity type. The activity types are number of teams chat messages, private chat messages, calls, or meetings. |
+| [Get distribution user counts](../api/reportroot-getteamsuseractivitydistributionusercounts.md) | Stream | Get the number of Microsoft Teams licensed users by activity type for the selected period. The activity types are number of teams chat messages, private chat messages, calls, and meetings. |
+| [Get distribution total user counts](../api/reportroot-getteamsuseractivitydistributiontotalusercounts.md) | Stream | Get the number of Microsoft Teams licensed or unlicensed users by activity type for the selected period. The activity types are number of teams chat messages, private chat messages, calls, and meetings. |
| [Get total distribution activity counts](../api/reportroot-getteamsuseractivitytotaldistributioncounts.md) | Stream | Get the number of Microsoft Teams user activities over the selected period. The activity types are team chat messages, private chat messages, calls, meetings, meetings organized, meetings attended, audio duration, video duration, screen share duration, post messages, and reply messages. | ### Microsoft Teams team activity For details about report views and names, see [Microsoft 365 reports - Microsoft Teams usage activity](/microsoft-365/admin/activity-reports/microsoft-teams-usage-activity).
-| Method | Return type | Description |
-|:--|:|:--|
-| [Get team detail](../api/reportroot-getteamsteamactivitydetail.md) | Stream | Get details about Teams activity by team. The numbers include activities for both licensed and non-licensed users. |
+| Method | Return type | Description |
+| : | :- | :-- |
+| [Get team detail](../api/reportroot-getteamsteamactivitydetail.md) | Stream | Get details about Teams activity by team. The numbers include activities for both licensed and nonlicensed users. |
| [Get team activity counts](../api/reportroot-getteamsteamactivitycounts.md) | Stream | Get the number of team activities across Microsoft Teams. The activity types are related to meetings and messages. |
-| [Get team activity distribution counts](../api/reportroot-getteamsteamactivitydistributioncounts.md) | Stream | Get the number of team activities across Microsoft Teams over a selected period. |
-| [Get team counts](../api/reportroot-getteamsteamcounts.md) | Stream | Get the number of teams by type across Microsoft Teams. |
+| [Get team activity distribution counts](../api/reportroot-getteamsteamactivitydistributioncounts.md) | Stream | Get the number of team activities across Microsoft Teams over a specified time period. |
+| [Get team counts](../api/reportroot-getteamsteamcounts.md) | Stream | Get the number of teams by type across Microsoft Teams. |
### Outlook activity For details about report views and names, see [Microsoft 365 reports - Email Activity](/microsoft-365/admin/activity-reports/email-activity-ww).
-| Method | Return type | Description |
-|:-|:|:--|
-| [Get user detail](../api/reportroot-getemailactivityuserdetail.md) | Stream | Get details about email activity users have performed. |
-| [Get activity counts](../api/reportroot-getemailactivitycounts.md) | Stream | Enables you to understand the trends of email activity (like how many were sent, read, and received) in your organization. |
+| Method | Return type | Description |
+| :-- | :- | :- |
+| [Get user detail](../api/reportroot-getemailactivityuserdetail.md) | Stream | Get details about email activity users have performed. |
+| [Get activity counts](../api/reportroot-getemailactivitycounts.md) | Stream | Enables you to understand the trends of email activity (like how many were sent, read, and received) in your organization. |
| [Get user counts](../api/reportroot-getemailactivityusercounts.md) | Stream | Enables you to understand trends on the number of unique users who are performing email activities like send, read, and receive. | ### Outlook app usage [Microsoft 365 reports - Email apps usage](/microsoft-365/admin/activity-reports/email-apps-usage-ww).
-| Method | Return type | Description |
-|:|:|:--|
-| [Get user detail](../api/reportroot-getemailappusageuserdetail.md) | Stream | Get details about which activities users performed on the various email apps. |
-| [Get apps user counts](../api/reportroot-getemailappusageappsusercounts.md) | Stream | Get the count of unique users per email app. |
+| Method | Return type | Description |
+| :- | :- | :-- |
+| [Get user detail](../api/reportroot-getemailappusageuserdetail.md) | Stream | Get details about which activities users performed on the various email apps. |
+| [Get apps user counts](../api/reportroot-getemailappusageappsusercounts.md) | Stream | Get the count of unique users per email app. |
| [Get user counts](../api/reportroot-getemailappusageusercounts.md) | Stream | Get the count of unique users that connected to Exchange Online using any email app. |
-| [Get versions user counts](../api/reportroot-getemailappusageversionsusercounts.md) | Stream | Get the count of unique users by Outlook desktop version. |
+| [Get versions user counts](../api/reportroot-getemailappusageversionsusercounts.md) | Stream | Get the count of unique users by Outlook desktop version. |
### Outlook mailbox usage For details about report views and names, see [Microsoft 365 reports - Mailbox usage](/microsoft-365/admin/activity-reports/mailbox-usage).
-| Method | Return type | Description |
-|:|:|:--|
-| [Get mailbox detail](../api/reportroot-getmailboxusagedetail.md) | Stream | Get details about mailbox usage. |
+| Method | Return type | Description |
+| :- | :- | : |
+| [Get mailbox detail](../api/reportroot-getmailboxusagedetail.md) | Stream | Get details about mailbox usage. |
| [Get mailbox counts](../api/reportroot-getmailboxusagemailboxcounts.md) | Stream | Get the total number of user mailboxes in your organization and how many are active each day of the reporting period. A mailbox is considered active if the user sent or read any email. |
-| [Get quota status mailbox counts](../api/reportroot-getmailboxusagequotastatusmailboxcounts.md) | Stream | Get the count of user mailboxes in each quota category. |
-| [Get storage](../api/reportroot-getmailboxusagestorage.md) | Stream | Get the amount of storage used in your organization. |
+| [Get quota status mailbox counts](../api/reportroot-getmailboxusagequotastatusmailboxcounts.md) | Stream | Get the count of user mailboxes in each quota category. |
+| [Get storage](../api/reportroot-getmailboxusagestorage.md) | Stream | Get the amount of storage used in your organization. |
### Microsoft 365 activations For details about report views and names, see [Microsoft 365 reports - Microsoft Office activations](/microsoft-365/admin/activity-reports/microsoft-office-activations-ww).
-| Method | Return type | Description |
-|:|:|:--|
-| [Get user detail](../api/reportroot-getoffice365activationsuserdetail.md) | Stream | Get details about users who have activated Microsoft 365. |
-| [Get activation counts](../api/reportroot-getoffice365activationcounts.md) | Stream | Get the count of Microsoft 365 activations on desktops and devices. |
+| Method | Return type | Description |
+| :- | :- | :- |
+| [Get user detail](../api/reportroot-getoffice365activationsuserdetail.md) | Stream | Get details about users who have activated Microsoft 365. |
+| [Get activation counts](../api/reportroot-getoffice365activationcounts.md) | Stream | Get the count of Microsoft 365 activations on desktops and devices. |
| [Get user counts](../api/reportroot-getoffice365activationsusercounts.md) | Stream | Get the count of users that are enabled and those that have activated the Office subscription on desktop or devices. | ### Microsoft 365 active users For details about report views and names, see [Microsoft 365 reports - Active Users](/microsoft-365/admin/activity-reports/active-users-ww).
-| Method | Return type | Description |
-|:--|:|:--|
-| [Get user detail](../api/reportroot-getoffice365activeuserdetail.md) | Stream | Get details about Microsoft 365 active users. |
+| Method | Return type | Description |
+| : | :- | :- |
+| [Get user detail](../api/reportroot-getoffice365activeuserdetail.md) | Stream | Get details about Microsoft 365 active users. |
| [Get user counts](../api/reportroot-getoffice365activeusercounts.md) | Stream | Get the count of daily active users in the reporting period by product. |
-| [Get services user counts](../api/reportroot-getoffice365servicesusercounts.md) | Stream | Get the count of users by activity type and service. |
+| [Get services user counts](../api/reportroot-getoffice365servicesusercounts.md) | Stream | Get the count of users by activity type and service. |
### Microsoft 365 apps usage For details about report views and names, see [Microsoft 365 reports - Microsoft 365 Apps usage](/microsoft-365/admin/activity-reports/microsoft365-apps-usage).
-| Method | Return type | Description |
-|:|:|:--|
+| Method | Return type | Description |
+| :- | :- | : |
| [Get user detail](../api/reportroot-getm365appuserdetail.md) | Stream | Get details about the usage of Microsoft 365 Apps by user. |
-| [Get user counts](../api/reportroot-getm365appusercounts.md) | Stream | Get the number of daily unique users by app. |
-| [Get platform user counts](../api/reportroot-getm365appplatformusercounts.md) | Stream | Get the number of daily unique users by platform. |
+| [Get user counts](../api/reportroot-getm365appusercounts.md) | Stream | Get the number of daily unique users by app. |
+| [Get platform user counts](../api/reportroot-getm365appplatformusercounts.md) | Stream | Get the number of daily unique users by platform. |
### Microsoft 365 browser usage For details about report views and names, see [Microsoft 365 reports - Microsoft browser usage](/microsoft-365/admin/activity-reports/browser-usage-report).
-| Method | Return type | Description |
-|:--|:|:--|
-| [Get user detail](../api/reportroot-getbrowseruserdetail.md ) | Stream | Get the detailed browser usage per user. |
-| [Get user counts](../api/reportroot-getbrowserusercounts.md ) | Stream | Get the trend in the number of active users for each browser. |
-| [Get distribution user counts](../api/reportroot-getbrowserdistributionusercounts.md) | Stream | Get the number of users by browser over a selected period. |
+| Method | Return type | Description |
+| : | :- | : |
+| [Get user detail](../api/reportroot-getbrowseruserdetail.md) | Stream | Get the detailed browser usage per user. |
+| [Get user counts](../api/reportroot-getbrowserusercounts.md) | Stream | Get the trend in the number of active users for each browser. |
+| [Get distribution user counts](../api/reportroot-getbrowserdistributionusercounts.md) | Stream | Get the number of users by browser over a specified time period. |
### Microsoft 365 groups activity For details about report views and names, see [Microsoft 365 reports - Microsoft 365 groups](/microsoft-365/admin/activity-reports/office-365-groups-ww).
-| Method | Return type | Description |
-|:-|:|:--|
-| [Get group detail](../api/reportroot-getoffice365groupsactivitydetail.md) | Stream | Get details about Microsoft 365 groups activity by group. |
-| [Get activity counts](../api/reportroot-getoffice365groupsactivitycounts.md) | Stream | Get the number of group activities across group workloads. |
+| Method | Return type | Description |
+| :-- | :- | :-- |
+| [Get group detail](../api/reportroot-getoffice365groupsactivitydetail.md) | Stream | Get details about Microsoft 365 groups activity by group. |
+| [Get activity counts](../api/reportroot-getoffice365groupsactivitycounts.md) | Stream | Get the number of group activities across group workloads. |
| [Get group counts](../api/reportroot-getoffice365groupsactivitygroupcounts.md) | Stream | Get the daily total number of groups and how many of them were active based on email conversations, Viva Engage posts, and SharePoint file activities. |
-| [Get storage](../api/reportroot-getoffice365groupsactivitystorage.md) | Stream | Get the total storage used across all group mailboxes and group sites. |
-| [Get file counts](../api/reportroot-getoffice365groupsactivityfilecounts.md) | Stream | Get the total number of files and how many of them were active across all group sites associated with a Microsoft 365 group. |
+| [Get storage](../api/reportroot-getoffice365groupsactivitystorage.md) | Stream | Get the total storage used across all group mailboxes and group sites. |
+| [Get file counts](../api/reportroot-getoffice365groupsactivityfilecounts.md) | Stream | Get the total number of files and how many of them were active across all group sites associated with a Microsoft 365 group. |
### OneDrive activity For details about report views and names, see [Microsoft 365 reports - OneDrive for Business activity](/microsoft-365/admin/activity-reports/onedrive-for-business-activity-ww).
-| Method | Return type | Description |
-|:-|:|:--|
-| [Get user detail](../api/reportroot-getonedriveactivityuserdetail.md) | Stream | Get details about OneDrive activity by user. |
-| [Get user counts](../api/reportroot-getonedriveactivityusercounts.md) | Stream | Get the trend in the number of active OneDrive users. |
+| Method | Return type | Description |
+| :-- | :- | : |
+| [Get user detail](../api/reportroot-getonedriveactivityuserdetail.md) | Stream | Get details about OneDrive activity by user. |
+| [Get user counts](../api/reportroot-getonedriveactivityusercounts.md) | Stream | Get the trend in the number of active OneDrive users. |
| [Get file counts](../api/reportroot-getonedriveactivityfilecounts.md) | Stream | Get the number of unique, licensed users that performed file interactions against any OneDrive account. | ### OneDrive usage For details about report views and names, see [Microsoft 365 reports - OneDrive for Business usage](/microsoft-365/admin/activity-reports/onedrive-for-business-usage-ww).
-| Method | Return type | Description |
-|:-|:|:--|
-| [Get account detail](../api/reportroot-getonedriveusageaccountdetail.md) | Stream | Get details about OneDrive usage by account. |
-| [Get account counts](../api/reportroot-getonedriveusageaccountcounts.md) | Stream | Get the trend in the number of active OneDrive for Business sites. Any site on which users viewed, modified, uploaded, downloaded, shared, or synced files is considered an active site. |
+| Method | Return type | Description |
+| :-- | :- | :-- |
+| [Get account detail](../api/reportroot-getonedriveusageaccountdetail.md) | Stream | Get details about OneDrive usage by account. |
+| [Get account counts](../api/reportroot-getonedriveusageaccountcounts.md) | Stream | Get the trend in the number of active OneDrive for Business sites. Any site on which users viewed, modified, uploaded, downloaded, shared, or synced files is considered an active site. |
| [Get file counts](../api/reportroot-getonedriveusagefilecounts.md) | Stream | Get the total number of files across all sites and how many are active files. A file is considered active if it has been saved, synced, modified, or shared within the specified time period. |
-| [Get storage](../api/reportroot-getonedriveusagestorage.md) | Stream | Get the trend on the amount of storage you are using in OneDrive for Business. |
+| [Get storage](../api/reportroot-getonedriveusagestorage.md) | Stream | Get the trend on the amount of storage you are using in OneDrive for Business. |
### SharePoint activity For details about report views and names, see [Microsoft 365 reports - SharePoint activity](/microsoft-365/admin/activity-reports/sharepoint-activity-ww).
-| Method | Return type | Description |
-|:|:|:--|
-| [Get user detail](../api/reportroot-getsharepointactivityuserdetail.md) | Stream | Get details about SharePoint activity by user. |
-| [Get file counts](../api/reportroot-getsharepointactivityfilecounts.md) | Stream | Get the number of unique, licensed users who interacted with files stored on SharePoint sites. |
+| Method | Return type | Description |
+| :- | :- | :- |
+| [Get user detail](../api/reportroot-getsharepointactivityuserdetail.md) | Stream | Get details about SharePoint activity by user. |
+| [Get file counts](../api/reportroot-getsharepointactivityfilecounts.md) | Stream | Get the number of unique, licensed users who interacted with files stored on SharePoint sites. |
| [Get user counts](../api/reportroot-getsharepointactivityusercounts.md) | Stream | Get the trend in the number of active users. A user is considered active if he or she has executed a file activity (save, sync, modify, or share) or visited a page within the specified time period. |
-| [Get pages](../api/reportroot-getsharepointactivitypages.md) | Stream | Get the number of unique pages visited by users. |
+| [Get pages](../api/reportroot-getsharepointactivitypages.md) | Stream | Get the number of unique pages visited by users. |
### SharePoint site usage For details about report views and names, see [Microsoft 365 reports - SharePoint site usage](/microsoft-365/admin/activity-reports/sharepoint-site-usage-ww).
-| Method | Return type | Description |
-|:-|:|:--|
-| [Get site detail](../api/reportroot-getsharepointsiteusagedetail.md) | Stream | Get details about SharePoint site usage. |
+| Method | Return type | Description |
+| :-- | :- | :-- |
+| [Get site detail](../api/reportroot-getsharepointsiteusagedetail.md) | Stream | Get details about SharePoint site usage. |
| [Get file counts](../api/reportroot-getsharepointsiteusagefilecounts.md) | Stream | Get the total number of files across all sites and the number of active files. A file (user or system) is considered active if it has been saved, synced, modified, or shared within the specified time period. |
-| [Get site counts](../api/reportroot-getsharepointsiteusagesitecounts.md) | Stream | Get the trend of total and active site count during the reporting period. |
-| [Get storage](../api/reportroot-getsharepointsiteusagestorage.md) | Stream | Get the trend of storage allocated and consumed during the reporting period. |
-| [Get pages](../api/reportroot-getsharepointsiteusagepages.md) | Stream | Get the number of pages viewed across all sites. |
+| [Get site counts](../api/reportroot-getsharepointsiteusagesitecounts.md) | Stream | Get the trend of total and active site count during the reporting period. |
+| [Get storage](../api/reportroot-getsharepointsiteusagestorage.md) | Stream | Get the trend of storage allocated and consumed during the reporting period. |
+| [Get pages](../api/reportroot-getsharepointsiteusagepages.md) | Stream | Get the number of pages viewed across all sites. |
### Skype for Business activity For details about report views and names, see [Skype for Business activity](/skypeforbusiness/skype-for-business-online-reporting/activity-report).
-| Method | Return type | Description |
-|:|:|:--|
-| [Get user detail](../api/reportroot-getskypeforbusinessactivityuserdetail.md) | Stream | Get details about Skype for Business activity by user. |
-| [Get activity counts](../api/reportroot-getskypeforbusinessactivitycounts.md) | Stream | Get the trends on how many users organized and participated in conference sessions held in your organization through Skype for Business. The report also includes the number of peer-to-peer sessions. |
+| Method | Return type | Description |
+| :- | :- | : |
+| [Get user detail](../api/reportroot-getskypeforbusinessactivityuserdetail.md) | Stream | Get details about Skype for Business activity by user. |
+| [Get activity counts](../api/reportroot-getskypeforbusinessactivitycounts.md) | Stream | Get the trends on how many users organized and participated in conference sessions held in your organization through Skype for Business. The report also includes the number of peer-to-peer sessions. |
| [Get user counts](../api/reportroot-getskypeforbusinessactivityusercounts.md) | Stream | Get the trends on how many unique users organized and participated in conference sessions held in your organization through Skype for Business. The report also includes the number of peer-to-peer sessions. | ### Skype for Business device usage For details about report views and names, see [Skype for Business clients used](/skypeforbusiness/skype-for-business-online-reporting/device-usage-report).
-| Method | Return type | Description |
-|:-|:|:|
-| [Get user detail](../api/reportroot-getskypeforbusinessdeviceusageuserdetail.md) | Stream | Get details about Skype for Business device usage by user. |
-| [Get distribution user counts](../api/reportroot-getskypeforbusinessdeviceusagedistributionusercounts.md) | Stream | Get the number of users using unique devices in your organization. The report shows you the number of users per device including Windows, Windows phone, Android phone, iPhone, and iPad. |
+| Method | Return type | Description |
+| :-- | :- | :-- |
+| [Get user detail](../api/reportroot-getskypeforbusinessdeviceusageuserdetail.md) | Stream | Get details about Skype for Business device usage by user. |
+| [Get distribution user counts](../api/reportroot-getskypeforbusinessdeviceusagedistributionusercounts.md) | Stream | Get the number of users using unique devices in your organization. The report shows you the number of users per device including Windows, Windows phone, Android phone, iPhone, and iPad. |
| [Get user counts](../api/reportroot-getskypeforbusinessdeviceusageusercounts.md) | Stream | Get the usage trends on how many users in your organization have connected using the Skype for Business app. You also get a breakdown by the type of device (Windows, Windows phone, Android phone, iPhone, or iPad) on which the Skype for Business client app is installed and used across your organization. | ### Skype for Business organizer activity For details about report views and names, see [Skype for Business conference organizer activity](/skypeforbusiness/skype-for-business-online-reporting/conference-organizer-activity-report).
-| Method | Return type | Description |
-|:-|:|:--|
-| [Get activity counts](../api/reportroot-getskypeforbusinessorganizeractivitycounts.md) | Stream | Get usage trends on the number and type of conference sessions held and organized by users in your organization. Types of conference sessions include IM, audio/video, application sharing, web, dial-in/out - third party, and dial-in/out Microsoft. |
+| Method | Return type | Description |
+| :-- | :- | : |
+| [Get activity counts](../api/reportroot-getskypeforbusinessorganizeractivitycounts.md) | Stream | Get usage trends on the number and type of conference sessions held and organized by users in your organization. Types of conference sessions include IM, audio/video, application sharing, web, dial-in/out - third party, and dial-in/out Microsoft. |
| [Get user counts](../api/reportroot-getskypeforbusinessorganizeractivityusercounts.md) | Stream | Get usage trends on the number of unique users and type of conference sessions held and organized by users in your organization. Types of conference sessions include IM, audio/video, application sharing, web, dial-in/out - third party, and dial-in/out Microsoft. |
-| [Get minute counts](../api/reportroot-getskypeforbusinessorganizeractivityminutecounts.md) | Stream | Get usage trends on the length in minutes and type of conference sessions held and organized by users in your organization. Types of conference sessions include audio/video, and dial-in and dial-out - Microsoft. |
+| [Get minute counts](../api/reportroot-getskypeforbusinessorganizeractivityminutecounts.md) | Stream | Get usage trends on the length in minutes and type of conference sessions held and organized by users in your organization. Types of conference sessions include audio/video, and dial-in and dial-out - Microsoft. |
### Skype for Business participant activity For details about report views and names, see [Skype for Business conference participant activity](/skypeforbusiness/skype-for-business-online-reporting/conference-participant-activity-report).
-| Method | Return type | Description |
-|:|:|:--|
-| [Get activity counts](../api/reportroot-getskypeforbusinessparticipantactivitycounts.md) | Stream | Get usage trends on the number and type of conference sessions that users from your organization participated in. Types of conference sessions include IM, audio/video, application sharing, web, and dial-in/out - third party. |
+| Method | Return type | Description |
+| :- | :- | :-- |
+| [Get activity counts](../api/reportroot-getskypeforbusinessparticipantactivitycounts.md) | Stream | Get usage trends on the number and type of conference sessions that users from your organization participated in. Types of conference sessions include IM, audio/video, application sharing, web, and dial-in/out - third party. |
| [Get user counts](../api/reportroot-getskypeforbusinessparticipantactivityusercounts.md) | Stream | Get usage trends on the number of unique users and type of conference sessions that users from your organization participated in. Types of conference sessions include IM, audio/video, application sharing, web, and dial-in/out - third party. |
-| [Get minute counts](../api/reportroot-getskypeforbusinessparticipantactivityminutecounts.md) | Stream | Get usage trends on the length in minutes and type of conference sessions that users from your organization participated in. Types of conference sessions include audio/video. |
+| [Get minute counts](../api/reportroot-getskypeforbusinessparticipantactivityminutecounts.md) | Stream | Get usage trends on the length in minutes and type of conference sessions that users from your organization participated in. Types of conference sessions include audio/video. |
### Skype for Business peer-to-peer activity For details about report views and names, see [Skype for Business peer-to-peer activity](/skypeforbusiness/skype-for-business-online-reporting/peer-to-peer-activity-report).
-| Method | Return type | Description |
-|:--|:|:--|
-| [Get activity counts](../api/reportroot-getskypeforbusinesspeertopeeractivitycounts.md) | Stream | Get usage trends on the number and type of sessions held in your organization. Types of sessions include IM, audio, video, application sharing, and file transfer. |
+| Method | Return type | Description |
+| : | :- | : |
+| [Get activity counts](../api/reportroot-getskypeforbusinesspeertopeeractivitycounts.md) | Stream | Get usage trends on the number and type of sessions held in your organization. Types of sessions include IM, audio, video, application sharing, and file transfer. |
| [Get user counts](../api/reportroot-getskypeforbusinesspeertopeeractivityusercounts.md) | Stream | Get usage trends on the number of unique users and type of peer-to-peer sessions held in your organization. Types of sessions include IM, audio, video, application sharing, and file transfers in peer-to-peer sessions. |
-| [Get minute counts](../api/reportroot-getskypeforbusinesspeertopeeractivityminutecounts.md) | Stream | Get usage trends on the length in minutes and type of peer-to-peer sessions held in your organization. Types of sessions include audio and video. |
+| [Get minute counts](../api/reportroot-getskypeforbusinesspeertopeeractivityminutecounts.md) | Stream | Get usage trends on the length in minutes and type of peer-to-peer sessions held in your organization. Types of sessions include audio and video. |
### Viva Engage activity For details about report views and names, see [Microsoft 365 reports - Viva Engage Activity](/microsoft-365/admin/activity-reports/viva-engage-activity-report-ww).
-| Method | Return type | Description |
-|:--|:|:--|
-| [Get user detail](../api/reportroot-getyammeractivityuserdetail.md) | Stream | Get details about Viva Engage activity by user. |
+| Method | Return type | Description |
+| : | :- | : |
+| [Get user detail](../api/reportroot-getyammeractivityuserdetail.md) | Stream | Get details about Viva Engage activity by user. |
| [Get activity counts](../api/reportroot-getyammeractivitycounts.md) | Stream | Get the trends on the amount of Viva Engage activity in your organization by how many messages were posted, read, and liked. |
-| [Get user counts](../api/reportroot-getyammeractivityusercounts.md) | Stream | Get the trends on the number of unique users who posted, read, and liked Viva Engage messages. |
+| [Get user counts](../api/reportroot-getyammeractivityusercounts.md) | Stream | Get the trends on the number of unique users who posted, read, and liked Viva Engage messages. |
### Viva Engage device usage For details about report views and names, see [Microsoft 365 reports - Viva Engage device usage](/microsoft-365/admin/activity-reports/viva-engage-device-usage-report-ww).
-| Method | Return type | Description |
-|:|:|:--|
+| Method | Return type | Description |
+| :- | :- | :-- |
| [Get user detail](../api/reportroot-getyammerdeviceusageuserdetail.md) | Stream | Get details about Viva Engage device usage by user. |
-| [Get distribution user counts](../api/reportroot-getyammerdeviceusagedistributionusercounts.md) | Stream | Get the number of users by device type. |
-| [Get user counts](../api/reportroot-getyammerdeviceusageusercounts.md) | Stream | Get the number of daily users by device type. |
+| [Get distribution user counts](../api/reportroot-getyammerdeviceusagedistributionusercounts.md) | Stream | Get the number of users by device type. |
+| [Get user counts](../api/reportroot-getyammerdeviceusageusercounts.md) | Stream | Get the number of daily users by device type. |
### Viva Engage groups activity For details about report views and names, see [Microsoft 365 reports - Viva Engage groups activity](/microsoft-365/admin/activity-reports/viva-engage-groups-activity-report-ww).
-| Method | Return type | Description |
-|:-|:|:--|
-| [Get group detail](../api/reportroot-getyammergroupsactivitydetail.md) | Stream | Get details about Viva Engage groups activity by group. |
+| Method | Return type | Description |
+| :-- | :- | : |
+| [Get group detail](../api/reportroot-getyammergroupsactivitydetail.md) | Stream | Get details about Viva Engage groups activity by group. |
| [Get group counts](../api/reportroot-getyammergroupsactivitygroupcounts.md) | Stream | Get the total number of groups that existed and how many included group conversation activity. |
-| [Get activity counts](../api/reportroot-getyammergroupsactivitycounts.md) | Stream | Get the number of Viva Engage messages posted, read, and liked in groups. |
+| [Get activity counts](../api/reportroot-getyammergroupsactivitycounts.md) | Stream | Get the number of Viva Engage messages posted, read, and liked in groups. |
## Properties
None.
## Relationships
-| Relationship | Type | Description |
-|:-|:-|:|
-| appCredentialSignInActivities | [appCredentialSignInActivity](appcredentialsigninactivity.md) collection | Represents a collection of sign-in activities of application credentials. |
-| applicationSignInDetailedSummary | [applicationSignInDetailedSummary](applicationsignindetailedsummary.md) collection | Represents a detailed summary of an application sign-in. |
-| authenticationMethods | [authenticationMethodsRoot](authenticationmethodsroot.md) | Container for navigation properties for Microsoft Entra authentication methods resources. |
-| credentialUserRegistrationDetails | [credentialUserRegistrationDetails](credentialuserregistrationdetails.md) collection | Details of the usage of self-service password reset and multifactor authentication (MFA) for all registered users. |
-| dailyPrintUsageByPrinter | [printUsageByPrinter](printusagebyprinter.md) collection | Retrieve a list of daily print usage summaries, grouped by printer. |
-| dailyPrintUsageByUser | [printUsageByUser](printusagebyuser.md) collection | Retrieve a list of daily print usage summaries, grouped by user. |
-| monthlyPrintUsageByPrinter | [printUsageByPrinter](printusagebyprinter.md) collection | Retrieve a list of monthly print usage summaries, grouped by printer. |
-| monthlyPrintUsageByUser | [printUsageByUser](printusagebyuser.md) collection | Retrieve a list of monthly print usage summaries, grouped by user. |
-| partners | [partners](partners.md) | Represents billing details for a Microsoft direct partner. |
-| readingAssignmentSubmission | [readingAssignmentSubmission](../resources/readingassignmentsubmission.md) collection| Represents the submission details of the reading assignment associated with this data. |
-| reflectCheckInResponse | [reflectCheckInResponse](../resources/reflectcheckinresponse.md) collection | Represents the response to the Microsoft Reflect check-in associated with this data. |
-| security | [securityReportsRoot](securityreportsroot.md) | Provides the ability to launch a simulated phishing attack that organizations can learn from. |
-| servicePrincipalSignInActivities | [servicePrincipalSignInActivity](serviceprincipalsigninactivity.md) collection | Represents a collection of sign-in activities of service principals. |
-| serviceActivity | [serviceActivity](serviceactivity.md) | Reports that relate to tenant-level authentication activities in Microsoft Entra. |
-| sla | [serviceLevelAgreementRoot](servicelevelagreementroot.md) | Reports that relate to tenant-level Microsoft Entra SLA attainment. |
-| userCredentialUsageDetails | [userCredentialUsageDetails](usercredentialusagedetails.md) collection | Represents the self-service password reset (SSPR) usage for a given tenant. |
-| userInsights | [userInsightsRoot](userinsightsroot.md) | Represents a collection of user activities on applications in a tenant that is configured for Microsoft Entra External ID for customers. |
+| Relationship | Type | Description |
+| :-- | : | : |
+| appCredentialSignInActivities | [appCredentialSignInActivity](appcredentialsigninactivity.md) collection | Represents a collection of sign-in activities of application credentials. |
+| applicationSignInDetailedSummary | [applicationSignInDetailedSummary](applicationsignindetailedsummary.md) collection | Represents a detailed summary of an application sign-in. |
+| authenticationMethods | [authenticationMethodsRoot](authenticationmethodsroot.md) | Container for navigation properties for Microsoft Entra authentication methods resources. |
+| credentialUserRegistrationDetails | [credentialUserRegistrationDetails](credentialuserregistrationdetails.md) collection | Details of the usage of self-service password reset and multifactor authentication (MFA) for all registered users. |
+| dailyPrintUsageByPrinter | [printUsageByPrinter](printusagebyprinter.md) collection | Retrieve a list of daily print usage summaries, grouped by printer. |
+| dailyPrintUsageByUser | [printUsageByUser](printusagebyuser.md) collection | Retrieve a list of daily print usage summaries, grouped by user. |
+| monthlyPrintUsageByPrinter | [printUsageByPrinter](printusagebyprinter.md) collection | Retrieve a list of monthly print usage summaries, grouped by printer. |
+| monthlyPrintUsageByUser | [printUsageByUser](printusagebyuser.md) collection | Retrieve a list of monthly print usage summaries, grouped by user. |
+| partners | [partners](partners.md) | Represents billing details for a Microsoft direct partner. |
+| readingAssignmentSubmission | [readingAssignmentSubmission](../resources/readingassignmentsubmission.md) collection | Represents the submission details of the reading assignment associated with this data. |
+| reflectCheckInResponse | [reflectCheckInResponse](../resources/reflectcheckinresponse.md) collection | Represents the response to the Microsoft Reflect check-in associated with this data. |
+| security | [securityReportsRoot](securityreportsroot.md) | Provides the ability to launch a simulated phishing attack that organizations can learn from. |
+| servicePrincipalSignInActivities | [servicePrincipalSignInActivity](serviceprincipalsigninactivity.md) collection | Represents a collection of sign-in activities of service principals. |
+| serviceActivity | [serviceActivity](serviceactivity.md) | Reports that relate to tenant-level authentication activities in Microsoft Entra. |
+| sla | [serviceLevelAgreementRoot](servicelevelagreementroot.md) | Reports that relate to tenant-level Microsoft Entra SLA attainment. |
+| userCredentialUsageDetails | [userCredentialUsageDetails](usercredentialusagedetails.md) collection | Represents the self-service password reset (SSPR) usage for a given tenant. |
+| userInsights | [userInsightsRoot](userinsightsroot.md) | Represents a collection of user activities on applications in a tenant that is configured for Microsoft Entra External ID for customers. |
## JSON representation The following JSON representation shows the resource type.+ <!-- { "blockType": "resource", "keyProperty": "id",
The following JSON representation shows the resource type.
"openType": false } -->
-``` json
+
+```json
{ "@odata.type": "#microsoft.graph.reportRoot" }
v1.0 Restorepoint https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/restorepoint.md
Namespace: microsoft.graph
Represents the date and time when an [artifact](../resources/restoreartifactbase.md) is protected by a [protectionPolicy](../resources/protectionpolicybase.md) and can be restored.
+The following limitations apply to this API:
+
+- When sites or mailboxes are added to a backup policy, it might take up to 15 minutes per 1,000 sites or mailboxes for restore points to become available.
+- Although OneDrive account and mailbox backups of deleted users are maintained and restorable after the userΓÇÖs Microsoft Entra ID is deleted, the user is displayed as an empty user in results.
+ ## Methods |Method|Return type|Description|
v1.0 Restoresessionbase https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/restoresessionbase.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Represents a restore session for a [protection unit](protectionunitbase.md) that's protected by a [protection policy](protectionpolicybase.md). APIs are used by Global Admin or SharePoint Online Admin for SharePoint Online/OneDrive & Exchange Online Admin for Exchange Online to perform restore related tasks on artifacts that are protected as part of Protection Policy.
+Represents a restore session for a [protection unit](protectionunitbase.md) that's protected by a [protection policy](protectionpolicybase.md). Restore session APIs are used by global admins, SharePoint Online admins, and Exchange Online admins to perform restore-related tasks on artifacts that are protected as part of protection policy.
+
+Restoring to both a new location and the same URL in a single restore session is not supported.
## Methods
v1.0 Scheduleinformation https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/scheduleinformation.md
Represents the availability of a user, distribution list, or resource (room or e
## Properties | Property | Type |Description| |:|:--|:-|
-|availabilityView |String |Represents a merged view of availability of all the items in `scheduleItems`. The view consists of time slots. Availability during each time slot is indicated with: `0`= free or working elswhere, `1`= tentative, `2`= busy, `3`= out of office.<br><br>**Note:** Working elsewhere is set to `0` instead of `4` for backward compatibility. For details, see the [Q&A](/answers/questions/309571/working-elsewhere-in-getschedules-availabilityview).|
+|availabilityView |String |Represents a merged view of availability of all the items in `scheduleItems`. The view consists of time slots. Availability during each time slot is indicated with: `0`= free or working elswhere, `1`= tentative, `2`= busy, `3`= out of office.<br><br>**Note:** Working elsewhere is set to `0` instead of `4` for backward compatibility. For details, see the [Q&A](/answers/questions/309571/working-elsewhere-in-getschedules-availabilityview) and [Exchange 2007 and Exchange 2010 do not use the WorkingElsewhere value](/openspecs/exchange_server_protocols/ms-oxwscdata/e5ec9563-0491-486d-9bec-50585fa2a2c6#Appendix_A_117).|
|error |[freeBusyError](freebusyerror.md) |Error information from attempting to get the availability of the user, distribution list, or resource. | |scheduleId |String |An SMTP address of the user, distribution list, or resource, identifying an instance of **scheduleInformation**. | |scheduleItems |[scheduleItem](scheduleitem.md) collection |Contains the items that describe the availability of the user or resource. |
v1.0 Security Alert https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-alert.md
Security providers create an alert in the system when they detect a threat. Micr
|detectionSource|[microsoft.graph.security.detectionSource](#detectionsource-values)| Detection technology or sensor that identified the notable component or activity. Possible values are: `unknown`, `microsoftDefenderForEndpoint`, `antivirus`, `smartScreen`, `customTi`, `microsoftDefenderForOffice365`, `automatedInvestigation`, `microsoftThreatExperts`, `customDetection`, `microsoftDefenderForIdentity`, `cloudAppSecurity`, `microsoft365Defender`, `azureAdIdentityProtection`, `manual`, `microsoftDataLossPrevention`, `appGovernancePolicy`, `appGovernanceDetection`, `unknownFutureValue`, `microsoftDefenderForCloud`, `microsoftDefenderForIoT`, `microsoftDefenderForServers`, `microsoftDefenderForStorage`, `microsoftDefenderForDNS`, `microsoftDefenderForDatabases`, `microsoftDefenderForContainers`, `microsoftDefenderForNetwork`, `microsoftDefenderForAppService`, `microsoftDefenderForKeyVault`, `microsoftDefenderForResourceManager`, `microsoftDefenderForApiManagement`, `microsoftSentinel`, `nrtAlerts`, `scheduledAlerts`, `microsoftDefenderThreatIntelligenceAnalytics`, `builtInMl`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value(s) in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `microsoftDefenderForCloud`, `microsoftDefenderForIoT`, `microsoftDefenderForServers`, `microsoftDefenderForStorage`, `microsoftDefenderForDNS`, `microsoftDefenderForDatabases`, `microsoftDefenderForContainers`, `microsoftDefenderForNetwork`, `microsoftDefenderForAppService`, `microsoftDefenderForKeyVault`, `microsoftDefenderForResourceManager`, `microsoftDefenderForApiManagement`, `microsoftSentinel`, `nrtAlerts`, `scheduledAlerts`, `microsoftDefenderThreatIntelligenceAnalytics`, `builtInMl`.| |detectorId|String| The ID of the detector that triggered the alert.| |productName|String| The name of the product which published this alert.|
-|determination|[microsoft.graph.security.alertDetermination](#alertdetermination-values)| Specifies the result of the investigation, whether the alert represents a true attack, and if so, the nature of the attack. Possible values are: `unknown`, `apt`, `malware`, `securityPersonnel`, `securityTesting`, `unwantedSoftware`, `other`, `multiStagedAttack`, `compromisedUser`, `phishing`, `maliciousUserActivity`, `clean`, `insufficientData`, `confirmedUserActivity`, `lineOfBusinessApplication`, `unknownFutureValue`.|
+|determination|[microsoft.graph.security.alertDetermination](#alertdetermination-values)| Specifies the result of the investigation, whether the alert represents a true attack, and if so, the nature of the attack. Possible values are: `unknown`, `apt`, `malware`, `securityPersonnel`, `securityTesting`, `unwantedSoftware`, `other`, `multiStagedAttack`, `compromisedAccount`, `phishing`, `maliciousUserActivity`, `notMalicious`, `notEnoughDataToValidate`, `confirmedUserActivity`, `lineOfBusinessApplication`, `unknownFutureValue`.|
|evidence|[microsoft.graph.security.alertEvidence](security-alertEvidence.md) collection| Collection of evidence related to the alert.| |firstActivityDateTime|DateTimeOffset| The earliest activity associated with the alert.| |id|String| Unique identifier to represent the **alert** resource.|
Security providers create an alert in the system when they detect a threat. Micr
| securityPersonnel | A true positive alert that detected valid suspicious activity performed by someone on the customer's security team. | | securityTesting | The alert detected valid suspicious activity that was performed as part of a known security testing. | | unwantedSoftware | The alert detected unwanted software. |
+| other | Other determination. |
| multiStagedAttack | A true positive alert that detected multiple kill-chain attack stages. | | compromisedAccount | A true positive alert that detected that the intended user's credentials were compromised or stolen. | | phishing | A true positive alert that detected a phishing email. |
Security providers create an alert in the system when they detect a threat. Micr
| notEnoughDataToValidate | A false alert, without enough information to prove otherwise. | | confirmedActivity | The alert caught a true suspicious activity that is considered OK because it's a known user activity. | | lineOfBusinessApplication | The alert caught a true suspicious activity that is considered OK because it's a known and confirmed internal application. |
-| other | Other determination. |
| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | ### alertSeverity values
v1.0 Security Api Overview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-api-overview.md
You can create advanced hunting [Custom detection rules](/microsoft-365/security
Alerts are detailed warnings about suspicious activities in a customer's tenant that Microsoft or partner security providers have identified and flagged for action. Attacks typically employ various techniques against different types of entities, such as devices, users, and mailboxes. The result is alerts from multiple security providers for multiple entities in the tenant. Piecing the individual alerts together to gain insight into an attack can be challenging and time-consuming. The beta version of the security API offers two types of alerts that aggregate other alerts from security providers and make analyzing attacks and determining responses easier:-- [Alerts and incidents](#alerts-and-incidents) - the latest generation of alerts in the Microsoft Graph security API. They are represented by the [alert](security-alert.md) resource and its collection, [incident](security-incident.md) resource, defined in the `microsoft.graph.security` namespace.-- [Legacy alerts](#legacy-alerts) - the first generation of alerts in the Microsoft Graph security API. They are represented by the [alert](alert.md) resource defined in the `microsoft.graph` namespace.
+- [Alerts and incidents](#alerts-and-incidents) - the latest generation of alerts in the Microsoft Graph security API. They're represented by the [alert](security-alert.md) resource and its collection, [incident](security-incident.md) resource, defined in the `microsoft.graph.security` namespace.
+- [Legacy alerts](#legacy-alerts) - the first generation of alerts in the Microsoft Graph security API. They're represented by the [alert](alert.md) resource defined in the `microsoft.graph` namespace.
### Alerts and incidents
Alerts from the following security providers are available via the legacy **aler
\* File issue: Alert status gets updated across Microsoft Graph security API integrated applications but not reflected in the providerΓÇÖs management experience.
-\*\* Microsoft Defender for Endpoint requires additional [user roles](/windows/security/threat-protection/microsoft-defender-atp/user-roles) to those required by the Microsoft Graph security API. Only the users in both Microsoft Defender for Endpoint and Microsoft Graph security API roles can have access to the Microsoft Defender for Endpoint data. Because application-only authentication is not limited by this, we recommend that you use an application-only authentication token.
+\*\* Microsoft Defender for Endpoint requires additional [user roles](/windows/security/threat-protection/microsoft-defender-atp/user-roles) to those required by the Microsoft Graph security API. Only the users in both Microsoft Defender for Endpoint and Microsoft Graph security API roles can have access to the Microsoft Defender for Endpoint data. Because application-only authentication isn't limited by this, we recommend that you use an application-only authentication token.
\*\*\* Microsoft Defender for Identity alerts are available via the Microsoft Defender for Cloud Apps integration. This means you get Microsoft Defender for Identity alerts only if you have joined Unified SecOps and connected Microsoft Defender for Identity into Microsoft Defender for Cloud Apps. Learn more about [how to integrate Microsoft Defender for Identity and Microsoft Defender for Cloud Apps](/azure-advanced-threat-protection/atp-mcas-integration).
Alerts from the following security providers are available via the legacy **aler
[Microsoft Purview Audit](/microsoft-365/compliance/audit-solutions-overview) provides an integrated solution to help organizations effectively respond to security events, forensic investigations, internal investigations, and compliance obligations. Thousands of user and admin operations performed in dozens of Microsoft 365 services and solutions are captured, recorded, and retained in your organization's unified audit log. Audit records for these events are searchable by security ops, IT admins, insider risk teams, and compliance and legal investigators in your organization. This capability provides visibility into the activities performed across your Microsoft 365 organization.
+## Identities
+
+### Health issues
+
+The Microsoft Defender for Identity health issues API allows you to monitor the health status of your sensors and agents across your hybrid identity infrastructure. You can use the health issues API to retrieve information about the current health issues of your sensors, such as the issue type, status, configuration, and severity. You can also use the API to identify and resolve any issues that might affect the functionality or security of your sensors and agents.
+
+> **Note:** The Microsoft Defender for Identity health issues API is only available on the Defender for Identity plan or Microsoft 365 E5/A5/G5/F5 Security service plans.
+ ## Incidents An [incident](security-incident.md) is a collection of correlated  [alerts](security-alert.md) and associated data that make up the story of an attack. Incident management is part of Microsoft 365 Defender and is available in the Microsoft 365 Defender portal (https://security.microsoft.com/).
TheΓÇ» [incident](security-incident.md) resource and its APIs allow you to sort
## Records management
-Most organizations need to manage data to proactively comply with industry regulations and internal policies, reduce risk in the event of litigation or a security breach, and let their employees effectively and agiley share knowledge that is current and relevant to them. You can use the [records management APIs](../resources/security-recordsmanagement-overview.md) to systematically apply [retention labels](security-retentionlabel.md) to different types of content that require different retention settings. For example, you can configure the start of retention period from when the content was created, last modified, labeled or when an event occurs for a particular event type. Further, you can use [file plan descriptors](security-fileplandescriptor.md) to improve the manageability of these retention labels.
+Most organizations need to manage data to proactively comply with industry regulations and internal policies, reduce risk in the event of litigation or a security breach, and let their employees effectively and agilely share knowledge that is current and relevant to them. You can use the [records management APIs](../resources/security-recordsmanagement-overview.md) to systematically apply [retention labels](security-retentionlabel.md) to different types of content that require different retention settings. For example, you can configure the start of retention period from when the content was created, last modified, labeled or when an event occurs for a particular event type. Further, you can use [file plan descriptors](security-fileplandescriptor.md) to improve the manageability of these retention labels.
## Secure Score
The Microsoft Graph threat submission API helps organizations to submit a threat
> **Note:** These APIs are only available for Defender for Office 365 Plan 2 or Microsoft 365 A5/E5/F5/G5 Security service plans. For the most up-to-date list of service plans, see [Microsoft Defender for Office 365 service description](/office365/servicedescriptions/office-365-advanced-threat-protection-service-description).
-## Identities
-
-### Health Issues
-The Defender for Identity health issues API allows you to monitor the health status of your sensors and agents across your hybrid identity infrastructure. You can use the health issues API to retrieve information about the current health issues of your sensors, such as the issue type, status, configuration, and severity. You can also use the API to identify and resolve any issues that may affect the functionality or security of your sensors and agents.
## Common use cases
v1.0 Security Auditlogquery https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-auditlogquery.md
Inherits from [microsoft.graph.entity](../resources/entity.md).
|objectIdFilters|String collection|For SharePoint and OneDrive for Business activity, the full path name of the file or folder accessed by the user. For Exchange admin audit logging, the name of the object that was modified by the cmdlet.| |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).| |recordTypeFilters|microsoft.graph.security.auditLogRecordType collection|The type of operation 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`.|
-|serviceFilter|String|The Office 365 service where the activity occurred.|
+|serviceFilter|String|Refers to the workload property in the audit record. This is the Microsoft service where the activity occurred. Optional.|
|status|microsoft.graph.security.auditLogQueryStatus|Describes the current status of the query. The possible values are: `notStarted`, `running`, `succeeded`, `failed`, `cancelled`, `unknownFutureValue`.| |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_.|
v1.0 Security Healthissue https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-healthissue.md
Title: "healthIssue resource type"
-description: "Represents potential issues within a customer's Microsoft Defender for Identity configuration that Microsoft Defender for Identity identified."
+description: "Represents potential issues identified by Microsoft Defender for Identity within a customer's Microsoft Defender for Identity configuration."
ms.localizationpriority: medium doc_type: resourcePageType
Namespace: microsoft.graph.security
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Represents potential issues within a customer's Microsoft Defender for Identity configuration that Microsoft Defender for Identity identified.
+Represents potential issues identified by Microsoft Defender for Identity within a customer's Microsoft Defender for Identity configuration.
-Inherits from [microsoft.graph.entity](../resources/entity.md).
+Inherits from [entity](../resources/entity.md).
## Methods |Method|Return type|Description|
Inherits from [microsoft.graph.entity](../resources/entity.md).
|Property|Type|Description| |:|:|:| |additionalInformation|String collection|Contains additional information about the issue, such as a list of items to fix.|
-|createdDateTime|DateTimeOffset|The date and time of when the health issue was generated.|
+|createdDateTime|DateTimeOffset|The date and time when the health issue was generated. 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`.|
|description|String|Contains more detailed information about the health issue.| |displayName|String|The display name of the health issue.| |domainNames|String collection|A list of the fully qualified domain names of the domains or the sensors the health issue is related to.| |healthIssueType|[microsoft.graph.security.healthIssueType](#healthissuetype-values)|The type of the health issue. The possible values are: `sensor`, `global`, `unknownFutureValue`. For a list of all health issues and their identifiers, see [Microsoft Defender for Identity health issues](/defender-for-identity/health-alerts). |
-|ID|String|A unique identifier that represents the health issue.|
+|id|String|A unique identifier that represents the health issue. Inherited from [entity](../resources/entity.md).|
|issueTypeId|String|The type identifier of the health issue. For a list of all health issues and their identifiers, see [Microsoft Defender for Identity health issues](/defender-for-identity/health-alerts).|
-|lastModifiedDateTime|DateTimeOffset|The date and time of when the health issue was last updated.|
-|recommendations|String collection|This field contains a list of recommended actions that can be taken to resolve the issue effectively and efficiently. These actions might include how to investigate the issue further. Not limited to prewritten responses.|
-|recommendedActionCommands|String collection|Contains a list of commands from the product's PowerShell module that can be used to resolve the issue, if available. If there aren't any commands that can be used to solve the issue, this field is empty. The commands, if present, provide a quick and efficient way to address the issue. The commands run in order for the single recommended fix.|
-|sensorDNSNames|String collection|A list of the dns names of the sensors the health issue is related to.|
+|lastModifiedDateTime|DateTimeOffset|The date and time when the health issue was last updated. 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`.|
+|recommendations|String collection|A list of recommended actions that can be taken to resolve the issue effectively and efficiently. These actions might include instructions for further investigation and aren't limited to prewritten responses.|
+|recommendedActionCommands|String collection|A list of commands from the PowerShell module for the product that can be used to resolve the issue, if available. If no commands can be used to solve the issue, this property is empty. The commands, if present, provide a quick and efficient way to address the issue. These commands run in sequence for the single recommended fix.|
+|sensorDNSNames|String collection|A list of the DNS names of the sensors the health issue is related to.|
|severity|[microsoft.graph.security.healthIssueSeverity](#healthissueseverity-values)|The severity of the health issue. The possible values are: `low`, `medium`, `high`, `unknownFutureValue`.| |status|[microsoft.graph.security.healthIssueStatus](#healthissuestatus-values)|The status of the health issue. The possible values are: `open`, `closed`, `suppressed`, `unknownFutureValue`.|
-#### healthIssueSeverity values
+### healthIssueSeverity values
| Member | Description | | :--| : |
Inherits from [microsoft.graph.entity](../resources/entity.md).
| high | High severity health issues indicate critical issues that could have a severe impact on your environment. These issues require immediate attention and action. | | unknownFutureValue | Evolvable enumeration sentinel value. Don't use.|
-#### healthIssueStatus values
+### healthIssueStatus values
| Member | Description | | :--| : |
Inherits from [microsoft.graph.entity](../resources/entity.md).
| suppressed | The operator suppressed the issue manually. | | unknownFutureValue | Evolvable enumeration sentinel value. Don't use.|
-#### healthIssueType values
+### healthIssueType values
| Member | Description | | :--| : |
-| Sensor | The issue is on specific sensor. |
-| Global | The issue is in the Defender for identity system configuration. |
+| sensor | The issue is on specific sensor. |
+| global | The issue is in the Defender for identity system configuration. |
| unknownFutureValue | Evolvable enumeration sentinel value. Don't use.| ## Relationships
None.
The following JSON representation shows the resource type. <!-- { "blockType": "resource",
- "keyProperty": "ID",
+ "keyProperty": "id",
"@odata.type": "microsoft.graph.security.healthIssue", "baseType": "microsoft.graph.entity", "openType": false
The following JSON representation shows the resource type.
``` json { "@odata.type": "#microsoft.graph.security.healthIssue",
- "ID": "String (identifier)",
+ "additionalInformation": ["String"],
+ "createdDateTime": "String (timestamp)",
+ "description": "String",
"displayName": "String",
+ "domainNames": ["String"],
"healthIssueType": "String",
+ "id": "String (identifier)",
"issueTypeId": "String",
- "severity": "String",
- "status": "String",
- "createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
- "domainNames": [
- "String"
- ],
- "sensorDNSNames": [
- "String"
- ],
- "description": "String",
- "recommendations": [
- "String"
- ],
- "recommendedActionCommands": [
- "String"
- ],
- "additionalInformation": [
- "String"
- ]
+ "recommendations": ["String"],
+ "recommendedActionCommands": ["String"],
+ "sensorDNSNames": ["String"],
+ "severity": "String",
+ "status": "String"
} ```
v1.0 Security Identitycontainer https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-identitycontainer.md
Title: "identityContainer resource type"
-description: "A container for security identities APIs."
+description: "Represents a container for security identities APIs that currently exposes the [healthIssues](security-healthissue.md) relationship."
ms.localizationpriority: medium doc_type: resourcePageType
Namespace: microsoft.graph.security
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-A container for security identities APIs. Currently exposes the [healthIssues](security-healthissue.md) relationship.
+Represents a container for security identities APIs that currently exposes the [healthIssues](security-healthissue.md) relationship.
## Methods
None.
|Relationship|Type|Description| |:|:|:|
-|healthIssues|[microsoft.graph.security.healthIssue](security-healthissue.md) collection| Represents potential issues within a customer's Microsoft Defender for Identity configuration that Microsoft Defender for Identity identified.|
+|healthIssues|[microsoft.graph.security.healthIssue](security-healthissue.md) collection| Represents potential issues identified by Microsoft Defender for Identity within a customer's Microsoft Defender for Identity configuration.|
## JSON representation
v1.0 Serviceprincipal https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/serviceprincipal.md
This resource supports using [delta query](/graph/delta-query-overview) to track
|notificationEmailAddresses|String collection|Specifies the list of email addresses where Microsoft Entra ID sends a notification when the active certificate is near the expiration date. This is only for the certificates used to sign the SAML token issued for Microsoft Entra Gallery applications.| |passwordCredentials|[passwordCredential](passwordcredential.md) collection|The collection of password credentials associated with the service principal. Not nullable. | |passwordSingleSignOnSettings|[passwordSingleSignOnSettings](passwordsinglesignonsettings.md)|The collection for settings related to password single sign-on. Use `$select=passwordSingleSignOnSettings` to read the property. Read-only for [applicationTemplates](applicationTemplate.md) except for custom applicationTemplates. |
-|preferredSingleSignOnMode|string|Specifies the single sign-on mode configured for this application. Microsoft Entra ID uses the preferred single sign-on mode to launch the application from Microsoft 365 or the Microsoft Entra My Apps. The supported values are `password`, `saml`, `notSupported`, and `oidc`.|
+|preferredSingleSignOnMode|string|Specifies the single sign-on mode configured for this application. Microsoft Entra ID uses the preferred single sign-on mode to launch the application from Microsoft 365 or the Microsoft Entra My Apps. The supported values are `password`, `saml`, `notSupported`, and `oidc`. **Note:** This field might be `null` for older SAML apps and for OIDC applications where it isn't set automatically.|
|permissionGrantPreApprovalPolicies|[permissionGrantPreApprovalPolicy](../resources/permissiongrantpreapprovalpolicy.md) collection|The list of preapproval policies that has been assigned to the service principal.| |preferredTokenSigningKeyEndDateTime|DateTimeOffset|Specifies the expiration date of the keyCredential used for token signing, marked by **preferredTokenSigningKeyThumbprint**. Updating this attribute isn't currently supported. For details, see [ServicePrincipal property differences](/graph/migrate-azure-ad-graph-property-differences#serviceprincipal-property-differences).| |preferredTokenSigningKeyThumbprint|String|This property can be used on SAML applications (apps that have **preferredSingleSignOnMode** set to `saml`) to control which certificate is used to sign the SAML responses. For applications that aren't SAML, don't write or otherwise rely on this property. |
v1.0 Shareddriveitem https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/shareddriveitem.md
+ Title: sharedDriveItem resource type
description: The sharedDriveItem resource is returned when using the Shares API to access a shared driveItem. Previously updated : 09/10/2017 Title: SharedDriveItem ms.localizationpriority: medium doc_type: resourcePageType
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-The **sharedDriveItem** resource is returned when using the [Shares](../api/shares-get.md) API to access a shared [driveItem](driveitem.md).
+The **sharedDriveItem** resource is returned when using the [shares](../api/shares-get.md) API to access a shared [driveItem](driveitem.md).
-## JSON representation
-
-Here is a JSON representation of the **sharedDriveItem** resource.
+The **sharedDriveItem** resource is derived from [baseItem](baseitem.md) and inherits properties from that resource.
-The **sharedDriveItem** resource is derived from [**baseItem**](baseitem.md) and inherits properties from that resource.
+For more information about the facets on a DriveItem, see [driveItem](driveitem.md).
-<!-- {
- "blockType": "resource",
- "baseType": "microsoft.graph.baseItem",
- "optionalProperties": [ ],
- "@odata.type": "microsoft.graph.sharedDriveItem"
-}-->
-
-```json
-{
- "id": "string",
- "name": "string",
- "owner": { "@odata.type": "microsoft.graph.identitySet" },
+## Methods
- "driveItem": { "@odata.type": "microsoft.graph.driveItem" },
- "items": [ { "@odata.type": "microsoft.graph.driveItem" }],
- "list": { "@odata.type": "microsoft.graph.list" },
- "listItem": { "@odata.type": "microsoft.graph.listItem" },
- "permission": { "@odata.type": "microsoft.graph.permission" },
- "site": { "@odata.type": "microsoft.graph.site" }
-}
-```
+| Method | Return Type | Description |
+|:|:--|:|
+| [Use sharing links](../api/shares-get.md) | [sharedDriveItem](shareddriveitem.md) | Access a shared item or a collection of shared items by using a **shareId** or sharing URL. |
## Properties
The **sharedDriveItem** resource is derived from [**baseItem**](baseitem.md) and
| :- | :- | : | | id | String | The unique identifier for the share being accessed. | | name | String | The display name of the shared item. |
-| owner | [IdentitySet](identityset.md) | Information about the owner of the shared item being referenced. |
+| owner | [identitySet](identityset.md) | Information about the owner of the shared item being referenced. |
## Relationships
-| Relationship | Type | Description |
-| -- | : | :- |
-| **driveItem** | [**driveItem**][driveItem] | Used to access the underlying **driveItem** |
-| **list** | [**list**][list] | Used to access the underlying **list** |
-| **listItem** | [**listItem**][listItem] | Used to access the underlying **listItem** |
-| **permission** | [**permission**][permission] | Used to access the **permission** representing the underlying sharing link |
-| **site** | [**site**][site] | Used to access the underlying **site** |
+| Relationship name | Type | Description |
+| |:-|:|
+| driveItem | [driveItem][driveItem] | Used to access the underlying driveItem |
+| list | [list][list] | Used to access the underlying list |
+| listItem | [listItem][listItem] | Used to access the underlying listItem |
+| permission | [permission][permission] | Used to access the permission representing the underlying sharing link |
+| site | [site][site] | Used to access the underlying site |
Alternatively, for **driveItems** shared from personal OneDrive accounts, the following relationships may also be used.
-| Relationship name | Type | Description |
-| -- | : | :- |
-| **items** | [**driveItem**][driveItem] collection | All driveItems contained in the sharing root. This collection cannot be enumerated. |
-| **driveItem** | [**driveItem**][driveItem] | Used to access the underlying **driveItem** |
+| Relationship name | Type | Description |
+| |:-|:|
+| items | [driveItem][driveItem] collection | All driveItems contained in the sharing root. This collection cannot be enumerated. |
[driveItem]: driveitem.md [list]: list.md
Alternatively, for **driveItems** shared from personal OneDrive accounts, the fo
[permission]: permission.md [site]: site.md
-## Methods
+## JSON representation
-| Method | REST Path |
-| :-- | :-- |
-| [Use sharing links](../api/shares-get.md) | `GET /shares/{share-id}` |
+The following JSON representation shows the resource.
-## Remarks
+<!-- {
+ "blockType": "resource",
+ "baseType": "microsoft.graph.baseItem",
+ "optionalProperties": [ ],
+ "@odata.type": "microsoft.graph.sharedDriveItem"
+}-->
-For more information about the facets on a DriveItem, see [DriveItem](driveitem.md).
+```json
+{
+ "id": "string",
+ "name": "string",
+ "owner": { "@odata.type": "microsoft.graph.identitySet" },
+
+ "driveItem": { "@odata.type": "microsoft.graph.driveItem" },
+ "items": [ { "@odata.type": "microsoft.graph.driveItem" }],
+ "list": { "@odata.type": "microsoft.graph.list" },
+ "listItem": { "@odata.type": "microsoft.graph.listItem" },
+ "root": { "@odata.type": "microsoft.graph.driveItem" },
+ "site": { "@odata.type": "microsoft.graph.site" }
+}
+```
<!-- {
v1.0 Sharepointprotectionpolicy https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/sharepointprotectionpolicy.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Represents a plan defined by the SharePoint Online Admin to protect SharePoint Online, including what data to protect, when to protect it, and for what time period to retain the protected data.
+Represents a plan defined by the SharePoint Online admin to protect SharePoint Online, including what data to protect, when to protect it, and for what time period to retain the protected data. Currently, policies are supported only for SharePoint Online sites in the main geolocation only; multi-geo tenants aren't supported.
Inherits from [protectionPolicyBase](../resources/protectionpolicybase.md).
v1.0 Signin https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/signin.md
The [Microsoft Entra data retention policies](/azure/active-directory/reports-mo
|homeTenantId|String|The tenant identifier of the user initiating the sign-in. Not applicable in Managed Identity or service principal sign ins.| |homeTenantName|String|For user sign ins, the identifier of the tenant that the user is a member of. Only populated in cases where the home tenant provides affirmative consent to Microsoft Entra ID to show the tenant content.| |id|String|The identifier representing the sign-in activity. Inherited from [entity](entity.md). <br/><br/> Supports `$filter` (`eq`).|
-|incomingTokenType|incomingTokenType|Indicates the token types that were presented to Microsoft Entra ID to authenticate the actor in the sign in. The possible values are: `none`, `primaryRefreshToken`, `saml11`, `saml20`, `unknownFutureValue`, `remoteDesktopToken`. <br><br> **NOTE** Microsoft Entra ID might have also used token types not listed in this enum type to authenticate the actor. Don't infer the lack of a token if it isn't one of the types listed. Also, you must use the `Prefer: include-unknown-enum-members` request header to get the following value or values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `remoteDesktopToken`.|
+|incomingTokenType|incomingTokenType|Indicates the token types that were presented to Microsoft Entra ID to authenticate the actor in the sign in. The possible values are: `none`, `primaryRefreshToken`, `saml11`, `saml20`, `unknownFutureValue`, `remoteDesktopToken`, `refreshToken`. <br><br> **NOTE** Microsoft Entra ID might have also used token types not listed in this enum type to authenticate the actor. Don't infer the lack of a token if it isn't one of the types listed. Also, you must use the `Prefer: include-unknown-enum-members` request header to get the following value or values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `remoteDesktopToken`, `refreshToken`.|
|ipAddress|String|The IP address of the client from where the sign-in occurred. <br/><br/> Supports `$filter` (`eq`, `startsWith`).| |ipAddressFromResourceProvider|String|The IP address a user used to reach a resource provider, used to determine Conditional Access compliance for some policies. For example, when a user interacts with Exchange Online, the IP address that Microsoft Exchange receives from the user can be recorded here. This value is often `null`.| |isInteractive|Boolean|Indicates whether a user sign in is interactive. In interactive sign in, the user provides an authentication factor to Microsoft Entra ID. These factors include passwords, responses to MFA challenges, biometric factors, or QR codes that a user provides to Microsoft Entra ID or an associated app. In non-interactive sign in, the user doesn't provide an authentication factor. Instead, the client app uses a token or code to authenticate or access a resource on behalf of a user. Non-interactive sign ins are commonly used for a client to sign in on a user's behalf in a process transparent to the user.|
v1.0 Strongauthenticationrequirements https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/strongauthenticationrequirements.md
Captures settings relating to per-user Microsoft Entra multifactor authenticatio
## Properties |Property|Type|Description| |:|:|:|
-|perUserMfaState|perUserMfaState|Sets the per-user MFA state for the user. The possible values are: `disabled`, `enforced`, `enabled`, `unknownFutureValue`.|
+|perUserMfaState|perUserMfaState|Sets the per-user MFA state for the user. The possible values are: `disabled`, `enforced`, `enabled`, `unknownFutureValue`. When you update a user's MFA state to `enabled` and the user has already registered an MFA method, their state changes automatically to `enforced`.|
## Relationships None.
v1.0 Tasks Overview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/tasks-overview.md
ms.localizationpriority: high doc_type: conceptualPageType
+toc. Title: To-do tasks API overview (deprecated)
# Use the To Do API built on base tasks in Microsoft Graph (deprecated)
v1.0 Teamdiscoverysettings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teamdiscoverysettings.md
Title: "teamDiscoverySettings resource type" description: "Settings to configure team discoverability by others." ms.localizationpriority: medium-+ doc_type: resourcePageType
v1.0 Teamfunsettings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teamfunsettings.md
Title: "teamFunSettings resource type" description: "Settings to configure use of Giphy, memes, and stickers in the team." ms.localizationpriority: medium-+ doc_type: resourcePageType
v1.0 Teamguestsettings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teamguestsettings.md
Title: "teamGuestSettings resource type" description: "Settings to configure whether guests can create, update, or delete channels in the team." ms.localizationpriority: medium-+ doc_type: resourcePageType
v1.0 Teammessagingsettings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teammessagingsettings.md
Title: "teamMessagingSettings resource type" description: "Settings to configure messaging and mentions in the team."-+ ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Teams Api Overview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teams-api-overview.md
Title: "Use the Microsoft Graph API to work with Microsoft Teams" description: "Microsoft Teams is a chat-based workspace in Microsoft 365 that provides built-in access to team-specific calendars, files, OneNote notes, Planner plans, and more." ms.localizationpriority: high-+ doc_type: conceptualPageType
v1.0 Teamsapp https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teamsapp.md
Title: "teamsApp resource type" description: "Represents an app in the Microsoft Teams app catalog."-+ ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Teamsappauthorization https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teamsappauthorization.md
The authorization details of a [teamsApp](teamsapp.md).
## Properties |Property|Type|Description| |:|:|:|
+|clientAppId|String|The registration ID of the Microsoft Entra app ID associated with the [teamsApp](teamsapp.md). |
|requiredPermissionSet|[teamsAppPermissionSet](../resources/teamsapppermissionset.md)|Set of permissions required by the [teamsApp](teamsapp.md).| ## Relationships
The following JSON representation shows the resource type.
``` json { "@odata.type": "#microsoft.graph.teamsAppAuthorization",
+ "clientAppId": "String",
"requiredPermissionSet": { "@odata.type": "microsoft.graph.teamsAppPermissionSet" } } ```-
v1.0 Teamsappdefinition https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teamsappdefinition.md
Title: "teamsAppDefinition resource type" description: "The details of one version of a teamsApp."-+ ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Teamsappinstalledstate https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teamsappinstalledstate.md
Title: "Members" description: "Describes the current installation status of a teamsApp."-+ ms.localizationpriority: medium doc_type: enumPageType
v1.0 Teamsasyncoperation https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teamsasyncoperation.md
Title: "teamsAsyncOperation resource type" description: "A Microsoft Teams async operation is an operation that transcends the lifetime of a single API request. "-+ ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Teamsasyncoperationstatus https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teamsasyncoperationstatus.md
Title: "teamsAsyncOperationStatus enum type" description: "Describes the current status of a teamsAsyncOperation."-+ ms.localizationpriority: medium doc_type: enumPageType
v1.0 Teamsasyncoperationtype https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teamsasyncoperationtype.md
Title: "teamsAsyncOperationType enum type" description: "Types of teamsAsyncOperation. Members are added here as more async operations are supported."-+ ms.localizationpriority: medium doc_type: enumPageType
v1.0 Teamscatalogapp https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teamscatalogapp.md
Title: "teamsCatalogApp resource type" description: "see teamsApp."-+ ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Teamspecialization https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teamspecialization.md
Title: "teamSpecialization enum type" description: "Describes the special use case for a team."-+ ms.localizationpriority: medium doc_type: enumPageType
v1.0 Teamstabconfiguration https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teamstabconfiguration.md
Title: "teamsTabConfiguration resource type (Open Type)" description: "The settings that determine the content of a tab."-+ ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Teamstemplate https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teamstemplate.md
Title: "teamsTemplate resource type" description: "Describes the teamsTemplate entity."-+ ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Teamtemplate https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teamtemplate.md
Title: "teamTemplate resource type" description: "Represents a logical container for all the definitions and versions of the same team template."-+ ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Teamvisibilitytype https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teamvisibilitytype.md
Title: "Members" description: "Describes the visibility of a team. "-+ ms.localizationpriority: medium doc_type: enumPageType
v1.0 Teamwork https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teamwork.md
Inherits from [entity](../resources/entity.md).
|:|:|:| |id|string|The default teamwork identifier.| |isTeamsEnabled|Boolean|Indicates whether Microsoft Teams is enabled for the organization.|
-|region|string|Represents the region of the organization or the tenant. The **region** value can be any region supported by the Teams payload. The possible values are: `Americas`, `Europe and MiddleEast`, `Asia Pacific`, `UAE`, `Australia`, `Brazil`, `Canada`, `Switzerland`, `Germany`, `France`, `India`, `Japan`, `South Korea`, `Norway`, `Singapore`, `United Kingdom`, `South Africa`, `Sweden`, `Qatar`, `Poland`, `Italy`, `Israe`l, `USGov Community Cloud`, `USGov Community Cloud High`, `USGov Department of Defense`, and `China`.|
+|region|string|Represents the region of the organization or the tenant. The **region** value can be any region supported by the Teams payload. The possible values are: `Americas`, `Europe and MiddleEast`, `Asia Pacific`, `UAE`, `Australia`, `Brazil`, `Canada`, `Switzerland`, `Germany`, `France`, `India`, `Japan`, `South Korea`, `Norway`, `Singapore`, `United Kingdom`, `South Africa`, `Sweden`, `Qatar`, `Poland`, `Italy`, `Israel`, `Spain`, `Mexico`, `USGov Community Cloud`, `USGov Community Cloud High`, `USGov Department of Defense`, and `China`.|
## Relationships | Relationship | Type | Description |
v1.0 User https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/user.md
For example, Cameron is an administrator of a directory for an elementary school
|scopedRoleMemberOf|[scopedRoleMembership](scopedrolemembership.md) collection| The scoped-role administrative unit memberships for this user. Read-only. Nullable.| |security|[security](security.md) |Nullable.| |settings|[userSettings](usersettings.md) | Read-only. Nullable.|
+|solutions|[userSolutionRoot](../resources/usersolutionroot.md)| Represents a user's custom solution entity. Read-Only. Nullable.|
|sponsors|[directoryObject](../resources/directoryobject.md) collection|The users and groups responsible for this guest user's privileges in the tenant and keep the guest user's information and access updated. (HTTP Methods: GET, POST, DELETE.). Supports `$expand`.| |teamwork|[userTeamwork](userteamwork.md)| A container for Microsoft Teams features available for the user. Read-only. Nullable.| |todo|[todo](todo.md)|Represents the To Do services available to a user. |
v1.0 Usersolutionroot https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/usersolutionroot.md
+
+ Title: "userSolutionRoot resource type"
+description: "Represents a user's custom userSolutionRoot entity."
+
+ms.localizationpriority: medium
+++
+# userSolutionRoot resource type
+
+Namespace: microsoft.graph
++
+Represents a user's custom solution entity.
+
+## Properties
+
+|Property|Type|Description|
+|:|:|:|
+|id|String|A unique programmatic identifier for the entity. Read-only.|
+
+## Relationships
+
+|Relationship|Type|Description|
+|:|:|:|
+|workingTimeSchedule|[workingTimeSchedule](../resources/workingtimeschedule.md)|The working time schedule entity associated with the solution.|
+
+## JSON representation
+
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.userSolutionRoot",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.userSolutionRoot",
+ "id": "String (identifier)"
+}
+```
v1.0 Userteamwork https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/userteamwork.md
Represents a container for the range of Microsoft Teams functionalities that are
|:|:--|:-| |id| String|The unique identifier for the **userTeamwork** object.| |locale|String |Represents the location that a user selected in Microsoft Teams and doesn't follow the Office's locale setting. A userΓÇÖs locale is represented by their preferred language and country or region. For example, `en-us`. The language component follows two-letter codes as defined in [ISO 639-1](https://www.iso.org/iso/home/standards/language_codes.htm), and the country component follows two-letter codes as defined in [ISO 3166-1 alpha-2](https://www.iso.org/iso/country_codes.htm).|
-|region|string|Represents the region of the organization or the user. For users with multigeo licenses, the property contains the user's region (if available). For users without multigeo licenses, the property contains the organization's region.<br><br>The **region** value can be any region supported by the Teams payload. The possible values are: `Americas`, `Europe and MiddleEast`, `Asia Pacific`, `UAE`, `Australia`, `Brazil`, `Canada`, `Switzerland`, `Germany`, `France`, `India`, `Japan`, `South Korea`, `Norway`, `Singapore`, `United Kingdom`, `South Africa`, `Sweden`, `Qatar`, `Poland`, `Italy`, `Israe`l, `USGov Community Cloud`, `USGov Community Cloud High`, `USGov Department of Defense`, and `China`.|
+|region|string|Represents the region of the organization or the user. For users with multigeo licenses, the property contains the user's region (if available). For users without multigeo licenses, the property contains the organization's region.<br><br>The **region** value can be any region supported by the Teams payload. The possible values are: `Americas`, `Europe and MiddleEast`, `Asia Pacific`, `UAE`, `Australia`, `Brazil`, `Canada`, `Switzerland`, `Germany`, `France`, `India`, `Japan`, `South Korea`, `Norway`, `Singapore`, `United Kingdom`, `South Africa`, `Sweden`, `Qatar`, `Poland`, `Italy`, `Israel`, `Spain`, `Mexico`, `USGov Community Cloud`, `USGov Community Cloud High`, `USGov Department of Defense`, and `China`.|
## Relationships
v1.0 Virtualendpoint https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/virtualendpoint.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-> [!CAUTION]
-> The **cloudPcSharedUseServicePlan** resource is deprecated and stopped returning data on October 8, 2023. Existing apps that use this feature with the **cloudPcSharedUseServicePlan** should be updated.
- Represents a container for APIs to manage Cloud PCs. Use the Cloud PC API to provision and manage virtual desktops for employees in an organization, or along with the [Intune API](../resources/intune-graph-overview.md) to manage physical and virtual endpoints.
Inherits from [entity](../resources/entity.md).
|[List external partner settings](../api/virtualendpoint-list-externalpartnersettings.md)|[cloudPcExternalPartnerSetting](../resources/cloudpcexternalpartnersetting.md) collection|Get a list of the [cloudPcExternalPartnerSetting](../resources/cloudpcexternalpartnersetting.md) objects and their properties.| |[Create external partner setting](../api/virtualendpoint-post-externalpartnersettings.md)|[cloudPcExternalPartnerSetting](../resources/cloudpcexternalpartnersetting.md)|Create a new [cloudPcExternalPartnerSetting](../resources/cloudpcexternalpartnersetting.md) object.| |[List front line service plans](../api/virtualendpoint-list-frontlineserviceplans.md) |[cloudPcFrontLineServicePlan](../resources/cloudpcfrontlineserviceplan.md) collection|Get a list of the [cloudPcFrontLineServicePlan](../resources/cloudpcfrontlineserviceplan.md) objects and their properties.|
-|[List shared use service plans](../api/virtualendpoint-list-shareduseserviceplans.md) (deprecated)|[cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.md) collection|List properties and relationships of the [cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.md) objects.|
|[List bulk actions](../api/virtualendpoint-list-bulkactions.md)|[cloudPcBulkAction](../resources/cloudpcbulkaction.md) collection|Get a list of the [cloudPcBulkAction](../resources/cloudpcbulkaction.md) objects and their properties.| |[Create bulk action](../api/virtualendpoint-post-bulkactions.md)|[cloudPcBulkAction](../resources/cloudpcbulkaction.md)|Create a new [cloudPcBulkAction](../resources/cloudpcbulkaction.md) object.| |[Retrieve tenant encryption setting](../api/virtualendpoint-retrievetenantencryptionsetting.md)|[cloudPcTenantEncryptionSetting](../resources/cloudPcTenantEncryptionSetting.md)|Retrieve the [cloudPcTenantEncryptionSetting](../resources/cloudPcTenantEncryptionSetting.md) associated with the current authenticated user.|
Inherits from [entity](../resources/entity.md).
|snapshots|[cloudPcSnapshot](../resources/cloudpcsnapshot.md) collection|Cloud PC snapshots.| |supportedRegions|[cloudPcSupportedRegion](../resources/cloudpcsupportedregion.md) collection|Cloud PC supported regions.| |userSettings|[cloudPcUserSetting](../resources/cloudpcusersetting.md) collection|Cloud PC user settings. |
-|sharedUseServicePlans (deprecated)|[cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.md) collection|Cloud PC shared-use service plans. The **sharedUseServicePlans** relationship is deprecated and stopped returning data on October 8, 2023. Going forward, use the **frontLineServicePlans** relationship.|
|tenantEncryptionSetting|[cloudPcTenantEncryptionSetting](../resources/cloudPcTenantEncryptionSetting.md) collection|Cloud PC encryption setting for a tenant. | ## JSON representation
v1.0 Virtualeventsession https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/virtualeventsession.md
Namespace: microsoft.graph
Represents a session in a [virtualEvent](../resources/virtualevent.md).
-Inherits from [onlineMeetingBase](../resources/onlinemeetingBase.md).
+Inherits from [onlineMeetingBase](../resources/onlinemeetingbase.md).
## Methods
Inherits from [onlineMeetingBase](../resources/onlinemeetingBase.md).
| Property | Type | Description | | :-- | :-- | : |
-| allowAttendeeToEnableCamera | Boolean | Indicates whether attendees can turn on their camera. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| allowAttendeeToEnableMic | Boolean | Indicates whether attendees can turn on their microphone. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| allowMeetingChat | [meetingChatMode](#meetingchatmode-values) | Specifies the mode of meeting chat. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| allowParticipantsToChangeName | Boolean | Specifies whether participants are allowed to rename themselves in an instance of the meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| allowTeamworkReactions | Boolean | Indicates whether Teams reactions are enabled for the virtual event session. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| allowTranscription | Boolean | Indicates whether transcription is enabled for the virtual event session. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| allowRecording | Boolean | Indicates whether recording is enabled for the virtual event session. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| allowedPresenters | [onlineMeetingPresenters](#onlinemeetingpresenters-values)| Specifies who can be a presenter in a virtual event session. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| anonymizeIdentityForRoles | onlineMeetingRole collection | Specifies whose identity is anonymized in the virtual event session. Possible values are: `attendee`. The `attendee` value can't be removed through a PATCH operation once added. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md).|
-| audioConferencing | [audioConferencing](audioconferencing.md) | The phone access (dial-in) information for the virtual event session. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| chatInfo | [chatInfo](chatinfo.md) | The chat information associated with the virtual event session. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
+| allowAttendeeToEnableCamera | Boolean | Indicates whether attendees can turn on their camera. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| allowAttendeeToEnableMic | Boolean | Indicates whether attendees can turn on their microphone. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| allowBreakoutRooms | Boolean | Indicates whether breakout rooms are enabled for the virtual event session. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| allowedPresenters | [onlineMeetingPresenters](#onlinemeetingpresenters-values)| Specifies who can be a presenter in a virtual event session. Possible values are: `everyone`, `organization`, `roleIsPresenter`, `organizer`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| allowLiveShare | [meetingLiveShareOptions](#meetingliveshareoptions-values) | Indicates whether live share is enabled for the virtual event session. Possible values are: `enabled`, `disabled`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| allowMeetingChat | [meetingChatMode](#meetingchatmode-values) | Specifies the mode of meeting chat. Possible values are: `enabled`, `disabled`, `limited`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| allowParticipantsToChangeName | Boolean | Specifies whether participants are allowed to rename themselves in an instance of the meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| allowPowerPointSharing | Boolean | Indicates whether PowerPoint live is enabled for the virtual event session. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| allowRecording | Boolean | Indicates whether recording is enabled for the virtual event session. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| allowTeamworkReactions | Boolean | Indicates whether Teams reactions are enabled for the virtual event session. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| allowTranscription | Boolean | Indicates whether transcription is enabled for the virtual event session. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| allowWhiteboard | Boolean | Indicates whether whiteboard is enabled for the virtual event session. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| anonymizeIdentityForRoles | onlineMeetingRole collection | Specifies whose identity is anonymized in the virtual event session. Possible values are: `attendee`. The `attendee` value can't be removed through a PATCH operation once added. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md).|
+| audioConferencing | [audioConferencing](audioconferencing.md) | The phone access (dial-in) information for the virtual event session. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| chatInfo | [chatInfo](chatinfo.md) | The chat information associated with the virtual event session. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
| endDateTime | [DateTimeTimeZone](../resources/datetimetimezone.md) | The virtual event session end time. |
-| id | String | The unique identifier of the virtual event session. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| isEntryExitAnnounced | Boolean | Indicates whether to announce when callers join or leave. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| joinInformation | [itemBody](itembody.md) | The join information of the virtual event session. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| joinMeetingIdSettings | [joinMeetingIdSettings](joinmeetingidsettings.md) | Specifies the **joinMeetingId**, the meeting passcode, and the requirement for the passcode. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| joinWebUrl | String | The join URL of the virtual event session. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| lobbyBypassSettings | [lobbyBypassSettings](lobbyBypassSettings.md) | Specifies which participants can bypass the meeting lobby. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| recordAutomatically | Boolean | Indicates whether to record the virtual event session automatically. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
+| id | String | The unique identifier of the virtual event session. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| isEntryExitAnnounced | Boolean | Indicates whether to announce when callers join or leave. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| joinInformation | [itemBody](itembody.md) | The join information of the virtual event session. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| joinMeetingIdSettings | [joinMeetingIdSettings](joinmeetingidsettings.md) | Specifies the **joinMeetingId**, the meeting passcode, and the requirement for the passcode. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| joinWebUrl | String | The join URL of the virtual event session. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| lobbyBypassSettings | [lobbyBypassSettings](lobbyBypassSettings.md) | Specifies which participants can bypass the meeting lobby. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| recordAutomatically | Boolean | Indicates whether to record the virtual event session automatically. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| shareMeetingChatHistoryDefault | [meetingChatHistoryDefaultMode](#meetingchathistorydefaultmode-values) | Specifies whether meeting chat history is shared with participants. Possible values are: `all`, `none`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
| startDateTime | [DateTimeTimeZone](../resources/datetimetimezone.md) | The virtual event session start time. |
-| subject | String | The subject of the virtual event session. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| videoTeleconferenceId | String | The video teleconferencing ID. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
-| watermarkProtection | [watermarkProtectionValues](watermarkprotectionvalues.md) | Specifies whether the client application should apply a watermark to a content type. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). |
+| subject | String | The subject of the virtual event session. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| videoTeleconferenceId | String | The video teleconferencing ID. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
+| watermarkProtection | [watermarkProtectionValues](watermarkprotectionvalues.md) | Specifies whether the client application should apply a watermark to a content type. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |
-### onlineMeetingPresenters values
+### meetingChatHistoryDefaultMode values
-| Value | Description |
-| | - |
-| everyone | Everyone is a presenter. Default. |
-| organization | Everyone in organizerΓÇÖs organization is a presenter. |
-| roleIsPresenter | Only the participants whose role is presenter are presenters. |
-| organizer | Only the organizer is a presenter. |
-| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
+| Value | Description |
+| | - |
+| all | All meeting chat history is shared. |
+| none | No meeting chat history is shared. |
+| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
### meetingChatMode values
Inherits from [onlineMeetingBase](../resources/onlinemeetingBase.md).
| | - | | enabled | Meeting chat is enabled. | | disabled | Meeting chat is disabled. |
-| limited | Meeting chat is enabled but only during the meeting call. |
+| limited | Meeting chat is enabled but only during the meeting call. |
| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
-### meetingChatHistoryDefaultMode values
+### meetingLiveShareOptions values
| Value | Description | | | - |
-| all | All meeting chat history is shared. |
-| none | No meeting chat history is shared. |
+| enabled | Meeting live share is enabled. |
+| disabled | Meeting live share is disabled. |
| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
+### onlineMeetingPresenters values
+
+| Value | Description |
+| | - |
+| everyone | Everyone is a presenter. Default. |
+| organization | Everyone in organizerΓÇÖs organization is a presenter. |
+| roleIsPresenter | Only the participants whose role is presenter are presenters. |
+| organizer | Only the organizer is a presenter. |
+| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. |
+ ## Relationships |Relationship|Type|Description|
The following JSON representation shows the resource type.
"@odata.type": "#microsoft.graph.virtualEventSession", "allowAttendeeToEnableCamera": "Boolean", "allowAttendeeToEnableMic": "Boolean",
+ "allowBreakoutRooms": "Boolean",
+ "allowedPresenters": "String",
+ "allowLiveShare": "String",
"allowMeetingChat": "String", "allowParticipantsToChangeName": "Boolean",
+ "allowPowerPointSharing": "Boolean",
+ "allowRecording": "Boolean",
"allowTeamworkReactions": "Boolean",
- "allowedPresenters": "String",
+ "allowTranscription": "Boolean",
+ "allowWhiteboard": "Boolean",
"anonymizeIdentityForRoles": ["String"], "audioConferencing": {"@odata.type": "microsoft.graph.audioConferencing"}, "chatInfo": {"@odata.type": "microsoft.graph.chatInfo"},
v1.0 Workforceintegrationencryption https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workforceintegrationencryption.md
An encryption entity defining the protocol and secret for a [workforceintegratio
|protocol|String| Possible values are: `sharedSecret`, `unknownFutureValue`.| |secret|String|Encryption shared secret.|
+## Relationships
+
+None.
+ ## JSON representation
-HEre's a JSON representation of the resource.
+The following JSON representation shows the resource type.
<!-- { "blockType": "resource",
v1.0 Workingtimeschedule https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workingtimeschedule.md
+
+ Title: "workingTimeSchedule resource type"
+description: "Represents a user's scheduled working hours."
+
+ms.localizationpriority: medium
+++
+# workingTimeSchedule resource type
+
+Namespace: microsoft.graph
++
+Represents a user's scheduled working hours.
+
+## Methods
+
+|Method|Return type|Description|
+|:|:|:|
+|[Get](../api/workingtimeschedule-get.md)|[workingTimeSchedule](../resources/workingtimeschedule.md)|Read the properties and relationships of a [workingTimeSchedule](../resources/workingtimeschedule.md) object.|
+|[Start working time](../api/workingtimeschedule-startworkingtime.md)|None|Trigger the policies associated with the start of working hours for a specific user.|
+|[End working time](../api/workingtimeschedule-endworkingtime.md)|None|Trigger the policies associated with the end of working hours for a specific user.|
+
+## Properties
+
+|Property|Type|Description|
+|:|:|:|
+|id|String|A unique programmatic identifier for the entity. Read-only.|
+
+## Relationships
+
+None.
+
+## JSON representation
+
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.workingTimeSchedule",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.workingTimeSchedule",
+ "id": "String (identifier)"
+}
+```
v1.0 Workplacesensor https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workplacesensor.md
Represents a sensor on hardware that collects and reports data on physical or en
|displayName|String|The display name of the sensor. Optional.| |placeId|String| The unique identifier of the place that the sensor detects. If the device is installed in a room equipped with a mailbox, this property should match the **ExternalDirectoryObjectId** or Microsoft Entra object ID of the room mailbox. If the sensor detects the same place as the location of the device, the property can be omitted. The default value is the place identifier of the device. Optional. | |sensorId|String| The user-defined unique identifier of the sensor on the device. If the device has multiple sensors of the same type, the property must be provided to identify each sensor. If the device has only one sensor of a type, the property can be omitted. The default value is the sensor type. Optional. |
-|sensorType|[workplaceSensorType](../resources/workplacesensor.md#workplacesensortype-values)|The type of sensor. The possible values are: `occupancy`, `peopleCount`, `inferredOccupancy`, `heartbeat`, `bagde`, `wifi`, `unknownFutureValue`. Required. |
+|sensorType|[workplaceSensorType](../resources/workplacesensor.md#workplacesensortype-values)|The type of sensor. The possible values are: `occupancy`, `peopleCount`, `inferredOccupancy`, `heartbeat`, `badge`, `unknownFutureValue`. Required. |
### workplaceSensorType values
Represents a sensor on hardware that collects and reports data on physical or en
| inferredOccupancy | The sensor estimates the occupancy status of the place based on other clues, such as the presence of a laptop or a backpack. Use it for sensors that don't directly detect motion or people count. | | heartbeat | The sensor reports the heartbeat of the device. It indicates if the device is online or not. Use it for sensors that monitor the status of the device. | | badge | The sensor reports badge-swiping events of the people. Use it for sensors that accept active user interactions. |
-| wifi | The sensor reports the device's Wi-Fi connection and disconnects events from people. Use it for sensors that connect to other devices with Wi-Fi. |
| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | ## Relationships
v1.0 Workplacesensordevicetelemetry https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workplacesensordevicetelemetry.md
Represents the data collected and reported by a sensor on a device, such as occu
|deviceId|String|The user-defined unique identifier of the device provided at the time of creation. Don't use the system generated identifier of the device.| |intValue|Int32|The value of the sensor as an integer. Use it for sensors that report numerical values, such as people count. | |sensorId|String|The user-defined unique identifier of the sensor on the device. Optional. If the device has multiple sensors of the same type, the property must be provided to identify each sensor. If the device has unique sensor types, the property can be omitted. The default value is the sensor type.|
-|sensorType|[workplaceSensorType](../resources/workplacesensor.md#workplacesensortype-values)| The type of sensor. The possible values are: `occupancy`, `peopleCount`, `inferredOccupancy`, `heartbeat`, `badge`, `wifi`, `unknownFutureValue`.|
+|sensorType|[workplaceSensorType](../resources/workplacesensor.md#workplacesensortype-values)| The type of sensor. The possible values are: `occupancy`, `peopleCount`, `inferredOccupancy`, `heartbeat`, `badge`, `unknownFutureValue`.|
|timestamp|DateTimeOffset|The date and time when the sensor measured and reported its value. 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`. |
-|eventValue| [workplaceSensorEventValue](../resources/workplacesensoreventvalue.md)| The extra values associated with badge and Wi-Fi signals. |
+|eventValue| [workplaceSensorEventValue](../resources/workplacesensoreventvalue.md)| The extra values associated with badge signals. |
|locationHint|String|The additional information to indicate the location of the device. | ## Relationships
v1.0 Workplacesensoreventvalue https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workplacesensoreventvalue.md
Title: "workplaceSensorEventValue resource type"
-description: "Represents the data collected and reported by a Wi-Fi or badge-swiping device."
+description: "Represents the data collected and reported by a badge-swiping device."
ms.localizationpriority: medium
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Represents the data collected and reported by a Wi-Fi or badge-swiping device.
+Represents the data collected and reported by a badge-swiping device.
## Properties | Property | Type | Description | |:|:--|:|
-| eventType | [workplaceSensorEventType](../resources/workplacesensoreventvalue.md#workplacesensoreventtype-values) | The type of possible sensor event value. The possible values are: `badgeIn`, `badgeOut`, `wifiConnect`, `wifiDisconnect`, `unknownFutureValue`. |
+| eventType | [workplaceSensorEventType](../resources/workplacesensoreventvalue.md#workplacesensoreventtype-values) | The type of possible sensor event value. The possible values are: `badgeIn`, `badgeOut`, `unknownFutureValue`. |
| user | [emailIdentity](../resources/emailidentity.md) | The unique identifier of a user. It could be an email or a Microsoft Entra ID. | ### workplaceSensorEventType values
Represents the data collected and reported by a Wi-Fi or badge-swiping device.
|:-|:| | badgeIn | An event in which a user enters a place by swiping the badge. | | badgeOut | An event in which a user exits a place by swiping the badge. |
-| wifiConnect | An event in which a user connects to the Wi-Fi device. |
-| wifiDisconnect | An event in which a user disconnects from the Wi-Fi device. |
| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | ## JSON representation The following JSON representation shows the resource type.
v1.0 Accesspackageassignmentpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/accesspackageassignmentpolicy-get.md
The following example shows how to retrieve the collection of custom extension s
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_accesspackageassignmentpolicy_expand_customextensionstagesettings" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/accessPackageAssignmentPolicies/4540a08f-8ab5-43f6-a923-015275799197?$expand=customExtensionStageSettings($expand=customExtension)
+GET https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/assignmentPolicies/4540a08f-8ab5-43f6-a923-015275799197?$expand=customExtensionStageSettings($expand=customExtension)
```
+# [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 Accesspackageassignmentpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/accesspackageassignmentpolicy-update.md
If successful, this method returns a `200 OK` response code and an updated [acce
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_accesspackageassignmentpolicy" } --> ``` http
-PUT https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/accessPackageassignmentPolicies/87e1c7f7-c7f7-87e1-f7c7-e187f7c7e187
+PUT https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/assignmentPolicies/87e1c7f7-c7f7-87e1-f7c7-e187f7c7e187
Content-Type: application/json {
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.
To remove the collection of **customExtensionStageSettings** and their associate
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_accesspackageassignmentpolicy_delete_customExtensionStageSettings"
The following example shows a request.
--> ```http
-PUT https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/accessPackageAssignmentPolicies/4540a08f-8ab5-43f6-a923-015275799197
+PUT https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/assignmentPolicies/4540a08f-8ab5-43f6-a923-015275799197
Content-Type: application/json {
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.
The following example shows how to update a policy to include a custom extension
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_accesspackageassignmentpolicy_updating_customExtensionStageSettings"
The following example shows a request.
--> ```http
-PUT https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/accessPackageAssignmentPolicies/f9afd2e3-7486-40df-9c35-aa2ae108c495
+PUT https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/assignmentPolicies/f9afd2e3-7486-40df-9c35-aa2ae108c495
Content-Type: application/json {
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 Accesspackageassignmentrequest Resume https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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
doc_type: "apiPageType"
Namespace: microsoft.graph
-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-only.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 <!-- {
If successful, this action returns a `204 No Content` response code.
#### Request
-The following is an example of a call to resume an access package assignment request that's waiting for a callback.
+The following example shows a request of a call to resume an access package assignment request that's waiting for a callback.
# [HTTP](#tab/http) <!-- {
HTTP/1.1 204 No Content
#### Request
-The following is an example to resume the processing of an access package assignment request by denying the request that's waiting for a callback. A request cannot be denied at the `assignmentRequestCreated` stage of the callout.
+The following example shows a request to resume the processing of an access package assignment request by denying the request that's waiting for a callback. A request cannot be denied at the `assignmentRequestCreated` stage of the callout.
<!-- { "blockType": "request" }
v1.0 Adminreportsettings Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/adminreportsettings-get.md
+
+ Title: "Get adminReportSettings"
+description: "Get the tenant-level settings for Microsoft 365 reports."
+ms.localizationpriority: medium
++++
+# Get adminReportSettings
+
+Namespace: microsoft.graph
+
+Get the tenant-level settings for Microsoft 365 reports.
+
+> **Note:** For details about different report views and names, see [Microsoft 365 Reports in the admin center - Microsoft 365 Apps usage](/microsoft-365/admin/activity-reports/microsoft365-apps-usage).
++
+## 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": "adminreportsettings_get" } -->
+
+> **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
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+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 |
+| : | : |
+|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 an [adminReportSettings](../resources/adminreportsettings.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_adminreportsettings"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/admin/reportSettings
+```
+
+# [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.adminReportSettings"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": {
+ "@odata.type": "#microsoft.graph.adminReportSettings",
+ "displayConcealedNames": true
+ }
+}
+```
v1.0 Adminreportsettings Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/adminreportsettings-update.md
+
+ Title: "Update adminReportSettings"
+description: "Update tenant-level settings for Microsoft 365 reports."
+ms.localizationpriority: medium
++++
+# Update adminReportSettings
+
+Namespace: microsoft.graph
+
+Update tenant-level settings for Microsoft 365 reports.
++
+## 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": "adminreportsettings_update" } -->
+
+> **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" } -->
+```http
+PATCH /admin/reportSettings
+```
+
+## 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 |
+| -- | -- | - |
+| 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
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+The following example shows a request that updates a tenant-level setting for Microsoft 365 reports.
+
+### Request
+The following example shows a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "update_adminreportsettings"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/v1.0/admin/reportSettings
+Content-Type: application/json
+Content-length: 37
+
+{
+ "displayConcealedNames": true
+}
+```
+
+# [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"
+} -->
+```http
+HTTP/1.1 204 No Content
+```
v1.0 Appcatalogs List Teamsapps https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/appcatalogs-list-teamsapps.md
Title: "List teamsApp" description: "List apps from the Microsoft Teams app catalog."-+ ms.localizationpriority: medium doc_type: apiPageType
v1.0 Application List Owners https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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
-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
<!-- { "blockType": "permissions", "name": "application_list_owners" } --> [!INCLUDE [permissions-table](../includes/permissions/application-list-owners-permissions.md)] - ## HTTP request
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 a 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/v1.0/applications/acc848e9-e8ec-4feb-a521-8d58b5482e09/owners
+GET https://graph.microsoft.com/v1.0/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.
+### 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. <!-- {
HTTP/1.1 200 OK
Content-type: application/json {
- "value": [
- {
- "id": "id-value"
- }
- ]
+ "@odata.context": "https://graph.microsoft.com/v1.0/$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/v1.0/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 will need to [register the calling bot](/microsoftteams/platform/concepts/calls-and-meetings/registering-calling-bot) and go through the list of permissions needed as mentioned below.
+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-us.md)] ## Permissions
v1.0 Application Upsert https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 Applicationtemplate Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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/v1.0/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/v1.0/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 Authenticationconditionapplication Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/authenticationconditionapplication-delete.md
DELETE https://graph.microsoft.com/v1.0/identity/authenticationEventsFlows/0313c
[!INCLUDE [sample-code](../includes/snippets/php/delete-includeapplications-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-includeapplications-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Authenticationconditionsapplications List Includeapplications https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/authenticationconditionsapplications-list-includeapplications.md
GET https://graph.microsoft.com/v1.0/identity/authenticationEventsFlows/0313cc37
[!INCLUDE [sample-code](../includes/snippets/php/get-includeapplications-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-includeapplications-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Authenticationconditionsapplications Post Includeapplications https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/authenticationconditionsapplications-post-includeapplications.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/post-includeapplications-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-includeapplications-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Authenticationeventsflow Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/authenticationeventsflow-delete.md
DELETE https://graph.microsoft.com/v1.0/identity/authenticationEventsFlows/0313c
[!INCLUDE [sample-code](../includes/snippets/php/delete-authenticationeventsflow-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-authenticationeventsflow-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Authenticationeventsflow Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/authenticationeventsflow-get.md
GET https://graph.microsoft.com/v1.0/identity/authenticationEventsFlows/0313cc37
[!INCLUDE [sample-code](../includes/snippets/php/get-authenticationeventsflow-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-authenticationeventsflow-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Authenticationeventsflow Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/authenticationeventsflow-update.md
You must include the **@odata.type** property with a value of the specific user
|conditions|[authenticationConditions](../resources/authenticationconditions.md)|The conditions representing the context of the authentication request that is used to decide whether the events policy is invoked. | |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
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/authenticationeventsflow-update-beta-e1-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/authenticationeventsflow-update-beta-e1-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
The following example shows the response.
HTTP/1.1 204 No Content ```
-### Example 2: Update the onAttributeCollection event of an external identities 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're 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"
+ }
+ ]
} ] }
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-authenticationeventsflow-onattributecollection-beta-e2-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Python](#tab/python)
---
-#### Response
-
-The following example shows the response.
-<!-- {
- "blockType": "response",
- "truncated": true
-}
>
-``` http
-HTTP/1.1 204 No Content
-```
-
-### Example 3: Remove an attribute collected during an external identities 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/v1.0/identity/authenticationEventsFlows/0313cc37-d421-421d-857b-87804d61e33e
-Content-Type: application/json
-
-{
- "@odata.type": "#microsoft.graph.externalUsersSelfServiceSignUpEventsFlow",
- "onAttributeCollection": {
- "@odata.type": "#microsoft.graph.onAttributeCollectionExternalUsersSelfServiceSignUp",
- "attributeCollectionPage": {
- "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)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Python](#tab/python) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
The following example shows the response.
``` http HTTP/1.1 204 No Content ```-
v1.0 Authenticationmethod Resetpassword https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 [passwordResetResponse](../resources/passwordresetresponse.md) in the response body. The response body might also include a **Location** header with a URL to check the status of the [reset operation](longrunningoperation-get.md).
+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 didn't 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/v1.0/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. You can use the ID in the **Location**
<!-- { "blockType": "response", "truncated": true,
- "@odata.type": "microsoft.graph.entity"
+ "@odata.type": "microsoft.graph.passwordResetResponse"
} --> ```http
-HTTP/1.1 202 ACCEPTED
+HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/v1.0/users/6ea91a8d-e32e-41a1-b7bd-d2d185eed0e0/authentication/operations/77bafe36-3ac0-4f89-96e4-a4a5a48da851?aadgdc=DUB02P&aadgsu=ssprprod-a Content-type: application/json
v1.0 Backuprestoreroot Delete Serviceapps https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/backuprestoreroot-delete-serviceapps.md
If successful, this method returns a `204 No Content` response code.
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_serviceapp"
The following example shows a request.
DELETE https://graph.microsoft.com/v1.0/solutions/backupRestore/serviceApps/{71633878-8321-4950-bfaf-ed285bdd1461} ```
+# [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 Enable https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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
If successful, this action returns a `200 OK` response code and a [serviceStatus
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "backuprestoreroot_enable"
POST https://graph.microsoft.com/v1.0/solutions/backupRestore/enable
} ```
+# [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 Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/backuprestoreroot-get.md
If successful, this method returns a `200 OK` response code and a [backupRestore
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "backuprestoreroot_get"
The following example shows a request.
GET https://graph.microsoft.com/v1.0/solutions/backupRestore ```
+# [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 List Driveprotectionunits https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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
The following example shows how to get a list of all the **driveProtectionUnits*
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_all_driveprotectionunit"
The following example shows a request.
GET /solutions/backupRestore/driveProtectionUnits ```
+# [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.
The following example shows how to list all the **driveProtectionUnits** associa
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_driveprotectionunit"
The following example shows a request.
GET /solutions/backupRestore/oneDriveForBusinessProtectionPolicies/845457dc-4bb2-4815-bef3-8628ebd1952e/driveProtectionUnits ```
+# [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 List Mailboxprotectionunits https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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
If successful, this method returns a `200 OK` response code and a [mailboxProtec
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_all_mailboxprotectionunit"
The following example shows a request.
GET https://graph.microsoft.com/v1.0/solutions/backupRestore/mailboxProtectionUnits ```
+# [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 List Protectionpolicies https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/backuprestoreroot-list-protectionpolicies.md
If successful, this method returns a `200 OK` response code and a [protectionPol
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "protectionpolicybase_list"
The following example shows a request.
GET https://graph.microsoft.com/v1.0/solutions/backupRestore/ProtectionPolicies ```
+# [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 List Restorepoints https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/backuprestoreroot-list-restorepoints.md
doc_type: resourcePageType
Namespace: microsoft.graph
-Get a list of the [restorePoint](../resources/restorepoint.md) objects and their properties.
+Get a list of the [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)]
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
The following example shows a request.
GET https://graph.microsoft.com/v1.0/solutions/backupRestore/restorePoints?$expand=protectionUnit($filter=id eq 'd234cf54-e0fb-49b7-9c8a-5bcd1439e853')&$filter=protectionDateTime lt 2024-05-12T10:01:00Z ```
+# [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 List Restoresessions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/backuprestoreroot-list-restoresessions.md
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": "restoresession_list"
The following example shows a request.
GET https://graph.microsoft.com/v1.0/solutions/backupRestore/restoreSessions ```
+# [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 List Serviceapps https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/backuprestoreroot-list-serviceapps.md
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": "serviceapps_list"
The following example shows a request.
GET https://graph.microsoft.com/v1.0/solutions/backupRestore/serviceApps ```
+# [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 List Siteprotectionunits https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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
The following example shows how to get a list of all the **siteProtectionUnits**
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_all_siteprotectionunit"
The following example shows a request.
GET https://graph.microsoft.com/v1.0/solutions/backupRestore/siteProtectionUnits ```
+# [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.
The following example shows how to list all the **siteProtectionUnits** associat
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_siteprotectionunit"
The following example shows a request.
GET https://graph.microsoft.com/v1.0/solutions/backupRestore/sharePointProtectionPolicies/845457dc-4bb2-4815-bef3-8628ebd1952e/siteProtectionUnits ```
+# [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 Exchangeprotectionpolicies https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "exchangeprotectionpolicy_create"
POST https://graph.microsoft.com/v1.0/solutions/backupRestore/exchangeProtection
} ```
+# [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 Exchangerestoresessions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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
If successful, this method returns a `201 Created` response code and an [exchang
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "exchangerestoresession_create_mailboxrestoreartifacts"
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.
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/v1.0/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 The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "onedriveforbusinessprotectionpolicy_create"
POST https://graph.microsoft.com/v1.0/solutions/backupRestore/oneDriveForBusines
} ```
+# [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 Onedriveforbusinessrestoresessions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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
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 Serviceapps https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/backuprestoreroot-post-serviceapps.md
If successful, this method returns a `201 Created` response code and a [serviceA
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_serviceapp"
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 Sharepointprotectionpolicies https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "sharepointprotectionpolicy_create"
POST https://graph.microsoft.com/v1.0/solutions/backupRestore/sharePointProtecti
} ```
+# [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 Sharepointrestoresessions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "sharepointrestoresession_create"
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 Basesitepage Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/basesitepage-delete.md
DELETE /sites/{site-id}/pages/{page-id}
| Name | Value | Description |:--|:|:--
-|Authorization|Bearer {token}.| Required|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| Required|
| _if-match_ | etag | If this request header is included and the eTag provided doesn't match the current tag on the item, a `412 Precondition Failed` response is returned and the item won't be deleted. ## Request body
v1.0 Bookingappointment Cancel https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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/v1.0/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/v1.0/api/bookingappointment-get.md
This method supports the `$count` and `$expand` [OData query parameters](/graph/
| 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/v1.0/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/v1.0/api/bookingbusiness-get.md
This method supports the `$count` [OData query parameter](/graph/query-parameter
| 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/v1.0/api/bookingbusiness-list-calendarview.md
This method also supports some of the `$count` and `$expand` [OData query parame
| 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 Customers https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingbusiness-list-customers.md
This method supports the $count and $expand [OData query parameters](/graph/quer
## 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/v1.0/api/bookingbusiness-list.md
This method also supports the `query` parameter which accepts a string value. Th
| Name |Description| |:-|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Bookingbusiness Post Bookingbusinesses https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 a [bookingBusiness](../resources/bookingbusiness.md) object.
v1.0 Bookingbusiness Publish https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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/v1.0/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/v1.0/api/bookingbusiness-update.md
PATCH /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 [!INCLUDE [table-intro](../../includes/update-property-table-intro.md)]
v1.0 Bookingcurrency Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingcurrency-get.md
This method supports the $count and $expand [OData query parameters](/graph/quer
## 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/v1.0/api/bookingcurrency-list.md
This method supports the $count and $expand [OData query parameters](/graph/quer
## 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/v1.0/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/v1.0/api/bookingcustomer-get.md
This method supports the $count and $expand [OData query parameters](/graph/quer
| Name |Description| |:-|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Bookingcustomer Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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
v1.0 Bookingservice Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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/v1.0/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/v1.0/api/bookingstaffmember-get.md
This method supports the $count and $expand [OData query parameters](/graph/quer
| Name |Description| |:-|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Call Answer https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/call-answer.md
doc_type: apiPageType
Namespace: microsoft.graph
-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 will contain 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 will contain 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 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-us.md)] ## Permissions
The following example shows how to call this API.
#### Request The following example shows the request. - # [HTTP](#tab/http) <!-- { "blockType": "request",
Content-Type: application/json
#### Request - # [HTTP](#tab/http) <!-- { "blockType": "request",
Content-Type: application/json
#### Request - # [HTTP](#tab/http) <!-- { "blockType": "request",
v1.0 Callrecording Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/callrecording-delta.md
+
+ Title: "callRecording: delta"
+description: "Get a set of callRecording resources added for onlineMeeting instances organized by the specified user."
+ms.localizationpriority: medium
++++
+# callRecording: delta
+
+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 do an initial full synchronization, and then get incremental changes to that recording view periodically.
+
+A GET request with the delta function returns one of the following:
+
+- 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. 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.
+
+### Known issues
+
+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).
+- [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).
+
+## 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": "callrecording_delta" } -->
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+``` http
+GET /users/{usersId}/onlineMeetings/getAllRecordings(meetingOrganizerUserId='{userId}',startDateTime={startDateTime})/delta
+```
+>**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.
+
+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 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
+
+| Header | Value |
+|||
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## 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.
+
+## Examples
+
+### Example 1: Initial round of synchronization
+
+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 3: [third request](#third-request) and [final response](#third-and-final-response-for-the-round).
+
+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 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/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta
+```
+
+#### Initial response
+
+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": "Collection(microsoft.graph.callRecording)"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(callRecording)",
+ "@odata.nextLink": "https://graph.microsoft.com/v1.0/users({userId})/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={skipToken1}",
+ "@odata.count": 1,
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.callRecording",
+ "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=",
+ "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy",
+ "createdDateTime": "2023-12-02T06:59:34.7411768Z",
+ "recordingContentUrl": "https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy/recordings/VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=/content",
+ "meetingOrganizer": {
+ "application": null,
+ "device": null,
+ "user": {
+ "@odata.type": "#microsoft.graph.teamworkUserIdentity",
+ "id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "displayName": null,
+ "userIdentityType": "aadUser",
+ "tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853"
+ }
+ }
+ }
+ ]
+}
+```
+
+#### 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.
+
+<!-- { "blockType": "ignored" } -->
+```http
+GET https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta
+$skiptoken={skipToken1}
+```
+
+#### Second response
+
+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": "Collection(microsoft.graph.callRecording)"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(callRecording)",
+ "@odata.nextLink": "https://graph.microsoft.com/v1.0/users({userId})/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={skipToken2}",
+ "@odata.count": 1,
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.callRecording",
+ "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=",
+ "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy",
+ "createdDateTime": "2023-12-02T06:59:34.7411768Z",
+ "recordingContentUrl": "https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy/recordings/VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=/content",
+ "meetingOrganizer": {
+ "application": null,
+ "device": null,
+ "user": {
+ "@odata.type": "#microsoft.graph.teamworkUserIdentity",
+ "id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "displayName": null,
+ "userIdentityType": "aadUser",
+ "tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853"
+ }
+ }
+ }
+ ]
+}
+```
+
+#### Third 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/v1.0/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 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": "Collection(microsoft.graph.callRecording)"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(callRecording)",
+ "@odata.deltaLink": "https://graph.microsoft.com/v1.0/users({userId})/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={deltaToken1}",
+ "@odata.count": 1,
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.callRecording",
+ "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=",
+ "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy",
+ "createdDateTime": "2023-12-02T06:59:34.7411768Z",
+ "recordingContentUrl": "https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy/recordings/VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=/content",
+ "meetingOrganizer": {
+ "application": null,
+ "device": null,
+ "user": {
+ "@odata.type": "#microsoft.graph.teamworkUserIdentity",
+ "id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "displayName": null,
+ "userIdentityType": "aadUser",
+ "tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853"
+ }
+ }
+ }
+ ]
+}
+```
+
+### 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.
+
+#### Request
+The following example shows a request.
+
+<!-- { "blockType": "ignored" } -->
+```http
+GET https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={deltaToken1}
+```
+
+#### 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.callRecording)"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(callRecording)",
+ "@odata.deltaLink": "https://graph.microsoft.com/v1.0/users({userId})/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={deltaToken2}",
+ "@odata.count": 1,
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.callRecording",
+ "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=",
+ "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy",
+ "createdDateTime": "2023-12-02T06:59:34.7411768Z",
+ "recordingContentUrl": "https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy/recordings/VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=/content",
+ "meetingOrganizer": {
+ "application": null,
+ "device": null,
+ "user": {
+ "@odata.type": "#microsoft.graph.teamworkUserIdentity",
+ "id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "displayName": null,
+ "userIdentityType": "aadUser",
+ "tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853"
+ }
+ }
+ }
+ ]
+}
+```
v1.0 Callrecording Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/callrecording-get.md
GET https://graph.microsoft.com/v1.0/me/onlineMeetings/MSoxMjczYTAxNi0yMDFkLTRmO
[!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)
v1.0 Callrecords Callrecord List Participants_V2 https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/callrecords-callrecord-list-participants_v2.md
This method supports the following OData query parameter to help customize the r
| Name |Description| |:-|:-|
-| Authorization | Bearer {token} |
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: odata.maxpagesize={x} | Specifies a preferred integer {x} page size for paginated results. This value must be equal to or less than the maximum allowable page size. Optional. | | Prefer: include-unknown-enum-members | Enables evolvable enum values beyond the sentinel value. For more information, see [Best practices for working with Microsoft Graph](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations). Optional. | | Prefer: omit-values=nulls | Removes null or empty values from the response. Optional. |
v1.0 Callrecords Cloudcommunications List Callrecords https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/callrecords-cloudcommunications-list-callrecords.md
This method supports the following OData query parameters to help customize the
| Name |Description| |:-|:-|
-| Authorization | Bearer {token} |
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Prefer: odata.maxpagesize={x} | Specifies a preferred integer {x} page size for paginated results. This value must be equal to or less than the maximum allowable page size. Optional. | | Prefer: include-unknown-enum-members | Enables evolvable enum values beyond the sentinel value. For more information, see [Best practices for working with Microsoft Graph](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations). Optional. | | Prefer: omit-values=nulls | Removes null or empty values from the response. Optional. |
v1.0 Calltranscript Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/calltranscript-delta.md
+
+ Title: "callTranscript: delta"
+description: "Get a set of callTranscript resources added for onlineMeeting instances organized by the specified user."
+ms.localizationpriority: medium
++++
+# callTranscript: delta
+
+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.
+
+A GET request with the delta function returns one of the following:
+
+- 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. 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.
+
+### Known issues
+
+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).
+- [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. 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": "calltranscript_delta" } -->
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+``` http
+GET /users/{usersId}/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='{userId}',startDateTime={startDateTime})/delta
+```
+>**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.
+
+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 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
+
+| Header | Value |
+|||
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## 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.
+
+## Examples
+
+### Example 1: Initial round of synchronization
+
+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 3: [third request](#third-request) and [final response](#third-and-final-response-for-the-round).
+
+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 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/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta
+```
+
+#### Initial response
+
+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": "Collection(microsoft.graph.callTranscript)"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(callTranscript)",
+ "@odata.nextLink": "https://graph.microsoft.com/v1.0/users({userId})/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={skipToken1}",
+ "@odata.count": 1,
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.callTranscript",
+ "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=",
+ "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy",
+ "createdDateTime": "2023-12-02T06:59:34.7411768Z",
+ "transcriptContentUrl": "https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy/transcripts/VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=/content",
+ "meetingOrganizer": {
+ "application": null,
+ "device": null,
+ "user": {
+ "@odata.type": "#microsoft.graph.teamworkUserIdentity",
+ "id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "displayName": null,
+ "userIdentityType": "aadUser",
+ "tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853"
+ }
+ }
+ }
+ ]
+}
+```
+
+#### 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.
+
+<!-- { "blockType": "ignored" } -->
+```http
+GET https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta
+$skiptoken={skipToken1}
+```
+
+#### Second response
+
+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": "Collection(microsoft.graph.callTranscript)"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(callTranscript)",
+ "@odata.nextLink": "https://graph.microsoft.com/v1.0/users({userId})/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={skipToken2}",
+ "@odata.count": 1,
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.callTranscript",
+ "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=",
+ "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy",
+ "createdDateTime": "2023-12-02T06:59:34.7411768Z",
+ "transcriptContentUrl": "https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy/transcripts/VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=/content",
+ "meetingOrganizer": {
+ "application": null,
+ "device": null,
+ "user": {
+ "@odata.type": "#microsoft.graph.teamworkUserIdentity",
+ "id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "displayName": null,
+ "userIdentityType": "aadUser",
+ "tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853"
+ }
+ }
+ }
+ ]
+}
+```
+
+#### Third 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/v1.0/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 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": "Collection(microsoft.graph.callTranscript)"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(callTranscript)",
+ "@odata.deltaLink": "https://graph.microsoft.com/v1.0/users({userId})/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={deltaToken1}",
+ "@odata.count": 1,
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.callTranscript",
+ "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=",
+ "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy",
+ "createdDateTime": "2023-12-02T06:59:34.7411768Z",
+ "transcriptContentUrl": "https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy/transcripts/VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=/content",
+ "meetingOrganizer": {
+ "application": null,
+ "device": null,
+ "user": {
+ "@odata.type": "#microsoft.graph.teamworkUserIdentity",
+ "id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "displayName": null,
+ "userIdentityType": "aadUser",
+ "tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853"
+ }
+ }
+ }
+ ]
+}
+```
+
+### 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.
+
+#### Request
+The following example shows a request.
+
+<!-- { "blockType": "ignored" } -->
+```http
+GET https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={deltaToken1}
+```
+
+#### 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.callTranscript)"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(callTranscript)",
+ "@odata.deltaLink": "https://graph.microsoft.com/v1.0/users({userId})/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={deltaToken2}",
+ "@odata.count": 1,
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.callTranscript",
+ "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=",
+ "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy",
+ "createdDateTime": "2023-12-02T06:59:34.7411768Z",
+ "transcriptContentUrl": "https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy/transcripts/VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=/content",
+ "meetingOrganizer": {
+ "application": null,
+ "device": null,
+ "user": {
+ "@odata.type": "#microsoft.graph.teamworkUserIdentity",
+ "id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "displayName": null,
+ "userIdentityType": "aadUser",
+ "tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853"
+ }
+ }
+ }
+ ]
+}
+```
v1.0 Calltranscript Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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/v1.0/me/onlineMeetings/MSoxMjczYTAxNi0yMDFkLTRmOTUtODA4My0xYjdmOTliM2VkZWIqMCoqMTk6bWVldGluZ19OV1EwWm1GbFpEY3RORFJqTmkwMFlXRm1MV0U1WXpBdE9UZzJNMk0yTm1Nd1pERTNAdGhyZWFkLnYy/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 Archive https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/channel-archive.md
POST https://graph.microsoft.com/v1.0/teams/16dc05c0-2259-4540-a970-3580ff459721
[!INCLUDE [sample-code](../includes/snippets/php/archive-channel-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/archive-channel-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
POST https://graph.microsoft.com/v1.0/teams/16dc05c0-2259-4540-a970-3580ff459721
[!INCLUDE [sample-code](../includes/snippets/php/archive-channel-on-archived-team-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/archive-channel-on-archived-team-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Channel Delete Tabs https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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/v1.0/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/v1.0/api/channel-get-filesfolder.md
Title: "Get filesFolder" description: "Retrieve the filesFolder 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/v1.0/api/channel-get-tabs.md
Title: "Get tab in channel" description: "Retrieve the properties and relationships of the specified tab. "-+ ms.localizationpriority: medium doc_type: apiPageType
v1.0 Channel Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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/v1.0/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 `ChannelMessage.Read.Group` permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent).
## HTTP request
This method supports the following [OData query parameters](/graph/query-paramet
| Name | Description | |:-|:| | [$top](/graph/query-parameters#top-parameter)| Apply `$top` to specify the number of channel messages returned per page in the response. The default page size is 20 messages. You can extend up to 50 channel messages per page. |
-| [$expand](/graph/query-parameters#expand) | Apply `$expand` to get the properties of channel messages that are replies. By default, a response can include up to 1000 replies. For an operation that expands channel messages with more than 1000 replies, use the request URL returned in `replies@odata.nextLink` to get the next page of replies. |
+| [$expand](/graph/query-parameters#expand) | Apply `$expand` to get the properties of channel messages that are replies. By default, a response can include up to 1,000 replies. For an operation that expands channel messages with more than 1,000 replies, use the request URL returned in `replies@odata.nextLink` to get the next page of replies. |
-The other [OData query parameters](/graph/query-parameters) are not currently supported.
+The other [OData query parameters](/graph/query-parameters) aren't currently supported.
> **Note:** [GET /teams/{team-id}/channels/{channel-id}/messages/delta](chatmessage-delta.md) supports filtering by date, which provides similar data to GET /teams/{team-id}/channels/{channel-id}/messages .
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
If successful, this method returns a `200 OK` response code and a collection of
#### Request
-The following example shows a request with the $top query option and without the optional prefer header.
+The following example shows a request with the `$top` query option and without the optional prefer header.
# [HTTP](#tab/http)
GET https://graph.microsoft.com/v1.0/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 1000 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 1000 replies in that channel message, but for readability, the following response shows only 3 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/v1.0/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 List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/channel-list.md
Title: "List channels" description: "Retrieve the list of channels in this team."-+ doc_type: "apiPageType" ms.localizationpriority: high
v1.0 Channel Patch Tabs https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 Messagereply https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/channel-post-messagereply.md
Title: "Reply to a message in a channel" description: "Reply to an existing message in a channel."-+ ms.localizationpriority: medium doc_type: apiPageType
v1.0 Channel Post Tabs https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/channel-post-tabs.md
Title: "Add tab to channel" description: "Add (pin) a tab to the specified channel within a team. "-+ ms.localizationpriority: high doc_type: apiPageType
v1.0 Channel Post https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/channel-post.md
Title: "Create channel" description: "Create new channel in a team, as specified in the request body." ms.localizationpriority: medium-+ doc_type: apiPageType
v1.0 Channel Unarchive https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/channel-unarchive.md
POST https://graph.microsoft.com/v1.0/teams/16dc05c0-2259-4540-a970-3580ff459721
[!INCLUDE [sample-code](../includes/snippets/php/unarchive-channel-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/unarchive-channel-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
POST https://graph.microsoft.com/v1.0/teams/16dc05c0-2259-4540-a970-3580ff459721
[!INCLUDE [sample-code](../includes/snippets/php/unarchive-channel-on-archived-team-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/unarchive-channel-on-archived-team-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Chat Delete Installedapps https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/chat-delete-installedapps.md
Title: "Uninstall app in a chat" description: "Uninstall (remove) an app installed in a chat."-+ ms.localizationpriority: high doc_type: apiPageType
v1.0 Chatmessage List Hostedcontents https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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/v1.0/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 Community Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/community-delete.md
+
+ Title: "Delete community"
+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
+++
+# Delete community
+
+Namespace: microsoft.graph
+
+Delete a Viva Engage [community](../resources/community.md) along with all associated Microsoft 365 content, including the connected Microsoft 365 group, OneNote notebook, and Planner plans. For more information, see [What happens if I delete a Viva Engage community connected to Microsoft 365 groups](/viva/engage/engage-microsoft-365-groups#q-what-happens-if-i-delete-a-viva-engage-community-connected-to-microsoft-365-groups).
++
+## 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": "community_delete" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /employeeExperience/communities/{communityId}
+```
+
+## 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_community",
+ "sampleKeys": ["eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI4MzIxMjc1In0"]
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/v1.0/employeeExperience/communities/eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI4MzIxMjc1In0
+```
+
+# [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.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Community Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/community-get.md
+
+ Title: "Get community"
+description: "Read the properties and relationships of a community object."
+
+ms.localizationpriority: medium
+++
+# Get community
+
+Namespace: microsoft.graph
+
+Read the properties and relationships of a [community](../resources/community.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": "community_get" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /employeeExperience/communities/{communityId}
+```
+
+## Optional query parameters
+
+This method supports the `$select` and `$expand` [OData query parameters](/graph/query-parameters) to help 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 [community](../resources/community.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_community",
+ "sampleKeys": ["eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI4MzIxMjc1In0"]
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/employeeExperience/communities/eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI4MzIxMjc1In0
+```
+
+# [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.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.community"
+}
+-->
+```http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#employeeExperience/communities/$entity",
+ "id": "eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI4MzIxMjc1In0",
+ "displayName": "Financial Advice for Software Engineers",
+ "description": "A community where financial advisors who represent customers from software engineering profession can discuss advice and suggestions for there clients.",
+ "privacy": "public",
+ "groupId": "963da73d-a587-4ef3-aab0-d783e937e9e7"
+}
+```
v1.0 Community Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/community-update.md
+
+ Title: "Update community"
+description: "Update the properties of an existing Viva Engage community."
+
+ms.localizationpriority: medium
+++
+# Update community
+
+Namespace: microsoft.graph
+
+Update the properties of an existing Viva Engage [community](../resources/community.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).
+
+<!-- { "blockType": "permissions", "name": "community_update" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /employeeExperience/communities/{communityId}
+```
+
+## 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|
+|:|:|:|
+| description | String | The description of the community. Maximum length is 1,024 characters. |
+| displayName | String | The name of the community. Maximum length is 255 characters. |
+| privacy | [communityPrivacy](../resources/community.md#communityprivacy-values) | Defines the privacy level of the community. The possible values are: `public`, `private`, `unknownFutureValue`. |
++
+## 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": "update_community",
+ "sampleKeys": ["eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI4MzIxMjc1In0"]
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/v1.0/employeeExperience/communities/eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI4MzIxMjc1In0
+Content-Type: application/json
+
+{
+ "displayName": "Financial Advice for Software Engineers",
+ "description": "A community where financial advisors who represent customers from software engineering profession can discuss advice and suggestions for their clients.",
+ "privacy": "public"
+}
+```
+
+# [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.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
v1.0 Directoryaudit Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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/v1.0/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 Driveitem Getretentionlabel https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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/v1.0/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/v1.0/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/v1.0/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/v1.0/api/educationassignment-get.md
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**.
You can use `$expand` with the following navigation properties of the [educationAssignment](../resources/educationassignment.md) resource: **categories**, **resources**, **rubric**, **submissions**, and **gradingCategory**. You can also use `*` to specify all the navigation properties.
v1.0 Educationassignment Post Categories https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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.
Content-type: application/json
{ "@odata.id": "https://graph.microsoft.com/v1.0/education/classes/acdefc6b-2dc6-4e71-b1e9-6d9810ab1793/assignmentCategories/ec98f158-341d-4fea-9f8c-14a250d489ac" }- ``` # [C#](#tab/csharp)
Content-type: application/json
-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. <!-- { "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.educationAssignmentResource"
+ "truncated": true
} --> ```http HTTP/1.1 204 No Content-
-{
-}
``` <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC -->
v1.0 Educationassignment Remove Category https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/educationassignment-remove-category.md
The following example shows a request.
<!-- { "blockType": "request", "sampleKeys": ["ec98f158-341d-4fea-9f8c-14a250d489ac"],
- "name": "add_educationcategory_to_educationassignment_classID_assignID"
+ "name": "remove_educationcategory_from_educationassignment"
}--> ```http DELETE https://graph.microsoft.com/v1.0/education/classes/acdefc6b-2dc6-4e71-b1e9-6d9810ab1793/assignments/ad8afb28-c138-4ad7-b7f5-a6986c2655a8/categories/ec98f158-341d-4fea-9f8c-14a250d489ac/$ref ``` # [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)]
The following example shows the response.
<!-- { "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.educationAssignmentResource"
+ "truncated": true
} --> ```http HTTP/1.1 204 No Content-
-{
-}
``` <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC -->
v1.0 Educationcategory Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 Educationfeedbackresourceoutcome Post Outcomes https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/educationfeedbackresourceoutcome-post-outcomes.md
HTTP/1.1 201 Created
Content-type: application/json {
- "@odata.context": "https://graph.microsoft.com/v1.0/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/v1.0/$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-10-21T18:58:42.019513Z",
- "id": "8c3d65c1-eacb-40f7-9360-7e47bb5b7d75",
+ "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-10-21T18:58:42.0195022Z",
- "lastModifiedDateTime": "2022-10-21T18:58:42.019513Z",
- "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F8CNZWU38SarWxPyWM7jx/items/01VANVJQ5X3ULNDOWTJJEYSIBXZIK42E5G",
+ "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 Educationsubmission Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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/v1.0/api/educationsubmission-list-outcomes.md
The following example shows a request.
}--> ```msgraph-interactive
-GET https://graph.microsoft.com/v1.0/education/classes/acdefc6b-2dc6-4e71-b1e9-6d9810ab1793/assignments/cf6005fc-9e13-44a2-a6ac-a53322006454/submissions/d1bee293-d8bb-48d4-af3e-c8cb0e3c7fe7/outcomes
+GET https://graph.microsoft.com/v1.0/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/v1.0/$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
{ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/assignments('a3cce0ba-2008-4c4d-bf62-079408562d96')/submissions('2185e6d7-2924-4ed1-dde1-269f89e29184')/outcomes",
+ "@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>')/assignments('<guid>')/submissions('<guid>')/outcomes?$select=lastModifiedBy,lastModifiedDateTime",
"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/v1.0/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,
Content-type: application/json
} } }
+ },
+ {
+ "@odata.type": "#microsoft.graph.educationFeedbackResourceOutcome",
+ "lastModifiedDateTime": "2022-05-06T00:52:21.8011514Z",
+ "id": "4176c991-c263-4772-9b01-5a27d55e123e",
+ "resourceStatus": "notPublished",
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
+ "displayName": null
+ }
+ },
+ "feedbackResource": {
+ "@odata.type": "#microsoft.graph.educationWordResource",
+ "displayName": "Document4.docx",
+ "createdDateTime": "2022-05-06T00:52:21.8011302Z",
+ "lastModifiedDateTime": "2022-05-06T00:52:21.8011514Z",
+ "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F8CNZWU38SarWxPyWM7jx/items/01VANVJQ3OHVMMZAEQPRC3LQJLBEQQY4BI",
+ "createdBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
+ "displayName": null
+ }
+ }
+ }
} ] }
v1.0 Educationsubmission Reassign https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/educationsubmission-reassign.md
POST https://graph.microsoft.com/v1.0/education/classes/37d99af7-cfc5-4e3b-8566-
The following is an example of the response when `Prefer: include-unknown-enum-members` isn't 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
The following is an example of the response when `Prefer: include-unknown-enum-m
<!-- { "blockType": "response",
+ "truncated": true,
"@odata.type": "microsoft.graph.educationSubmission" } --> ```http
v1.0 Educationuser List Assignments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/educationuser-list-assignments.md
GET /education/users/{user-id}/assignments
This method supports the `$top`, `$filter`, `$orderby`, and `$select` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
-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 Employeeexperience List Communities https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/employeeexperience-list-communities.md
+
+ Title: "List communities"
+description: "Get a list of the Viva Engage community objects and their properties."
+
+ms.localizationpriority: medium
+++
+# List communities
+
+Namespace: microsoft.graph
+
+Get a list of the Viva Engage [community](../resources/community.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": "employeeexperience_list_communities" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /employeeExperience/communities
+```
+
+## Optional query parameters
+
+This method supports the `$top`, `$select`, and `$expand` [OData query parameters](/graph/query-parameters) to help customize the response. It also supports the `$orderby` parameter for the **displayName** property.
+
+## 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 [community](../resources/community.md) objects in the response body.
+
+## Examples
+
+### Example 1: Get a list of communities
+
+The following example shows how to get a list of Viva Engage communities.
+
+#### Request
+
+The following example shows a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "list_community"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/employeeExperience/communities
+```
+
+# [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.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.community)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#employeeExperience/communities",
+ "value": [
+ {
+ "id": "eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxOTEzMjYyODk5MjAifQ",
+ "displayName": "All Company",
+ "description": "This is the default group for everyone in the network",
+ "privacy": "public",
+ "groupId": "195d9ecd-f80e-4bab-af95-176eba253dfa"
+ },
+ {
+ "id": "eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxOTE0NzY2Mzc2OTYifQ",
+ "displayName": "TestCommunity5",
+ "description": "Test community created via API",
+ "privacy": "public",
+ "groupId": "0bed8b86-5026-4a93-ac7d-56750cc099f1"
+ }
+ ]
+}
+```
+
+### Example 2: Get a list of communities with pagination
+
+The following example shows how to get a list of Viva Engage communities using the `$top` query parameter to set the page size of results.
+
+#### Request
+
+The following example shows a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "list_community_top"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/employeeExperience/communities?$top=2
+```
+
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
+++
+#### Response
+
+If the number of communities exceeds 20 or you use the `$top` query parameter to set the page size of results, multiple query requests might be necessary to retrieve all results. In this scenario, the API continues to return a reference to the next page of results in the **@odata.nextLink** property with each response until no more pages remain to be retrieved.
+
+The following example shows the response that includes the **@odata.nextLink** property.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.community)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#employeeExperience/communities",
+ "@odata.nextLink": "https://graph.microsoft.com/v1.0/employeeExperience/communities?$skiptoken=UVWlYzI7VjE7MTE2NDUzNDU3OTIwOzIwO0RlbW8tdGVzdC01OztEaXNwbGF5TmFtZTtmYWXYZTs",
+ "value": [
+ {
+ "id": "eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxOTEzMjYyODk5MjAifQ",
+ "displayName": "All Company",
+ "description": "This is the default group for everyone in the network",
+ "privacy": "public",
+ "groupId": "195d9ecd-f80e-4bab-af95-176eba253dfa"
+ },
+ {
+ "id": "eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxOTE0NzY2Mzc2OTYifQ",
+ "displayName": "TestCommunity5",
+ "description": "Test community created via API",
+ "privacy": "public",
+ "groupId": "0bed8b86-5026-4a93-ac7d-56750cc099f1"
+ }
+ ]
+}
+```
+
v1.0 Employeeexperience Post Communities https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/employeeexperience-post-communities.md
+
+ Title: "Create community"
+description: "Create a new community in Viva Engage."
+
+ms.localizationpriority: medium
+++
+# Create community
+
+Namespace: microsoft.graph
+
+Create a new [community](../resources/community.md) in Viva Engage.
++
+## 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": "employeeexperience_post_communities" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /employeeExperience/communities
+```
+
+## 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 [community](../resources/community.md) object.
+
+You can specify the following properties when you create a **community**.
+
+|Property|Type|Description|
+|:|:|:|
+| description | String | The description of the community. Maximum length is 1,024 characters. |
+| displayName | String | The name of the community. Maximum length is 255 characters. |
+| privacy | [communityPrivacy](../resources/community.md#communityprivacy-values) | Defines the privacy level of the community. The possible values are: `public`, `private`, `unknownFutureValue`. |
+
+## Response
+
+If successful, this method returns a `202 Accepted` response code. The response also contains an `Operation-Location` header with a link to the [engagementAsyncOperation](../resources/engagementasyncoperation.md). You can poll the `Operation-Location` endpoint for status update on the creation operation.
+
+## Examples
+
+### Example 1: Delegated permissions
+
+#### Request
+
+The following example shows a request with delegated permissions. When the **owners** property isn't specified in the request body, the calling user is automatically assigned as the community owner.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "create_community_from_minimal_e1"
+}
+-->
+``` http
+POST https://graph.microsoft.com/v1.0/employeeExperience/communities
+Content-Type: application/json
+
+{
+ "displayName": "Financial Advice for Software Engineers",
+ "description": "A community where financial advisors who represent customers from software engineering profession can discuss advice and suggestions for their clients.",
+ "privacy": "public"
+}
+```
+
+# [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.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 202 Accepted
+Content-Type: application/json
+Operation-Location: https://graph.microsoft.com/v1.0/employeeExperience/engagementAsyncOperations('3a6fdce1-c261-48bc-89de-1cfef658c0d5')
+```
+
+### Example 2: Application permissions
+
+#### Request
+
+The following example shows a minimal request that requires application permissions. If the **owners** property isn't specified in the request body, the request fails.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "create_community_from_app_only_e2"
+}
+-->
+``` http
+POST https://graph.microsoft.com/v1.0/employeeExperience/communities
+Content-Type: application/json
+
+{
+ "displayName": "Financial Advice for Software Engineers",
+ "description": "A community where financial advisors who represent customers from software engineering profession can discuss advice and suggestions for their clients.",
+ "privacy": "public",
+ "owners@odata.bind": [
+ "https://graph.microsoft.com/v1.0/users/26be1845-4119-4801-a799-aea79d09f1a2"
+ ]
+}
+```
+
+# [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.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 202 Accepted
+Content-Type: application/json
+Operation-Location: https://graph.microsoft.com/v1.0/employeeExperience/engagementAsyncOperations('3a6fdce1-c261-48bc-89de-1cfef658c0d5')
+```
v1.0 Engagementasyncoperation Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/engagementasyncoperation-get.md
+
+ Title: "Get engagementAsyncOperation"
+description: "Get an engagementAsyncOperation to track a long-running operation request."
+
+ms.localizationpriority: medium
+++
+# Get engagementAsyncOperation
+
+Namespace: microsoft.graph
+
+Get an [engagementAsyncOperation](../resources/engagementasyncoperation.md) to track a long-running operation request.
++
+## 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": "engagementasyncoperation_get" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /employeeExperience/engagementAsyncOperations/{engagementAsyncOperationId}
+```
+
+## Optional query parameters
+
+This method supports the `$select` [OData query parameter](/graph/query-parameters) to help 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 an [engagementAsyncOperation](../resources/engagementasyncoperation.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_engagementasyncoperation"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/employeeExperience/engagementAsyncOperations/a6fdce1-c261-48bc-89de-1cfef658c0d5
+```
+
+# [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.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.engagementAsyncOperation"
+}
+-->
+```http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/employeeExperience/engagementAsyncOperations/$entity",
+ "id": "eyJfdHlwZSI6IkxvbmdSdW5uaW5nT3BlcmF0aW9uIiwiaWQiOiI0ZmVhMjE5Ni0yZTRjLTQ4MzctYTlhNi1iMTVjOTBhNTM2ODkiLCJvcGVyYXRpb24iOiJDcmVhdGVDb21tdW5pdHkifQ",
+ "createdDateTime": "2023-12-06T09:42:54.367629-08:00",
+ "lastActionDateTime": "2023-12-06T09:42:54.367663-08:00",
+ "status": "succeeded",
+ "statusDetail": null,
+ "resourceLocation": "https://graph.microsoft.com/v1.0/employeeExperience/communities('eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI4MzIxMjc1In0')",
+ "operationType": "createCommunity",
+ "resourceId": "eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI4MzIxMjc1In0"
+}
+```
v1.0 Exchangeprotectionpolicy List Mailboxinclusionrules https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/exchangeprotectionpolicy-list-mailboxinclusionrules.md
If successful, this method returns a `200 OK` response code and a [mailboxProtec
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "exchangeprotectionpolicy_list_mailboxinclusionrule"
GET https://graph.microsoft.com/v1.0/solutions/backupRestore/exchangeProtectionP
Authorization: Bearer <Access-Token> ```
+# [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 Exchangeprotectionpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "exchangeprotectionpolicy_update"
Authorization: Bearer <Access-Token>
} ```
+# [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 Exchangerestoresession List Mailboxrestoreartifacts https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "mailboxrestoreartifact_list"
The following example shows a request.
GET https://graph.microsoft.com/v1.0/solutions/backupRestore/exchangeRestoreSessions/845457dc-4bb2-4815-bef3-8628ebd1952e/mailboxRestoreArtifacts ```
+# [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 Exchangerestoresession Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "exchangerestoresession_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 Filestoragecontainer Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/filestoragecontainer-get.md
Content-Type: application/json
"description": "Description of My Application Storage Container", "containerTypeId": "91710488-5756-407f-9046-fbe5f0b4de73", "status": "active",
- "createdDateTime": "2021-11-24T15:41:52.347Z"
+ "createdDateTime": "2021-11-24T15:41:52.347Z",
+ "settings": {
+ "isOcrEnabled": false
+ }
} ```
v1.0 Filestoragecontainer Post https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/filestoragecontainer-post.md
Namespace: microsoft.graph
Create a new [fileStorageContainer](../resources/filestoragecontainer.md) object.
-The respective container type identified by **containerTypeId** must be enabled in the tenant.
+The container type identified by **containerTypeId** must be enabled in the tenant.
For delegated calls, the calling user is set as the owner of the **fileStorageContainer**.
You can specify the following properties when you create a **fileStorageContaine
|Property|Type|Description| |:|:|:| |displayName|String|The display name of the container. Required.|
-|description|String|Provides a user-visible description of the item. Optional.|
+|description|String|A user-visible description of the item. Optional.|
|containerTypeId|GUID|The container type of the container instance. Required.|
+|settings|[fileStorageContainerSettings](../resources/filestoragecontainersettings.md)|Settings associated with the container. Optional.|
## Response
Content-Type: application/json
{ "displayName": "My Application Storage Container", "description": "Description of My Application Storage Container",
- "containerTypeId": "91710488-5756-407f-9046-fbe5f0b4de73"
+ "containerTypeId": "91710488-5756-407f-9046-fbe5f0b4de73",
+ "settings": {
+ "isOcrEnabled": true
+ }
} ```
Content-type: application/json
"description": "Description of My Application Storage Container", "containerTypeId": "91710488-5756-407f-9046-fbe5f0b4de73", "status": "inactive",
- "createdDateTime": "2021-11-24T15:41:52.347Z"
+ "createdDateTime": "2021-11-24T15:41:52.347Z",
+ "settings": {
+ "isOcrEnabled": true
+ }
} ```
v1.0 Filestoragecontainer Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/filestoragecontainer-update.md
Content-Type: application/json
{ "displayName": "Updated Name",
- "description": "Updated Description"
+ "description": "Updated Description",
+ "settings": {
+ "isOcrEnabled": false
+ }
} ```
Content-type: application/json
"description": "Updated Description", "containerTypeId": "91710488-5756-407f-9046-fbe5f0b4de73", "status": "active",
- "createdDateTime": "2021-11-24T15:41:52.347Z"
+ "createdDateTime": "2021-11-24T15:41:52.347Z",
+ "settings": {
+ "isOcrEnabled": false
+ }
} ```
v1.0 Group Assignlicense https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/group-assignlicense.md
doc_type: "apiPageType"
Namespace: microsoft.graph
-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](../resources/subscribedsku.md).
v1.0 Group List Members https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/group-list-members.md
Namespace: microsoft.graph
Get a list of the group's direct members. A group can have users, organizational contacts, devices, service principals and other groups as members. This operation is not transitive. > [!IMPORTANT]
-> This API has a known issue where service principals are not listed as group members in v1.0. Use this API on the `beta` endpoint instead or the `/groups/{id}?$expand=members` API. Note the [limitations of $expand on directory objects](https://developer.microsoft.com/en-us/graph/known-issues/?search=13635).
+> This API has a known issue where service principals are not listed as group members in v1.0. As a workaround, use this API on the `beta` endpoint or use the `/groups/{id}?$expand=members` API. For more information, see the related [known issue](https://developer.microsoft.com/en-us/graph/known-issues/?search=25984).
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
v1.0 Group Post Groups https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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/v1.0/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 Identitycontainer List Authenticationeventsflows https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identitycontainer-list-authenticationeventsflows.md
GET https://graph.microsoft.com/v1.0/identity/authenticationEventsFlows
[!INCLUDE [sample-code](../includes/snippets/php/list-authenticationeventsflow-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-authenticationeventsflow-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
GET https://graph.microsoft.com/v1.0/identity/authenticationEventsFlows?$filter=
[!INCLUDE [sample-code](../includes/snippets/php/list-authenticationeventsflow-selfservicesignup-identityproviders-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-authenticationeventsflow-selfservicesignup-identityproviders-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
GET https://graph.microsoft.com/v1.0/identity/authenticationEventsFlows?$filter=
[!INCLUDE [sample-code](../includes/snippets/php/list-authenticationeventsflow-filter-selfservicesignup-attributes-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-authenticationeventsflow-filter-selfservicesignup-attributes-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
GET https://graph.microsoft.com/v1.0/identity/authenticationEventsFlows?$filter=
[!INCLUDE [sample-code](../includes/snippets/php/list-authenticationeventsflow-filter-includeapplications-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-authenticationeventsflow-filter-includeapplications-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Identitycontainer List Identityproviders https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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/v1.0/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/v1.0/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
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-authenticationeventsflow-selfservicesignup-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-authenticationeventsflow-selfservicesignup-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-authenticationeventsflow-selfservicesignup-includeapplications-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-authenticationeventsflow-selfservicesignup-includeapplications-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-authenticationeventsflow--selfservicesignup-socialproviders-customattribute-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-authenticationeventsflow--selfservicesignup-socialproviders-customattribute-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Identitygovernance Deleteditemcontainer Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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/v1.0/api/identitygovernance-insights-toptasksprocessedsummary.md
+
+ Title: "insights: topTasksProcessedSummary"
+description: "Get a summary of the most processed tasks by Lifecycle Workflows in a tenant."
+
+ms.localizationpriority: medium
+++
+# insights: topTasksProcessedSummary
+
+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).
+
+<!-- {
+ "blockType": "permissions",
+ "name": "identitygovernance-insights-toptasksprocessedsummary-permissions"
+}
+-->
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /identityGovernance/lifecycleWorkflows/insights/topTasksProcessedSummary(startDateTime={startDateTime},endDateTime={endDateTime})
+```
+
+## Function parameters
+
+In the request URL, provide the following query parameters with values. The following table lists the parameters that are required when you call this function.
+
+|Parameter|Type|Description|
+|:|:|:|
+|startDateTime|DateTimeOffset|The start date, and time, of the insight summary for most tasks processed in a tenant.|
+|endDateTime|DateTimeOffset|The end date, and time, of the insight summary for most tasks processed in a tenant.|
+
+## 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 function returns a `200 OK` response code and a [microsoft.graph.identityGovernance.topTasksInsightsSummary](../resources/identitygovernance-toptasksinsightssummary.md) collection in the response body.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "insightsthis.toptasksprocessedsummary"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/identityGovernance/lifecycleWorkflows/insights/topTasksProcessedSummary(startDateTime=2023-01-01T00:00:00Z,endDateTime=2023-01-31T00:00:00Z)
+```
+
+# [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.identityGovernance.topTasksInsightsSummary)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.identityGovernance.topTasksInsightsSummary)",
+"value": [
+ {
+ "taskDefinitionId" : "gbc28c8e-f522-43b1-9d30-ee62b4ee941c",
+ "taskDefinitionDisplayName" : "Disable User Account",
+ "totalTasks" : 32,
+ "successfulTasks" : 15,
+ "failedTasks" : 17,
+ "totalUsers" : 46 ,
+ "successfulUsers" : 25 ,
+ "failedUsers" : 21
+ },
+ {
+ "taskDefinitionId" : "afg23h8e-a522-53b1-5d30-ft62b4ee941d",
+ "taskDefinitionDisplayName" : "Add user to groups",
+ "totalProcessedTasks" : 30,
+ "successfulTasks" : 14,
+ "failedTasks" : 16,
+ "totalUsers" : 36 ,
+ "successfulUsers" : 25 ,
+ "failedUsers" : 11
+ },
+ {
+ "taskDefinitionId" : "mcd28c8e-t523-83b1-3d70-jl62b4hh944g",
+ "taskDefinitionDisplayName" : "Send onboarding reminder email",
+ "totalProcessedTasks" : 28,
+ "successfulTasks" : 13,
+ "failedTasks" : 15,
+ "totalUsers" : 37 ,
+ "successfulUsers" : 23 ,
+ "failedUsers" : 14
+ },
+ {
+ "taskDefinitionId" : "beg28c8e-h23-53b1-8f60-kv62b4ee941c",
+ "taskDefinitionDisplayName" : "Generate TAP and Send Email",
+ "totalProcessedTasks" : 30,
+ "successfulTasks" : 18,
+ "failedTasks" : 12,
+ "totalUsers" : 35 ,
+ "successfulUsers" : 24 ,
+ "failedUsers" : 11
+ },
+ {
+ "taskDefinitionId" : "efc28c8e-j322-73b1-9e30-fh62b4ee941d",
+ "taskDefinitionDisplayName" : "Run a custom task extension",
+ "totalProcessedTasks" : 25,
+ "successfulTasks" : 15,
+ "failedTasks" : 10,
+ "totalUsers" : 26 ,
+ "successfulUsers" : 17 ,
+ "failedUsers" : 9
+ },
+ {
+ "taskDefinitionId" : "nmd28c8e-k822-53b1-3d30-ee62b4ee941e",
+ "taskDefinitionDisplayName" : "Request user access package assignment",
+ "totalProcessedTasks" : 26,
+ "successfulTasks" : 18,
+ "failedTasks" : 8,
+ "totalUsers" : 32,
+ "successfulUsers" : 24 ,
+ "failedUsers" : 8
+ },
+ {
+ "taskDefinitionId" : "qbc28c8e-f522-43b1-9d30-ee62b4ee941c",
+ "taskDefinitionDisplayName" : "Send Welcome Email",
+ "totalProcessedTasks" : 25,
+ "successfulTasks" : 20,
+ "failedTasks" : 5,
+ "totalUsers" : 28 ,
+ "successfulUsers" : 22 ,
+ "failedUsers" : 6
+ },
+ ]
+}
+```
v1.0 Identitygovernance Insights Topworkflowsprocessedsummary https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identitygovernance-insights-topworkflowsprocessedsummary.md
+
+ Title: "insights: topWorkflowsProcessedSummary"
+description: "Get a summary of the most processed workflows by Lifecycle Workflows in a tenant."
+
+ms.localizationpriority: medium
+++
+# insights: topWorkflowsProcessedSummary
+
+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).
+
+<!-- {
+ "blockType": "permissions",
+ "name": "identitygovernance-insights-topworkflowsprocessedsummary-permissions"
+}
+-->
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /identityGovernance/lifecycleWorkflows/insights/topWorkflowsProcessedSummary(startDateTime={startDateTime},endDateTime={endDateTime})
+```
+
+## Function parameters
+
+In the request URL, provide the following query parameters with values. The following table lists the parameters that are required when you call this function.
+
+|Parameter|Type|Description|
+|:|:|:|
+|startDateTime|DateTimeOffset|The start date, and time, of the summary of the most workflows processed in a tenant.|
+|endDateTime|DateTimeOffset|The end date, and time, of the summary of the most workflows processed in a tenant.|
+
+## 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 function returns a `200 OK` response code and a [microsoft.graph.identityGovernance.topWorkflowsInsightsSummary](../resources/identitygovernance-topworkflowsinsightssummary.md) collection in the response body.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "insightsthis.topworkflowsprocessedsummary"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/identityGovernance/lifecycleWorkflows/insights/topWorkflowsProcessedSummary(startDateTime=2023-01-01T00:00:00Z,endDateTime=2023-01-31T00:00:00Z)
+```
+
+# [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.identityGovernance.topWorkflowsInsightsSummary)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.identityGovernance.topWorkflowsInsightsSummary)",
+ "value": [
+ {
+ "workflowId" : "6a98cceb-503b-709c-996c-3cg0f24481eb",
+ "workflowDisplayName" : "Pre-hire workflow",
+ "workflowCategory" : "Joiner",
+ "totalRuns" : 30 ,
+ "successfulRuns" : 28 ,
+ "failedRuns" : 2 ,
+ "scheduledRuns" : 26,
+ "onDemandRuns" : 4,
+ "totalUsers" : 45,
+ "successfulUsers" : 38,
+ "failedUsers": 7,
+ "workflowVersion" : 3
+ },
+ {
+ "workflowId" : "8b67ddeb-603b-609c-293f-4dg0f28481ek",
+ "workflowDisplayName" : "Pre-Hire workflow",
+ "workflowCategory" : "Joiner",
+ "totalRuns" : 35 ,
+ "successfulRuns" : 26 ,
+ "failedUsers" : 9,
+ "scheduledRuns" : 30,
+ "onDemandRuns" : 5,
+ "totalUsers" : 56,
+ "successfulUsers" : 47 ,
+ "failedUsers": 9,
+ "workflowVersion" : 1
+ },
+ {
+ "workflowId" : "1f67cceb-203b-909c-096f-6cg0f28481fg",
+ "workflowDisplayName" : "Post-Hire Workflow",
+ "workflowCategory" : "Jeaver",
+ "totalRuns" : 32 ,
+ "successfulRuns" : 25 ,
+ "failedRuns" : 7 ,
+ "scheduldedRuns" : 15,
+ "onDemandRuns" : 17,
+ "totalUsers": 53,
+ "successfulUsers" : 45,
+ "failedUsers" : 8,
+ "workflowVersion" : 2
+ },
+ {
+ "workflowId" : "2s67ddeb-303b-709c-896f-4cg0f28481ed",
+ "workflowDisplayName" : "Pre-Hire Workflow",
+ "workflowCategory" :"Joiner" ,
+ "totalRuns" : 28 ,
+ "successfulRuns" : 23,
+ "failedRuns" : 5,
+ "scheduldedRuns" : 20,
+ "onDemandRuns" : 8,
+ "totalUsers" : 40,
+ "successfulUsers" : 32 ,
+ "failedUsers" : 8,
+ "workflowVersion" : 2
+ },
+ {
+ "workflowId" : "7a67ddeb-503b-909d-995f-3cg0f26481eh",
+ "workflowDisplayName" : "Post-Hire Workflow",
+ "workflowCategory" : "Leaver",
+ "totalRuns" : 26 ,
+ "successfulRuns" : 20 ,
+ "failedRuns" : 6 ,
+ "scheduldedRuns" : 12,
+ "onDemandRuns" : 14,
+ "totalUsers" : 34,
+ "successfulUsers" : 23,
+ "failedUsers" : 11,
+ "workflowVersion" : 1
+ },
+ ]
+}
+```
v1.0 Identitygovernance Insights Workflowsprocessedbycategory https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identitygovernance-insights-workflowsprocessedbycategory.md
+
+ Title: "insights: workflowsProcessedByCategory"
+description: "Provide a summary of workflows processed in a tenant by the workflow category."
+
+ms.localizationpriority: medium
+++
+# insights: workflowsProcessedByCategory
+
+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).
+
+<!-- {
+ "blockType": "permissions",
+ "name": "identitygovernance-insights-workflowsprocessedbycategory-permissions"
+}
+-->
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /identityGovernance/lifecycleWorkflows/insights/workflowsProcessedByCategory(startDateTime={startDateTime},endDateTime={endDateTime})
+```
+
+## Function parameters
+
+In the request URL, provide the following query parameters with values.
+
+|Parameter|Type|Description|
+|:|:|:|
+|startDateTime|DateTimeOffset|The start date, and time, of the insight summary for workflows processed by category in a tenant.|
+|endDateTime|DateTimeOffset|The end date, and time, of the insight summary for workflows processed by category in a tenant.|
+
+## 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 function returns a `200 OK` response code and a [workflowsInsightsByCategory](../resources/identitygovernance-workflowsinsightsbycategory.md) in the response body.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "insightsthis.workflowsprocessedbycategory"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/identityGovernance/lifecycleWorkflows/insights/workflowsProcessedByCategory(startDateTime=2023-01-01T00:00:00Z,endDateTime=2023-01-31T00:00:00Z)
+```
+
+# [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.identityGovernance.workflowsInsightsByCategory"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "totalJoinerRuns" : 136,
+ "successfulJoinerRuns" : 112,
+ "failedJoinerRuns" : 24,
+ "totalMoverRuns" : 97,
+ "successfulMoverRuns" : 79,
+ "failedMoverRuns" : 18,
+ "totalLeaverRuns" : 103,
+ "successfulLeaverRuns" : 96,
+ "failedLeaverRuns" : 7,
+}
+```
v1.0 Identitygovernance Insights Workflowsprocessedsummary https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identitygovernance-insights-workflowsprocessedsummary.md
+
+ Title: "insights: workflowsProcessedSummary"
+description: "Get the summary of workflows processed by Lifecycle Workflows within a tenant."
+
+ms.localizationpriority: medium
+++
+# insights: workflowsProcessedSummary
+
+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).
+
+<!-- {
+ "blockType": "permissions",
+ "name": "identitygovernance-insights-workflowsprocessedsummary-permissions"
+}
+-->
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /identityGovernance/lifecycleWorkflows/insights/workflowsProcessedSummary(startDateTime={startDateTime},endDateTime={endDateTime})
+```
+
+## Function parameters
+
+In the request URL, provide the following query parameters with values. The following table lists the parameters that are required when you call this function.
+
+|Parameter|Type|Description|
+|:|:|:|
+|startDateTime|DateTimeOffset|The start date, and time, of the summary report of workflows processed in a tenant.|
+|endDateTime|DateTimeOffset|The end date, time, of the summary report of workflows processed in a tenant.|
+
+## 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 function returns a `200 OK` response code and a [workflowsInsightsSummary](../resources/identitygovernance-workflowsinsightssummary.md) in the response body.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "insightsthis.workflowsprocessedsummary"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/identityGovernance/lifecycleWorkflows/insights/workflowsProcessedSummary(startDateTime=2023-01-01T00:00:00Z,endDateTime=2023-01-31T00:00:00Z)
+```
+
+# [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.identityGovernance.workflowsInsightsSummary"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#microsoft.graph.identityGovernance.workflowsInsightsSummary",
+ "totalRuns" : 106,
+ "successfulRuns" : 71,
+ "failedRuns": 35,
+ "totalUsers" : 150,
+ "successfulUsers" : 112,
+ "failedUsers" : 38 ,
+ "totalTasks" : 75,
+ "successfulTasks" : 56,
+ "failedTasks" :19 ,
+}
+```
v1.0 Identitygovernance Lifecycleworkflowscontainer List Taskdefinitions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 tasks in Lifecycle Workflows."
ms.localizationpriority: medium
doc_type: apiPageType
Namespace: microsoft.graph.identityGovernance
-Get a list of the [taskDefinition](../resources/identitygovernance-taskdefinition.md) objects and their properties.
+Get a list of built-in 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/v1.0/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/v1.0/$metadata#identityGovernance/lifecycleWorkflows/taskDefinitions",
- "@odata.count": 16,
+ "@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",
+ "category": "joiner,leaver,mover",
"description": "Add user to selected groups",
- "displayName": "Add User To Groups",
+ "displayName": "Add user to groups",
"id": "22085229-5809-45e8-97fd-270d28d66910", "version": 1, "parameters": [
Content-Type: application/json
{ "category": "joiner,leaver", "description": "Disable user account in the directory",
- "displayName": "Disable User Account",
+ "displayName": "Disable user account",
"id": "1dfdfcc7-52fa-4c2e-bf3a-e3919cc12950", "version": 1,
- "parameters": []
+ "parameters": [
+ {
+ "name": "disableOnPremisesAccount",
+ "values": [
+ "true",
+ "false"
+ ],
+ "valueType": "enum"
+ }
+ ]
}, { "category": "joiner,leaver", "description": "Enable user account in the directory",
- "displayName": "Enable User Account",
+ "displayName": "Enable user account",
"id": "6fc52c9d-398b-4305-9763-15f42c1676fc", "version": 1,
- "parameters": []
+ "parameters": [
+ {
+ "name": "enableOnPremisesAccount",
+ "values": [
+ "true",
+ "false"
+ ],
+ "valueType": "enum"
+ }
+ ]
}, {
- "category": "joiner,leaver",
+ "category": "joiner,leaver,mover",
"description": "Remove user from membership of selected Azure AD groups", "displayName": "Remove user from selected groups", "id": "1953a66c-751c-45e5-8bfe-01462c70da3c",
Content-Type: application/json
{ "category": "joiner", "description": "Generate Temporary Access Pass and send via email to user's manager",
- "displayName": "Generate TAP And Send Email",
+ "displayName": "Generate TAP and send email",
"id": "1b555e50-7f65-41d5-b514-5894a026d10d", "version": 1, "parameters": [
Content-Type: application/json
"false" ], "valueType": "enum"
+ },
+ {
+ "name": "cc",
+ "values": [],
+ "valueType": "string"
+ },
+ {
+ "name": "customSubject",
+ "values": [],
+ "valueType": "string"
+ },
+ {
+ "name": "customBody",
+ "values": [],
+ "valueType": "string"
+ },
+ {
+ "name": "locale",
+ "values": [],
+ "valueType": "string"
} ] }, { "category": "joiner", "description": "Send welcome email to new hire",
- "displayName": "Send Welcome Email",
+ "displayName": "Send welcome email",
"id": "70b29d51-b59a-4773-9280-8841dfd3f2ea", "version": 1,
- "parameters": []
+ "parameters": [
+ {
+ "name": "cc",
+ "values": [],
+ "valueType": "string"
+ },
+ {
+ "name": "customSubject",
+ "values": [],
+ "valueType": "string"
+ },
+ {
+ "name": "customBody",
+ "values": [],
+ "valueType": "string"
+ },
+ {
+ "name": "locale",
+ "values": [],
+ "valueType": "string"
+ }
+ ]
}, {
- "category": "joiner,leaver",
- "description": "Add user to selected teams",
- "displayName": "Add User To Teams",
+ "category": "joiner,leaver,mover",
+ "description": "Add user to selected Teams",
+ "displayName": "Add user to Teams",
"id": "e440ed8d-25a1-4618-84ce-091ed5be5594", "version": 1, "parameters": [
Content-Type: application/json
{ "category": "leaver", "description": "Delete user account in Azure AD",
- "displayName": "Delete User Account",
+ "displayName": "Delete user account",
"id": "8d18588d-9ad3-4c0f-99d0-ec215f0e3dff", "version": 1,
- "parameters": []
+ "parameters": [
+ {
+ "name": "deleteOnPremisesAccount",
+ "values": [
+ "true",
+ "false"
+ ],
+ "valueType": "enum"
+ }
+ ]
}, {
- "category": "joiner,leaver",
+ "category": "joiner,leaver,mover",
"description": "Remove user from membership of selected Teams", "displayName": "Remove user from selected Teams", "id": "06aa7acb-01af-4824-8899-b14e5ed788d6",
Content-Type: application/json
"parameters": [] }, {
- "category": "joiner,leaver",
+ "category": "joiner,leaver,mover",
"description": "Run a Custom Task Extension to callout to an external system.", "displayName": "Run a Custom Task Extension", "id": "4262b724-8dba-4fad-afc3-43fcbb497a0e",
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": []
+ "parameters": [
+ {
+ "name": "cc",
+ "values": [],
+ "valueType": "string"
+ },
+ {
+ "name": "customSubject",
+ "values": [],
+ "valueType": "string"
+ },
+ {
+ "name": "customBody",
+ "values": [],
+ "valueType": "string"
+ },
+ {
+ "name": "locale",
+ "values": [],
+ "valueType": "string"
+ }
+ ]
}, { "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": []
+ "parameters": [
+ {
+ "name": "cc",
+ "values": [],
+ "valueType": "string"
+ },
+ {
+ "name": "customSubject",
+ "values": [],
+ "valueType": "string"
+ },
+ {
+ "name": "customBody",
+ "values": [],
+ "valueType": "string"
+ },
+ {
+ "name": "locale",
+ "values": [],
+ "valueType": "string"
+ }
+ ]
}, { "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": [
+ {
+ "name": "cc",
+ "values": [],
+ "valueType": "string"
+ },
+ {
+ "name": "customSubject",
+ "values": [],
+ "valueType": "string"
+ },
+ {
+ "name": "customBody",
+ "values": [],
+ "valueType": "string"
+ },
+ {
+ "name": "locale",
+ "values": [],
+ "valueType": "string"
+ }
+ ]
+ },
+ {
+ "category": "joiner",
+ "description": "Send onboarding reminder email to user's manager",
+ "displayName": "Send onboarding reminder email",
+ "id": "3C860712-2D37-42A4-928F-5C93935D26A1",
+ "version": 1,
+ "parameters": [
+ {
+ "name": "cc",
+ "values": [],
+ "valueType": "string"
+ },
+ {
+ "name": "customSubject",
+ "values": [],
+ "valueType": "string"
+ },
+ {
+ "name": "customBody",
+ "values": [],
+ "valueType": "string"
+ },
+ {
+ "name": "locale",
+ "values": [],
+ "valueType": "string"
+ }
+ ]
+ },
+ {
+ "category": "joiner,mover",
+ "description": "Request user assignment to selected access package",
+ "displayName": "Request user access package assignment",
+ "id": "c1ec1e76-f374-4375-aaa6-0bb6bd4c60be",
+ "version": 1,
+ "parameters": [
+ {
+ "name": "assignmentPolicyId",
+ "values": [],
+ "valueType": "string"
+ },
+ {
+ "name": "accessPackageId",
+ "values": [],
+ "valueType": "string"
+ }
+ ]
+ },
+ {
+ "category": "leaver,mover",
+ "description": "Remove user assignment of selected access package",
+ "displayName": "Remove access package assignment for user",
+ "id": "4a0b64f2-c7ec-46ba-b117-18f262946c50",
+ "version": 1,
+ "parameters": [
+ {
+ "name": "accessPackageId",
+ "values": [],
+ "valueType": "string"
+ }
+ ]
+ },
+ {
+ "category": "leaver",
+ "description": "Remove all access packages assigned to the user",
+ "displayName": "Remove all access package assignments for user",
+ "id": "42ae2956-193d-4f39-be06-691b8ac4fa1d",
+ "version": 1,
+ "parameters": []
+ },
+ {
+ "category": "leaver",
+ "description": "Cancel all pending access packages assignment requests for the user",
+ "displayName": "Cancel pending access package assignment requests for user",
+ "id": "498770d9-bab7-4e4c-b73d-5ded82a1d0b3",
+ "version": 1,
"parameters": []
+ },
+ {
+ "category": "mover",
+ "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,
+ "parameters": [
+ {
+ "name": "cc",
+ "values": [],
+ "valueType": "string"
+ },
+ {
+ "name": "customSubject",
+ "values": [],
+ "valueType": "string"
+ },
+ {
+ "name": "customBody",
+ "values": [],
+ "valueType": "string"
+ },
+ {
+ "name": "locale",
+ "values": [],
+ "valueType": "string"
+ }
+ ]
+ },
+ {
+ "category": "joiner,mover",
+ "description": "Assign selected licenses to the user",
+ "displayName": "Assign licenses to user",
+ "id": "683c87a4-2ad4-420b-97d4-220d90afcd24",
+ "version": 1,
+ "parameters": [
+ {
+ "name": "licenses",
+ "values": [],
+ "valueType": "string"
+ }
+ ]
+ },
+ {
+ "category": "leaver,mover",
+ "description": "Remove selected licenses assigned to the user",
+ "displayName": "Remove licenses from user",
+ "id": "5fc402a8-daaf-4b7b-9203-da868b05fc5f",
+ "version": 1,
+ "parameters": [
+ {
+ "name": "licenses",
+ "values": [],
+ "valueType": "string"
+ }
+ ]
} ] }
v1.0 Identitygovernance Taskdefinition Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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
doc_type: apiPageType
Namespace: microsoft.graph.identityGovernance
-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 Learningcourseactivity Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/learningcourseactivity-get.md
To get a specific learning course activity based on its **externalCourseActivity
} --> ``` http
-GET /employeeExperience/learningProviders/{registrationId}/learningCourseActivities(externalCourseActivityId={externalCourseActivityId})
+GET /employeeExperience/learningProviders/{registrationId}/learningCourseActivities(externalCourseActivityId='{externalCourseActivityId}')
``` To get the details of a learning course activity for a user:
The following example shows a request to get the details of a learning course ac
}--> ``` http
-GET https://graph.microsoft.com/v1.0/employeeExperience/learningProviders/01e8f81b-3060-4dec-acf0-0389665a0a38/learningCourseActivities(externalCourseActivityId=12a2228a-e020-11ec-9d64-0242ac120002)
+GET https://graph.microsoft.com/v1.0/employeeExperience/learningProviders/01e8f81b-3060-4dec-acf0-0389665a0a38/learningCourseActivities(externalCourseActivityId='12a2228a-e020-11ec-9d64-0242ac120002')
``` # [C#](#tab/csharp)
v1.0 M365appsinstallationoptions Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/m365appsinstallationoptions-get.md
Choose the permission or permissions marked as least privileged for this API. Us
[!INCLUDE [permissions-table](../includes/permissions/m365appsinstallationoptions-get-permissions.md)] When calling on behalf of a user, the user needs to belong to the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json):
-+ Global administrator
++ Office apps administrator (recommended) + Global reader
-+ Office apps administrator
++ Global administrator ## HTTP request
v1.0 M365appsinstallationoptions Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/m365appsinstallationoptions-update.md
Choose the permission or permissions marked as least privileged for this API. Us
[!INCLUDE [permissions-table](../includes/permissions/m365appsinstallationoptions-update-permissions.md)] When calling on behalf of a user, the user needs to belong to the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json):-++ Office apps administrator (recommended) + Global administrator
-+ Office apps administrator
## HTTP request
v1.0 Multitenantorganization Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganization-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-multitenantorganization-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-multitenantorganization-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/v1.0/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/v1.0/api/onattributecollectionexternalusersselfservicesignup-delete-attributes.md
doc_type: apiPageType
# Remove attribute (from user flow) 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 **onAttributeCollection** > **attributes** and **onAttributeCollection** > **attributeCollectionPage** > **views** collections of 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",
DELETE https://graph.microsoft.com/v1.0/identity/authenticationEventsFlows/0313c
[!INCLUDE [sample-code](../includes/snippets/php/delete-onattributecollectionexternalusersselfservicesignup-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-onattributecollectionexternalusersselfservicesignup-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Onattributecollectionexternalusersselfservicesignup List Attributes https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/onattributecollectionexternalusersselfservicesignup-list-attributes.md
GET https://graph.microsoft.com/v1.0/identity/authenticationEventsFlows/0313cc37
[!INCLUDE [sample-code](../includes/snippets/php/get-onattributecollectionexternalusersselfservicesignup-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-onattributecollectionexternalusersselfservicesignup-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Onattributecollectionexternalusersselfservicesignup Post Attributes https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/onattributecollectionexternalusersselfservicesignup-post-attributes.md
doc_type: apiPageType
# Add attribute (to user flow) Namespace: microsoft.graph
-Add an attribute to an external identities self-service user flow represented by an [externalUsersSelfServiceSignupEventsFlow](../resources/externalusersselfservicesignupeventsflow.md) object. You can add both custom and built-in attributes to a user flow.
+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.
-Prerequisite: [PATCH the user flow](../api/authenticationeventsflow-update.md) with the updated onAttributeCollection event that includes the new attribute.
+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 unsucces
#### 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) <!-- {
POST https://graph.microsoft.com/v1.0/identity/authenticationEventsFlows/0313cc3
[!INCLUDE [sample-code](../includes/snippets/php/onattributecollectionexternalusersselfservicesignup-post-attributes-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/onattributecollectionexternalusersselfservicesignup-post-attributes-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Onauthenticationmethodloadstartexternalusersselfservicesignup Delete Identityproviders https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/onauthenticationmethodloadstartexternalusersselfservicesignup-delete-identityproviders.md
DELETE https://graph.microsoft.com/v1.0/identity/authenticationEventsFlows/0313c
[!INCLUDE [sample-code](../includes/snippets/php/delete-onauthenticationmethodloadstartexternalusersselfservicesignup-identityproviders-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-onauthenticationmethodloadstartexternalusersselfservicesignup-identityproviders-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Onauthenticationmethodloadstartexternalusersselfservicesignup List Identityproviders https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/onauthenticationmethodloadstartexternalusersselfservicesignup-list-identityproviders.md
GET https://graph.microsoft.com/v1.0/identity/authenticationEventsFlows/0313cc37
[!INCLUDE [sample-code](../includes/snippets/php/list-onauthenticationmethodloadstartexternalusersselfservicesignup-identityproviders-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-onauthenticationmethodloadstartexternalusersselfservicesignup-identityproviders-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Onedriveforbusinessprotectionpolicy List Driveinclusionrules https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/onedriveforbusinessprotectionpolicy-list-driveinclusionrules.md
If successful, this method returns a `200 OK` response code and a [driveProtecti
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "onedriveforbusinessprotectionpolicy_list_driveinclusionrule"
The following example shows a request.
GET https://graph.microsoft.com/v1.0/solutions/backupRestore/oneDriveForBusinessProtectionPolicies/71633878-8321-4950-bfaf-ed285bdd1461/driveInclusionRules ```
+# [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 Onedriveforbusinessprotectionpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "onedriveforbusinessprotectionpolicy_update"
PATCH https://graph.microsoft.com/v1.0/solutions/backupRestore/oneDriveForBusine
} ```
+# [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 Onedriveforbusinessrestoresession List Driverestoreartifacts https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_driverestoreartifact"
The following example shows a request.
GET https://graph.microsoft.com/v1.0/solutions/backupRestore/oneDriveForBusinessRestoreSessions/845457dc-4bb2-4815-bef3-8628ebd1952e/driveRestoreArtifacts ```
+# [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 Onedriveforbusinessrestoresession Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "onedriveforbusinessrestoresession_update"
PATCH https://graph.microsoft.com/v1.0/solutions/backupRestore/oneDriveForBusine
} ```
+# [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 Onlinemeeting Getallrecordings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/onlinemeeting-getallrecordings.md
+
+ Title: "onlineMeeting: getAllRecordings"
+description: "Get recordings from all online meetings that a user is an organizer of."
+
+ms.localizationpriority: medium
+++
+# onlineMeeting: getAllRecordings
+
+Namespace: microsoft.graph
+
+Get all recordings from scheduled [onlineMeeting](../resources/onlinemeeting.md) instances for which the specified user is the organizer. This API currently doesn't support getting call recordings from channel meetings.
+
+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 perform 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 [Export content with the Microsoft Teams export APIs](/microsoftteams/export-teams-content).
+++
+## 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": "onlinemeeting_getallrecordings" } -->
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+``` http
+GET /users/{usersId}/onlineMeetings/getAllRecordings(meetingOrganizerUserId='{userId}',startDateTime={startDateTime},endDateTime={endDateTime})
+```
+>**Note:** The request fails if you don't pass the function parameter **meetingOrganizerUserId** or a filter clause with **MeetingOrganizer/User/Id**.
+
+## 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. 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`.|
+
+## Optional query parameters
+
+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
+
+| Header | Value |
+|:|:--|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [callRecording](../resources/callrecording.md) objects in the response body.
+
+## Examples
+
+### Example 1: Get all recordings
+
+The following example shows a request to get all the recordings of a given meeting organizer.
+
+#### Request
+
+The following example shows a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "sampleKeys": ["8b081ef6-4792-4def-b2c9-c363a1bf41d5"],
+ "name": "get_allrecordings"
+}-->
+```msgraph-interactive
+GET https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllRecordings?$filter=MeetingOrganizer/User/Id eq '8b081ef6-4792-4def-b2c9-c363a1bf41d5'
+```
+
+# [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,
+ "name": "get_allrecordings",
+ "@odata.type": "Collection(microsoft.graph.callRecording)"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(callRecording)",
+ "@odata.nextLink": "https://graph.microsoft.com/v1.0/users({userId})/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')?skipToken={skipToken}",
+ "@odata.count": 1,
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.callRecording",
+ "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=",
+ "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy",
+ "createdDateTime": "2023-12-02T06:59:34.7411768Z",
+ "recordingContentUrl": "https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy/recordings/VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=/content",
+ "meetingOrganizer": {
+ "application": null,
+ "device": null,
+ "user": {
+ "@odata.type": "#microsoft.graph.teamworkUserIdentity",
+ "id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "displayName": null,
+ "userIdentityType": "aadUser",
+ "tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853"
+ }
+ }
+ }
+ ]
+}
+```
+
+### 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",
+ "sampleKeys": ["8b081ef6-4792-4def-b2c9-c363a1bf41d5", "2024-01-15T00:00:00Z", "2024-01-31T00:00:00Z"],
+ "name": "get_allrecordings_with_dates"
+}-->
+```msgraph-interactive
+GET https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5', startDateTime=2024-01-15T00:00:00Z, endDateTime=2024-01-31T00:00:00Z)
+```
+
+# [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,
+ "name": "get_allrecordings_with_dates",
+ "@odata.type": "Collection(microsoft.graph.callRecording)"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(callRecording)",
+ "@odata.nextLink": "https://graph.microsoft.com/v1.0/users({userId})/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5', startDateTime=2024-01-15T00:00:00Z, endDateTime=2024-01-31T00:00:00Z)?skipToken={skipToken}",
+ "@odata.count": 1,
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.callRecording",
+ "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=",
+ "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy",
+ "createdDateTime": "2023-12-02T06:59:34.7411768Z",
+ "recordingContentUrl": "https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy/recordings/VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=/content",
+ "meetingOrganizer": {
+ "application": null,
+ "device": null,
+ "user": {
+ "@odata.type": "#microsoft.graph.teamworkUserIdentity",
+ "id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "displayName": null,
+ "userIdentityType": "aadUser",
+ "tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853"
+ }
+ }
+ }
+ ]
+}
+```
+
+## 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)
v1.0 Onlinemeeting Getalltranscripts https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/onlinemeeting-getalltranscripts.md
+
+ Title: "onlineMeeting: getAllTranscripts"
+description: "Get transcripts from all online meetings that a user is an organizer of."
+
+ms.localizationpriority: medium
+++
+# onlineMeeting: getAllTranscripts
+
+Namespace: microsoft.graph
+
+Get all transcripts from scheduled [onlineMeeting](../resources/onlinemeeting.md) instances for which the specified user is the organizer. This API currently doesn't support getting call transcripts from channel meetings.
+
+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 perform 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 [Export content with the Microsoft Teams export APIs](/microsoftteams/export-teams-content).
+++
+## 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": "onlinemeeting_getalltranscripts" } -->
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+``` http
+GET /users/{usersId}/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='{userId}',startDateTime={startDateTime},endDateTime={endDateTime})
+```
+>**Note:** The request fails if you don't pass the function parameter **meetingOrganizerUserId**, or a filter clause with **MeetingOrganizer/User/Id**.
+
+## 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 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`.|
+
+## Optional query parameters
+
+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
+
+| Header | Value |
+|:|:--|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [callTranscript](../resources/calltranscript.md) objects in the response body.
+
+## Examples
+
+### Example 1: Get all transcripts
+
+The following example shows a request to get all the transcripts of a given meeting organizer.
+
+#### Request
+
+The following example shows a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "sampleKeys": ["8b081ef6-4792-4def-b2c9-c363a1bf41d5"],
+ "name": "get_alltranscripts"
+}-->
+```msgraph-interactive
+GET https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllTranscripts?$filter=MeetingOrganizer/User/Id eq '8b081ef6-4792-4def-b2c9-c363a1bf41d5'
+```
+
+# [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,
+ "name": "get_alltranscripts",
+ "@odata.type": "Collection(microsoft.graph.callTranscript)"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(callTranscript)",
+ "@odata.nextLink": "https://graph.microsoft.com/v1.0/users({userId})/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')?skipToken={skipToken}",
+ "@odata.count": 1,
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.callTranscript",
+ "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=",
+ "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy",
+ "createdDateTime": "2023-12-02T06:59:34.7411768Z",
+ "transcriptContentUrl": "https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy/transcripts/VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=/content",
+ "meetingOrganizer": {
+ "application": null,
+ "device": null,
+ "user": {
+ "@odata.type": "#microsoft.graph.teamworkUserIdentity",
+ "id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "displayName": null,
+ "userIdentityType": "aadUser",
+ "tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853"
+ }
+ }
+ }
+ ]
+}
+```
+
+### Example 2: Get all transcripts of a given meeting organizer using the 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",
+ "sampleKeys": ["8b081ef6-4792-4def-b2c9-c363a1bf41d5", "2024-01-15T00:00:00Z", "2024-01-31T00:00:00Z"],
+ "name": "get_alltranscripts_with_dates"
+}-->
+```msgraph-interactive
+GET https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5', startDateTime=2024-01-15T00:00:00Z, endDateTime=2024-01-31T00:00:00Z)
+```
+
+# [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,
+ "name": "get_alltranscripts_with_dates",
+ "@odata.type": "Collection(microsoft.graph.callTranscript)"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(callTranscript)",
+ "@odata.nextLink": "https://graph.microsoft.com/v1.0/users({userId})/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5', startDateTime=2024-01-15T00:00:00Z, endDateTime=2024-01-31T00:00:00Z)?skipToken={skipToken}",
+ "@odata.count": 1,
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.callTranscript",
+ "id": "VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=",
+ "meetingId": "MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy",
+ "createdDateTime": "2023-12-02T06:59:34.7411768Z",
+ "transcriptContentUrl": "https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSoxYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTEqMCoqMTk6bWVldGluZ19PVEJsT1RjeE16QXROemMwWVMwMFl6QTFMVGhpWldFdFpUaGtNMlk0WkRKaFlUQTFAdGhyZWFkLnYy/transcripts/VjIjIzExYzkxNjVmZi1hZTkyLTQ5YWYtODliNC00MTU1NTRhMzZhNTFhMWQyODZkYi02MTQ5LTRiM2QtOTVhZC0yM2M5ZTFiZjY4NTMwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODA3ZTcwYzAyM2U4MGEwOWVmN2ZmZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDI3N2Q3NzZjYmNmMjQ5NGNiNDk0NDExZGE3YzRhMmM1IyM3YTM2NDRjYi1mMDA3LTRjMDAtOWJiMy1jMTUzYzE4ODY4NGY=/content",
+ "meetingOrganizer": {
+ "application": null,
+ "device": null,
+ "user": {
+ "@odata.type": "#microsoft.graph.teamworkUserIdentity",
+ "id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "displayName": null,
+ "userIdentityType": "aadUser",
+ "tenantId": "a1d286db-6149-4b3d-95ad-23c9e1bf6853"
+ }
+ }
+ }
+ ]
+}
+```
+
+## 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)
v1.0 Payload Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 Protectionpolicybase Activate https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "protectionpolicybase_activate_example_1"
The following example shows a request.
POST https://graph.microsoft.com/v1.0/solutions/backupRestore/ProtectionPolicies/61633878-8321-4950-bfaf-ed285bdd1461/activate ```
+# [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-Location: https://graph.microsoft.com/v1.0/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 The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "protectionpolicybase_activate_example_2"
The following example shows a request.
POST https://graph.microsoft.com/v1.0/solutions/backupRestore/protectionPolicies/61633878-8321-4950-bfaf-ed285bdd1461/activate ```
+# [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 Protectionpolicybase Deactivate https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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
Deactivating the protection policy when it is in active state.
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "protectionpolicybase_deactivate_example_1"
The following example shows a request.
POST https://graph.microsoft.com/v1.0/solutions/backupRestore/ProtectionPolicies/61633878-8321-4950-bfaf-ed285bdd1461/deactivate ```
+# [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.
Deactivating the protection policy when it is in updating state.
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "protectionpolicybase_deactivate_example_2"
The following example shows a request.
POST https://graph.microsoft.com/v1.0/solutions/backupRestore/protectionPolicies/61633878-8321-4950-bfaf-ed285bdd1461/deactivate ```
+# [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 Protectionpolicybase Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_protectionpolicybase"
DELETE https://graph.microsoft.com/v1.0/solutions/backupRestore/protectionPolici
Authorization: Bearer <Access-Token> ```
+# [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 Protectionpolicybase Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "protectionpolicybase_get"
GET https://graph.microsoft.com/v1.0/solutions/backupRestore/ProtectionPolicies/
Authorization: Bearer <Access-Token> ```
+# [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 Protectionrulebase Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/protectionrulebase-delete.md
The following example shows how to delete a siteInclusionRule associated with a
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "siteprotectionrule_delete"
The following example shows a request.
DELETE https://graph.microsoft.com/v1.0/solutions/backupRestore/sharePointProtectionPolicies/71633878-8321-4950-bfaf-ed285bdd1461/siteInclusionRules/51633878-8321-4950-bfaf-ed285bdd1461 ```
+# [JavaScript](#tab/javascript)
+++ #### Response The following example shows the response.
The following example shows how to delete a driveInclusionRule associated with a
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_driveprotectionrule"
The following example shows a request.
DELETE https://graph.microsoft.com/v1.0/solutions/backupRestore/oneDriveForBusinessProtectionPolicies/71633878-8321-4950-bfaf-ed285bdd1461/driveInclusionRules/51633878-8321-4950-bfaf-ed285bdd1461 ```
+# [JavaScript](#tab/javascript)
+++ #### Response The following example shows the response.
The following example shows how to delete a mailboxInclusionRule associated with
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "mailboxprotectionrule_delete"
The following example shows a request.
DELETE https://graph.microsoft.com/v1.0/solutions/backupRestore/exchangeProtectionPolicies/71633878-8321-4950-bfaf-ed285bdd1461/mailboxInclusionRules/51633878-8321-4950-bfaf-ed285bdd1461 ```
+# [JavaScript](#tab/javascript)
+++ #### Response The following example shows the response.
v1.0 Protectionrulebase Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/protectionrulebase-get.md
The following example shows how to get a **siteInclusionRule** associated with a
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "sharepointprotectionpolicy_get_siteinclusionrules"
The following example shows a request.
GET https://graph.microsoft.com/v1.0/solutions/backupRestore/sharePointProtectionPolicies/71633878-8321-4950-bfaf-ed285bdd1461/siteInclusionRules/61633878-8321-4950-bfaf-ed285bdd1461 ```
+# [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.
he following example shows how to get a **driveInclusionRule** associated with a
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "onedriveforbusinessprotectionpolicy_get_driveinclusionrule"
The following example shows a request.
GET https://graph.microsoft.com/v1.0/solutions/backupRestore/oneDriveForBusinessProtectionPolicies/71633878-8321-4950-bfaf-ed285bdd1461/driveInclusionRules/61633878-8321-4950-bfaf-ed285bdd1461 ```
+# [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.
he following example shows how to get a **mailboxInclusionRule** associated with
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "exchangeprotectionpolicy_get_mailboxinclusionrule"
The following example shows a request.
GET https://graph.microsoft.com/v1.0/solutions/backupRestore/exchangeProtectionPolicies/71633878-8321-4950-bfaf-ed285bdd1461/mailboxInclusionRules/61633878-8321-4950-bfaf-ed285bdd1461 ```
+# [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 Protectionrulebase Post https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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
The following example shows how to create a new **siteInclusionRule** associated
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "sharepointprotectionpolicy_create_siteinclusionrules"
Content-Type: application/json
} ```
+# [JavaScript](#tab/javascript)
+++ #### Response The following example shows the response.
The following example shows how to create a new **driveInclusionRule** associate
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "onedriveforbusinessprotectionpolicy_create_driveinclusionrules"
Content-Type: application/json
} ```
+# [JavaScript](#tab/javascript)
+++ #### Response The following example shows the response.
The following example shows how to create a new **mailboxInclusionRule** associa
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "exchangeprotectionpolicy-create-mailboxinclusionrules"
POST https://graph.microsoft.com/v1.0/solutions/backupRestore/exchangeProtection
} ```
+# [JavaScript](#tab/javascript)
+++ #### Response The following example shows the response.
v1.0 Protectionrulebase Run https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/protectionrulebase-run.md
The following example shows how to activate a **siteInclusionRule** associated w
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "siteprotectionrulethis.run"
The following example shows a request.
POST https://graph.microsoft.com/v1.0/solutions/backupRestore/sharePointProtectionPolicies/71633878-8321-4950-bfaf-ed285bdd1461/siteInclusionRules/61633878-8321-4950-bfaf-ed285bdd1461/run ```
+# [JavaScript](#tab/javascript)
+++ #### Response The following example shows the response.
The following example shows how to activate a **driveInclusionRule**associated w
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "driveprotectionrulethis_run"
The following example shows a request.
POST https://graph.microsoft.com/v1.0/solutions/backupRestore/oneDriveForBusinessProtectionPolicies/71633878-8321-4950-bfaf-ed285bdd1461/driveInclusionRules/61633878-8321-4950-bfaf-ed285bdd1461/run ```
+# [JavaScript](#tab/javascript)
+++ ### Response The following example shows the response.
The following example shows how to activate a **mailboxInclusionRule** associate
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "mailboxprotectionrulethis.run"
The following example shows a request.
POST https://graph.microsoft.com/v1.0/solutions/backupRestore/exchangeProtectionPolicies/{exchangeProtectionPolicyId}/mailboxInclusionRules/{mailboxProtectionRuleId}/run ```
+# [JavaScript](#tab/javascript)
+++ #### Response The following example shows the response.
v1.0 Protectionunitbase Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "protectionunitbase_get"
The following example shows a request.
GET https://graph.microsoft.com/v1.0/solutions/backupRestore/protectionUnits/89014d8c-71fe-4d00-a01a-31850bc5b32c ```
+# [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 Range Cell https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/range-cell.md
Here is an example of how to call this API.
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!--{ "blockType": "request", "isComposable": true,
The following example shows a request.
GET https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/names/{name}/range/cell(row=5,column=6) ```
+# [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 Clear https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 Column https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/range-column.md
Here is an example of how to call this API.
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!--{ "blockType": "request", "isComposable": true,
The following example shows a request.
GET https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/names/{name}/range/column(column=5) ```
+# [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 Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/range-delete.md
doc_type: apiPageType
Namespace: microsoft.graph 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/v1.0/api/range-entirecolumn.md
doc_type: apiPageType
Namespace: microsoft.graph 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", "isComposable": true,
The following example shows a request.
GET https://graph.microsoft.com/v1.0/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/v1.0/api/range-entirerow.md
doc_type: apiPageType
Namespace: microsoft.graph 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", "isComposable": true,
The following example shows a request.
GET https://graph.microsoft.com/v1.0/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/v1.0/api/range-insert.md
doc_type: apiPageType
Namespace: microsoft.graph 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/v1.0/api/range-lastcell.md
doc_type: apiPageType
Namespace: microsoft.graph 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", "isComposable": true,
The following example shows a request.
GET https://graph.microsoft.com/v1.0/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/v1.0/api/range-lastcolumn.md
doc_type: apiPageType
Namespace: microsoft.graph 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", "isComposable": true,
The following example shows a request.
GET https://graph.microsoft.com/v1.0/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/v1.0/api/range-lastrow.md
doc_type: apiPageType
Namespace: microsoft.graph 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", "isComposable": true,
The following example shows a request.
GET https://graph.microsoft.com/v1.0/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/v1.0/api/range-merge.md
doc_type: apiPageType
Namespace: microsoft.graph 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/v1.0/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/v1.0/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/v1.0/api/range-usedrange.md
doc_type: apiPageType
Namespace: microsoft.graph 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", "isComposable": true,
The following example shows a request.
GET https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/names/{name}/range/usedRange ```
+# [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.
Here is an example specifying the optional `valuesOnly` parameter.
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!--{ "blockType": "request", "isComposable": true,
The following example shows a request.
GET https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/names/{name}/range/usedRange(valuesOnly=true) ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
+++ ##### Response <!-- {
v1.0 Rangeborder Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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/v1.0/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/v1.0/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/v1.0/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/v1.0/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/v1.0/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", "isComposable": true,
The following example shows a request.
GET https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/names/{name}/range/format/borders/itemAt(index=1) ```
+# [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/v1.0/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/v1.0/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/v1.0/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/v1.0/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/v1.0/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/v1.0/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/v1.0/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/v1.0/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/v1.0/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/v1.0/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/v1.0/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/v1.0/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/v1.0/api/rangeformat-get.md
doc_type: apiPageType
Namespace: microsoft.graph 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/v1.0/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/v1.0/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/v1.0/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/v1.0/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/v1.0/api/rangeformat-update.md
doc_type: apiPageType
Namespace: microsoft.graph 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_two1"
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_two1"
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_font_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 background color of the third cell.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_rangeformat_fill_three_v_one"
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/v1.0/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 Restorepoint Search https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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
If successful, this action returns a `200 OK` response code and a [restorePointS
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "restorepoint_search"
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
+- 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.
+ The following example shows the response. >**Note:** The response object shown here might be shortened for readability. <!-- {
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/v1.0/api/restoresessionbase-activate.md
Namespace: microsoft.graph
Activate a draft [restoreSessionBase](../resources/restoresessionbase.md) object.
+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 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)] ## Permissions
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 The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "restoresessionbasethis.activate"
The following example shows a request.
POST https://graph.microsoft.com/v1.0/solutions/backupRestore/restoreSessions/61633878-8321-4950-bfaf-ed285bdd1461/activate ```
+# [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 Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "restoresessionbase_delete"
The following example shows a request.
DELETE https://graph.microsoft.com/v1.0/solutions/backupRestore/restoreSessions/61633878-8321-4950-bfaf-ed285bdd1461 ```
+# [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 Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "restoresessionbase_get"
The following example shows a request.
GET https://graph.microsoft.com/v1.0/solutions/backupRestore/restoreSessions/959ba739-70b5-43c4-8c90-b2c22014f18b ```
+# [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 Security Healthissue Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-healthissue-get.md
+
+ Title: "Get healthIssue"
+description: "Read the properties and relationships of a healthIssue object."
++++
+# Get healthIssue
+
+Namespace: microsoft.graph.security
+
+Read the properties and relationships of a [healthIssue](../resources/security-healthissue.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": "security_healthissue_get"
+}
+-->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /security/identities/healthIssues/{healthIssueId}
+```
+
+## 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 [microsoft.graph.security.healthIssue](../resources/security-healthissue.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+<!-- {
+ "blockType": "request",
+ "name": "get_healthissue"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/security/identities/healthIssues/bf600aba-e975-0274-d332-c0f79dc75740
+```
++
+### 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.security.healthIssue"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.security.healthIssue",
+ "additionalInformation": ["Descendant User Objects (Schema-Id-Guid: bf967aba-0de6-11d0-a285-00aa003049e2)"],
+ "createdDateTime": "2022-07-15T12:19:27.7211305Z",
+ "description": "Directory Services Object Auditing isn't configured as required on domain1.contoso.com",
+ "displayName": "Directory Services Object Auditing isn't configured as required",
+ "domainNames": ["domain1.contoso.com", "domain2.contoso.com"],
+ "healthIssueType": "Global",
+ "id": "b3c1b5fc-828c-45fa-a1e1-10d74f6d6e9c",
+ "issueTypeId": "1031",
+ "lastModifiedDateTime": "2022-07-15T12:19:27.7211305Z",
+ "recommendations": ["Please configure the Directory Services Object Auditing events according to the guidance as described in https://aka.ms/mdi/objectauditing"],
+ "recommendedActionCommands": ["Import-Module DefenderForIdentity"],
+ "sensorDNSNames": ["DC1.domain1.contoso.com", "DC2.domain2.contoso.com"],
+ "severity": "medium",
+ "status": "open"
+}
+```
v1.0 Security Healthissue Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-healthissue-update.md
+
+ Title: "Update healthIssue"
+description: "Update the properties of a healthIssue object."
+
+ms.localizationpriority: medium
+++
+# Update healthIssue
+
+Namespace: microsoft.graph.security
+
+Update the properties of a [healthIssue](../resources/security-healthissue.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": "security_healthissue_update" } -->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /security/identities/healthIssues/{healthIssueId}
+```
+
+## 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|
+|:|:|:|
+|status|microsoft.graph.security.healthIssueStatus|The status of the health issue. The possible values are: `open`, `closed`, `suppressed`, `unknownFutureValue`.|
++
+## Response
+
+If successful, this method returns a `200 OK` response code and an updated [microsoft.graph.security.healthIssue](../resources/security-healthissue.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+<!-- {
+ "blockType": "request",
+ "name": "update_healthissue"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/v1.0/security/identities/healthIssues/b3c1b5fc-828c-45fa-a1e1-10d74f6d6e9c
+Content-Type: application/json
+
+{
+ "status": "closed"
+}
+```
+
+### Response
+
+The following example shows the response.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "@odata.type": "microsoft.graph.security.healthIssue",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.security.healthIssue",
+ "additionalInformation": ["Descendant User Objects (Schema-Id-Guid: bf967aba-0de6-11d0-a285-00aa003049e2)"],
+ "createdDateTime": "2022-07-15T12:19:27.7211305Z",
+ "description": "Directory Services Object Auditing isn't configured as required on domain1.contoso.com",
+ "displayName": "Directory Services Object Auditing isn't configured as required",
+ "domainNames": ["domain1.contoso.com", "domain2.contoso.com"],
+ "healthIssueType": "Global",
+ "id": "b3c1b5fc-828c-45fa-a1e1-10d74f6d6e9c",
+ "issueTypeId": "1031",
+ "lastModifiedDateTime": "2022-07-15T12:19:27.7211305Z",
+ "recommendations": ["Please configure the Directory Services Object Auditing events according to the guidance as described in https://aka.ms/mdi/objectauditing"],
+ "recommendedActionCommands": ["Import-Module DefenderForIdentity"],
+ "sensorDNSNames": ["DC1.domain1.contoso.com", "DC2.domain2.contoso.com"],
+ "severity": "medium",
+ "status": "closed"
+}
+```
v1.0 Security Identitycontainer List Healthissues https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-identitycontainer-list-healthissues.md
+
+ Title: "List healthIssues"
+description: "Get a list of the healthIssue objects and their properties."
+
+ms.localizationpriority: medium
+++
+# List healthIssues
+
+Namespace: microsoft.graph.security
+
+Get a list of [healthIssue](../resources/security-healthissue.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": "security_identitycontainer_list_healthissues"
+}
+-->
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /security/identities/healthIssues
+```
+
+## Optional query parameters
+
+This method supports the `$count`, `$filter`, `$skip`, `$top`, and `$select` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+The following examples show how to use optional query parameters.
+
+### Get all open health alerts
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /security/identities/healthIssues?$filter=Status eq 'open'
+```
+
+### Get the top five open health alerts
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /security/identities/healthIssues?$filter=Status eq 'open'&$top=5
+```
+
+### Get open health alerts based on issue type
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /security/identities/healthIssues?$filter=Status eq 'open' and healthIssueType eq 'global'
+GET /security/identities/healthIssues?$filter=Status eq 'open' and healthIssueType eq 'sensor'
+```
+
+### Get open health alerts based on severity
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /security/identities/healthIssues?$filter=Status eq 'open' and severity eq 'medium'
+GET /security/identities/healthIssues?$filter=Status eq 'open' and severity eq 'low'
+```
+
+### Get open global health alerts where the domain name or sensor DNS name ends with a specific value
+
+The following example shows how to get global health alerts where the domain name or sensor DNS name ends with a specific value, for example, `contoso.com`.
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /security/identities/healthissues?$filter=Status eq 'open' and healthIssueType eq 'global' and domainNames/any(s:endswith(s,'contoso.com'))
+GET /security/identities/healthissues?$filter=Status eq 'open' and healthIssueType eq 'global' and sensorDNSNames/any(s:endswith(s,'contoso.com'))
+```
+
+## 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.security.healthIssue](../resources/security-healthissue.md) objects in the response body.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+<!-- {
+ "blockType": "request",
+ "name": "list_healthissues"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/security/identities/healthIssues
+```
++
+### 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.security.healthIssue)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.security.healthIssue",
+ "additionalInformation": ["Descendant User Objects (Schema-Id-Guid: bf967aba-0de6-11d0-a285-00aa003049e2)"],
+ "createdDateTime": "2022-07-15T12:19:27.7211305Z",
+ "description": "Directory Services Object Auditing isn't configured as required on domain1.contoso.com",
+ "displayName": "Directory Services Object Auditing isn't configured as required",
+ "domainNames": ["domain1.contoso.com", "domain2.contoso.com"],
+ "healthIssueType": "Global",
+ "id": "b3c1b5fc-828c-45fa-a1e1-10d74f6d6e9c",
+ "issueTypeId": "1031",
+ "lastModifiedDateTime": "2022-07-15T12:19:27.7211305Z",
+ "recommendations": ["Please configure the Directory Services Object Auditing events according to the guidance as described in https://aka.ms/mdi/objectauditing"],
+ "recommendedActionCommands": ["Import-Module DefenderForIdentity"],
+ "sensorDNSNames": ["DC1.domain1.contoso.com", "DC2.domain2.contoso.com"],
+ "severity": "medium",
+ "status": "open"
+ }
+ ]
+}
+```
v1.0 Security Incident Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 Serviceapp Activate https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "serviceappthis.activate"
Authorization: Bearer <Access-Token>
} ```
+# [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 Serviceapp Deactivate https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/serviceapp-deactivate.md
If successful, this action returns a `202 Accepted` response code and a [service
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "serviceapp_deactivate"
The following example shows a request.
POST https://graph.microsoft.com/v1.0/solutions/backupRestore/serviceApps/71633878-8321-4950-bfaf-ed285bdd1461/deactivate ```
+# [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 Serviceapp Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/serviceapp-get.md
If successful, this method returns a `200 OK` response code and a [serviceApp](.
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "serviceapp_get"
The following example shows a request.
GET https://graph.microsoft.com/v1.0/solutions/backupRestore/serviceApps/71633878-8321-4950-bfaf-ed285bdd1461 ```
+# [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 Serviceprincipal List Owners https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 You can address the service principal 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 /servicePrincipals/{id}/owners
GET /servicePrincipals(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 |
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/v1.0/servicePrincipals/00063ffc-54e9-405d-b8f3-56124728e051/owners
+GET https://graph.microsoft.com/v1.0/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/v1.0/$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",
+ "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 Serviceprincipal Post Approleassignedto https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/serviceprincipal-post-approleassignedto.md
To grant an app role assignment, you need three identifiers:
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": "serviceprincipal_post_approleassignedto" } -->
[!INCLUDE [permissions-table](../includes/permissions/serviceprincipal-post-approleassignedto-permissions.md)] [!INCLUDE [rbac-approleassignments-apis-write](../includes/rbac-for-apis/rbac-approleassignments-apis-write.md)]
v1.0 Sharepointprotectionpolicy List Siteinclusionrules https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/sharepointprotectionpolicy-list-siteinclusionrules.md
If successful, this method returns a `200 OK` response code and a [siteProtectio
The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "sharepointprotectionpolicy_list_siteinclusionrules"
The following example shows a request.
GET https://graph.microsoft.com/v1.0/solutions/backupRestore/sharePointProtectionPolicies/71633878-8321-4950-bfaf-ed285bdd1461/siteInclusionRules ```
+# [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 Sharepointprotectionpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "sharepointprotectionpolicy_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 Sharepointrestoresession List Siterestoreartifacts https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 The following example shows a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "siterestoreartifact_list"
The following example shows a request.
GET https://graph.microsoft.com/v1.0/solutions/backupRestore/sharePointRestoreSessions/845457dc-4bb2-4815-bef3-8628ebd1952e/siteRestoreArtifacts ```
+# [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 Sharepointrestoresession Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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
v1.0 Signin Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/signin-get.md
This method supports OData query parameters to help customize the response. For
| Name |Description| |:-|:-|
-| Authorization | Bearer {code}|
+| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
## Request body
v1.0 Synchronization Serviceprincipal Put Synchronization https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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/v1.0/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/v1.0/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/v1.0/api/team-archive.md
Title: "Archive team" description: "Archive the specified team. "-+ ms.localizationpriority: high doc_type: apiPageType
v1.0 Team Clone https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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/v1.0/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/v1.0/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/v1.0/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/v1.0/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/v1.0/api/team-put-teams.md
Title: "Create team from group" description: "Create a new team under a group."-+ ms.localizationpriority: high doc_type: apiPageType
v1.0 Team Unarchive https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/team-unarchive.md
Title: "Unarchive team" description: "Restore an archived team. This API restores users' ability to send messages and edit the team, abiding by tenant and team settings. A Teams is 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/v1.0/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/v1.0/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
v1.0 Teamsapp Publish https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 <!-- { "blockType": "ignored" } -->
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
Content-type: application/json
} ``` ++ ## Related content - [App catalog C# sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/graph-appcatalog-lifecycle/csharp)
v1.0 Teamsapp Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/teamsapp-update.md
Title: "Update teamsApp" description: "Update an app previously published to a Teams app catalog."-+ ms.localizationpriority: medium doc_type: apiPageType
v1.0 User Assignlicense https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-assignlicense.md
doc_type: apiPageType
Namespace: microsoft.graph
-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 method is an alternative to [group-based licensing](../api/group-assignlicense.md).
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
v1.0 User Changepassword https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-changepassword.md
doc_type: apiPageType
Namespace: microsoft.graph
-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 Delete Approleassignments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-delete-approleassignments.md
Namespace: microsoft.graph
-Delete an [appRoleAssignment](../resources/approleassignment.md) that has been granted to a user.
+Delete an [appRoleAssignment](../resources/approleassignment.md) that has been granted to a [user](../resources/user.md).
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
v1.0 User Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-delta.md
doc_type: apiPageType
Namespace: microsoft.graph
-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/v1.0/api/user-get.md
doc_type: apiPageType
Namespace: microsoft.graph
-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/v1.0/api/user-list-approleassignments.md
Namespace: microsoft.graph
-Retrieve the list of [appRoleAssignments](../resources/approleassignment.md) that are currently granted to a user. 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 are currently granted to a [user](../resources/user.md). 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/v1.0/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/v1.0/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/v1.0/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/v1.0/api/user-post-approleassignments.md
Namespace: microsoft.graph
-Use this API to assign an app role to a user. To grant an app role assignment to a user, you need three identifiers:
+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 Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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. | |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`| |businessPhones| String collection | The telephone numbers for the user. NOTE: Although this is a string collection, only one number can be set for this property.|
v1.0 Userinsightssettings Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/userinsightssettings-get.md
If successful, this method returns a `200 OK` response code and a [userInsightsS
The following example shows a request to get user item insights and meeting hours insights settings.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_userInsightsSettings"
The following example shows a request to get user item insights and meeting hour
GET https://graph.microsoft.com/v1.0/me/settings/itemInsights ```
+# [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 Userinsightssettings Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/userinsightssettings-update.md
If successful, this method returns a `200 OK` response code and a [userInsightsS
The following example shows how a user updates the **isEnabled** privacy setting to disable their item insights and meeting hours insights.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_userInsightsSettings"
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 Virtualeventsroot List Webinars https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/virtualeventsroot-list-webinars.md
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": "list_virtualeventwebinars"
The following example shows a request.
GET https://graph.microsoft.com/v1.0/solutions/virtualEvents/webinars ```
+# [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 Virtualeventsroot Post Townhalls https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/virtualeventsroot-post-townhalls.md
You can specify the following properties when you create a [virtualEventTownhall
| endDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | The date and time when the town hall ends. | | invitedAttendees | [identity](../resources/identity.md) collection | The identities of the attendees invited to the town hall. The supported identities are: [communicationsGuestIdentity](../resources/communicationsguestidentity.md) and [communicationsUserIdentity](../resources/communicationsuseridentity.md). | | isInviteOnly | Boolean | Indicates whether the town hall is only open to invited people and groups within your organization. The **isInviteOnly** property can only be `true` if the value of the **audience** property is set to `organization`. |
+| settings | [virtualEventSettings](../resources/virtualeventsettings.md) | The virtual event settings. |
| startDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | The date and time when the town hall starts. | ## Response
Content-Type: application/json
"id":ΓÇ»"7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b", "tenantId":ΓÇ»"77229959-e479-4a73-b6e0-ddac27be315c" }
- ]
+ ],
+ "settings": {
+ "isAttendeeEmailNotificationEnabled": false
+ }
} ```
Content-Type: application/json
"tenantId":ΓÇ»"77229959-e479-4a73-b6e0-ddac27be315c" } ],
+ "settings": {
+ "isAttendeeEmailNotificationEnabled": false
+ },
"invitedAttendees": [], "isInviteOnly": false }
v1.0 Virtualeventsroot Post Webinars https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/virtualeventsroot-post-webinars.md
You can specify the following properties when you create a [virtualEventWebinar]
| description | [itemBody](../resources/itembody.md) | A description of the webinar. | | displayName | String | The display name of the webinar. | | endDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | The date and time when the webinar ends. |
+| settings | [virtualEventSettings](../resources/virtualeventsettings.md) | The webinar settings. Inherited from [virtualEvent](../resources/virtualevent.md). |
| startDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | The date and time when the webinar starts. | ## Response
Content-Type: application/json
"id":ΓÇ»"7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b", "tenantId":ΓÇ»"77229959-e479-4a73-b6e0-ddac27be315c" }
- ]
+ ],
+ "settings": {
+ "isAttendeeEmailNotificationEnabled": false
+ }
} ```
Content-Type: application/json
"displayName": "Kenneth Brown", "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c" }
- ]
+ ],
+ "settings": {
+ "isAttendeeEmailNotificationEnabled": false
+ }
} ```
v1.0 Virtualeventtownhall Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/virtualeventtownhall-get.md
Content-Type: application/json
"tenantId": "77229959-e479-4a73-b6e0-ddac27be315c" } ],
+ "settings": {
+ "isAttendeeEmailNotificationEnabled": false
+ },
"invitedAttendees": [ { "@odata.type": "microsoft.graph.communicationsUserIdentity",
v1.0 Virtualeventtownhall Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/virtualeventtownhall-update.md
PATCH /solutions/virtualEvents/townhalls/{id}
| displayName | String | Display name of the virtual event. | | endDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | Date and time when the virtual event ends. | | invitedAttendees | [identity](../resources/identity.md) collection | The identities of the attendees invited to the town hall. The supported identities are: [communicationsGuestIdentity](../resources/communicationsguestidentity.md) and [communicationsUserIdentity](../resources/communicationsuseridentity.md). |
+| settings | [virtualEventSettings](../resources/virtualeventsettings.md) | The virtual event settings. |
| startDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | Date and time when the virtual event starts. | ## Response
Content-Type: application/json
"displayName": "Emilee Pham", "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c" }
- ]
+ ],
+ "settings": {
+ "isAttendeeEmailNotificationEnabled": false
+ }
} ```
v1.0 Virtualeventwebinar Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/virtualeventwebinar-update.md
PATCH /solutions/virtualEvents/webinars/{id}
| description | [itemBody](../resources/itembody.md) | Description of the virtual event. | | displayName | String | Display name of the virtual event. | | endDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | Date and time when the virtual event ends. |
+| settings | [virtualEventSettings](../resources/virtualeventsettings.md) | The webinar settings. Inherited from [virtualEvent](../resources/virtualevent.md). |
| startDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | Date and time when the virtual event starts. | ## Response
Content-Type: application/json
"displayName": "Kenneth Brown", "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c" }
- ]
+ ],
+ "settings": {
+ "isAttendeeEmailNotificationEnabled": false
+ }
} ```
v1.0 Webpart Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/webpart-delete.md
DELETE /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/ho
``` ## Request headers
-| Name | Value | Description
-|:--|:|:--
-|Authorization|Bearer {token}.| Required|
-| _if-match_ | etag | If this request header is included and the eTag provided does not match the current tag on the item, a `412 Precondition Failed` response is returned and the item will not be deleted.
+|Name|Description|
+|:|:|
+|Authorization| Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+| _if-match_ | eTag. If this request header is included and the eTag provided does not match the current tag on the item, a `412 Precondition Failed` response is returned and the item will not be deleted.|
## Request body
v1.0 Workbookformatprotection Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 [FormatProtectio
##### 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/v1.0/me/drive/items/{id}/workbook/names/{name}/range/format/protection ```
+# [JavaScript](#tab/javascript)
+++ ##### Response The following example shows the response. Note: The response object shown here might be shortened for readability. <!-- {
v1.0 Workbookformatprotection Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 [workboo
##### 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. Note: The response object shown here might be shortened for readability. <!-- {
v1.0 Workbookrange Columnsafter https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/workbookrange-columnsafter.md
Namespace: microsoft.graph
Gets a certain 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", "isComposable": true,
The following example shows a request.
GET https://graph.microsoft.com/v1.0/me/drive/root/workbook/worksheets/{id}/range/columnsAfter(count=2) ```
+# [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 Workbookrange Columnsbefore https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/workbookrange-columnsbefore.md
Namespace: microsoft.graph
Gets a certain 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", "isComposable": true,
The following example shows a request.
GET https://graph.microsoft.com/v1.0/me/drive/root/workbook/worksheets/{id}/range/columnsBefore(count=2) ```
+# [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 Workbookrange Rowsabove https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/workbookrange-rowsabove.md
Namespace: microsoft.graph
Gets a certain 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", "isComposable": true,
The following example shows a request.
GET https://graph.microsoft.com/v1.0/me/drive/root/workbook/worksheets/{id}/range/rowsAbove(count=2) ```
+# [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.
If called without the optional `count` parameter, this function returns the sing
##### Request
+# [HTTP](#tab/http)
<!--{ "blockType": "request", "isComposable": true,
If called without the optional `count` parameter, this function returns the sing
GET https://graph.microsoft.com/v1.0/me/drive/root/workbook/worksheets/{id}/range/rowsAbove ```
+# [C#](#tab/csharp)
+
+# [CLI](#tab/cli)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
+++ ##### Response <!-- { "blockType": "response",
v1.0 Workbookrange Rowsbelow https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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", "isComposable": true,
The following example shows a request.
GET https://graph.microsoft.com/v1.0/me/drive/root/workbook/worksheets/{id}/range/rowsBelow(count=2) ```
+# [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.
If called without the `count` parameter, this function defaults to one row.
##### Request The following example shows a request.
+# [HTTP](#tab/http)
<!--{ "blockType": "request", "isComposable": true,
The following example shows a request.
GET https://graph.microsoft.com/v1.0/me/drive/root/workbook/worksheets/{id}/range/rowsBelow ```
+# [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 Workbookrange Visibleview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/workbookrange-visibleview.md
doc_type: apiPageType
Namespace: microsoft.graph + ## 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/v1.0/me/drive/root/workbook/worksheets/{id}/range(address='A1:Z10')/visibleView ```
+# [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 Workbookrangeview List Rows https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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/v1.0/me/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/v1.0/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", "isComposable": true,
The following example shows a request.
GET https://graph.microsoft.com/v1.0/me/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 Link Validation Config.Json https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/config/link-validation-config.json a/api-reference/v1.0/config/link-validation-config.json
"/universal-print", "/training", "/troubleshoot",
+ "/viva",
"/windows", "/windows-hardware" ]
v1.0 Accesspackageassignmentrequest https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accesspackageassignmentrequest.md
In [Microsoft Entra Entitlement Management](entitlementmanagement-overview.md),
| [Create](../api/entitlementmanagement-post-assignmentrequests.md) | [accessPackageAssignmentRequest](accesspackageassignmentrequest.md) | Creates a new **accessPackageAssignmentRequest** object. | |[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.|
## Properties |Property|Type|Description|
v1.0 Accessreviewhistoryschedulesettings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accessreviewhistoryschedulesettings.md
Defines the settings of an [accessReviewHistoryDefinition](accessreviewhistoryde
| recurrence|[patternedRecurrence](patternedrecurrence.md) | Detailed settings for recurrence using the standard Outlook recurrence object. <br/><br/>**Note:** Only **dayOfMonth**, **interval**, and **type** (`weekly`, `absoluteMonthly`) properties are supported. Use the property **startDate** on **recurrenceRange** to determine the day the review starts. Required. | |reportRange|String|A duration string in ISO 8601 duration format specifying the lookback period of the generated review history data. For example, if a history definition is scheduled to run on the first of every month, the **reportRange** is `P1M`. In this case, on the first of every month, access review history data is collected containing only the previous month's review data. <br/><br/>**Note:** Only **years**, **months**, and **days** ISO 8601 properties are supported. Required.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.+ <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.accessReviewHistoryScheduleSettings"
v1.0 Accessreviewstagesettings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accessreviewstagesettings.md
Represents the settings of the stages that are associated with a [multi-stage ac
|reviewers|[accessReviewReviewerScope](../resources/accessreviewreviewerscope.md) collection|Defines who the reviewers are. If none is specified, the review is a self-review (users review their own access). For examples of options for assigning reviewers, see [Assign reviewers to your access review definition using the Microsoft Graph API](/graph/accessreviews-reviewers-concept). <br/><br/>**NOTE:** The value of this property overrides the corresponding setting on the [accessReviewScheduleDefinition](accessReviewScheduleDefinition.md). | |stageId|String|Unique identifier of the **accessReviewStageSettings** object. The **stageId** is used by the **dependsOn** property to indicate the order of the stages. Required. |
+## Relationships
+
+None.
+ ## JSON representation
-HEre's a JSON representation of the resource.
+
+The following JSON representation shows the resource type.
+ <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.accessReviewStageSettings"
v1.0 Admin https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/admin.md
None.
| edge | [edge](edge.md) | A container for Microsoft Edge resources. Read-only. | | microsoft365Apps |[adminMicrosoft365Apps](../resources/adminmicrosoft365apps.md)|A container for the Microsoft 365 apps admin functionality.| | people | [peopleAdminSettings](../resources/peopleadminsettings.md) | Represents a setting to control people-related admin settings in the tenant. |
+| reportSettings |[adminReportSettings](../resources/adminreportsettings.md)|A container for administrative resources to manage reports.|
| serviceAnnouncement | [serviceAnnouncement](serviceannouncement.md) | A container for service communications resources. Read-only. | | sharepointSettings | [sharepointSettings](../resources/sharepointSettings.md) | A container for administrative resources to manage tenant-level settings for SharePoint and OneDrive. |
v1.0 Adminreportsettings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/adminreportsettings.md
+
+ Title: "adminReportSettings resource type"
+description: "Represents the tenant-level settings for Microsoft 365 reports."
+ms.localizationpriority: medium
++++
+# adminReportSettings resource type
+
+Namespace: microsoft.graph
+
+Represents the tenant-level settings for Microsoft 365 reports.
+
+## Methods
+
+|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.|
+
+## Properties
+
+| Property | Type | Description |
+| -- | -- | - |
+| 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
+
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.adminReportSettings",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.adminReportSettings",
+ "displayConcealedNames": "Boolean"
+}
+```
v1.0 Aggregationoption https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/aggregationoption.md
Specifies which aggregations should be returned alongside the search results. Th
|field|String|Computes aggregation on the field while the field exists in the current entity type. Required.| |size|Int32|The number of [searchBucket](searchBucket.md) resources to be returned. This isn't required when the range is provided manually in the search request. The minimum accepted size is 1, and the maximum is 65535. Optional.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Agreementfiledata https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/agreementfiledata.md
Represents a Microsoft Entra terms of use agreement file.
|:-|:|:| |data|Binary|Data that represents the terms of use PDF document. Read-only.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Alterationresponse https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/alterationresponse.md
Provides information related to spelling corrections in the alteration response.
|queryAlteration|[searchAlteration](searchalteration.md)| Defines the details of the alteration information for the spelling correction.| |queryAlterationType|searchAlterationType| Defines the type of the spelling correction. Possible values are: `suggestion`, `modification`.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Alteredquerytoken https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/alteredquerytoken.md
Represents changed segments related to an original user query.
|offset|Int32| Defines the offset of a changed segment.| |suggestion|String| Represents the corrected segment string.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Appidentity https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/appidentity.md
Title: "appIdentity resource type"
-description: "Indicates the identity of the application that performed the action or was changed. Includes Application Id, Name, Service Principal ID and Name. This resource is called by the directoryAudit API"
+description: "Indicates the identity of the application that performed the action or was changed. This resource is called by the directoryAudit API"
ms.localizationpriority: medium
doc_type: resourcePageType
Namespace: microsoft.graph
-Indicates the identity of the application that performed the action or was changed. Includes application ID, name, and service principal ID and name. This resource is used by the [Get directoryAudit](../api/directoryaudit-get.md) operation.
+Indicates the identity of the application that performed the action or was changed. Includes the application ID, name, and service principal ID and name. This resource is used by the [directoryAudit](../api/directoryaudit-get.md) operation.
## Properties
Indicates the identity of the application that performed the action or was chang
|servicePrincipalId|String|Refers to the unique ID for the service principal in Microsoft Entra ID.| |servicePrincipalName|String|Refers to the Service Principal Name is the Application name in the tenant. |
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Approleassignment https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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, it's 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.|
-|[Delete 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 | Property | Type | Description | |:|:--|:-|
-| 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's 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. |
| createdDateTime | DateTimeOffset | The time when the app role assignment was created. 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`. Read-only. | | deletedDateTime | DateTimeOffset | The date and time when the app role assignment was deleted. Always `null` for an appRoleAssignment object that hasn't been deleted. Inherited from [directoryObject](directoryobject.md). | | id | String | A unique identifier for the **appRoleAssignment** key. Not nullable. Read-only. |
v1.0 Archivedprintjob https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/archivedprintjob.md
A record of a "final state" (completed, aborted, or canceled) print job that is
|processingState|printJobProcessingState|The print job's final processing state. Read-only.| |createdDateTime|DateTimeOffset|The dateTimeOffset when the job was created. Read-only.| |acquiredDateTime|DateTimeOffset|The dateTimeOffset when the job was acquired by the printer, if any. Read-only.|
-|completionDateTime|DateTimeOffset|The dateTimeOffset when the job was completed, canceled or aborted. Read-only.|
+|completionDateTime|DateTimeOffset|The dateTimeOffset when the job was completed, canceled, or aborted. Read-only.|
|acquiredByPrinter|Boolean|True if the job was acquired by a printer; false otherwise. Read-only.| |copiesPrinted|Int32|The number of copies that were printed. Read-only.| |createdBy|[userIdentity](useridentity.md)|The user who created the print job. Read-only.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Availabilityitem https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/availabilityitem.md
Indicates the status of a [staff member](bookingstaffmember.md) for a given time
|status |bookingsAvailabilityStatus |The status of the staff member. Possible values are: `available`, `busy`, `slotsAvailable`, `outOfOffice`, `unknownFutureValue`.| |startDateTime |dateTimeTimeZone |The start time of the time slot.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Bookingcustomerinformationbase https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/bookingcustomerinformationbase.md
Abstract base type for an appointment's customer information.
Base type of [bookingCustomerInformation](bookingcustomerinformation.md).
+## Properties
+
+None.
+
+## Relationships
+
+None.
+ ## JSON representation+ The following JSON representation shows the resource type.+ <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.bookingCustomerInformationBase"
v1.0 Bookingreminder https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/bookingreminder.md
Represents when and whom to send an email reminder.
|offset|Duration|The amount of time before the start of an appointment that the reminder should be sent. It's denoted in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.| |recipients|bookingReminderRecipients|The persons who should receive the reminder. Possible values are: `allAttendees`, `staff`, `customer`, `unknownFutureValue`.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Bookingschedulingpolicy https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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| |:|:--|:-|
Represents the set of policies that determine how appointments should be created
|sendConfirmationsToOwner|Boolean| `True` to notify the business via email when a booking is created or changed. Use the email address specified in the **email** property of the **bookingBusiness** entity for the business. | |timeSlotInterval|Duration|Duration of each time slot, denoted in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Bookingworkhours https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/bookingworkhours.md
Represents the set of working hours in a single day of the week, for a [bookingB
|day|String| The day of the week represented by this instance. Possible values are: `sunday`, `monday`, `tuesday`, `wednesday`, `thursday`, `friday`, `saturday`.| |timeSlots|[bookingWorkTimeSlot](bookingworktimeslot.md) collection|A list of start/end times during a day.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Bookingworktimeslot https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/bookingworktimeslot.md
Defines the start and end times for work.
|endTime|TimeOfDay|The time of the day when work stops. For example, 17:00:00.0000000.| |startTime|TimeOfDay|The time of the day when work starts. For example, 08:00:00.0000000.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Bucketaggregationdefinition https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/bucketaggregationdefinition.md
Provides the details on how to generate the aggregations in the results.
|minimumCount|Int32|The minimum number of items that should be present in the aggregation to be returned in a bucket. Optional.| |prefixFilter|String|A filter to define a matching criteria. The key should start with the specified prefix to be returned in the response. Optional.| |ranges|[bucketAggregationRange](bucketaggregationrange.md) collection|Specifies the manual ranges to compute the aggregations. This is only valid for nonstring refiners of date or numeric type. Optional.|
-|sortBy|bucketAggregationSortProperty| The possible values are `count` to sort by the number of matches in the aggregation, `keyAsString`to sort alphabetically based on the key in the aggregation, `keyAsNumber` for numerical sorting based on the key in the aggregation. Required.
+|sortBy|bucketAggregationSortProperty| The possible values are `count` to sort by the number of matches in the aggregation, `keyAsString`to sort alphabetically based on the key in the aggregation, `keyAsNumber` for numerical sorting based on the key in the aggregation. Required.|
+
+## Relationships
+
+None.
## JSON representation
v1.0 Bucketaggregationrange https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/bucketaggregationrange.md
Specifies the lower and upper limit to a range for aggregating search results. A
|from|String| Defines the lower bound from which to compute the aggregation. This can be a numeric value or a string representation of a date using the `YYYY-MM-DDTHH:mm:ss.sssZ` format. Required.| |to|String| Defines the upper bound up to which to compute the aggregation. This can be a numeric value or a string representation of a date using the `YYYY-MM-DDTHH:mm:ss.sssZ` format. Required.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Call https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/call.md
Becomes:
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. |
The following JSON representation shows the resource type.
"suppressions": [] } -->-
v1.0 Callrecording https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 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/v1.0/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 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.|
## Properties
v1.0 Channel https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/channel.md
Title: "channel resource type" description: "A channel is a collection of chatMessages within a team."-+ ms.localizationpriority: high doc_type: resourcePageType
v1.0 Clonableteamparts https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/clonableteamparts.md
Title: "clonableTeamParts enum type" description: "Describes which part of a team should be cloned. " ms.localizationpriority: medium-+ doc_type: enumPageType
v1.0 Collapseproperty https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/collapseproperty.md
Specifies the criteria used for collapsing search results. Applies only to sorta
|fields|String Collection| Defines the collapse group to trim results. The properties in this collection must be sortable/refinable properties. Required.| |limit|Int16| Defines a maximum limit count for this field. This numeric value must be a positive integer. Required.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Community https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/community.md
+
+ Title: "community resource type"
+description: "Represents a community in Viva Engage that is a central place for conversations, files, events, and updates for people sharing a common interest or goal."
+
+ms.localizationpriority: medium
+++
+# community resource type
+
+Namespace: microsoft.graph
+
+Represents a community in Viva Engage that is a central place for conversations, files, events, and updates for people sharing a common interest or goal.
+
+Every community is associated with a [Microsoft 365 group](../resources/group.md), but the group doesn't have the same ID as the community. For more information about managing communities in Viva Engage, see [Use the Microsoft Graph API to work with Viva Engage](../resources/engagement-api-overview.md).
+
+This resource is an open type that allows other properties to be passed in.
+
+Inherits from [entity](../resources/entity.md).
+
+## Methods
+
+|Method|Return type|Description|
+|:|:|:|
+|[List](../api/employeeexperience-list-communities.md)|[community](../resources/community.md) collection|Get a list of the Viva Engage [community](../resources/community.md) objects and their properties.|
+|[Create](../api/employeeexperience-post-communities.md)|[engagementAsyncOperation](../resources/engagementasyncoperation.md)|Create a new [community](../resources/community.md) in Viva Engage.|
+|[Get](../api/community-get.md)|[community](../resources/community.md)|Read the properties and relationships of a [community](../resources/community.md) object.|
+|[Update](../api/community-update.md)|None|Update the properties of an existing Viva Engage [community](../resources/community.md).|
+|[Delete](../api/community-delete.md)|None|Delete a Viva Engage [community](../resources/community.md) along with all associated Microsoft 365 content, including the connected Microsoft 365 group, OneNote notebook, and Planner plans.|
+
+## Properties
+
+|Property|Type|Description|
+|:|:|:|
+| description | String | The description of the community. The maximum length is 1,024 characters. |
+| displayName | String | The name of the community. The maximum length is 255 characters. |
+| groupId | String | The ID of the [Microsoft 365 group](../resources/group.md) that manages the membership of this community. |
+| id | String | The unique identifier of the community. Read-only. Inherited from [entity](../resources/entity.md). |
+| privacy | [communityPrivacy](../resources/community.md#communityprivacy-values) | Defines the privacy level of the community. The possible values are: `public`, `private`, `unknownFutureValue`. |
+
+### communityPrivacy values
+
+| Member | Description |
+|:|:-|
+| public | Any user from the tenant can join and participate in the community. |
+| private | A community administrator must add tenant users to the community before they can participate. |
+| unknownFutureValue | Evolvable enumeration sentinel value. Don't use.|
+
+## Relationships
+
+|Relationship|Type|Description|
+|:|:|:|
+|group|[group](../resources/group.md)|The [Microsoft 365 group](group.md) that manages the membership of this community.|
+|owners|[user](../resources/user.md) collection| The admins of the community. Limited to 100 users. If this property isn't specified when you create the community, the calling user is automatically assigned as the community owner. |
+
+## JSON representation
+
+The following JSON representation shows the resource type.
+
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.community",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.community",
+ "description": "String",
+ "displayName": "String",
+ "groupId": "String",
+ "id": "String (identifier)",
+ "privacy": "String"
+}
+```
+
+## Related content
+
+- [Use the Microsoft Graph API to work with Viva Engage](engagement-api-overview.md)
+- [Create a community](../api/employeeexperience-post-communities.md)
v1.0 Customextensionauthenticationconfiguration https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/customextensionauthenticationconfiguration.md
The type of token authentication used depends on the token security. If the toke
None.
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.+ <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.customExtensionAuthenticationConfiguration",
v1.0 Customextensionendpointconfiguration https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/customextensionendpointconfiguration.md
Abstract base type that exposes the derived types used to configure the **endpoi
None.
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.+ <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.customExtensionEndpointConfiguration",
v1.0 Datetimetimezone https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/datetimetimezone.md
Pacific/Apia
Pacific/Kiritimati
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Devicedetail https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/devicedetail.md
doc_type: resourcePageType
Namespace: microsoft.graph
-Indicates device details associated with a device used for signing in. The information includes information like device browser and operating system, and whether the device is Microsoft Entra ID managed.
+Indicates details of the device used in a sign-in activity. Includes information like device browser and OS info and if the device is Microsoft Entra ID-managed.
## Properties- | Property | Type |Description| |:|:--|:-|
-|browser|String|Indicates the browser information of the used for signing in.|
-|deviceId|String|Refers to the UniqueID of the device used for signing in.|
-|displayName|String|Refers to the name of the device used for signing in.|
-|isCompliant|Boolean|Indicates whether the device is compliant.|
-|isManaged|Boolean|Indicates whether the device is managed.|
-|operatingSystem|String|Indicates the operating system name and version used for signing in.|
-|trustType|String|Provides information about whether the signed-in device is Workplace Joined, AzureAD Joined, Domain Joined. |
+|browser|String|Indicates the browser information of the used in the sign-in. Populated for devices registered in Microsoft Entra.|
+|deviceId|String|Refers to the unique ID of the device used in the sign-in. Populated for devices registered in Microsoft Entra.|
+|displayName|String|Refers to the name of the device used in the sign-in. Populated for devices registered in Microsoft Entra.|
+|isCompliant|Boolean|Indicates whether the device is compliant or not.|
+|isManaged|Boolean|Indicates if the device is managed or not.|
+|operatingSystem|String|Indicates the OS name and version used in the sign-in.|
+|trustType|String|Indicates information on whether the device used in the sign-in is workplace-joined, Microsoft Entra-joined, domain-joined.|
## JSON representation
v1.0 Educationassignmentclassrecipient https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationassignmentclassrecipient.md
This resource is a subclass of [educationAssignmentRecipient](educationassignmen
None.
+## Relationships
+
+None.
+
+## JSON representation
+
+The following JSON representation shows the resource type.
+ <!-- { "blockType": "resource",
v1.0 Educationassignmentgrade https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationassignmentgrade.md
This is an abstract type that will never be instantiated; however, all types of
|gradedBy|[identitySet](identityset.md)| User who did the grading. | |gradedDateTime|DateTimeOffset| Moment in time when the grade was applied to this submission object. 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`|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Educationassignmentgradetype https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationassignmentgradetype.md
Base class for [educationAssignmentPointsGradeType](../resources/educationassign
None.
+## Relationships
+
+None.
+
+## JSON representation
+
+The following JSON representation shows the resource type.
+ <!-- { "blockType": "resource", "optionalProperties": [
v1.0 Educationassignmentindividualrecipient https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationassignmentindividualrecipient.md
This resource is a subclass of [educationAssignmentRecipient](educationassignmen
|:|:--|:-| |recipients|String collection|A collection of IDs of the recipients.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Educationassignmentpointsgrade https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationassignmentpointsgrade.md
which will add the who data to this property. The max points are stored in the *
|gradedDateTime|DateTimeOffset| Moment in time when the grade was applied to this submission object. 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`| |points|Single|Number of points a teacher is giving this submission object.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Educationassignmentpointsgradetype https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationassignmentpointsgradetype.md
an [educationAssignmentPointsGrade](educationassignmentpointsgrade.md) property
|:|:--|:-| |maxPoints|Single| Max points possible for this assignment. |
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Educationassignmentrecipient https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationassignmentrecipient.md
The [educationAssignmentClassRecipient](educationassignmentclassrecipient.md) an
## Properties None.
+## Relationships
+
+None.
+
+## JSON representation
+
+The following JSON representation shows the resource type.
+ <!-- { "blockType": "resource", "optionalProperties": [
v1.0 Educationcategory https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationcategory.md
A category that can be applied to assignments.
|displayName|String|Unique identifier for the category.| |id|String|Unique identifier for the category.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Educationchannelresource https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationchannelresource.md
A subclass of [educationResource](educationresource.md) that represents a Micros
| :- | :-- | : | | url | String | URL of the channel resource. |
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Educationexcelresource https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationexcelresource.md
or submission object to which this resource belongs.
|lastModifiedBy|[identitySet](identityset.md)|The last user to modify the resource.| |lastModifiedDateTime|DateTimeOffset|The date and time when the resource was last modified. 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`.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Educationexternalresource https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationexternalresource.md
This complex type allows all SDK callers to work seamlessly.
|displayName|string|The display name of the resource.| |lastModifiedBy|[identitySet](identityset.md)|The last user to modify the resource.| |lastModifiedDateTime|DateTimeOffset|The date and time when the resource was last modified. 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`.|
-|webUrl|String|Location of the resource. Required|
+|webUrl|String|Location of the resource. Required.|
+
+## Relationships
+
+None.
## JSON representation The following JSON representation shows the resource type.- <!-- { "blockType": "resource", "optionalProperties": [
v1.0 Educationfeedback https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationfeedback.md
This property represents both the text part of the feedback along with who provi
|feedbackDateTime|DateTimeOffset|Moment in time when the feedback was given. 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`| |text|[itemBody](itembody.md)|Feedback.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Educationfileresource https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationfileresource.md
In this case, the file isn't one of the special files (Word, Excel, and so on) b
|lastModifiedBy|[identitySet](identityset.md)|The last user to modify the resource.| |lastModifiedDateTime|DateTimeOffset|The date and time when the resource was last modified. 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`.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Educationlinkedassignmentresource https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationlinkedassignmentresource.md
A subclass of [educationResource](educationresource.md) that represents a link t
| :- | :-- | :- | | url | String | URL of the actual assignment. |
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Educationlinkresource https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationlinkresource.md
This resource is a link and doesn't have any other data associated with it.
|lastModifiedDateTime|DateTimeOffset|The date and time when the resource was last modified. 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`.| |link|String|URL to the resource.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Educationmediaresource https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationmediaresource.md
The following file types are media resources: `webm`, `mkv`, `avi`, `wmv`, `mp4`
|lastModifiedBy|[identitySet](identityset.md)|The last user to modify the resource| |lastModifiedDateTime|DateTimeOffset|The date and time when the resource was last modified. 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`.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Educationpowerpointresource https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationpowerpointresource.md
assignment or submission.
|lastModifiedBy|[identitySet](identityset.md)|The last user to modify the resource.| |lastModifiedDateTime|DateTimeOffset|The date and time when the resource was last modified. 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`.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Educationresource https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationresource.md
This resource stores the common properties across all resource types.
|lastModifiedBy|[identitySet](identityset.md)|The last user to modify the resource.| |lastModifiedDateTime|DateTimeOffset|Moment in time when the resource was last modified. 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`.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Educationsubmission https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationsubmission.md
If [setUpResourcesFolder](../api/educationsubmission-setupResourcesFolder.md) ha
## Properties | Property | Type |Description| |:|:--|:-|
-|id|String|Unique identifier for the submission.|
|excusedBy|[identitySet](identityset.md)| The user that marked the submission as excused.| |excusedDateTime|DateTimeOffset|The time that the submission was excused. 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`.|
+|id|String|Unique identifier for the submission.|
|reassignedBy|[identitySet](identityset.md)|User who moved the status of this submission to reassigned.| |reassignedDateTime|DateTimeOffset|Moment in time when the submission was reassigned. 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`.| |recipient|[educationSubmissionRecipient](educationsubmissionrecipient.md)|Who this submission is assigned to.|
The following JSON representation shows the resource type.
```json {
+ "excusedBy": {"@odata.type":"microsoft.graph.identitySet"},
+ "excusedDateTime": "String (timestamp)",
"id": "String (identifier)", "reassignedBy": {"@odata.type":"microsoft.graph.identitySet"}, "reassignedDateTime": "String (timestamp)",
v1.0 Educationsubmissionindividualrecipient https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationsubmissionindividualrecipient.md
A subclass of [educationSubmissionRecipient](educationsubmissionrecipient.md) th
|:|:--|:-| |userId|String|User ID of the user to whom the submission is assigned.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Educationsubmissionrecipient https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationsubmissionrecipient.md
Possible values include individuals or groups. This is used within the **submiss
## Properties None.
+## Relationships
+
+None.
+
+## JSON representation
+
+The following JSON representation shows the resource type.
+ <!-- { "blockType": "resource", "optionalProperties": [
v1.0 Educationteamsappresource https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationteamsappresource.md
Inherits from [educationResource](educationresource.md).
| teamsEmbeddedContentUrl | String | URL for the app resource that will be opened by Teams. | | webUrl | String | URL for the app resource that can be opened in the browser. |
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.- <!-- { "blockType": "resource", "optionalProperties": [
v1.0 Educationwordresource https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationwordresource.md
assignment or submission.
|lastModifiedBy|[identitySet](identityset.md)|The last user to modify the resource.| |lastModifiedDateTime|DateTimeOffset|The date and time when the resource was last modified. 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`.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Employeeexperience https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/employeeexperience.md
Title: "employeeExperience resource type"
description: "Represents a container that exposes navigation properties for employee experience resources." ms.localizationpriority: medium-+ doc_type: resourcePageType
Represents a container that exposes navigation properties for employee experienc
|Method|Return type|Description| |:|:|:|
-|[List](../api/employeeexperience-list-learningproviders.md)|[learningProvider](../resources/learningprovider.md) collection|Get a list of the [learningProvider](../resources/learningprovider.md) resources registered in Viva Learning for a tenant.|
-|[Create](../api/employeeexperience-post-learningproviders.md)|[learningProvider](../resources/learningprovider.md)|Create a new [learningProvider](../resources/learningprovider.md) object and register it with Viva Learning using the specified display name and logos for different themes.|
+|[List communities](../api/employeeexperience-list-communities.md)|[community](../resources/community.md) collection|Get a list of the Viva Engage [community](../resources/community.md) objects and their properties.|
+|[Create community](../api/employeeexperience-post-communities.md)|[community](../resources/community.md)|Create a new [community](../resources/community.md) in Viva Engage.|
+|[List learningProviders](../api/employeeexperience-list-learningproviders.md)|[learningProvider](../resources/learningprovider.md) collection|Get a list of the [learningProvider](../resources/learningprovider.md) resources registered in Viva Learning for a tenant.|
+|[Create learningProvider](../api/employeeexperience-post-learningproviders.md)|[learningProvider](../resources/learningprovider.md)|Create a new [learningProvider](../resources/learningprovider.md) object and register it with Viva Learning using the specified display name and logos for different themes.|
## Properties
None.
|Relationship|Type|Description| |:|:|:|
+|communities|[community](../resources/community.md) collection| A collection of communities in Viva Engage. |
+|engagementAsyncOperations|[engagementAsyncOperation](../resources/engagementasyncoperation.md) collection| A collection of long-running, asynchronous operations related to Viva Engage. |
|learningProviders|[learningProvider](../resources/learningprovider.md) collection|A collection of learning providers.| ## JSON representation
v1.0 Employeeorgdata https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/employeeorgdata.md
description: "Represents organization data associated with a user."
ms.localizationpriority: medium doc_type: resourcePageType -+ # employeeOrgData resource type
v1.0 Engagement Api Overview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/engagement-api-overview.md
+
+ Title: "Use the Microsoft Graph API to work with Viva Engage"
+description: "The Microsoft Graph API enables apps to manage communities in Viva Engage."
+ms.localizationpriority: medium
++++
+# Use the Microsoft Graph API to work with Viva Engage
+
+The Microsoft Graph API enables apps to manage communities in Viva Engage. Viva Engage is a social fabric for the Microsoft Viva suite of apps that connects people across the organization to share and learn. It's a place where employees can connect with leaders, coworkers, and communities, share their knowledge and ideas, and find belonging at work.
+
+> [!IMPORTANT]
+> The Viva Engage API in Microsoft Graph is only supported for Viva Engage networks in [native mode](/viva/engage/overview-native-mode). You can't use this API to manage legacy or external Viva Engage networks.
+
+## Authorization
+
+To call the Viva Engage API in Microsoft Graph, your app needs to acquire an access token. For details about access tokens, see [Get access tokens to call Microsoft Graph](/graph/auth/). Your app also needs the appropriate permissions. For more information, see [Microsoft Graph permissions reference](/graph/permissions-reference).
+
+## Common use cases
+
+The following table lists common use cases for the Viva Engage API.
+
+| Use case | API | Notes |
+|:--|:--|:--|
+| Create a community | [POST /employeeExperience/communities](../api/employeeexperience-post-communities.md) | If successful, this method returns a `202 Accepted` response code that contains a link to an [engagementAsyncOperation](../resources/engagementasyncoperation.md) object. |
+| Poll for community creation status | [GET /employeeExperience/engagementAsyncOperations/{engagementAsyncOperationId}](../api/engagementasyncoperation-get.md) | If successful, this method returns a `200 OK` response code and an [engagementAsyncOperation](../resources/engagementasyncoperation.md) object in the response body. Periodically check the status of the operation by making a GET request to this location; wait >30 seconds between checks. When the request completes successfully, the **status** indicates `succeeded` and the **resourceLocation** points to the created or modified resource. |
+| Get a community after creation | [GET /employeeExperience/communities/{communityId}](../api/community-get.md) | If successful, this method returns a `200 OK` response code and a [community](../resources/community.md) object in the response body. The community object references the associated [Microsoft 365 group](../resources/group.md) ID that you can use for community membership and ownership management. |
+| Get a list of communities | [GET /employeeExperience/communities](../api/employeeexperience-list-communities.md) | If successful, this method returns a `200 OK` response code and a collection of Viva Engage [community](../resources/community.md) objects in the response body.|
+| Update a community | [PATCH /employeeExperience/communities/{communityId}](../api/community-update.md) | If successful, this method updates an existing Viva Engage [community](../resources/community.md) and returns a `204 No Content` response code. |
+| Delete a community | [DELETE /employeeExperience/communities/{communityId}](../api/community-delete.md) | If successful, this method deletes a Viva Engage [community](../resources/community.md) along with all associated Microsoft 365 content, including the connected Microsoft 365 group, OneNote notebook, and Planner plans. For more information, see [What happens if I delete a Viva Engage community connected to Microsoft 365 groups](/viva/engage/engage-microsoft-365-groups#q-what-happens-if-i-delete-a-viva-engage-community-connected-to-microsoft-365-groups). |
+| Add members to a community | [POST /groups/{groupId}/members/$ref](../api/group-post-members.md) | When new members are added to a group, the associated membership of the community is automatically updated. |
+| Remove a member from a community | [DELETE /groups/{groupId}/members/{userId}/$ref](../api/group-delete-members.md) | When a member is removed from a group, the associated membership of the community is automatically updated. |
+| Add a community admin | [POST /groups/{groupId}/owners/$ref](../api/group-post-owners.md) | When a user is added as a group owner, they automatically become an admin of the associated community. |
+| Remove a community admin | [DELETE /groups/{groupId}/owners/{userId}/$ref](../api/group-delete-owners.md) | When a group owner is removed, they stop being admin for the associated community. You can't remove the last owner ([user](../resources/user.md) object) of a group. |
+
+## Communities and groups
+
+For Viva Engage networks in native mode, the creation of a new Viva Engage community also results in the creation of a connected Microsoft 365 group, along with a new SharePoint site, OneNote notebook, and Planner plan. Use the associated group to manage operations on a community, for example:
+
+* Add or remove group members
+* Manage group ownership
+* Delete a group
+* Rename a group
+* Update the group description
+
+For more information about the relationship between Viva Engage communities and Microsoft 365 groups, see [Viva Engage and Microsoft 365 Groups](/viva/engage/engage-microsoft-365-groups).
+
+>**Note:** You can't use the [Create group](../api/group-post-groups.md) API to provision a Viva Engage community.
+
+## API limits
+
+Viva Engage API calls are subject to rate limiting, allowing 10 requests per user, per app, within a 30-second time period. When you exceed the rate limit, all subsequent requests return a `429 Too Many Requests` response code.
+
+For guidance on how to handle throttling in Microsoft Graph, see [Microsoft Graph throttling guidance](/graph/throttling).
+
+## Next steps
+
+- Use the Microsoft Graph API to manage communities in Viva Engage.
+- Try the Viva Engage API in the [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer).
v1.0 Engagementasyncoperation https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/engagementasyncoperation.md
+
+ Title: "engagementAsyncOperation resource type"
+description: "Represents the status of a Viva Engage async operation that is an operation that transcends the lifetime of a single API request."
+
+ms.localizationpriority: medium
+++
+# engagementAsyncOperation resource type
+
+Namespace: microsoft.graph
+
+Represents the status of a Viva Engage async operation that is an operation that transcends the lifetime of a single API request. These operations are long-running or too expensive to complete within the time frame of their original request.
+
+When an async operation is initiated, the method returns a `202 Accepted` response code and an `Operation-Location` header that contains the location of the **engagementAsyncOperation**. Periodically check the status of the operation by making a GET request to this location; wait >30 seconds between checks. When the request completes successfully, the operation **status** indicates `succeeded` and the **resourceLocation** points to the created or modified resource.
+
+Inherits from [longRunningOperation](../resources/longrunningoperation.md).
+
+## Methods
+
+|Method|Return type|Description|
+|:|:|:|
+| [Get](../api/engagementasyncoperation-get.md) | [engagementAsyncOperation](../resources/engagementasyncoperation.md) | Get an [engagementAsyncOperation](../resources/engagementasyncoperation.md) to track a long-running operation request. |
+
+## Properties
+
+|Property|Type|Description|
+|:|:|:|
+| createdDateTime | DateTimeOffset | Date and time when the operation was created. 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`. Inherited from [longRunningOperation](../resources/longrunningoperation.md). |
+| id | String | The unique identifier for the operation. Inherited from [longRunningOperation](../resources/longrunningoperation.md). |
+| lastActionDateTime | DateTimeOffset | Date and time when the async operation was last updated. 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`. Inherited from [longRunningOperation](../resources/longrunningoperation.md). |
+| operationType | [engagementAsyncOperationType](../resources/engagementasyncoperation.md#engagementasyncoperationtype-values) | The type of the long-running operation. The possible values are: `createCommunity`, `unknownFutureValue`. |
+| resourceId | String | The ID of the object created or modified as a result of this async operation. |
+| resourceLocation |String| The location of the object created or modified as a result of this async operation. Inherited from [longRunningOperation](../resources/longrunningoperation.md). |
+| status | longRunningOperationStatus | The status of the operation. The possible values are: `notStarted`, `running`, `succeeded`, `failed`, `skipped`, `unknownFutureValue`. Inherited from [longRunningOperation](../resources/longrunningoperation.md). |
+| statusDetail | String | Details about the status of the operation. Inherited from [longRunningOperation](../resources/longrunningoperation.md). |
+
+### engagementAsyncOperationType values
+
+| Member | Description |
+|:|:-|
+| createCommunity | Operation to create a Viva Engage community. |
+| unknownFutureValue | Evolvable enumeration sentinel value. Don't use.|
+
+## JSON representation
+
+The following JSON representation shows the resource type.
+
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.engagementAsyncOperation",
+ "baseType": "microsoft.graph.longRunningOperation",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.engagementAsyncOperation",
+ "createdDateTime": "String (timestamp)",
+ "id": "String (identifier)",
+ "lastActionDateTime": "String (timestamp)",
+ "operationType": "String",
+ "resourceId": "String",
+ "resourceLocation": "String",
+ "status": "String",
+ "statusDetail": "String"
+}
+```
v1.0 Enums Identitygovernance https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/enums-identitygovernance.md
Namespace: microsoft.graph.identityGovernance
|employeeLeaveDateTime| |unknownFutureValue|
+### membershipChangeType values
+++
+|Member|
+|:|
+|add|
+|remove|
+|unknownFutureValue|
++ <!-- {
v1.0 Enums https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/enums.md
Namespace: microsoft.graph
|boolean| |unknownFutureValue|
-## fileStorageContainerStatus values
+### fileStorageContainerStatus values
| Member | | -- |
Namespace: microsoft.graph
| active | | unknownfuturevalue |
-## binaryOperator values
+### binaryOperator values
| Member | | - | | or | | and |
-## entityType values
+### entityType values
| Member | | - |
Namespace: microsoft.graph
| acronym | | bookmark |
-## conditionalAccessExternalTenantsMembershipKind values
+### conditionalAccessExternalTenantsMembershipKind values
| Member | | -- |
Namespace: microsoft.graph
| enumerated | | unknownFutureValue |
-## conditionalAccessGuestOrExternalUserTypes values
+### conditionalAccessGuestOrExternalUserTypes values
| Member | | |
Namespace: microsoft.graph
| serviceProvider | | unknownFutureValue |
-## migrationStatus values
+### migrationStatus values
| Member | | - |
Namespace: microsoft.graph
| additionalStepsRequired | | unknownFutureValue |
-## appCredentialRestrictionType values
+### appCredentialRestrictionType values
| Member | | -- |
Namespace: microsoft.graph
| symmetricKeyLifetime | | unknownFutureValue |
-## appKeyCredentialRestrictionType values
+### appKeyCredentialRestrictionType values
| Member | | | | asymmetricKeyLifetime | | unknownFutureValue |
-## assignmentType values
+### assignmentType values
| Member | | -- |
Namespace: microsoft.graph
| unknownFutureValue | | peerRecommeded |
-## courseStatus values
+### courseStatus values
| Member | | |
Namespace: microsoft.graph
| inProgress | | completed |
-## userPurpose values
+### userPurpose values
| Member | | |
Namespace: microsoft.graph
| others | | unknownFutureValue |
-## bookingsAvailabilityStatus values
+### bookingsAvailabilityStatus values
| Member | | |
Namespace: microsoft.graph
| outOfOffice | | unknownFutureValue |
-## signInFrequencyAuthenticationType values
+### signInFrequencyAuthenticationType values
| Member | | |
Namespace: microsoft.graph
| secondaryAuthentication | | unknownFutureValue |
-## signInFrequencyInterval values
+### signInFrequencyInterval values
| Member | | | | timeBased | | everyTime |
-## crossTenantAccessPolicyTargetConfigurationAccessType values
+### crossTenantAccessPolicyTargetConfigurationAccessType values
| Member | | |
Namespace: microsoft.graph
| blocked | | unknownFutureValue |
-## crossTenantAccessPolicyTargetType values
+### crossTenantAccessPolicyTargetType values
| Member | | |
Namespace: microsoft.graph
| application | | unknownFutureValue |
-## multiTenantOrganizationMemberProcessingStatus values
+### multiTenantOrganizationMemberProcessingStatus values
| Member | | - |
Namespace: microsoft.graph
| failed | | unknownFutureValue |
-## multiTenantOrganizationMemberRole values
+### multiTenantOrganizationMemberRole values
| Member | | - |
Namespace: microsoft.graph
| member | | unknownFutureValue |
-## multiTenantOrganizationMemberState values
+### multiTenantOrganizationMemberState values
| Member | | - |
Namespace: microsoft.graph
| removed | | unknownFutureValue |
-## multiTenantOrganizationState values
+### multiTenantOrganizationState values
| Member | | - |
Namespace: microsoft.graph
| inactive | | unknownFutureValue |
-## templateApplicationLevel values
+### templateApplicationLevel values
| Member | | - |
Namespace: microsoft.graph
| existingPartners | | unknownFutureValue |
-## federatedIdpMfaBehavior values
+### federatedIdpMfaBehavior values
| Member | | -- |
Namespace: microsoft.graph
| rejectMfaByFederatedIdp | | unknownFutureValue |
-## promptLoginBehavior values
+### promptLoginBehavior values
| Member | | -- |
Namespace: microsoft.graph
| disabled | | unknownFutureValue |
-## expirationPatternType values
+### expirationPatternType values
| Member | | - |
Namespace: microsoft.graph
| afterDateTime | | afterDuration |
-## recurrencePatternType values
+### recurrencePatternType values
| Member | | |
Namespace: microsoft.graph
| absoluteYearly | | relativeYearly |
-## assignmentScheduleFilterByCurrentUserOptions values
+### assignmentScheduleFilterByCurrentUserOptions values
| Member | | | | principal | | unknownFutureValue |
-## assignmentScheduleInstanceFilterByCurrentUserOptions values
+### assignmentScheduleInstanceFilterByCurrentUserOptions values
| Member | | | | principal | | unknownFutureValue |
-## assignmentScheduleRequestFilterByCurrentUserOptions values
+### assignmentScheduleRequestFilterByCurrentUserOptions values
| Member | | |
Namespace: microsoft.graph
| approver | | unknownFutureValue |
-## eligibilityScheduleFilterByCurrentUserOptions values
+### eligibilityScheduleFilterByCurrentUserOptions values
| Member | | | | principal | | unknownFutureValue |
-## eligibilityScheduleInstanceFilterByCurrentUserOptions values
+### eligibilityScheduleInstanceFilterByCurrentUserOptions values
| Member | | | | principal | | unknownFutureValue |
-## eligibilityScheduleRequestFilterByCurrentUserOptions values
+### eligibilityScheduleRequestFilterByCurrentUserOptions values
| Member | | |
Namespace: microsoft.graph
| approver | | unknownFutureValue |
-## privilegedAccessGroupAssignmentType values
+### privilegedAccessGroupAssignmentType values
| Member | | |
Namespace: microsoft.graph
| activated | | unknownFutureValue |
-## privilegedAccessGroupMemberType values
+### privilegedAccessGroupMemberType values
| Member | | |
Namespace: microsoft.graph
| group | | unknownFutureValue |
-## privilegedAccessGroupRelationships values
+### privilegedAccessGroupRelationships values
| Member | | |
Namespace: microsoft.graph
| member | | unknownFutureValue |
-## scheduleRequestActions values
+### scheduleRequestActions values
| Member | | |
Namespace: microsoft.graph
| selfRenew | | unknownFutureValue |
-## roleAssignmentScheduleFilterByCurrentUserOptions values
+### roleAssignmentScheduleFilterByCurrentUserOptions values
| Member | | | | principal | | unknownFutureValue |
-## roleAssignmentScheduleInstanceFilterByCurrentUserOptions values
+### roleAssignmentScheduleInstanceFilterByCurrentUserOptions values
| Member | | | | principal | | unknownFutureValue |
-## roleAssignmentScheduleRequestFilterByCurrentUserOptions values
+### roleAssignmentScheduleRequestFilterByCurrentUserOptions values
| Member | | |
Namespace: microsoft.graph
| approver | | unknownFutureValue |
-## roleEligibilityScheduleFilterByCurrentUserOptions values
+### roleEligibilityScheduleFilterByCurrentUserOptions values
| Member | | | | principal | | unknownFutureValue |
-## roleEligibilityScheduleInstanceFilterByCurrentUserOptions values
+### roleEligibilityScheduleInstanceFilterByCurrentUserOptions values
| Member | | | | principal | | unknownFutureValue |
-## roleEligibilityScheduleRequestFilterByCurrentUserOptions values
+### roleEligibilityScheduleRequestFilterByCurrentUserOptions values
| Member | | |
Namespace: microsoft.graph
| approver | | unknownFutureValue |
-## unifiedRoleManagementPolicyRuleTargetOperations values
+### unifiedRoleManagementPolicyRuleTargetOperations values
| Member | | |
Namespace: microsoft.graph
| renew | | unknownFutureValue |
-## userSignInRecommendationScope values
+### userSignInRecommendationScope values
| Member | | |
Namespace: microsoft.graph
| application | | unknownFutureValue |
-## unifiedRoleScheduleRequestActions values
+### unifiedRoleScheduleRequestActions values
| Member | | |
Namespace: microsoft.graph
| selfRenew | | unknownFutureValue |
-## approvalFilterByCurrentUserOptions values
+### approvalFilterByCurrentUserOptions values
| Member | | |
Namespace: microsoft.graph
| approver | | unknownFutureValue |
-## accessReviewExpirationBehavior values
+### accessReviewExpirationBehavior values
| Member | | -- |
Namespace: microsoft.graph
| acceptAccessRecommendation | | unknownFutureValue |
-## allowedTargetScope values
+### allowedTargetScope values
| Member | | |
Namespace: microsoft.graph
| allExternalUsers | | unknownFutureValue |
-## accessPackageAssignmentFilterByCurrentUserOptions values
+### accessPackageAssignmentFilterByCurrentUserOptions values
| Member | | |
Namespace: microsoft.graph
| createdBy | | unknownFutureValue |
-## accessPackageAssignmentRequestFilterByCurrentUserOptions values
+### accessPackageAssignmentRequestFilterByCurrentUserOptions values
| Member | | |
Namespace: microsoft.graph
| approver | | unknownFutureValue |
-## accessPackageAssignmentState values
+### accessPackageAssignmentState values
| Member | | |
Namespace: microsoft.graph
| deliveryFailed | | unknownFutureValue |
-## accessPackageCatalogState values
+### accessPackageCatalogState values
| Member | | |
Namespace: microsoft.graph
| published | | unknownFutureValue |
-## accessPackageCatalogType values
+### accessPackageCatalogType values
| Member | | |
Namespace: microsoft.graph
| serviceManaged | | unknownFutureValue |
-## accessPackageExternalUserLifecycleAction values
+### accessPackageExternalUserLifecycleAction values
| Member | | -- |
Namespace: microsoft.graph
| blockSignInAndDelete | | unknownFutureValue |
-## accessPackageFilterByCurrentUserOptions values
+### accessPackageFilterByCurrentUserOptions values
| Member | | | | allowedRequestor | | unknownFutureValue |
-## accessPackageRequestState values
+### accessPackageRequestState values
| Member | | |
Namespace: microsoft.graph
| partiallyDelivered | | unknownFutureValue |
-## accessPackageRequestType values
+### accessPackageRequestType values
| Member | | |
Namespace: microsoft.graph
| onBehalfAdd | | unknownFutureValue |
-## accessPackageSubjectType values
+### accessPackageSubjectType values
| Member | | |
Namespace: microsoft.graph
| servicePrincipal | | unknownFutureValue |
-## connectedOrganizationState values
+### connectedOrganizationState values
| Member | | - | | configured | | proposed |
-## accessReviewInstanceDecisionItemFilterByCurrentUserOptions values
+### accessReviewInstanceDecisionItemFilterByCurrentUserOptions values
| Member | | | | reviewer | | unknownFutureValue |
-## accessReviewStageFilterByCurrentUserOptions values
+### accessReviewStageFilterByCurrentUserOptions values
| Member | | | | reviewer | | unknownFutureValue |
-## accessPackageCustomExtensionStage values
+### accessPackageCustomExtensionStage values
| Member | | - |
Namespace: microsoft.graph
| assignmentOneDayBeforeExpiration | | unknownFutureValue |
-## customExtensionCalloutInstanceStatus values
+### customExtensionCalloutInstanceStatus values
| Member | | - |
Namespace: microsoft.graph
| waitingForCallback | | unknownFutureValue |
-## volumeType values
+### volumeType values
| Member | | |
Namespace: microsoft.graph
| removableDataVolume | | unknownFutureValue |
-## filterMode values
+### filterMode values
| Member | | - | | include | | exclude |
-## lifecycleEventType values
+### lifecycleEventType values
| Member | | -- |
Namespace: microsoft.graph
| subscriptionRemoved | | reauthorizationRequired |
-## changeType values
+### changeType values
| Member | | - | | clientIpAddress | | authenticatorAppGps |
-## countryLookupMethodType values
+### countryLookupMethodType values
| Member | | - | | clientIpAddress | | authenticatorAppGps |
-## consentRequestFilterByCurrentUserOptions values
+### consentRequestFilterByCurrentUserOptions values
| Member | | | | reviewer | | unknownFutureValue |
-## educationFeedbackResourceOutcomeStatus values
+### educationFeedbackResourceOutcomeStatus values
| Member | | |
Namespace: microsoft.graph
| failedPublish | | unknownFutureValue |
-## externalEmailOtpState values
+### externalEmailOtpState values
| Member | | |
Namespace: microsoft.graph
| disabled | | unknownFutureValue |
-## educationAddedStudentAction values
+### educationAddedStudentAction values
| Member | | |
Namespace: microsoft.graph
| assignIfOpen | | unknownFutureValue |
-## educationModuleStatus values
+### educationModuleStatus values
| Member | | | | draft | | published |
-## fido2RestrictionEnforcementType values
+### fido2RestrictionEnforcementType values
| Member | | | | allow | | block |
-## x509CertificateAuthenticationMode values
+### x509CertificateAuthenticationMode values
| Member | | |
Namespace: microsoft.graph
| x509CertificateMultiFactor | | unknownFutureValue |
-## x509CertificateRuleType values
+### x509CertificateRuleType values
| Member | | |
Namespace: microsoft.graph
| policyOID | | unknownFutureValue |
-## attestationLevel values
+### attestationLevel values
| Member | | -- | | attested | | notAttested |
-## authenticationMethodTargetType values
+### authenticationMethodTargetType values
| Member | | | | user | | group |
-## authenticationMethodState values
+### authenticationMethodState values
| Member | | -- | | enabled | | disabled |
-## microsoftAuthenticatorAuthenticationMode values
+### microsoftAuthenticatorAuthenticationMode values
| Member | | |
Namespace: microsoft.graph
| push | | deviceBasedPush |
-## keyStrength values
+### keyStrength values
| Member | | - |
Namespace: microsoft.graph
| weak | | unknown |
-## authenticationMethodKeyStrength values
+### authenticationMethodKeyStrength values
| Member | | - |
Namespace: microsoft.graph
| weak | | unknown |
-## allowInvitesFrom values
+### allowInvitesFrom values
| Member | | -- |
Namespace: microsoft.graph
| everyone | | unknownFutureValue |
-## dataPolicyOperationStatus values
+### dataPolicyOperationStatus values
| Member | | |
Namespace: microsoft.graph
| failed | | unknownFutureValue |
-## conditionalAccessDevicePlatform values
+### conditionalAccessDevicePlatform values
| Member | | |
Namespace: microsoft.graph
| all | | unknownFutureValue |
-## signinFrequencyType values
+### signinFrequencyType values
| Member | | | | days | | hours |
-## persistentBrowserSessionMode values
+### persistentBrowserSessionMode values
| Member | | | | always | | never |
-## cloudAppSecuritySessionControlType values
+### cloudAppSecuritySessionControlType values
| Member | | |
Namespace: microsoft.graph
| blockDownloads | | unknownFutureValue |
-## conditionalAccessGrantControl values
+### conditionalAccessGrantControl values
| Member | | -- |
Namespace: microsoft.graph
| passwordChange | | unknownFutureValue |
-## conditionalAccessClientApp values
+### conditionalAccessClientApp values
| Member | | |
Namespace: microsoft.graph
| other | | unknownFutureValue |
-## conditionalAccessPolicyState values
+### conditionalAccessPolicyState values
| Member | | |
Namespace: microsoft.graph
| disabled | | enabledForReportingButNotEnforced |
-## deviceProfileType values
+### deviceProfileType values
| Member | | - |
Namespace: microsoft.graph
| Shared | | IoT |
-## appliedConditionalAccessPolicyResult values
+### appliedConditionalAccessPolicyResult values
| Member | | |
Namespace: microsoft.graph
| unknown | | unknownFutureValue |
-## groupType values
+### groupType values
| Member | | |
Namespace: microsoft.graph
| azureAD | | unknownFutureValue |
-## conditionalAccessStatus values
+### conditionalAccessStatus values
| Member | | |
Namespace: microsoft.graph
| notApplied | | unknownFutureValue |
-## templateScenarios values
+### templateScenarios values
| Member | | |
Namespace: microsoft.graph
| emergingThreats | | unknownFutureValue |
-## operationResult values
+### operationResult values
| Member | | |
Namespace: microsoft.graph
| timeout | | unknownFutureValue |
-## tone values
+### tone values
| Member | | |
Namespace: microsoft.graph
| d | | flash |
-## mediaState values
+### mediaState values
| Member | | |
Namespace: microsoft.graph
| inactive | | unknownFutureValue |
-## basicStatus values
+### basicStatus values
| Member | | -- | | active | | inactive |
-## callState values
+### callState values
| Member | | - |
Namespace: microsoft.graph
| terminating | | terminated |
-## callType values
+### callType values
| Member | | |
Namespace: microsoft.graph
| peerToPeer | | unknownFutureValue |
-## educationAddToCalendarOptions values
+### educationAddToCalendarOptions values
| Member | | |
Namespace: microsoft.graph
| unknownFutureValue | | studentsOnly |
-## educationSubmissionStatus values
+### educationSubmissionStatus values
| Member | | |
Namespace: microsoft.graph
| unknownFutureValue | | reassigned |
-## onlineMeetingRole values
+### onlineMeetingRole values
| Member | | |
Namespace: microsoft.graph
| presenter | | unknownFutureValue |
-## modality values
+### modality values
| Member | | -- |
Namespace: microsoft.graph
| screenSharing | | unknownFutureValue |
-## endpointType values
+### endpointType values
| Member | | - |
Namespace: microsoft.graph
| skypeForBusinessVoipPhone | | unknownFutureValue |
-## callDirection values
+### callDirection values
| Member | | -- | | incoming | | outgoing |
-## signInAudience values
+### signInAudience values
| Member | | - |
Namespace: microsoft.graph
| AzureADandPersonalMicrosoftAccount | | PersonalMicrosoftAccount |
-## groupMembershipClaims values
+### groupMembershipClaims values
| Member | | - |
Namespace: microsoft.graph
| SecurityGroup | | All |
-## recipientScopeType values
+### recipientScopeType values
| Member | | |
Namespace: microsoft.graph
| externalPartner | | externalNonPartner |
-## activityType values
+### activityType values
| Member | | |
Namespace: microsoft.graph
| unknownFutureValue | | servicePrincipal |
-## riskDetectionTimingType values
+### riskDetectionTimingType values
| Member | | |
Namespace: microsoft.graph
| offline | | unknownFutureValue |
-## tokenIssuerType values
+### tokenIssuerType values
| Member | | -- |
Namespace: microsoft.graph
| ADFederationServices | | UnknownFutureValue |
-## attachmentType values
+### attachmentType values
| Member | | |
Namespace: microsoft.graph
| item | | reference |
-## contactRelationship values
+### contactRelationship values
| Member | Value | Description | | | -- | - |
Namespace: microsoft.graph
| other | 6 | An unspecified relationship to the user. | | unknownFutureValue | 7 | Marker value for future compatibility. |
-## scheduleEntityTheme values
+### scheduleEntityTheme values
| Member | | -- |
Namespace: microsoft.graph
| darkYellow | | unknownFutureValue |
-## timeOffReasonIconType values
+### timeOffReasonIconType values
| Member | | |
Namespace: microsoft.graph
| sunny | | unknownFutureValue |
-## windowsSettingType values
+### windowsSettingType values
Possible types of Windows settings.
Possible types of Windows settings.
| backup | | unknownFutureValue |
-## workforceIntegrationEncryptionProtocol values
+### workforceIntegrationEncryptionProtocol values
| Member | | -- | | sharedSecret | | unknownFutureValue |
-## workforceIntegrationSupportedEntities values
+### workforceIntegrationSupportedEntities values
| Member | | -- |
Possible types of Windows settings.
| offerShiftRequest | | unknownFutureValue |
-## timeZoneStandard values
+### timeZoneStandard values
| Member | | | | windows | | iana |
-## freeBusyStatus values
+### freeBusyStatus values
| Member | Value | | - | -- |
Possible types of Windows settings.
| workingElsewhere | 4 | | unknown | -1 |
-## attendeeType values
+### attendeeType values
| Member | | -- |
Possible types of Windows settings.
| optional | | resource |
-## externalAudienceScope values
+### externalAudienceScope values
| Member | | -- |
Possible types of Windows settings.
| contactsOnly | | all |
-## automaticRepliesStatus values
+### automaticRepliesStatus values
| Member | | -- |
Possible types of Windows settings.
| alwaysEnabled | | scheduled |
-## calendarColor values
+### calendarColor values
| Member | Value | | -- | -- |
Possible types of Windows settings.
| lightRed | 8 | | maxColor | 9 |
-## educationExternalSource values
+### educationExternalSource values
| Member | | |
Possible types of Windows settings.
| manual | | unknownFutureValue |
-## educationGender values
+### educationGender values
| Member | | -- |
Possible types of Windows settings.
| other | | unknownFutureValue |
-## eventType values
+### eventType values
| Member | | -- |
Possible types of Windows settings.
| exception | | seriesMaster |
-## sensitivity values
+### sensitivity values
| Member | | -- |
Possible types of Windows settings.
| private | | confidential |
-## importance values
+### importance values
| Member | | -- |
Possible types of Windows settings.
| normal | | high |
-## educationUserRole values
+### educationUserRole values
| Member | | |
Possible types of Windows settings.
| none | | unknownFutureValue |
-## meetingMessageType values
+### meetingMessageType values
| Member | | |
Possible types of Windows settings.
| meetingTenativelyAccepted | | meetingDeclined |
-## followupFlagStatus values
+### followupFlagStatus values
| Member | | -- |
Possible types of Windows settings.
| complete | | flagged |
-## inferenceClassificationType values
+### inferenceClassificationType values
| Member | | | | focused | | other |
-## iosNotificationAlertType values
+### iosNotificationAlertType values
| Member | | -- |
Possible types of Windows settings.
| modal | | none |
-## deviceEnrollmentFailureReason values
+### deviceEnrollmentFailureReason values
| Member | | -- |
Possible types of Windows settings.
| enrollmentRestrictionsEnforced | | clientDisconnected |
-## bodyType values
+### bodyType values
| Member | | - | | text | | html |
-## locationType values
+### locationType values
| Member | | -- |
Possible types of Windows settings.
| localBusiness | | postalAddress |
-## locationUniqueIdType values
+### locationUniqueIdType values
| Member | | -- |
Possible types of Windows settings.
| private | | bing |
-## messageActionFlag values
+### messageActionFlag values
| Member | | -- |
Possible types of Windows settings.
| replyToAll | | review |
-## onenoteUserRole values
+### onenoteUserRole values
| Member | Value | | -- | -- |
Possible types of Windows settings.
| Reader | 2 | | None | -1 |
-## operationStatus values
+### operationStatus values
| Member | | |
Possible types of Windows settings.
| Completed | | Failed |
-## onenotePatchActionType values
+### onenotePatchActionType values
| Member | | -- |
Possible types of Windows settings.
| Insert | | Prepend |
-## onenotePatchInsertPosition values
+### onenotePatchInsertPosition values
| Member | | -- | | After | | Before |
-## phoneType values
+### phoneType values
| Member | | -- |
Possible types of Windows settings.
| pager | | radio |
-## plannerContainerType values
+### plannerContainerType values
| Member | | |
Possible types of Windows settings.
| unknownFutureValue | | roster |
-## plannerPreviewType values
+### plannerPreviewType values
| Member | | -- |
Possible types of Windows settings.
| description | | reference |
-## status values
+### status values
| Member | | |
Possible types of Windows settings.
| ignored | | unknownFutureValue |
-## weekIndex values
+### weekIndex values
| Member | | -- |
Possible types of Windows settings.
| fourth | | last |
-## dayOfWeek values
+### dayOfWeek values
| Member | | -- |
Possible types of Windows settings.
| friday | | saturday |
-## recurrenceRangeType values
+### recurrenceRangeType values
| Member | | -- |
Possible types of Windows settings.
| noEnd | | numbered |
-## onenoteSourceService values
+### onenoteSourceService values
| Member | | - |
Possible types of Windows settings.
| OneDriveForBusiness | | OnPremOneDriveForBusiness |
-## responseType values
+### responseType values
| Member | | -- |
Possible types of Windows settings.
| declined | | notResponded |
-## activityDomain values
+### activityDomain values
| Member | | -- |
Possible types of Windows settings.
| personal | | unrestricted |
-## websiteType values
+### websiteType values
| Member | | -- |
Possible types of Windows settings.
| blog | | profile |
-## categoryColor values
+### categoryColor values
| Member | Value | | -- | -- |
Possible types of Windows settings.
| preset23 | 23 | | preset24 | 24 |
-## alertFeedback values
+### alertFeedback values
Possible feedback values on the alert provided by an analyst.
Possible feedback values on the alert provided by an analyst.
| falsePositive | 2 | Alert is false-positive. | | benignPositive | 3 | Alert is benign-positive. |
-## fileHashType values
+### fileHashType values
Enum for file hash types.
Enum for file hash types.
| peSha1 | 7 | PESHA1 hash type. | | peSha256 | 8 | PESHA256 hash type. |
-## connectionDirection values
+### connectionDirection values
Enum for the direction of the network connection (inbound/outbound).
Enum for the direction of the network connection (inbound/outbound).
| inbound | 1 | Inbound connection. | | outbound | 2 | Outbound connection. |
-## connectionStatus values
+### connectionStatus values
Enum for the status of connections.
Enum for the status of connections.
| blocked | 3 | Connection blocked. | | failed | 4 | Connection failed. |
-## processIntegrityLevel values
+### processIntegrityLevel values
Possible integrity level values of the process.
Possible integrity level values of the process.
| high | 40 | Integrity level is High. | | system | 50 | Integrity level is System. |
-## registryHive values
+### registryHive values
Enum for registry hives as defined by [/windows/desktop/sysinfo/registry-hives](/windows/desktop/sysinfo/registry-hives).
Enum for registry hives as defined by [/windows/desktop/sysinfo/registry-hives](
| localMachineSystem | 5 | HKEY_LOCAL_MACHINE\System hive. | | usersDefault | 6 | HKEY_USERS\\.DEFAULT hive. |
-## registryOperation values
+### registryOperation values
Operation that changed the registry key name and/or value.
Operation that changed the registry key name and/or value.
| modify | 2 | Modify registry. | | delete | 3 | Delete registry. |
-## registryValueType values
+### registryValueType values
Enum for registry value types as defined by [/windows/desktop/sysinfo/registry-value-types](/windows/desktop/sysinfo/registry-value-types).
Enum for registry value types as defined by [/windows/desktop/sysinfo/registry-v
| qwordlittleEndian | 10 | REG_QWORD_LITTLE_ENDIAN registry value type. | | sz | 11 | REG_SZ registry value type. |
-## alertSeverity values
+### alertSeverity values
Enum for severity of alerts.
Enum for severity of alerts.
| medium | 3 | Severity is medium. | | high | 4 | Severity is high. |
-## alertStatus values
+### alertStatus values
Possible values of an Alert lifecycle status (stage).
Possible values of an Alert lifecycle status (stage).
| inProgress | 20 | Alert is in progress. | | resolved | 30 | Alert is resolved. |
-## emailRole values
+### emailRole values
Possible values for email roles.
Possible values for email roles.
| sender | 1 | Sender of the email. | | recipient | 2 | Recipient of the email. |
-## logonType values
+### logonType values
Possible values for the method of user signin.
Possible values for the method of user signin.
| batch | 3 | Logon is batch. | | service | 4 | Logon is service. |
-## userAccountSecurityType values
+### userAccountSecurityType values
Possible values for user account types (group membership), per Windows definition.
Possible values for user account types (group membership), per Windows definitio
| power | 1 | Member of Power Users group. | | administrator | 2 | Member of Administrators group. |
-## riskDetail values
+### riskDetail values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| adminDismissedRiskForSignIn | | adminConfirmedAccountSafe |
-## riskEventTypes values
+### riskEventTypes values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| generic | | unknownFutureValue |
-## riskEventType values
+### riskEventType values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| maliciousIPAddressValidCredentialsBlockedIP | | unknownFutureValue |
-## riskLevel values
+### riskLevel values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| hidden | | unknownFutureValue |
-## riskState values
+### riskState values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| confirmedCompromised | | unknownFutureValue |
-## exchangeIdFormat values
+### exchangeIdFormat values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| restId | | restImmutableEntryId |
-## onlineMeetingProviderType values
+### onlineMeetingProviderType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| skypeForConsumer | | teamsForBusiness |
-## delegateMeetingMessageDeliveryOptions values
+### delegateMeetingMessageDeliveryOptions values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| sendToDelegateAndPrincipal | | sendToDelegateOnly |
-## calendarRoleType values
+### calendarRoleType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| delegateWithPrivateEventAccess | | custom |
-## threatAssessmentContentType values
+### threatAssessmentContentType values
| Member | Value | Description | | | -- | -- |
Possible values for user account types (group membership), per Windows definitio
| url | 2 | URL threat. | | file | 3 | Attachment file threat. |
-## threatExpectedAssessment values
+### threatExpectedAssessment values
| Member | Value | Description | | - | -- | | | block | 1 | The threat should be blocked. | | unblock | 2 | The threat shouldn't be blocked. |
-## threatCategory values
+### threatCategory values
| Member | Value | Description | | | -- | |
Possible values for user account types (group membership), per Windows definitio
| malware | 3 | Malware threat. | | unknownFutureValue | 4 | A sentinel member. |
-## threatAssessmentStatus values
+### threatAssessmentStatus values
| Member | Value | Description | | | -- | - | | pending | 1 | The threat assessment still in progress. | | completed | 2 | The threat assessment completed. |
-## threatAssessmentRequestSource values
+### threatAssessmentRequestSource values
| Member | Value | Description | | - | -- | |
Possible values for user account types (group membership), per Windows definitio
| user | 1 | User submission. | | administrator | 2 | Tenant admin submission. |
-## threatAssessmentResultType values
+### threatAssessmentResultType values
| Member | Value | Description | | | -- | - |
Possible values for user account types (group membership), per Windows definitio
| rescan | 2 | The rescan result. | | unknownFutureValue | 3 | A sentinel member. |
-## mailDestinationRoutingReason values
+### mailDestinationRoutingReason values
| Member | Value | Description | | | -- | -- |
Possible values for user account types (group membership), per Windows definitio
| junk | 14 | Blocked due to junk. | | unknownFutureValue | 15 | A sentinel member. |
-## chatMessageType values
+### chatMessageType values
| Value | | |
Possible values for user account types (group membership), per Windows definitio
| unknownFutureValue | | systemEventMessage |
-## chatMessagePolicyViolationDlpActionType values
+### chatMessagePolicyViolationDlpActionType values
| Value | | - |
Possible values for user account types (group membership), per Windows definitio
| BlockAccess | | BlockAccessExternal |
-## chatMessagePolicyViolationUserActionType values
+### chatMessagePolicyViolationUserActionType values
| Member | Int value | Description | | - | | |
Possible values for user account types (group membership), per Windows definitio
| Override | 1 | Sender has overridden the message verdict and sent the message anyway. | | ReportFalsePositive | 2 | Sender has reported the message verdict to the admins as a false positive. |
-## chatMessagePolicyViolationVerdictDetailsType values
+### chatMessagePolicyViolationVerdictDetailsType values
| Member | Int value | Description | | | | -- |
Possible values for user account types (group membership), per Windows definitio
| AllowOverrideWithoutJustification | 2 | User is allowed to override the block and send the message. Justification text isn't required. Exclusive to `AllowOverrideWithJustification`. | | AllowOverrideWithJustification | 4 | User is allowed to override the block and send the message. Justification text is required. Exclusive to `AllowOverrideWithoutJustification`. |
-## wellknownListName values
+### wellknownListName values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| flaggedEmails | | unknownFutureValue |
-## taskStatus values
+### taskStatus values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| waitingOnOthers | | deferred |
-## columnTypes values
+### columnTypes values
| Member | Description | | | -- |
Possible values for user account types (group membership), per Windows definitio
| approvalStatus | Content approval status column. | | unknownFutureValue | UnknownFuturevalue |
-## permissionClassificationType values
+### permissionClassificationType values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| medium | | high |
-## permissionType values
+### permissionType values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| delegated | | delegatedUserConsentable |
-## printColorMode values
+### printColorMode values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| auto | | unknownFutureValue |
-## printDuplexMode values
+### printDuplexMode values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| oneSided | | unknownFutureValue |
-## printerFeedOrientation values
+### printerFeedOrientation values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| shortEdgeFirst | | unknownFutureValue |
-## printFinishing values
+### printFinishing values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| trimAfterCopies | | trimAfterJob |
-## printMultipageLayout values
+### printMultipageLayout values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| clockwiseFromBottomRight | | unknownFutureValue |
-## printOrientation values
+### printOrientation values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| reversePortrait | | unknownFutureValue |
-## printQuality values
+### printQuality values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| high | | unknownFutureValue |
-## printScaling values
+### printScaling values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| none | | unknownFutureValue |
-## userFlowType values
+### userFlowType values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| resourceOwner | | unknownFutureValue |
-## identityUserFlowAttributeDataType values
+### identityUserFlowAttributeDataType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| dateTime | | unknownFutureValue |
-## identityUserFlowAttributeType values
+### identityUserFlowAttributeType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| required | | unknownFutureValue |
-## identityUserFlowAttributeInputType values
+### identityUserFlowAttributeInputType values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| emailBox | | checkboxMultiSelect |
-## authenticationAttributeCollectionInputType values
+### authenticationAttributeCollectionInputType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| boolean | | unknownFutureValue |
-## teamworkActivityTopicSource values
+### teamworkActivityTopicSource values
| Member | | | | entityUrl | | text |
-## provisioningResult values
+### provisioningResult values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| warning | | unknownFutureValue |
-## provisioningStepType values
+### provisioningStepType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| export | | unknownFutureValue |
-## provisioningStatusErrorCategory values
+### provisioningStatusErrorCategory values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| success | | unknownFutureValue |
-## provisioningAction values
+### provisioningAction values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| stagedDelete | | unknownFutureValue |
-## initiatorType values
+### initiatorType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| system | | unknownFutureValue |
-## teamworkApplicationIdentityType values
+### teamworkApplicationIdentityType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| outgoingWebhook | | unknownFutureValue |
-## teamworkConversationIdentityType values
+### teamworkConversationIdentityType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| chat | | unknownFutureValue |
-## teamworkUserIdentityType values
+### teamworkUserIdentityType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| unknownFutureValue | | emailUser |
-## postType values
+### postType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| strategic | | unknownFutureValue |
-## searchAlterationType values
+### searchAlterationType values
| Member | | | | modification | | suggestion |
-## serviceHealthClassificationType values
+### serviceHealthClassificationType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| incident | | unknownFutureValue |
-## serviceHealthOrigin values
+### serviceHealthOrigin values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| customer | | unknownFutureValue |
-## featureTargetType values
+### featureTargetType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| role | | unknownFutureValue |
-## serviceHealthStatus values
+### serviceHealthStatus values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| reported | | unknownFutureValue |
-## serviceUpdateCategory values
+### serviceUpdateCategory values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| stayInformed | | unknownFutureValue |
-## serviceUpdateSeverity values
+### serviceUpdateSeverity values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| critical | | unknownFutureValue |
-## subjectRightsRequestStage values
+### subjectRightsRequestStage values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| unknownFutureValue | | approval |
-## subjectRightsRequestStageStatus values
+### subjectRightsRequestStageStatus values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| failed | | unknownFutureValue |
-## subjectRightsRequestStatus values
+### subjectRightsRequestStatus values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| closed | | unknownFutureValue |
-## subjectRightsRequestType values
+### subjectRightsRequestType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| tagForAction | | unknownFutureValue |
-## dataSubjectType values
+### dataSubjectType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| other | | unknownFutureValue |
-## advancedConfigState values
+### advancedConfigState values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| disabled | | unknownFutureValue |
-## callRecordingStatus values
+### callRecordingStatus values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| chunkFinished | | unknownFutureValue |
-## endUserNotificationPreference values
+### endUserNotificationPreference values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| custom | | unknownFutureValue |
-## endUserNotificationSettingType values
+### endUserNotificationSettingType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| noNotification | | unknownFutureValue |
-## endUserNotificationType values
+### endUserNotificationType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| trainingReminder | | unknownFutureValue |
-## notificationDeliveryFrequency values
+### notificationDeliveryFrequency values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| biWeekly | | unknownFutureValue |
-## notificationDeliveryPreference values
+### notificationDeliveryPreference values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| deliverAfterCampaignEnd | | unknownFutureValue |
-## oAuthAppScope values
+### oAuthAppScope values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| sendMail | | unknownFutureValue |
-## targettedUserType values
+### targettedUserType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| allUsers | | unknownFutureValue |
-## trainingAssignedTo values
+### trainingAssignedTo values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| didNothing | | unknownFutureValue |
-## trainingAvailabilityStatus values
+### trainingAvailabilityStatus values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| delete | | unknownFutureValue |
-## trainingCompletionDuration values
+### trainingCompletionDuration values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| month | | unknownFutureValue |
-## trainingSettingType values
+### trainingSettingType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| custom | | unknownFutureValue |
-## trainingType values
+### trainingType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| phishing | | unknownFutureValue |
-## payloadDeliveryPlatform values
+### payloadDeliveryPlatform values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| teams | | unknownFutureValue |
-## trainingStatus values
+### trainingStatus values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| overdue | | unknownFutureValue |
-## teamworkCallEventType values
+### teamworkCallEventType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| screenShare | | unknownFutureValue |
-## bookingReminderRecipients values
+### bookingReminderRecipients values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| customer | | unknownFutureValue |
-## bookingStaffRole values
+### bookingStaffRole values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| scheduler | | teamMember |
-## answerInputType values
+### answerInputType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| radioButton | | unknownFutureValue |
-## bookingPriceType values
+### bookingPriceType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| notSet | | unknownFutureValue |
-## accessReviewHistoryStatus values
+### accessReviewHistoryStatus values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| requested | | unknownFutureValue |
-## accessReviewHistoryDecisionFilter values
+### accessReviewHistoryDecisionFilter values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| notNotified | | unknownFutureValue |
-## weakAlgorithms values
+### weakAlgorithms values
| Member | | - | | rsaSha1 | | unknownFutureValue |
-## authenticationProtocol values
+### authenticationProtocol values
| Member | | | | wsFed | | saml |
-## longRunningOperationStatus values
+### longRunningOperationStatus values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| failed | | unknownFutureValue |
-## delegatedAdminAccessAssignmentStatus values
+### delegatedAdminAccessAssignmentStatus values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| error | | unknownFutureValue |
-## delegatedAdminAccessContainerType values
+### delegatedAdminAccessContainerType values
| Member | | | | securityGroup | | unknownFutureValue |
-## delegatedAdminRelationshipOperationType values
+### delegatedAdminRelationshipOperationType values
| Member | | | | delegatedAdminAccessAssignmentUpdate | | unknownFutureValue |
-## delegatedAdminRelationshipRequestAction values
+### delegatedAdminRelationshipRequestAction values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| unknownFutureValue | | reject |
-## delegatedAdminRelationshipRequestStatus values
+### delegatedAdminRelationshipRequestStatus values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| failed | | unknownFutureValue |
-## delegatedAdminRelationshipStatus values
+### delegatedAdminRelationshipStatus values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| terminationRequested | | unknownFutureValue |
-## onPremisesDirectorySynchronizationDeletionPreventionType values
+### onPremisesDirectorySynchronizationDeletionPreventionType values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| enabledForCount | | enabledForPercentage |
-## searchContent values
+### searchContent values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| privateContent | | unknownFutureValue |
-## authenticationMethodsPolicyMigrationState values
+### authenticationMethodsPolicyMigrationState values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| migrationComplete | | unknownFutureValue |
-## authenticationStrengthPolicyType values
+### authenticationStrengthPolicyType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| custom | | unknownFutureValue |
-## authenticationStrengthRequirements values
+### authenticationStrengthRequirements values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| mfa | | unknownFutureValue |
-## authenticationMethodModes values
+### authenticationMethodModes values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| federatedMultiFactor | | unknownFutureValue |
-## baseAuthenticationMethod values
+### baseAuthenticationMethod values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| federation | | unknownFutureValue |
-## browserSharedCookieSourceEnvironment values
+### browserSharedCookieSourceEnvironment values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| both | | unknownFutureValue |
-## browserSiteCompatibilityMode values
+### browserSiteCompatibilityMode values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| internetExplorer5 | | unknownFutureValue |
-## browserSiteMergeType values
+### browserSiteMergeType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| default | | unknownFutureValue |
-## browserSiteTargetEnvironment values
+### browserSiteTargetEnvironment values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| none | | unknownFutureValue |
-## browserSiteStatus values
+### browserSiteStatus values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| pendingDelete | | unknownFutureValue |
-## browserSharedCookieStatus values
+### browserSharedCookieStatus values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| pendingDelete | | unknownFutureValue |
-## browserSiteListStatus values
+### browserSiteListStatus values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| pending | | unknownFutureValue |
-## chatMessageActions values
+### chatMessageActions values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| actionUndefined | | unknownFutureValue |
-## attributeDefinitionMetadata values
+### attributeDefinitionMetadata values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| MaximumLength | | ReferencedProperty |
-## attributeFlowBehavior values
+### attributeFlowBehavior values
| Member | | - | | FlowWhenChanged | | FlowAlways |
-## attributeFlowType values
+### attributeFlowType values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| ValueAddOnly | | AttributeAddOnly |
-## attributeMappingSourceType values
+### attributeMappingSourceType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| Constant | | Function |
-## directoryDefinitionDiscoverabilities values
+### directoryDefinitionDiscoverabilities values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| ReferenceAttributes | | UnknownFutureValue |
-## attributeType values
+### attributeType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| Boolean | | DateTime |
-## mutability values
+### mutability values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| Immutable | | WriteOnly |
-## objectDefinitionMetadata values
+### objectDefinitionMetadata values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| Extensions | | BaseObjectName |
-## objectFlowTypes values
+### objectFlowTypes values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| Update | | Delete |
-## objectMappingMetadata values
+### objectMappingMetadata values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| ExcludeFromReporting | | Unsynchronized |
-## synchronizationMetadata values
+### synchronizationMetadata values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| SynchronizationLearnMoreIbizaFwLink | | ConfigurationFields |
-## synchronizationSecret values
+### synchronizationSecret values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| TestReferences | | ConnectionString |
-## synchronizationStatusCode values
+### synchronizationStatusCode values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| Paused | | Quarantine |
-## synchronizationTaskExecutionResult values
+### synchronizationTaskExecutionResult values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| Failed | | EntryLevelErrors |
-## stagedFeatureName values
+### stagedFeatureName values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| certificateBasedAuthentication | | multiFactorAuthentication |
-## synchronizationJobRestartScope values
+### synchronizationJobRestartScope values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| Full | | ForceDeletes |
-## quarantineReason values
+### quarantineReason values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| TooManyDeletes | | IngestionInterrupted |
-## synchronizationScheduleState values
+### synchronizationScheduleState values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| Disabled | | Paused |
-## scopeOperatorMultiValuedComparisonType values
+### scopeOperatorMultiValuedComparisonType values
| Member | | - | | All | | Any |
-## scopeOperatorType values
+### scopeOperatorType values
| Member | | | | Binary | | Unary |
-## entryExportStatus values
+### entryExportStatus values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| PermanentError | | Error |
-## entrySyncOperation values
+### entrySyncOperation values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| Delete | | Update |
-## escrowBehavior values
+### escrowBehavior values
| Member | | | | Default | | IgnoreLookupReferenceResolutionFailure |
-## synchronizationDisposition values
+### synchronizationDisposition values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
| Discard | | Escrow |
-## outlierMemberType values
+### outlierMemberType values
| Member | | - | | user | | unknownFutureValue |
-## outlierContainerType values
+### outlierContainerType values
| Member | | - | | group | | unknownFutureValue |
-## authenticationMethodFeature values
+### authenticationMethodFeature values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| mfaCapable | | unknownFutureValue |
-## featureType values
+### featureType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| reset | | unknownFutureValue |
-## includedUserRoles values
+### includedUserRoles values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| user | | unknownFutureValue |
-## includedUserTypes values
+### includedUserTypes values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| guest | | unknownFutureValue |
-## signInUserType values
+### signInUserType values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| guest | | unknownFutureValue |
-## userDefaultAuthenticationMethod values
+### userDefaultAuthenticationMethod values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| none | | unknownFutureValue |
-## layoutTemplateType values
+### layoutTemplateType values
| Member | | |
Possible values for user account types (group membership), per Windows definitio
| verticalSplit | | unknownFutureValue |
-## meetingAudience values
+### meetingAudience values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| organization | | unknownFutureValue |
-## virtualEventAttendeeRegistrationStatus values
+### virtualEventAttendeeRegistrationStatus values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| rejectedByOrganizer | | unknownFutureValue |
-## virtualEventStatus values
+### virtualEventStatus values
| Member | | - |
Possible values for user account types (group membership), per Windows definitio
| published | | canceled |
-## socialIdentitySourceType values
+### socialIdentitySourceType values
| Member | | - | | facebook | | unknownFutureValue |
-## devicePlatformType values
+### devicePlatformType values
| Member | | -- |
Possible values for user account types (group membership), per Windows definitio
### nativeAuthenticationApisEnabled values
-| Member|
-|:|
-|none|
-|all|
-|unknownFutureValue|
-| unknown |
-| androidAOSP |
-| androidMobileApplicationManagement |
-| iOSMobileApplicationManagement |
-| unknownFutureValue |
-
-## educationAssignmentStatus values
-
-| Member |
-| |
-| draft |
-| published |
-| assigned |
-| unknownFutureValue |
-| inactive |
-
-## b2bIdentityProvidersType values
-
-| Member |
-| |
-| azureActiveDirectory |
-| externalFederation |
-| socialIdentityProviders |
-| emailOneTimePasscode |
-| microsoftAccount |
-| defaultConfiguredIdp |
-| unknownFutureValue |
-
-## bookingStaffMembershipStatus values
-
-| Member |
-| - |
-| active |
-| pendingAcceptance |
-| rejectedByStaff |
-| unknownFutureValue |
-
-## conditionalAccessInsiderRiskLevels values
-
-| Member |
-| - |
-| minor |
-| moderate |
-| elevated |
-| unknownFutureValue |
-
-## nativeAuthenticationApisEnabled values
- | Member | | - | | none |
v1.0 Externallink https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/externallink.md
Represents a URL that opens a OneNote page or notebook.
|:|:--|:| | href | String | The URL of the link. |
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Filestoragecontainer https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/filestoragecontainer.md
Represents a location where multiple users or a group of users can store files a
|description|String|Provides a user-visible description of the **fileStorageContainer**. Read-write.| |displayName|String|The display name of the **fileStorageContainer**. Read-write.| |id|String|The unique stable identifier of the **filerStorageContainer**. Read-only.|
-|status|fileStorageContainerStatus|Status of the **fileStorageContainer**. Containers are created as inactive and require activation. Inactive containers are subjected to automatic deletion in 24 hours. The possible values are: `inactive `, `active `. Read-only.|
+|status|fileStorageContainerStatus|Status of the **fileStorageContainer**. Containers are created as inactive and require activation. Inactive containers are subjected to automatic deletion in 24 hours. The possible values are: `inactive `, `active `. Read-only.|
|viewpoint|[fileStorageContainerViewpoint](../resources/filestoragecontainerviewpoint.md)|Data specific to the current user. Read-only.| ## Relationships
Represents a location where multiple users or a group of users can store files a
|:|:|:| |drive|[drive](../resources/drive.md)|The drive of the resource **fileStorageContainer**. Read-only.| |permissions|[permission](../resources/permission.md) collection|The set of permissions for users in the **fileStorageContainer**. Permission for each user is set by the **roles** property. The possible values are: `reader`, `writer`, `manager`, and `owner`. Read-write.|
+|settings|[fileStorageContainerSettings](../resources/filestoragecontainersettings.md)|Settings associated with a **fileStorageContainer**. Read-write.
### roles property values |Value|Description| |:|:|
-|reader|Readers can read **fileStorageContainer** metadata and the content inside.|
+|reader|Readers can read **fileStorageContainer** metadata and the contents inside.|
|writer|Writers can read and modify **fileStorageContainer** metadata and contents inside.| |manager|Managers can read and modify **fileStorageContainer** metadata and contents inside and manage the permissions to the container.| |owner|Owners can read and modify **fileStorageContainer** metadata and contents inside, manage container permissions, and delete and restore containers.|
The following JSON representation shows the resource type.
"@odata.type": "microsoft.graph.fileStorageContainerViewpoint" }, "status": "String",
- "createdDateTime": "String (timestamp)"
+ "createdDateTime": "String (timestamp)",
+ "settings": { "@odata.type": "microsoft.graph.fileStorageContainerSettings" }
} ```
v1.0 Filestoragecontainersettings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/filestoragecontainersettings.md
+
+ Title: "fileStorageContainerSettings resource type"
+description: "Represents settings of a fileStorageContainer."
+
+ms.localizationpriority: medium
+++
+# fileStorageContainerSettings resource type
+
+Namespace: microsoft.graph
+
+Represents settings associated with a [fileStorageContainer](../resources/filestoragecontainer.md).
++
+## Properties
+
+|Property|Type|Description|
+|:|:|:|
+|isOcrEnabled|Boolean|Indicates whether optical character recognition (OCR) is enabled for a given container. When OCR is enabled on a container, OCR extraction is performed for new and updated documents of supported types. The extracted fields are added to the metadata of the document, enabling end-user search and search-driven solutions. Changing this property from `true` to `false` doesn't remove OCR metadata that was created while it was `true`. Default value is `false`.|
+
+## Relationships
+
+None.
+
+## JSON representation
+
+The following JSON representation shows the resource type.
++
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.fileStorageContainerSettings"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.fileStorageContainerSettings",
+ "isOcrEnabled": "Boolean"
+}
+```
v1.0 Group https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/group.md
This resource supports:
| Property | Type | Description | |:-|:-|:-| | allowExternalSenders | Boolean | Indicates if people external to the organization can send messages to the group. The default value is `false`. <br><br>Returned only on `$select`. Supported only on the Get group API (`GET /groups/{ID}`). |
-| assignedLabels | [assignedLabel](assignedlabel.md) collection | The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. <br><br>Returned only on `$select`. |
+| assignedLabels | [assignedLabel](assignedlabel.md) collection | The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. <br><br>Returned only on `$select`. 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).|
| assignedLicenses | [assignedLicense](assignedlicense.md) collection | The licenses that are assigned to the group. <br><br>Returned only on `$select`. Supports `$filter` (`eq`).Read-only. | | autoSubscribeNewMembers | Boolean | Indicates if new members added to the group are autosubscribed to receive email notifications. You can set this property in a PATCH request for the group; don't set it in the initial POST request that creates the group. Default value is `false`. <br><br>Returned only on `$select`. Supported only on the Get group API (`GET /groups/{ID}`). | | classification | String | Describes a classification for the group (such as low, medium, or high business impact). Valid values for this property are defined by creating a ClassificationList [setting](groupsetting.md) value, based on the [template definition](groupsettingtemplate.md).<br><br>Returned by default. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `startsWith`). |
This resource supports:
| members | [directoryObject](directoryobject.md) collection | The members of this group, who can be users, devices, other groups, or service principals. Supports the [List members](../api/group-list-members.md), [Add member](../api/group-post-members.md), and [Remove member](../api/group-delete-members.md) operations. Nullable. <br/>Supports `$expand` including nested `$select`. For example, `/groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=members($select=id,userPrincipalName,displayName)`. | | membersWithLicenseErrors | [User](user.md) collection | A list of group members with license errors from this group-based license assignment. Read-only. | | onenote | [Onenote](onenote.md) | Read-only. |
-| owners | [directoryObject](directoryobject.md) collection | The owners of the group. Limited to 100 owners. Nullable. If this property isn't specified when creating a Microsoft 365 group, the calling user is automatically assigned as the group owner. <br/> Supports `$filter` (`/$count eq 0`, `/$count ne 0`, `/$count eq 1`, `/$count ne 1`). Supports `$expand` including nested `$select`. For example, `/groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=owners($select=id,userPrincipalName,displayName)`. |
+| owners | [directoryObject](directoryobject.md) collection | The owners of the group. Limited to 100 owners. Nullable. If this property isn't specified when creating a Microsoft 365 group the calling user (admin or non-admin) is automatically assigned as the group owner. For security groups, the admin caller isn't automatically added to this collection. <br/> Supports `$filter` (`/$count eq 0`, `/$count ne 0`, `/$count eq 1`, `/$count ne 1`). Supports `$expand` including nested `$select`. For example, `/groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=owners($select=id,userPrincipalName,displayName)`. |
| photo | [profilePhoto](profilephoto.md) | The group's profile photo | | photos | [profilePhoto](profilephoto.md) collection | The profile photos owned by the group. Read-only. Nullable. | | planner | [plannerGroup](plannergroup.md) | Entry-point to Planner resource that might exist for a Unified Group. |
The following JSON representation shows the resource type.
"conversations": [{ "@odata.type": "microsoft.graph.conversation" }], "createdDateTime": "String (timestamp)", "createdOnBehalfOf": { "@odata.type": "microsoft.graph.directoryObject" },
+ "deletedDateTime": "String (timestamp)",
"description": "String", "displayName": "String", "drive": { "@odata.type": "microsoft.graph.drive" },
v1.0 Groups Overview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/groups-overview.md
Using Microsoft Graph, you can perform the following common operations on groups
## Microsoft Entra roles for managing groups
-To manage groups in delegated scenarios, the app must be granted the appropriate permissions and the signed-in user must be in a supported [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json).
+To manage groups in delegated scenarios, the app must be granted the appropriate Microsoft Graph permissions and the signed-in user must be in a supported [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json).
-The following Microsoft Entra roles are the least privileged roles for managing all aspects of groups through Microsoft Graph, except for role-assignable groups. The least privileged role for managing role-assignable groups is **Privileged Role Administrator**.
+The following Microsoft Entra roles are the least privileged roles for all read and write operations on groups through Microsoft Graph, *except* for role-assignable groups. The least privileged role for managing role-assignable groups is **Privileged Role Administrator**.
- Directory Writers - Groups Administrator - User Administrator
+For a summary of the least privileged admin roles for different group-related tasks, see [Least privileged roles to manage groups](/entra/identity/role-based-access-control/delegate-by-task#groups).
+
+You can also create custom roles for group-related tasks. Refer to the [Microsoft Entra built-in roles reference](/entr) with the selected permissions.
+ ## Next step > [!div class="nextstepaction"]
v1.0 Identity https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/identity.md
Base type of [userIdentity](useridentity.md).
| tenantId | String | Unique identity of the tenant. Optional. | | thumbnails | [thumbnailSet](thumbnailset.md) | Keyed collection of thumbnail resources. Optional. Applies to drive items, for example. |
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Identitygovernance Attributechangetrigger https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/identitygovernance-attributechangetrigger.md
+
+ Title: "attributeChangeTrigger resource type"
+description: "An abstract type representing changes in user attributes that trigger the execution of workload conditions for a user."
+
+ms.localizationpriority: medium
+++
+# attributeChangeTrigger resource type
+
+Namespace: microsoft.graph.identityGovernance
+
+An abstract type representing changes in user attributes that trigger the execution of workload conditions for a user.
+
+Inherits from [microsoft.graph.identityGovernance.workflowExecutionTrigger](../resources/identitygovernance-workflowexecutiontrigger.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|triggerAttributes|[microsoft.graph.identityGovernance.triggerAttribute](../resources/identitygovernance-triggerattribute.md) collection|The trigger attribute being changed that triggers the workflowexecutiontrigger of a workflow.)|
+
+## Relationships
+None.
+
+## JSON representation
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.identityGovernance.attributeChangeTrigger"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.identityGovernance.attributeChangeTrigger",
+ "triggerAttributes": [
+ {
+ "@odata.type": "microsoft.graph.identityGovernance.triggerAttribute"
+ }
+ ]
+}
+```
+
v1.0 Identitygovernance Groupbasedsubjectset https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/identitygovernance-groupbasedsubjectset.md
+
+ Title: "groupBasedSubjectSet resource type"
+description: "Defines the group that is the scope of a lifecycle workflow membershipChangeTrigger configuration."
+
+ms.localizationpriority: medium
+++
+# groupBasedSubjectSet resource type
+
+Namespace: microsoft.graph.identityGovernance
+
+Defines the group that is the scope of a lifecycle workflow [membershipChangeTrigger](../resources/identitygovernance-membershipchangetrigger.md) configuration.
+
+Inherits from [microsoft.graph.subjectSet](../resources/subjectset.md).
+
+## Properties
+None.
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|groups|[microsoft.graph.group](../resources/group.md) collection|The specific group a user is interacting with in a [membershipChangeTrigger](identitygovernance-membershipchangetrigger.md) workflow.|
+
+## JSON representation
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.identityGovernance.groupBasedSubjectSet"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.identityGovernance.groupBasedSubjectSet"
+}
+```
+
v1.0 Identitygovernance Insights https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/identitygovernance-insights.md
+
+ Title: "insights resource type"
+description: "Represents insights into the health and processing of lifecycle workflows across different workflows."
+
+ms.localizationpriority: medium
+++
+# insights resource type
+
+Namespace: microsoft.graph.identityGovernance
+
+Represents insights into the health and processing of lifecycle workflows across different workflows. The insights include the number of total, successful, and failed workflow executions, tasks processed, and users processed across all workflows for the tenant for a given period.
+
+Inherits from [microsoft.graph.entity](../resources/entity.md).
+
+## Methods
+
+|Method|Return type|Description|
+|:|:|:|
+|[Get top workflows summary](../api/identitygovernance-insights-topworkflowsprocessedsummary.md)|[microsoft.graph.identityGovernance.topWorkflowsInsightsSummary](../resources/identitygovernance-topworkflowsinsightssummary.md) collection|Summarizes the top runs for workflows for a given data range.|
+|[Get top tasks summary](../api/identitygovernance-insights-toptasksprocessedsummary.md)|[microsoft.graph.identityGovernance.topTasksInsightsSummary](../resources/identitygovernance-toptasksinsightssummary.md) collection|Summarizes the top runs for tasks for a given data range.|
+|[Get workflows processed summary](../api/identitygovernance-insights-workflowsprocessedsummary.md)|[microsoft.graph.identityGovernance.workflowsInsightsSummary](../resources/identitygovernance-workflowsinsightssummary.md)|Summarizes the workflows, users, and tasks processed for a given date range.|
+|[Get workflows processed by category](../api/identitygovernance-insights-workflowsprocessedbycategory.md)|[microsoft.graph.identityGovernance.workflowsInsightsByCategory](../resources/identitygovernance-workflowsinsightsbycategory.md)|Summarizes workflow processing for each workflow category for a given date range.|
+
+## Properties
+
+None.
+
+## Relationships
+
+None.
+
+## JSON representation
+
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.identityGovernance.insights",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.identityGovernance.insights",
+ "id": "String (identifier)"
+}
+```
v1.0 Identitygovernance Lifecycleworkflowscontainer https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/identitygovernance-lifecycleworkflowscontainer.md
None.
|:|:|:| |customTaskExtensions|[microsoft.graph.identityGovernance.customTaskExtension](../resources/identitygovernance-customtaskextension.md) collection|The **customTaskExtension** instance.| |deletedItems|[deletedItemContainer](../resources/deleteditemcontainer.md)|Deleted workflows in your lifecycle workflows instance.|
+|insights|[microsoft.graph.identityGovernance.insights](../resources/identitygovernance-insights.md)|The insight container holding workflow insight summaries for a tenant.|
|settings|[microsoft.graph.identityGovernance.lifecycleManagementSettings](../resources/identitygovernance-lifecyclemanagementsettings.md)|The settings of the lifecycle workflows instance.| |taskDefinitions|[microsoft.graph.identityGovernance.taskDefinition](../resources/identitygovernance-taskdefinition.md) collection|The definition of tasks within the lifecycle workflows instance.| |workflows|[microsoft.graph.identityGovernance.workflow](../resources/identitygovernance-workflow.md) collection|The workflows in the lifecycle workflows instance.|
v1.0 Identitygovernance Membershipchangetrigger https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/identitygovernance-membershipchangetrigger.md
+
+ Title: "membershipChangeTrigger resource type"
+description: "An abstract type representing the change in group membership that triggers the execution conditions of a workflow for a user."
+
+ms.localizationpriority: medium
+++
+# membershipChangeTrigger resource type
+
+Namespace: microsoft.graph.identityGovernance
+
+An abstract type representing the change in group membership that triggers the execution conditions of a workflow for a user.
+
+Inherits from [microsoft.graph.identityGovernance.workflowExecutionTrigger](../resources/identitygovernance-workflowexecutiontrigger.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|changeType|microsoft.graph.identityGovernance.membershipChangeType|Defines what change that happens to the workflow group to trigger the [workflowExecutionTrigger](../resources/identitygovernance-workflowexecutiontrigger.md). Possible values are: `add`, `remove`, `unknownFutureValue`.|
+
+## Relationships
+None.
+
+## JSON representation
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.identityGovernance.membershipChangeTrigger"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.identityGovernance.membershipChangeTrigger",
+ "changeType": "String"
+}
+```
v1.0 Identitygovernance Toptasksinsightssummary https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/identitygovernance-toptasksinsightssummary.md
+
+ Title: "topTasksInsightsSummary resource type"
+description: "Represents a summary of top tasks ran within a tenant."
+
+ms.localizationpriority: medium
+++
+# topTasksInsightsSummary resource type
+
+Namespace: microsoft.graph.identityGovernance
+
+Represents a summary of the top tasks ran within a tenant, including total, failed, and successful tasks and user processing history.
+
+## Properties
+
+|Property|Type|Description|
+|:|:|:|
+|failedTasks|Int32|Count of failed runs of the task.|
+|failedUsers|Int32|Count of failed users who were processed by the task.|
+|successfulTasks|Int32|Count of successful runs of the task.|
+|successfulUsers|Int32|Count of successful users processed by the task.|
+|taskDefinitionDisplayName|String|The name of the task.|
+|taskDefinitionId|String|The task ID.|
+|totalTasks|Int32|Count of total runs of the task.|
+|totalUsers|Int32|Count of total users processed by the task.|
+
+## Relationships
+
+None.
+
+## JSON representation
+
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.identityGovernance.topTasksInsightsSummary"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.identityGovernance.topTasksInsightsSummary",
+ "taskDefinitionId": "String",
+ "taskDefinitionDisplayName": "String",
+ "totalTasks": "Integer",
+ "successfulTasks": "Integer",
+ "failedTasks": "Integer",
+ "totalUsers": "Integer",
+ "successfulUsers": "Integer",
+ "failedUsers": "Integer"
+}
+```
v1.0 Identitygovernance Topworkflowsinsightssummary https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/identitygovernance-topworkflowsinsightssummary.md
+
+ Title: "topWorkflowsInsightsSummary resource type"
+description: "Represents a summary of the workflows processed the most within a tenant."
+
+ms.localizationpriority: medium
+++
+# topWorkflowsInsightsSummary resource type
+
+Namespace: microsoft.graph.identityGovernance
+
+Represents a summary of the workflows that are processed the most, or the _top workflows_, within a tenant, including workflow details and the total, failed, and successful run and processing history for the workflow.
+
+## Properties
+
+|Property|Type|Description|
+|:|:|:|
+|failedRuns|Int32|Count of failed runs for workflow.|
+|failedUsers|Int32|Count of failed users who were processed.|
+|successfulRuns|Int32|Count of successful runs of the workflow.|
+|successfulUsers|Int32|Count of successful users processed by the workflow.|
+|totalRuns|Int32|Count of total runs of workflow.|
+|totalUsers|Int32|Total number of users processed by the workflow.|
+|workflowCategory|microsoft.graph.identityGovernance.lifecycleWorkflowCategory|The category of the workflow. The possible values are: `joiner`, `leaver`, `unknownFutureValue`, `mover`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value(s) in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `mover`.|
+|workflowDisplayName|String|The name of the workflow.|
+|workflowId|String|The workflow ID.|
+|workflowVersion|Int32|The version of the workflow that was a top workflow ran.|
+
+## Relationships
+
+None.
+
+## JSON representation
+
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.identityGovernance.topWorkflowsInsightsSummary"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.identityGovernance.topWorkflowsInsightsSummary",
+ "workflowId": "String",
+ "workflowDisplayName": "String",
+ "workflowCategory": "String",
+ "totalRuns": "Integer",
+ "successfulRuns": "Integer",
+ "failedRuns": "Integer",
+ "totalUsers": "Integer",
+ "successfulUsers": "Integer",
+ "failedUsers": "Integer",
+ "workflowVersion": "Integer"
+}
+```
v1.0 Identitygovernance Triggerattribute https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/identitygovernance-triggerattribute.md
+
+ Title: "triggerAttribute resource type"
+description: "An abstract type that defines the trigger attribute, which is changed to activate a workflow using an attributeChangeTrigger."
+
+ms.localizationpriority: medium
+++
+# triggerAttribute resource type
+
+Namespace: microsoft.graph.identityGovernance
+
+An abstract type that defines the trigger attribute, which is changed to activate a workflow using an [attributeChangeTrigger](../resources/identitygovernance-attributechangetrigger.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|name|String|The name of the trigger attribute that is changed to trigger an [attributeChangeTrigger](../resources/identitygovernance-attributechangetrigger.md) workflow.|
+
+## Relationships
+None.
+
+## JSON representation
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.identityGovernance.triggerAttribute"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.identityGovernance.triggerAttribute",
+ "name": "String"
+}
+```
+
v1.0 Identitygovernance Workflowsinsightsbycategory https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/identitygovernance-workflowsinsightsbycategory.md
+
+ Title: "workflowsInsightsByCategory resource type"
+description: "Represents a summary of workflows ran by category in a tenant"
+
+ms.localizationpriority: medium
+++
+# workflowsInsightsByCategory resource type
+
+Namespace: microsoft.graph.identityGovernance
+
+Represents a summary of the total, successful, and failed workflows run in a tenant by category. The possible categories are *Joiner*, *Mover*, or *Leaver*. For more information about workflows processed in a tenant, see [topWorkflowsInsightsSummary](identitygovernance-topworkflowsinsightssummary.md).
+
+## Properties
+
+|Property|Type|Description|
+|:|:|:|
+|failedJoinerRuns|Int32|Failed "*Joiner*" workflows processed in a tenant.|
+|failedLeaverRuns|Int32|Failed "*Leaver*" workflows processed in a tenant.|
+|failedMoverRuns|Int32|Failed "*Mover*" workflows processed in a tenant.|
+|successfulJoinerRuns|Int32|Successful "*Joiner*" workflows processed in a tenant.|
+|successfulLeaverRuns|Int32|Successful "*Leaver*" workflows processed in a tenant.|
+|successfulMoverRuns|Int32|Successful "*Mover*" workflows processed in a tenant.|
+|totalJoinerRuns|Int32|Total "*Joiner*" workflows processed in a tenant.|
+|totalLeaverRuns|Int32|Total "*Leaver*" workflows processed in a tenant.|
+|totalMoverRuns|Int32|Total "*Mover*" workflows processed in a tenant.|
+
+## Relationships
+
+None.
+
+## JSON representation
+
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.identityGovernance.workflowsInsightsByCategory"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.identityGovernance.workflowsInsightsByCategory",
+ "totalJoinerRuns": "Integer",
+ "successfulJoinerRuns": "Integer",
+ "failedJoinerRuns": "Integer",
+ "totalMoverRuns": "Integer",
+ "successfulMoverRuns": "Integer",
+ "failedMoverRuns": "Integer",
+ "totalLeaverRuns": "Integer",
+ "successfulLeaverRuns": "Integer",
+ "failedLeaverRuns": "Integer"
+}
+```
v1.0 Identitygovernance Workflowsinsightssummary https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/identitygovernance-workflowsinsightssummary.md
+
+ Title: "workflowsInsightsSummary resource type"
+description: "Provides a summary of workflow usage, known as insights, of Lifecycle Workflows in a tenant."
+
+ms.localizationpriority: medium
+++
+# workflowsInsightsSummary resource type
+
+Namespace: microsoft.graph.identityGovernance
+
+Provides a numerical summary of run information for workflows in a tenant, including total, successful, and failed tasks and user processing information. This resource contains information reported in the insights of a Lifecycle workflow tenant. More detailed specific task and workflow insight summaries are included in the [topTasksInsightsSummary](identitygovernance-toptasksinsightssummary.md) and [topWorkflowsInsightsSummary](identitygovernance-topworkflowsinsightssummary.md) resources.
+
+## Properties
+
+|Property|Type|Description|
+|:|:|:|
+|failedRuns|Int32|Count of failed workflow runs processed in the tenant.|
+|failedTasks|Int32|Count of failed tasks processed in the tenant.|
+|failedUsers|Int32|Count of failed users processed by workflows in the tenant.|
+|successfulRuns|Int32|Count of successful workflow runs processed in the tenant.|
+|successfulTasks|Int32|Count of successful tasks processed in the tenant.|
+|successfulUsers|Int32|Count of successful users processed by workflows in the tenant.|
+|totalRuns|Int32|Count of total workflows processed in the tenant.|
+|totalTasks|Int32|Count of total tasks processed by workflows in the tenant.|
+|totalUsers|Int32|Count of total users processed by workflows in the tenant.|
+
+## Relationships
+
+None.
+
+## JSON representation
+
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.identityGovernance.workflowsInsightsSummary"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.identityGovernance.workflowsInsightsSummary",
+ "totalRuns": "Integer",
+ "successfulRuns": "Integer",
+ "failedRuns": "Integer",
+ "totalUsers": "Integer",
+ "successfulUsers": "Integer",
+ "failedUsers": "Integer",
+ "totalTasks": "Integer",
+ "successfulTasks": "Integer",
+ "failedTasks": "Integer"
+}
+```
v1.0 Identityset https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/identityset.md
Represents a keyed collection of [identity](identity.md) resources. It is used t
| phone | [identity](identity.md) | Optional. The phone number associated with this action. | | user | [identity](identity.md) | Optional. The user associated with this action. |
+## Relationships
+
+None.
## JSON representation
v1.0 Insights Insightidentity https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/insights-insightidentity.md
Namespace: microsoft.graph
Complex type containing properties of [sharedInsight](insights-shared.md) items.
+## Properties
+
+| Property | Type | Description |
+| - |-- | -|
+| address | String | The email address of the user who shared the item. |
+| displayName | String | The display name of the user who shared the item. |
+| id | String | The ID of the user who shared the item. |
+
+## Relationships
+
+None.
+ ## JSON representation+ The following JSON representation shows the resource type. <!-- {
The following JSON representation shows the resource type.
} ```
-## Properties
-
-| Property | Type | Description |
-| - |-- | -|
-| address | String | The email address of the user who shared the item. |
-| displayName | String | The display name of the user who shared the item. |
-| id | String | The ID of the user who shared the item. |
-
v1.0 Insights Resourcereference https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/insights-resourcereference.md
Namespace: microsoft.graph
Complex type containing properties of [officeGraphInsights](officegraphinsights.md).
+## Properties
+
+| Property | Type | Description |
+| - |--| -|
+| id | String | The item's unique identifier. |
+| type | String | A string value that can be used to classify the item, such as "microsoft.graph.driveItem" |
+| webUrl | String | A URL leading to the referenced item. |
+
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.+ <!-- { "blockType": "resource", "optionalProperties": [
The following JSON representation shows the resource type.
"type": "string" } ```-
-## Properties
-
-| Property | Type | Description |
-| - |--| -|
-| id | String | The item's unique identifier. |
-| type | String | A string value that can be used to classify the item, such as "microsoft.graph.driveItem" |
-| webUrl | String | A URL leading to the referenced item. |
-
v1.0 Insights Resourcevisualization https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/insights-resourcevisualization.md
Namespace: microsoft.graph
Complex type containing properties of [officeGraphInsights](officegraphinsights.md).
-## JSON representation
-
-The following JSON representation shows the resource type.
-
-<!-- {
- "blockType": "resource",
- "optionalProperties": [
- ],
- "@odata.type": "microsoft.graph.resourceVisualization"
-}-->
-```json
-{
- "title": "string",
- "type" : "string",
- "mediaType": "string",
- "previewImageUrl": "string",
- "previewText": "string",
- "containerWebUrl": "string",
- "containerDisplayName": "string",
- "containerType": "string"
-}
-```
- ## Properties | Property | Type | Description |
The following JSON representation shows the resource type.
| previewText | String | A preview text for the item. | | type | String | The item's media type. Can be used for filtering for a specific file based on a specific type. See the section Type property values for supported types. |
-## Type property values
+### Type property values
- PowerPoint - Word - Excel
Example query:
Notes: For `spsite`, you may need to sort by `lastUsed/lastAccessedDateTime` desc in order to retrieve valid results
-## containerType property values
+### containerType property values
The supported types can differ based on containers from which [officeGraphInsights](officegraphinsights.md) returns files. For example, only the [sharedInsight](insights-shared.md) insight returns files from 'DropBox,' 'Box,' and 'GDrive.' - OneDriveBusiness
The supported types can differ based on containers from which [officeGraphInsigh
Example query: `https://graph.microsoft.com/v1.0/me/insights/trending?$filter=ResourceVisualization/containerType eq 'OneDriveBusiness'`
+## Relationships
+
+None.
+
+## JSON representation
+
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "optionalProperties": [
+ ],
+ "@odata.type": "microsoft.graph.resourceVisualization"
+}-->
+```json
+{
+ "title": "string",
+ "type" : "string",
+ "mediaType": "string",
+ "previewImageUrl": "string",
+ "previewText": "string",
+ "containerWebUrl": "string",
+ "containerDisplayName": "string",
+ "containerType": "string"
+}
+```
+
v1.0 Insights Sharingdetail https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/insights-sharingdetail.md
Contains properties of [sharedInsight](insights-shared.md) items.
| sharingType | String | Determines the way the document was shared. Can be by a 1Link1, 1Attachment1, 1Group1, 1Site1. | | sharingReference | [resourceReference](insights-resourcereference.md) | Reference properties of the document, such as the URL and type of the document. Read-only |
+## Relationships
+
+None.
## JSON representation+ The following JSON representation shows the resource type. <!-- { "blockType": "resource",
v1.0 Insights Usagedetails https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/insights-usagedetails.md
Namespace: microsoft.graph
Complex type containing properties of [Used](insights-used.md) items. Information on when the resource was last accessed (viewed) or modified (edited) by the user.
+## Properties
+
+| Property | Type | Description |
+| - || -|
+| lastAccessedDateTime | DateTimeOffset | The date and time the resource was last accessed by the user. The timestamp 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. |
+| lastModifiedDateTime | DateTimeOffset | The date and time the resource was last modified by the user. The timestamp 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. |
++
+## Relationships
+
+None.
## JSON representation
The following JSON representation shows the resource type.
"lastModifiedDateTime": "DateTimeOffset" } ```-
-## Properties
-
-| Property | Type | Description |
-| - || -|
-| lastAccessedDateTime | DateTimeOffset | The date and time the resource was last accessed by the user. The timestamp 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. |
-| lastModifiedDateTime | DateTimeOffset | The date and time the resource was last modified by the user. The timestamp 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. |
-
v1.0 Integerrange https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/integerrange.md
Represents an inclusive range of integers described by two Int64 boundaries.
|end|Int64|The inclusive upper bound of the integer range.| |start|Int64|The inclusive lower bound of the integer range.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.+ <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.integerRange"
v1.0 Itembody https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/itembody.md
Represents properties of the body of an item, such as a message, event or group
|content|String|The content of the item.| |contentType|bodyType|The type of the content. Possible values are `text` and `html`.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Keyvaluepair https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/keyvaluepair.md
Key value pair for action parameters.
|name|String|Name for this key-value pair| |value|String|Value for this key-value pair|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Location https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/location.md
Depending on how an event is created, expect Outlook to set the read-only **loca
| uniqueId | String | For internal use only.| | uniqueIdType | locationUniqueIdType | For internal use only. |
+## Relationships
+
+None.
+ ## JSON representation
+The following JSON representation shows the resource type.
+ <!-- { "blockType": "resource", "optionalProperties": [
v1.0 Logicapptriggerendpointconfiguration https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/logicapptriggerendpointconfiguration.md
The configuration details for the logic app's endpoint that is associated with a
|subscriptionId|String|Identifier of the Azure subscription for the logic app.| |url|String| The URL to the logic app endpoint that will be triggered. Only required for app-only token scenarios where app is creating a [customCalloutExtension](../resources/customcalloutextension.md) without a signed-in user.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.+ <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.logicAppTriggerEndpointConfiguration",
v1.0 Longrunningoperation https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/longrunningoperation.md
Namespace: microsoft.graph
Represents the status of a long-running Microsoft Graph API operation. The following types derive from this object:-- [richLongRunningOperation](richlongrunningoperation.md) - [attackSimulationOperation](../resources/attacksimulationoperation.md)
+- [engagementAsyncOperation](../resources/engagementasyncoperation.md)
+- [richLongRunningOperation](richlongrunningoperation.md)
## Properties |Property|Type|Description| |:|:|:|
-|createdDateTime|DateTimeOffset|The start time of the operation. 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`.|
+|createdDateTime|DateTimeOffset|The start time of the operation. 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`.|
|id|String|The unique identifier of the operation. |
-|lastActionDateTime|DateTimeOffset|The time of the last action in the operation. 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`.|
+|lastActionDateTime|DateTimeOffset|The time of the last action in the operation. 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`.|
|resourceLocation|String| URI of the resource that the operation is performed on. | |status|longRunningOperationStatus|The status of the operation. The possible values are: `notStarted`, `running`, `succeeded`, `failed`, `unknownFutureValue`.| |statusDetail|String|Details about the status of the operation.|
-The following JSON representation shows the resource type.
## JSON representation
v1.0 Notebooklinks https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/notebooklinks.md
Namespace: microsoft.graph
Links for opening a OneNote notebook.
+## Properties
+| Property | Type |Description|
+|:|:--|:-|
+|oneNoteClientUrl|[externalLink](externallink.md)|Opens the notebook in the OneNote native client if it's installed.|
+|oneNoteWebUrl|[externalLink](externallink.md)|Opens the notebook in OneNote on the web.|
+
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
The following JSON representation shows the resource type.
} ```
-## Properties
-| Property | Type |Description|
-|:|:--|:-|
-|oneNoteClientUrl|[externalLink](externallink.md)|Opens the notebook in the OneNote native client if it's installed.|
-|oneNoteWebUrl|[externalLink](externallink.md)|Opens the notebook in OneNote on the web.|
<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC -->
v1.0 Onenotebasemodel https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/onenotebasemodel.md
Namespace: microsoft.graph
This is the base type for OneNote entities.
+## Properties
+
+| Property | Type |Description|
+|:|:--|:-|
+|self|String|The endpoint where you can get details about the page. Read-only.|
+
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
The following JSON representation shows the resource type.
} ```
-## Properties
-| Property | Type |Description|
-|:|:--|:-|
-|self|String|The endpoint where you can get details about the page. Read-only.|
- <!-- uuid: bfb567de-2a2a-4b81-bf47-a55626a0c166 2015-10-25 14:57:30 UTC --> <!-- {
v1.0 Onenoteentityhierarchymodel https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/onenoteentityhierarchymodel.md
Namespace: microsoft.graph
A base type for OneNote entities.
+## Properties
+
+| Property | Type |Description|
+|:|:--|:-|
+|displayName|String|The name of the notebook.|
+|createdBy|[identitySet](identityset.md)|Identity of the user, device, and application that created the item. Read-only.|
+|lastModifiedBy|[identitySet](identityset.md)|Identity of the user, device, and application that created the item. Read-only.|
+|lastModifiedDateTime|DateTimeOffset|The date and time when the notebook was last modified. The timestamp 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.|
+
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
The following JSON representation shows the resource type.
} ```
-## Properties
-| Property | Type |Description|
-|:|:--|:-|
-|displayName|String|The name of the notebook.|
-|createdBy|[identitySet](identityset.md)|Identity of the user, device, and application that created the item. Read-only.|
-|lastModifiedBy|[identitySet](identityset.md)|Identity of the user, device, and application that created the item. Read-only.|
-|lastModifiedDateTime|DateTimeOffset|The date and time when the notebook was last modified. The timestamp 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.|
<!-- uuid: 8b1af557-1a7c-4432-86eb-94989c2d4b54 2015-10-25 14:57:30 UTC -->
v1.0 Onenoteentityschemaobjectmodel https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/onenoteentityschemaobjectmodel.md
Namespace: microsoft.graph
This is a base type for OneNote entities.
+## Properties
+
+| Property | Type |Description|
+|:|:--|:-|
+|createdDateTime|DateTimeOffset|The date and time when the page was created. The timestamp 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.|
+
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
The following JSON representation shows the resource type.
} ```
-## Properties
-| Property | Type |Description|
-|:|:--|:-|
-|createdDateTime|DateTimeOffset|The date and time when the page was created. The timestamp 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.|
<!-- uuid: bfb567de-2a2a-4b81-bf47-a55626a0c166 2015-10-25 14:57:30 UTC -->
v1.0 Onenoteoperationerror https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/onenoteoperationerror.md
Namespace: microsoft.graph
An error from a failed OneNote operation.
+## Properties
+
+| Property | Type |Description|
+|:|:--|:-|
+|code|string|The error code.|
+|message|string|The error message.|
+
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
The following JSON representation shows the resource type.
} ```
-## Properties
-| Property | Type |Description|
-|:|:--|:-|
-|code|string|The error code.|
-|message|string|The error message.|
<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC -->
v1.0 Operation https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/operation.md
The status of a long-running operation.
|lastActionDateTime| DateTimeOffset |The time of the last action of the operation.| |status|operationStatus|The current status of the operation: `notStarted`, `running`, `completed`, `failed` |
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Outlookgeocoordinates https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/outlookgeocoordinates.md
Namespace: microsoft.graph
The geographic coordinates, elevation, and their degree of accuracy for a physical location.
+## Properties
+| Property | Type |Description|
+|:|:--|:-|
+|accuracy|double|The accuracy of the latitude and longitude. As an example, the accuracy can be measured in meters, such as the latitude and longitude are accurate to within 50 meters.|
+|altitude|double|The altitude of the location.|
+|altitudeAccuracy|double|The accuracy of the altitude.|
+|latitude|double|The latitude of the location.|
+|longitude|double|The longitude of the location.|
+
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
The following JSON representation shows the resource type.
} ```
-## Properties
-| Property | Type |Description|
-|:|:--|:-|
-|accuracy|double|The accuracy of the latitude and longitude. As an example, the accuracy can be measured in meters, such as the latitude and longitude are accurate to within 50 meters.|
-|altitude|double|The altitude of the location.|
-|altitudeAccuracy|double|The accuracy of the altitude.|
-|latitude|double|The latitude of the location.|
-|longitude|double|The longitude of the location.|
- <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!-- {
v1.0 Pagelinks https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/pagelinks.md
Namespace: microsoft.graph
Links for opening a OneNote page.
+## Properties
+
+| Property | Type |Description|
+|:|:--|:-|
+|oneNoteClientUrl|[externalLink](externallink.md)|Opens the page in the OneNote native client if it's installed.|
+|oneNoteWebUrl|[externalLink](externallink.md)|Opens the page in OneNote on the web.|
+
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
The following JSON representation shows the resource type.
} ```
-## Properties
-| Property | Type |Description|
-|:|:--|:-|
-|oneNoteClientUrl|[externalLink](externallink.md)|Opens the page in the OneNote native client if it's installed.|
-|oneNoteWebUrl|[externalLink](externallink.md)|Opens the page in OneNote on the web.|
<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC -->
v1.0 Patternedrecurrence https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/patternedrecurrence.md
The recurrence pattern and range. This shared object is used to define the recur
|pattern|[recurrencePattern](recurrencepattern.md)|The frequency of an event. <br/><br/> For access reviews: <li>Do not specify this property for a one-time access review. <li> Only **interval**, **dayOfMonth**, and **type** (`weekly`, `absoluteMonthly`) properties of [recurrencePattern](recurrencepattern.md) are supported.| |range|[recurrenceRange](recurrencerange.md)|The duration of an event.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Phone https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/phone.md
Represents a phone number.
|number|string|The phone number.| |type|phoneType|The type of phone number. The possible values are: `home`, `business`, `mobile`, `other`, `assistant`, `homeFax`, `businessFax`, `otherFax`, `pager`, `radio`.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Physicaladdress https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/physicaladdress.md
Represents the street address of a resource such as a contact or event.
|state|String|The state.| |street|String|The street.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Plannerchecklistitems https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/plannerchecklistitems.md
Title: "plannerChecklistItems resource type"
-description: "The **plannerChecklistItemCollection** resource represents the collection of checklist items on a task. It's an Open Type. It's part of the task details object. The value in the property-value pair is the checklistItem object."
+description: "Represents the collection of checklist items on a task. This complex type is an open type that's part of the task details object. The value in the property-value pair is the checklistItem object."
ms.localizationpriority: medium
doc_type: resourcePageType
Namespace: microsoft.graph
-The **plannerChecklistItemCollection** resource represents the collection of checklist items on a task. It's an Open Type. It's part of the [task details](plannertaskdetails.md) object. The value in the property-value pair is the [checklistItem](plannerchecklistitem.md) object.
+Represents the collection of checklist items on a task. This complex type is an open type that's part of the [task details](plannertaskdetails.md) object. The value in the property-value pair is the [checklistItem](plannerchecklistitem.md) object.
## Properties
-Properties of an Open Type can be defined by the client. In this case, the client should provide **GUIDs** as properties and their values must be [checklistItem](plannerchecklistitem.md) objects. Example is shown below. To remove an item in the checklist, set the value of the property to `null`.
+Properties of an open type can be defined by the client. In this case, the client should provide **GUIDs** as properties and their values must be [checklistItem](plannerchecklistitem.md) objects. To remove an item in the checklist, set the value of the property to `null`.
## JSON representation
The following JSON representation shows the resource type.
{ "String-value": {
+ "@odata.type": "microsoft.graph.plannerChecklistItem",
"isChecked": true,
- "lastModifiedBy": "String-value",
+ "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
"lastModifiedByDateTime": "String(timestamp)", "orderHint": "String-value", "title": "String-value" } }
-```
-// Example
-
-```json
-{
- "3a73c9dd-fb47-4230-9c0f-b80788fb0f9b": // client-generated GUID
- {
- "@odata.type": "microsoft.graph.checklistItem", // required in PATCH requests to edit the checklist on a task
- "isChecked": true,
- "lastModifiedBy": {
- "user": {
- "id": "ebf3b108-5234-4e22-b93d-656d7dae5874"
- }
- },
- "lastModifiedByDateTime": "2015-09-21T17:45:12.039Z",
- "orderHint": "0009005756397228702",
- "title": "Get stamps"
- },
- "5f36f5b2-1ec0-4c48-9c75-ed59429516c5":
- {
- "@odata.type": "microsoft.graph.checklistItem",
- "isChecked": false,
- "lastModifiedBy": {
- "user": {
- "id": "ebf3b108-5234-4e22-b93d-656d7dae5874"
- }
- },
- "lastModifiedByDateTime": "2015-09-21T17:45:12.039Z",
- "orderHint": "0004105723397228784",
- "title": "Mail card at UPS"
- }
-}
- ``` <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
v1.0 Plannerplan https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/plannerplan.md
Represents a plan in Microsoft 365. A plan can be owned by a [group](group.md) a
| Method | Return Type |Description| |:|:--|:-|
-|[Get plan](../api/plannerplan-get.md) | [plannerPlan](plannerplan.md) |Read properties and relationships of **plannerPlan** object.|
+|[Create](../api/planner-post-plans.md) | [plannerPlan](plannerplan.md) |Create a **plannerPlan** object.|
+|[Get](../api/plannerplan-get.md) | [plannerPlan](plannerplan.md) |Read properties and relationships of **plannerPlan** object.|
+|[Update](../api/plannerplan-update.md) | [plannerPlan](plannerplan.md) |Update **plannerPlan** object. |
+|[Delete](../api/plannerplan-delete.md) | None | Delete **plannerPlan** object. |
|[List plan buckets](../api/plannerplan-list-buckets.md) |[plannerBucket](plannerbucket.md) collection| Get a **plannerBucket** object collection.| |[List plan tasks](../api/plannerplan-list-tasks.md) |[plannerTask](plannertask.md) collection| Get a **plannerTask** object collection.|
-|[Update plan](../api/plannerplan-update.md) | [plannerPlan](plannerplan.md) |Update **plannerPlan** object. |
-|[Delete plan](../api/plannerplan-delete.md) | None | Delete **plannerPlan** object. |
## Properties | Property | Type |Description|
v1.0 Plannertask https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/plannertask.md
Represents a Planner task in Microsoft 365. A Planner task is contained in a [pl
| Method | Return Type |Description| |:|:--|:-|
-|[Get task](../api/plannertask-get.md) | [plannerTask](plannertask.md) |Read properties and relationships of **plannerTask** object.|
-|[Update task](../api/plannertask-update.md) | [plannerTask](plannertask.md) |Update **plannerTask** object. |
-|[Delete task](../api/plannertask-delete.md) | None |Delete **plannerTask** object. |
+|[Create](../api/planner-post-tasks.md) | [plannerTask](plannertask.md) |Create **plannerTask** object.|
+|[Get](../api/plannertask-get.md) | [plannerTask](plannertask.md) |Read properties and relationships of **plannerTask** object.|
+|[Update](../api/plannertask-update.md) | [plannerTask](plannertask.md) |Update **plannerTask** object. |
+|[Delete](../api/plannertask-delete.md) | None |Delete **plannerTask** object. |
## Properties | Property | Type |Description|
v1.0 Printjobstatus https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/printjobstatus.md
Represents the current status of a print job.
|releaseWait|5|Job is pending to be released.| |interpreting|6|Job is in 'processing' state, but more specifically, document payload is being interpreted.|
+## Relationships
+
+None.
+ ## JSON representation+ The following JSON representation shows the resource type.+ <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.printJobStatus"
v1.0 Printmargin https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/printmargin.md
Specifies the margin widths to use when printing.
|right|Int32|The margin in microns from the right edge.| |top|Int32|The margin in microns from the top edge.|
+## Relationships
+
+None.
## JSON representation+ The following JSON representation shows the resource type.+ <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.printMargin"
v1.0 Printoperationstatus https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/printoperationstatus.md
Represents the current status of a long-running Universal Print operation.
|failed|3|The operation failed.| |unknownFutureValue|4|Evolvable enumeration sentinel value. Do not use.|
+## Relationships
+
+None.
+ ## JSON representation+ The following JSON representation shows the resource type.+ <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.printOperationStatus"
v1.0 Printsettings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/printsettings.md
Represents tenant-wide settings for the Universal Print service.
|:|:|:| |documentConversionEnabled|Boolean|Specifies whether document conversion is enabled for the tenant. If document conversion is enabled, Universal Print service will automatically convert documents into a format compatible with the printer (xps to pdf) when needed.|
+## Relationships
+
+None.
+ ## JSON representation+ The following JSON representation shows the resource type.+ <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.printSettings"
v1.0 Printtaskstatus https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/printtaskstatus.md
Represents the current execution status of a [printTask](printtask.md).
|aborted|3|Task execution was aborted.| |unknownFutureValue|4|Evolvable enumeration sentinel value. Do not use.|
+## Relationships
+
+None.
+ ## JSON representation+ The following JSON representation shows the resource type.+ <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.printTaskStatus"
v1.0 Protectionrulebase https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/protectionrulebase.md
Title: "protectionRuleBase resource type"
-description: "Describes Protection Rule and its properties "
+description: "Represents a protection rule specified by the client as part of a protection plan applied to Microsoft 365 data in an organization."
ms.localizationpriority: medium
Protection rules can be static or dynamic, which means that the rules can run on
This abstract type is the base type for [siteProtectionRule](../resources/siteprotectionrule.md), [mailboxProtectionRule](../resources/mailboxprotectionrule.md), and [driveProtectionRule](../resources/driveprotectionrule.md).
+The following limitations apply to this resource:
+
+- The protection rule APIs for bulk addition of sites via site names or URL in the backup policy creation workflow can accommodate a maximum of 10 keywords at a time. Each keyword can have a minimum of three characters and a maximum of 255 characters.
+- The protection rule APIs for bulk addition of user accounts via security groups or distribution lists can accommodate a maximum of three groups at a time.
+- The rules are static and applied one time only. That is, the security groups or distribution lists are flattened at the time they're added to the backup configuration policy. For example, groups or lists aren't dynamically updated in the system if users are added or removed from the original security group.
+ ## Properties |Property|Type|Description|
v1.0 Protectionunitbase https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/protectionunitbase.md
toc. Title: Protection unit
Namespace: microsoft.graph
-Represents a site, drive, or mailbox that's protected by a [protection policy](protectionpolicybase.md).
+Represents a site, drive, or mailbox that's protected by a [protection policy](protectionpolicybase.md). All the protection units in a protection policy have same retention period by default.
This resource is an abstract type.
v1.0 Recentnotebooklinks https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/recentnotebooklinks.md
Links for opening a OneNote notebook. This resource type exists as a property on
|oneNoteClientUrl|[externalLink](externallink.md)|Opens the notebook in the OneNote native client if it's installed.| |oneNoteWebUrl|[externalLink](externallink.md)|Opens the notebook in OneNote on the web.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Recurrencepattern https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/recurrencepattern.md
Use the **type** property to specify the different types of **recurrencePattern*
| `absoluteYearly` | Event repeats on the specified day and month, based on the number of years between occurrences. | Repeat event on the 15th of March every 3 years. | **type**, **interval**, **dayOfMonth**, **month** | | `relativeYearly` | Event repeats on the specified day or days of the week, in the same relative position in a specific month of the year, based on the number of years between occurrences. | Repeat event on the second Thursday or Friday of every November every 3 years. | **type**, **interval**, **daysOfWeek**, **month** |
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Recurrencerange https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/recurrencerange.md
Use the **type** property to specify the different types of **recurrenceRange**.
|`noEnd` |Range without an end date | Event repeats on all the days that fit the corresponding recurrence pattern beginning on the **startDate**. | Repeat event in the date range starting on June 1, 2017 indefinitely. | **type**, **startDate** | |`numbered`|Range with specific number of occurrences | Event repeats for the **numberOfOccurrences** based on the recurrence pattern beginning on the **startDate**. | Repeat event in the date range starting on June 1, 2017, for 10 occurrences. | **type**, **startDate**, **numberOfOccurrences** |
+## Relationships
+
+None.
## JSON representation
v1.0 Report https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/report.md
For details about the settings that govern identification/de-identification of i
Microsoft Graph controls access to resources via permissions. You must specify the permissions you need in order to access Reports resources. Typically, you specify permissions in the Microsoft Entra admin center. For more information, see [Microsoft Graph permissions reference](/graph/permissions-reference) and [Reports permissions](/graph/permissions-reference#reports-permissions).
+## Settings
+
+In Microsoft 365 reports, user information such as usernames, groups, and sites is concealed; actual values aren't displayed. You can use the [adminReportSettings](../resources/adminreportsettings.md) API to control the display of user information in the reports.
+ ## Cloud deployments The following table shows the availability for each API across all cloud deployments. | APIs | Microsoft Graph global service | Microsoft Cloud for US Government | Microsoft Cloud China operated by 21Vianet | | - | | -| |
+| [Admin report settings](../resources/adminreportsettings.md) | Γ£ö | Γ₧û | Γ₧û |
| [Microsoft 365 activations](reportroot.md#microsoft-365-activations) | Γ£ö | Γ₧û | Γ₧û | | [Microsoft 365 active users](reportroot.md#microsoft-365-active-users) | Γ£ö | Γ₧û | Γ₧û | | [Microsoft 365 apps usage](reportroot.md#microsoft-365-apps-usage) | Γ£ö | Γ₧û | Γ₧û |
v1.0 Requestormanager https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/requestormanager.md
It's a subtype of [subjectSet](subjectset.md), in which the `@odata.type` value
|managerLevel|Int32|The hierarchical level of the manager with respect to the requestor. For example, the direct manager of a requestor would have a managerLevel of 1, while the manager of the requestor's manager would have a managerLevel of 2. Default value for managerLevel is 1. Possible values for this property range from 1 to 2. | ## Relationships+ None.+ ## JSON representation+ The following JSON representation shows the resource type.+ <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.requestorManager",
v1.0 Restorepoint https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/restorepoint.md
Namespace: microsoft.graph
Represents the date and time when an [artifact](../resources/restoreartifactbase.md) is protected by a [protectionPolicy](../resources/protectionpolicybase.md) and can be restored.
+The following limitations apply to this API:
+
+- When sites or mailboxes are added to a backup policy, it might take up to 15 minutes per 1,000 sites or mailboxes for restore points to become available.
+- Although OneDrive account and mailbox backups of deleted users are maintained and restorable after the userΓÇÖs Microsoft Entra ID is deleted, the user is displayed as an empty user in results.
+ ## Methods |Method|Return type|Description|
v1.0 Restoresessionbase https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/restoresessionbase.md
toc. Title: Restore session
Namespace: microsoft.graph
-Represents a restore session for a [protection unit](protectionunitbase.md) that's protected by a [protection policy](protectionpolicybase.md). APIs are used by Global Admin or SharePoint Online Admin for SharePoint Online/OneDrive & Exchange Online Admin for Exchange Online to perform restore related tasks on artifacts that are protected as part of Protection Policy.
+Represents a restore session for a [protection unit](protectionunitbase.md) that's protected by a [protection policy](protectionpolicybase.md). Restore session APIs are used by global admins, SharePoint Online admins, and Exchange Online admins to perform restore-related tasks on artifacts that are protected as part of protection policy.
+
+Restoring to both a new location and the same URL in a single restore session is not supported.
## Methods
v1.0 Resulttemplate https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/resulttemplate.md
Represents a dictionary of **resultTemplateIds** and associated values, which in
|displayName|String|Name of the result template.| |key|String|ID of a result template. The **key** property must map to a **resultTemplateId** in the [searchHit](searchhit.md) collection.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Resulttemplateoption https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/resulttemplateoption.md
Provides the search result template options to render search results from connec
|:-|:|:| |enableResultTemplate|Boolean|Indicates whether search display layouts are enabled. If enabled, the user will get the result template to render the search results content in the **resultTemplates** property of the [response](/graph/api/resources/searchresponse). The result template is based on [Adaptive Cards](https://adaptivecards.io/). Optional. |
+## Relationships
+
+None.
## JSON representation
v1.0 Rubriccriterion https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/rubriccriterion.md
See [educationRubric](educationrubric.md) for a description of the relationship
|:-|:|:| |description|[itemBody](itembody.md)|The description of this criterion.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Rubriclevel https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/rubriclevel.md
See [educationRubric](educationrubric.md) for a description of the relationship
|grading|[educationAssignmentGradeType](educationassignmentgradetype.md)|Null if this is a no-points rubric; [educationAssignmentPointsGradeType](educationassignmentpointsgradetype.md) if it's a points rubric.| |levelId|String|The ID of this resource.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Rubricquality https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/rubricquality.md
See [educationRubric](educationrubric.md) for a description of the relationship
|qualityId|String|The ID of this resource.| |weight|Single|If present, a numerical weight for this quality. Weights must add up to 100.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Rubricqualityfeedbackmodel https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/rubricqualityfeedbackmodel.md
Feedback related to a specific [quality](rubricquality.md) of an [educationRubri
|feedback|[itemBody](itembody.md)|Specific feedback for one quality of this rubric.| |qualityId|String|The ID of the [rubricQuality](rubricquality.md) that this feedback is related to.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Rubricqualityselectedcolumnmodel https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/rubricqualityselectedcolumnmodel.md
Indicates the [rubricLevel](rubriclevel.md) selected by the teacher when grading
|columnId|String|ID of the selected level for this quality.| |qualityId|String|ID of the associated quality.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Scheduleinformation https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/scheduleinformation.md
Represents the availability of a user, distribution list, or resource (room or e
## Properties | Property | Type |Description| |:|:--|:-|
-|availabilityView |String |Represents a merged view of availability of all the items in `scheduleItems`. The view consists of time slots. Availability during each time slot is indicated with: `0`= free or working elswhere, `1`= tentative, `2`= busy, `3`= out of office.<br><br>**Note:** Working elsewhere is set to `0` instead of `4` for backward compatibility. For details, see the [Q&A](/answers/questions/309571/working-elsewhere-in-getschedules-availabilityview).|
+|availabilityView |String |Represents a merged view of availability of all the items in `scheduleItems`. The view consists of time slots. Availability during each time slot is indicated with: `0`= free or working elswhere, `1`= tentative, `2`= busy, `3`= out of office.<br><br>**Note:** Working elsewhere is set to `0` instead of `4` for backward compatibility. For details, see the [Q&A](/answers/questions/309571/working-elsewhere-in-getschedules-availabilityview) and [Exchange 2007 and Exchange 2010 do not use the WorkingElsewhere value](/openspecs/exchange_server_protocols/ms-oxwscdata/e5ec9563-0491-486d-9bec-50585fa2a2c6#Appendix_A_117).|
|error |[freeBusyError](freebusyerror.md) |Error information from attempting to get the availability of the user, distribution list, or resource. | |scheduleId |String |An SMTP address of the user, distribution list, or resource, identifying an instance of **scheduleInformation**. | |scheduleItems |[scheduleItem](scheduleitem.md) collection |Contains the items that describe the availability of the user or resource. |
v1.0 Searchalteration https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/searchalteration.md
Provides the details about the search alteration for spelling correction.
|alteredQueryString|String| Defines the altered query string with spelling correction.| |alteredQueryTokens|[alteredQueryToken](alteredquerytoken.md) collection| Represents changed segments related to an original user query.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Searchalterationoptions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/searchalterationoptions.md
Provides the search alteration options for spelling correction.
|enableModification|Boolean|Indicates whether spelling modifications are enabled. If enabled, the user gets the search results for the corrected query *if there were no results* for the original query with typos. The [response](/graph/api/resources/searchresponse) will also include the spelling modification information in the **queryAlterationResponse** property. Optional.| |enableSuggestion|Boolean|Indicates whether spelling suggestions are enabled. If enabled, the user gets the search results for the original search query and suggestions for spelling correction in the **queryAlterationResponse** property of the [response](/graph/api/resources/searchresponse) for the typos in the query. Optional.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Searchbucket https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/searchbucket.md
Represents a container for one or more search results that share the same value
|count|Int32| The approximate number of search matches that share the same value specified in the **key** property. Note that this number is not the exact number of matches.| |key|String| The discrete value of the field that an aggregation was computed on.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Searchhit https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/searchhit.md
Represents a single result within the list of search results.
|externalItem|Encoded string|`AAMkADRiYWU5MDRkLWE1NGEtNDg5OS1hZWM2LWIxOWZmNzQzMTdiYQBGAAAAAAAvZTGE+1bNQp4lDRL1ctayBwCQNOp97HTbQK/QVOV30iomAAAAEF6yAACQNOp97HTbQK/QVOV30iomAAAAG/DWAAA=` | |person|GUID@GUID|`497b7a2a-9e1a-48d7-80e8-2965d2fc3a81@72f988bf-86f1-41af-91ab-2d7cd011db47`|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Searchhitscontainer https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/searchhitscontainer.md
Represent the list of search results.
|moreResultsAvailable|Boolean|Provides information if more results are available. Based on this information, you can adjust the **from** and **size** properties of the [searchRequest](searchrequest.md) accordingly.| |total|Int32|The total number of results. Note this isn't the number of results on the page, but the total number of results satisfying the query.|
+## Relationships
+
+None.
## JSON representation
v1.0 Searchquery https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/searchquery.md
Represents a search query that contains search terms and optional filters.
|:-|:|:| |queryString|String|The search query containing the search terms. Required.| |queryTemplate|String|Provides a way to decorate the query string. Supports both KQL and query variables. Optional.|+
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Sectionlinks https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/sectionlinks.md
Namespace: microsoft.graph
Links for opening a OneNote section.
+## Properties
+
+| Property | Type |Description|
+|:|:--|:-|
+|oneNoteClientUrl|[externalLink](externallink.md)|Opens the section in the OneNote native client if it's installed.|
+|oneNoteWebUrl|[externalLink](externallink.md)|Opens the section in OneNote on the web.|
+
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
The following JSON representation shows the resource type.
} ```
-## Properties
-| Property | Type |Description|
-|:|:--|:-|
-|oneNoteClientUrl|[externalLink](externallink.md)|Opens the section in the OneNote native client if it's installed.|
-|oneNoteWebUrl|[externalLink](externallink.md)|Opens the section in OneNote on the web.|
- <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!-- {
v1.0 Security Alert https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-alert.md
When a security provider detects a threat, it creates an alert in the system. Mi
|description|String| String value describing each alert.| |detectionSource|[microsoft.graph.security.detectionSource](#detectionsource-values)| Detection technology or sensor that identified the notable component or activity. Possible values are: `unknown`, `microsoftDefenderForEndpoint`, `antivirus`, `smartScreen`, `customTi`, `microsoftDefenderForOffice365`, `automatedInvestigation`, `microsoftThreatExperts`, `customDetection`, `microsoftDefenderForIdentity`, `cloudAppSecurity`, `microsoft365Defender`, `azureAdIdentityProtection`, `manual`, `microsoftDataLossPrevention`, `appGovernancePolicy`, `appGovernanceDetection`, `unknownFutureValue`, `microsoftDefenderForCloud`, `microsoftDefenderForIoT`, `microsoftDefenderForServers`, `microsoftDefenderForStorage`, `microsoftDefenderForDNS`, `microsoftDefenderForDatabases`, `microsoftDefenderForContainers`, `microsoftDefenderForNetwork`, `microsoftDefenderForAppService`, `microsoftDefenderForKeyVault`, `microsoftDefenderForResourceManager`, `microsoftDefenderForApiManagement`, `microsoftSentinel`, `nrtAlerts`, `scheduledAlerts`, `microsoftDefenderThreatIntelligenceAnalytics`, `builtInMl`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value(s) in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `microsoftDefenderForCloud`, `microsoftDefenderForIoT`, `microsoftDefenderForServers`, `microsoftDefenderForStorage`, `microsoftDefenderForDNS`, `microsoftDefenderForDatabases`, `microsoftDefenderForContainers`, `microsoftDefenderForNetwork`, `microsoftDefenderForAppService`, `microsoftDefenderForKeyVault`, `microsoftDefenderForResourceManager`, `microsoftDefenderForApiManagement`, `microsoftSentinel`, `nrtAlerts`, `scheduledAlerts`, `microsoftDefenderThreatIntelligenceAnalytics`, `builtInMl`.| |detectorId|String| The ID of the detector that triggered the alert.|
-|determination|[microsoft.graph.security.alertDetermination](#alertdetermination-values)| Specifies the result of the investigation, whether the alert represents a true attack and if so, the nature of the attack. Possible values are: `unknown`, `apt`, `malware`, `securityPersonnel`, `securityTesting`, `unwantedSoftware`, `other`, `multiStagedAttack`, `compromisedUser`, `phishing`, `maliciousUserActivity`, `clean`, `insufficientData`, `confirmedUserActivity`, `lineOfBusinessApplication`, `unknownFutureValue`.|
+|determination|[microsoft.graph.security.alertDetermination](#alertdetermination-values)| Specifies the result of the investigation, whether the alert represents a true attack and if so, the nature of the attack. Possible values are: `unknown`, `apt`, `malware`, `securityPersonnel`, `securityTesting`, `unwantedSoftware`, `other`, `multiStagedAttack`, `compromisedAccount`, `phishing`, `maliciousUserActivity`, `notMalicious`, `notEnoughDataToValidate`, `confirmedUserActivity`, `lineOfBusinessApplication`, `unknownFutureValue`.|
|evidence|[microsoft.graph.security.alertEvidence](security-alertEvidence.md) collection| Collection of evidence related to the alert.| |firstActivityDateTime|DateTimeOffset| The earliest activity associated with the alert.| |id|String| Unique identifier to represent the **alert** resource.|
When a security provider detects a threat, it creates an alert in the system. Mi
| securityPersonnel | A true positive alert that detected valid suspicious activity that someone on the customer's security team performed. | | securityTesting | The alert detected valid suspicious activity that was performed as part of a known security testing. | | unwantedSoftware | The alert detected unwanted software. |
+| other | Other determination. |
| multiStagedAttack | A true positive alert that detected multiple kill-chain attack stages. | | compromisedAccount | A true positive alert that detected that the intended user's credentials were compromised or stolen. | | phishing | A true positive alert that detected a phishing email. |
When a security provider detects a threat, it creates an alert in the system. Mi
| notEnoughDataToValidate | A false alert, without enough information to prove otherwise. | | confirmedActivity | The alert caught a true suspicious activity that is considered OK because it's a known user activity. | | lineOfBusinessApplication | The alert caught a true suspicious activity that is considered OK because it's a known and confirmed internal application. |
-| other | Other determination. |
| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | ### alertSeverity values
v1.0 Security Api Overview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-api-overview.md
The following conditions relate to all queries.
Alerts are detailed warnings about suspicious activities in a customer's tenant that Microsoft or partner security providers identified and flagged for action. Attacks typically employ various techniques against different types of entities, such as devices, users, and mailboxes. The result is alerts from multiple security providers for multiple entities in the tenant. Piecing the individual alerts together to gain insight into an attack can be challenging and time-consuming. The security API offers two types of alerts that aggregate other alerts from security providers and make analyzing attacks and determining response easier: -- [Alerts and incidents](#alerts-and-incidents) - these are the latest generation of alerts in the Microsoft Graph security API. They are represented by the [alert](security-alert.md) resource and its collection, [incident](security-incident.md) resource, defined in the `microsoft.graph.security` namespace.-- [Legacy alerts](#legacy-alerts) - these are the first generation of alerts in the Microsoft Graph security API. They are represented by the [alert](alert.md) resource defined in the `microsoft.graph` namespace.
+- [Alerts and incidents](#alerts-and-incidents) - these are the latest generation of alerts in the Microsoft Graph security API. They're represented by the [alert](security-alert.md) resource and its collection, [incident](security-incident.md) resource, defined in the `microsoft.graph.security` namespace.
+- [Legacy alerts](#legacy-alerts) - these are the first generation of alerts in the Microsoft Graph security API. They're represented by the [alert](alert.md) resource defined in the `microsoft.graph` namespace.
### Alerts and incidents
Alerts from the following security providers are available via these rich alerts
The legacy [alert](alert.md) resources federate calling of supported Azure and Microsoft 365 Defender security providers. They aggregate common alert data among the different domains to allow applications to unify and streamline management of security issues across all integrated solutions. They enable applications to correlate alerts and context to improve threat protection and response.
-The legacy version of the security API offers the [alert](alert.md) resource which federates calling of supported Azure and Microsoft 365 Defender security providers. This **alert** resource aggregates alert data thatΓÇÖs common among the different domains to allow applications to unify and streamline management of security issues across all integrated solutions. This enables applications to correlate alerts and context to improve threat protection and response.
+The legacy version of the security API offers the [alert](alert.md) resource that federates calling of supported Azure and Microsoft 365 Defender security providers. This **alert** resource aggregates alert data thatΓÇÖs common among the different domains to allow applications to unify and streamline management of security issues across all integrated solutions. This enables applications to correlate alerts and context to improve threat protection and response.
With the alert update capability, you can sync the status of specific alerts across different security products and services that are integrated with the Microsoft Graph security API by updating your **alert** entity.
Alerts from the following providers are available via the **alert** resource. Su
\* File issue: Alert status gets updated across Microsoft Graph security API integrated applications but not reflected in the providerΓÇÖs management experience.
-\*\* Microsoft Defender for Endpoint requires additional [user roles](/windows/security/threat-protection/microsoft-defender-atp/user-roles) to those required by the Microsoft Graph security API. Only the users in both Microsoft Defender for Endpoint and Microsoft Graph security API roles can access the Microsoft Defender for Endpoint data. Because application-only authentication is not limited by this, we recommend that you use an application-only authentication token.
+\*\* Microsoft Defender for Endpoint requires additional [user roles](/windows/security/threat-protection/microsoft-defender-atp/user-roles) to those required by the Microsoft Graph security API. Only the users in both Microsoft Defender for Endpoint and Microsoft Graph security API roles can access the Microsoft Defender for Endpoint data. Because application-only authentication isn't limited by this, we recommend that you use an application-only authentication token.
\*\*\* Microsoft Defender for Identity alerts are available via the Microsoft Defender for Cloud Apps integration. This means you get Microsoft Defender for Identity alerts only if you joined Unified SecOps and connected Microsoft Defender for Identity into Microsoft Defender for Cloud Apps. Learn more about [how to integrate Microsoft Defender for Identity and Microsoft Defender for Cloud Apps](/defender-for-identity/mcas-integration).
Alerts from the following providers are available via the **alert** resource. Su
[Microsoft Purview eDiscovery (Premium)](/microsoft-365/compliance/overview-ediscovery-20) provides an end-to-end workflow to preserve, collect, analyze, review, and export content that's responsive to your organization's internal and external investigations.
+## Identities
+
+### Health issues
+
+The Microsoft Defender for Identity health issues API allows you to monitor the health status of your sensors and agents across your hybrid identity infrastructure. You can use the health issues API to retrieve information about the current health issues of your sensors, such as the issue type, status, configuration, and severity. You can also use this API to identify and resolve any issues that might affect the functionality or security of your sensors and agents.
+
+> **Note:** The Microsoft Defender for Identity health issues API is only available on the Defender for Identity plan or Microsoft 365 E5/A5/G5/F5 Security service plans.
+ ## Incidents An [incident](security-incident.md) is a collection of correlated  [alerts](security-alert.md) and associated data that make up the story of an attack. Incident management is part of Microsoft 365 Defender, and is available in the Microsoft 365 Defender portal (https://security.microsoft.com/).
Grouping related alerts into an incident gives you a comprehensive view of an at
- Where the attack started. - What tactics were used. -- How far the attack has gone into your tenant.
+- How far the attack went into your tenant.
- The scope of the attack, such as how many devices, users, and mailboxes were impacted. - All of the data associated with the attack.
TheΓÇ» [incident](security-incident.md) resource and its APIs allow you to sort
## Information protection
-The Microsoft Graph threat assessment API helps organizations to assess the threat received by any user in a tenant. This empowers customers to report spam emails, phishing URLs or malware attachments they receive to Microsoft. The policy check result and rescan result can help tenant administrators understand the threat scanning verdict and adjust their organizational policy.
+The Microsoft Graph threat assessment API helps organizations to assess the threat received by any user in a tenant. This empowers customers to report spam emails, phishing URLs, or malware attachments they receive to Microsoft. The policy check result and rescan result can help tenant administrators understand the threat scanning verdict and adjust their organizational policy.
## Records management
-Most organizations need to manage data to proactively comply with industry regulations and internal policies, reduce risk in the event of litigation or a security breach, and let people effectively and agiley share knowledge that is current and relevant to them. You can use the [records management APIs](../resources/security-recordsmanagement-overview.md) to systematically apply [retention labels](security-retentionlabel.md) to different types of content that require different retention settings. For example, you can configure the start of retention period from when the content was created, last modified, labeled or when an event occurs for a particular event type. Further, you can use [file plan descriptors](security-fileplandescriptor.md) to improve the manageability of these retention labels.
-
+Most organizations need to manage data to proactively comply with industry regulations and internal policies, reduce risk in the event of litigation or a security breach, and let people effectively and agilely share knowledge that is current and relevant to them. You can use the [records management APIs](../resources/security-recordsmanagement-overview.md) to systematically apply [retention labels](security-retentionlabel.md) to different types of content that require different retention settings. For example, you can configure the start of retention period from when the content was created, last modified, labeled or when an event occurs for a particular event type. Further, you can use [file plan descriptors](security-fileplandescriptor.md) to improve the manageability of these retention labels.
## Secure Score
The following are some of the most popular requests for working with the Microso
| **eDiscovery**||| |List eDiscovery cases|[List eDiscoveryCases](../api/security-casesroot-list-ediscoverycases.md)|[https://graph.microsoft.com/v1.0/security/cases/eDiscoveryCases](https://developer.microsoft.com/graph/graph-explorer?request=security%2Fcases%2FeDiscoverycases&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com)| |List eDiscovery case operations|[List caseOperations](../api/security-ediscoverycase-list-operations.md)|[https://graph.microsoft.com/v1.0/security/cases/ediscoveryCases/{id}/operations](https://developer.microsoft.com/graph/graph-explorer?request=security%2Fcases%2FeDiscoverycases%2F%7Bid%7D%2Foperations&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com)|
+| **Identities**|||
+| List health issues | [List health issues](../api/security-identitycontainer-list-healthissues.md) | [https://graph.microsoft.com/v1.0/security/identities/healthIssues](https://developer.microsoft.com/graph/graph-explorer?request=security/identities/healthIssues&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) |
| **Legacy alerts**||| | List alerts | [List alerts](../api/alert-list.md) | [https://graph.microsoft.com/v1.0/security/alerts](https://developer.microsoft.com/graph/graph-explorer?request=security/alerts&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) | | Update alerts | [Update alert](../api/alert-update.md) | [https://graph.microsoft.com/v1.0/security/alerts/{alert-id}](https://developer.microsoft.com/graph/graph-explorer?request=security/alerts/{alert-id}&method=PATCH&version=v1.0&GraphUrl=https://graph.microsoft.com) |
v1.0 Security Healthissue https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-healthissue.md
+
+ Title: "healthIssue resource type"
+description: "Represents potential issues identified by Microsoft Defender for Identity within a customer's Microsoft Defender for Identity configuration."
+
+ms.localizationpriority: medium
+++
+# healthIssue resource type
+
+Namespace: microsoft.graph.security
+
+Represents potential issues identified by Microsoft Defender for Identity within a customer's Microsoft Defender for Identity configuration.
+
+Inherits from [entity](../resources/entity.md).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List](../api/security-identitycontainer-list-healthissues.md)|[microsoft.graph.security.healthIssue](../resources/security-healthissue.md) collection|Get a list of [healthIssue](../resources/security-healthissue.md) objects and their properties.|
+|[Get](../api/security-healthissue-get.md)|[microsoft.graph.security.healthIssue](../resources/security-healthissue.md)|Read the properties and relationships of a [healthIssue](../resources/security-healthissue.md) object.|
+|[Update](../api/security-healthissue-update.md)|[microsoft.graph.security.healthIssue](../resources/security-healthissue.md)|Update the properties of a [healthIssue](../resources/security-healthissue.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|additionalInformation|String collection|Contains additional information about the issue, such as a list of items to fix.|
+|createdDateTime|DateTimeOffset|The date and time when the health issue was generated. 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`.|
+|description|String|Contains more detailed information about the health issue.|
+|displayName|String|The display name of the health issue.|
+|domainNames|String collection|A list of the fully qualified domain names of the domains or the sensors the health issue is related to.|
+|healthIssueType|[microsoft.graph.security.healthIssueType](#healthissuetype-values)|The type of the health issue. The possible values are: `sensor`, `global`, `unknownFutureValue`. For a list of all health issues and their identifiers, see [Microsoft Defender for Identity health issues](/defender-for-identity/health-alerts). |
+|id|String|A unique identifier that represents the health issue. Inherited from [entity](../resources/entity.md).|
+|issueTypeId|String|The type identifier of the health issue. For a list of all health issues and their identifiers, see [Microsoft Defender for Identity health issues](/defender-for-identity/health-alerts).|
+|lastModifiedDateTime|DateTimeOffset|The date and time when the health issue was last updated. 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`.|
+|recommendations|String collection|A list of recommended actions that can be taken to resolve the issue effectively and efficiently. These actions might include instructions for further investigation and aren't limited to prewritten responses.|
+|recommendedActionCommands|String collection|A list of commands from the PowerShell module for the product that can be used to resolve the issue, if available. If no commands can be used to solve the issue, this property is empty. The commands, if present, provide a quick and efficient way to address the issue. These commands run in sequence for the single recommended fix.|
+|sensorDNSNames|String collection|A list of the DNS names of the sensors the health issue is related to.|
+|severity|[microsoft.graph.security.healthIssueSeverity](#healthissueseverity-values)|The severity of the health issue. The possible values are: `low`, `medium`, `high`, `unknownFutureValue`.|
+|status|[microsoft.graph.security.healthIssueStatus](#healthissuestatus-values)|The status of the health issue. The possible values are: `open`, `closed`, `suppressed`, `unknownFutureValue`.|
+
+### healthIssueSeverity values
+
+| Member | Description |
+| :--| : |
+| low | Low severity health issues usually indicate minor issues that don't have a significant impact on your environment. These issues require further investigation, but they usually don't require immediate action. |
+| medium | Medium severity health issues indicate more significant issues that could potentially impact your environment. These issues may require further investigation and action to prevent any potential problems. |
+| high | High severity health issues indicate critical issues that could have a severe impact on your environment. These issues require immediate attention and action. |
+| unknownFutureValue | Evolvable enumeration sentinel value. Don't use.|
+
+### healthIssueStatus values
+
+| Member | Description |
+| :--| : |
+| open | The issue is open and should be addressed. |
+| closed | The issue was addressed. Either someone manually closed the issue or took an action on the affected item, or it was closed automatically by the system. |
+| suppressed | The operator suppressed the issue manually. |
+| unknownFutureValue | Evolvable enumeration sentinel value. Don't use.|
+
+### healthIssueType values
+
+| Member | Description |
+| :--| : |
+| sensor | The issue is on specific sensor. |
+| global | The issue is in the Defender for Identity system configuration. |
+| unknownFutureValue | Evolvable enumeration sentinel value. Don't use.|
+
+## Relationships
+None.
+
+## JSON representation
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.security.healthIssue",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.security.healthIssue",
+ "additionalInformation": ["String"],
+ "createdDateTime": "String (timestamp)",
+ "description": "String",
+ "displayName": "String",
+ "domainNames": ["String"],
+ "healthIssueType": "String",
+ "id": "String (identifier)",
+ "issueTypeId": "String",
+ "lastModifiedDateTime": "String (timestamp)",
+ "recommendations": ["String"],
+ "recommendedActionCommands": ["String"],
+ "sensorDNSNames": ["String"],
+ "severity": "String",
+ "status": "String"
+}
+```
v1.0 Security Identitycontainer https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security-identitycontainer.md
+
+ Title: "identityContainer resource type"
+description: "Represents a container for security identities APIs that currently exposes the healthIssues relationship."
+
+ms.localizationpriority: medium
+++
+# identityContainer resource type
+
+Namespace: microsoft.graph.security
+
+Represents a container for security identities APIs that currently exposes the [healthIssues](security-healthissue.md) relationship.
+
+## Methods
+
+None.
+
+## Properties
+
+None.
+
+## Relationships
+
+|Relationship|Type|Description|
+|:|:|:|
+|healthIssues|[microsoft.graph.security.healthIssue](security-healthissue.md) collection| Represents potential issues identified by Microsoft Defender for Identity within a customer's Microsoft Defender for Identity configuration. |
+
+## JSON representation
+
+The following JSON representation shows the resource type.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.security.identityContainer",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.security.identityContainer"
+}
+```
v1.0 Security https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/security.md
None
|:-|:|:| |alerts|[alert](alert.md) collection| Read-only. Nullable.| |alerts_v2 | [microsoft.graph.security.alert](security-alert.md) collection | A collection of alerts in Microsoft 365 Defender.|
+|identities|[microsoft.graph.security.identityContainer](../resources/security-identitycontainer.md)|A container for security identities APIs.|
|incidents | [microsoft.graph.security.incident](security-incident.md) collection | A collection of incidents in Microsoft 365 Defender, each of which is a set of correlated alerts and associated metadata that reflects the story of an attack.|
v1.0 Serviceprincipal https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/serviceprincipal.md
This resource supports using [delta query](/graph/delta-query-overview) to track
|notificationEmailAddresses|String collection|Specifies the list of email addresses where Microsoft Entra ID sends a notification when the active certificate is near the expiration date. This is only for the certificates used to sign the SAML token issued for Microsoft Entra Gallery applications.| |oauth2PermissionScopes|[permissionScope](permissionScope.md) collection|The delegated permissions exposed by the application. For more information, see the **oauth2PermissionScopes** property on the [application](application.md) entity's **api** property. Not nullable.| | passwordCredentials | [passwordCredential](passwordcredential.md) collection|The collection of password credentials associated with the application. Not nullable.|
-|preferredSingleSignOnMode|string|Specifies the single sign-on mode configured for this application. Microsoft Entra ID uses the preferred single sign-on mode to launch the application from Microsoft 365 or the My Apps portal. The supported values are `password`, `saml`, `notSupported`, and `oidc`.|
+|preferredSingleSignOnMode|string|Specifies the single sign-on mode configured for this application. Microsoft Entra ID uses the preferred single sign-on mode to launch the application from Microsoft 365 or the My Apps portal. The supported values are `password`, `saml`, `notSupported`, and `oidc`. **Note:** This field might be `null` for older SAML apps and for OIDC applications where it isn't set automatically.|
|preferredTokenSigningKeyThumbprint|String|This property can be used on SAML applications (apps that have **preferredSingleSignOnMode** set to `saml`) to control which certificate is used to sign the SAML responses. For applications that aren't SAML, don't write or otherwise rely on this property.| |replyUrls|String collection|The URLs that user tokens are sent to for sign in with the associated application, or the redirect URIs that OAuth 2.0 authorization codes and access tokens are sent to for the associated application. Not nullable. | |resourceSpecificApplicationPermissions|[resourceSpecificPermission](../resources/resourcespecificpermission.md) collection|The resource-specific application permissions exposed by this application. Currently, resource-specific permissions are only supported for [Teams apps accessing to specific chats and teams](/microsoftteams/platform/graph-api/rsc/resource-specific-consent) using Microsoft Graph. Read-only.|
v1.0 Shareddriveitem https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/shareddriveitem.md
Title: sharedDriveItem resource type ms.localizationpriority: medium
-description: "The sharedDriveItem resource is returned when using the Shares API to access a shared driveItem."
+description: The sharedDriveItem resource is returned when using the Shares API to access a shared driveItem.
doc_type: resourcePageType
Namespace: microsoft.graph
The **sharedDriveItem** resource is returned when using the [shares](../api/shares-get.md) API to access a shared [driveItem](driveitem.md).
-## JSON representation
-
-Here is a JSON representation of the **sharedDriveItem** resource.
-
-The **sharedDriveItem** resource is derived from [**baseItem**](baseitem.md) and inherits properties from that resource.
+The **sharedDriveItem** resource is derived from [baseItem](baseitem.md) and inherits properties from that resource.
-<!-- {
- "blockType": "resource",
- "baseType": "microsoft.graph.baseItem",
- "optionalProperties": [ ],
- "@odata.type": "microsoft.graph.sharedDriveItem"
-}-->
+For more information about the facets on a DriveItem, see [driveItem](driveitem.md).
-```json
-{
- "id": "string",
- "name": "string",
- "owner": { "@odata.type": "microsoft.graph.identitySet" },
+## Methods
- "driveItem": { "@odata.type": "microsoft.graph.driveItem" },
- "items": [ { "@odata.type": "microsoft.graph.driveItem" }],
- "list": { "@odata.type": "microsoft.graph.list" },
- "listItem": { "@odata.type": "microsoft.graph.listItem" },
- "root": { "@odata.type": "microsoft.graph.driveItem" },
- "site": { "@odata.type": "microsoft.graph.site" }
-}
-```
+| Method | Return Type | Description |
+|:|:--|:|
+| [Use sharing links](../api/shares-get.md) | [sharedDriveItem](shareddriveitem.md) | Access a shared item or a collection of shared items by using a **shareId** or sharing URL. |
## Properties
The **sharedDriveItem** resource is derived from [**baseItem**](baseitem.md) and
## Relationships
-| Relationship name | Type | Description
-| |:--|:--
-| **driveItem** | [**driveItem**][driveItem] | Used to access the underlying **driveItem**
-| **list** | [**list**][list] | Used to access the underlying **list**
-| **listItem** | [**listItem**][listItem] | Used to access the underlying **listItem**
-| **permission** | [**permission**][permission] | Used to access the **permission** representing the underlying sharing link
-| **site** | [**site**][site] | Used to access the underlying **site**
+| Relationship name | Type | Description |
+| |:-|:|
+| driveItem | [driveItem][driveItem] | Used to access the underlying driveItem |
+| list | [list][list] | Used to access the underlying list |
+| listItem | [listItem][listItem] | Used to access the underlying listItem |
+| permission | [permission][permission] | Used to access the permission representing the underlying sharing link |
+| site | [site][site] | Used to access the underlying site |
Alternatively, for **driveItems** shared from personal OneDrive accounts, the following relationships may also be used.
-| Relationship name | Type | Description
-| |:--|:--
-| **items** | [**driveItem**][driveItem] collection | All driveItems contained in the sharing root. This collection cannot be enumerated.
-| **root** | [**driveItem**][driveItem] | Used to access the underlying **driveItem**. Deprecated -- use `driveItem` instead.
+| Relationship name | Type | Description |
+| |:-|:|
+| items | [driveItem][driveItem] collection | All driveItems contained in the sharing root. This collection cannot be enumerated. |
+| root | [driveItem][driveItem] | Used to access the underlying driveItem. Deprecated -- use `driveItem` instead. |
[driveItem]: driveitem.md [list]: list.md
Alternatively, for **driveItems** shared from personal OneDrive accounts, the fo
[permission]: permission.md [site]: site.md
-## Methods
+## JSON representation
-| Method | REST Path |
-| :-- | :-- |
-| [Use sharing links](../api/shares-get.md) | `GET /shares/{share-id}` |
+The following JSON representation shows the resource.
-## Remarks
+<!-- {
+ "blockType": "resource",
+ "baseType": "microsoft.graph.baseItem",
+ "optionalProperties": [ ],
+ "@odata.type": "microsoft.graph.sharedDriveItem"
+}-->
-For more information about the facets on a DriveItem, see [driveItem](driveitem.md).
+```json
+{
+ "id": "string",
+ "name": "string",
+ "owner": { "@odata.type": "microsoft.graph.identitySet" },
+
+ "driveItem": { "@odata.type": "microsoft.graph.driveItem" },
+ "items": [ { "@odata.type": "microsoft.graph.driveItem" }],
+ "list": { "@odata.type": "microsoft.graph.list" },
+ "listItem": { "@odata.type": "microsoft.graph.listItem" },
+ "root": { "@odata.type": "microsoft.graph.driveItem" },
+ "site": { "@odata.type": "microsoft.graph.site" }
+}
+```
<!-- { "type": "#page.annotation",
v1.0 Sharepointonedriveoptions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/sharepointonedriveoptions.md
Provides the search content options when a search is performed using application
|:-|:|:| |includeContent|searchContent| The type of search content. The possible values are: `sharedContent`, `privateContent`, `unknownFutureValue`. Read-only. |
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Sharepointprotectionpolicy https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/sharepointprotectionpolicy.md
toc. Title: SharePoint protection policy
Namespace: microsoft.graph
-Represents a plan defined by the SharePoint Online Admin to protect SharePoint Online, including what data to protect, when to protect it, and for what time period to retain the protected data.
+Represents a plan defined by the SharePoint Online admin to protect SharePoint Online, including what data to protect, when to protect it, and for what time period to retain the protected data. Currently, policies are supported only for SharePoint Online sites in the main geolocation only; multi-geo tenants aren't supported.
Inherits from [protectionPolicyBase](../resources/protectionpolicybase.md).
v1.0 Sortproperty https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/sortproperty.md
Indicates the order to sort search results.
|isDescending|Boolean|`True` if the sort order is descending. Default is `false`, with the sort order as ascending. Optional.| |name|String|The name of the property to sort on. Required.|
+## Relationships
+
+None.
## JSON representation
v1.0 Staffavailabilityitem https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/staffavailabilityitem.md
Represents the available and busy time slots of a Microsoft Bookings [staff memb
|availabilityItems |[availabilityItem](availabilityitem.md) collection |Each item in this collection indicates a slot and the status of the staff member.| |staffId |String |The ID of the staff member.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Targetusersponsors https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/targetusersponsors.md
This resource is a subtype of [subjectSet](subjectset.md), in which the `@odata.
Inherits from [subjectSet](subjectset.md).
+## Properties
+
+None.
+
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.+ <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.targetUserSponsors"
v1.0 Teamfunsettings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teamfunsettings.md
Title: "teamFunSettings resource type" description: "Settings to configure use of Giphy, memes, and stickers in the team." ms.localizationpriority: medium-+ doc_type: resourcePageType
v1.0 Teamguestsettings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teamguestsettings.md
Title: "teamGuestSettings resource type" description: "Settings to configure whether guests can create, update, or delete channels in the team." ms.localizationpriority: medium-+ doc_type: resourcePageType
v1.0 Teammembersettings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teammembersettings.md
Title: "teamMemberSettings resource type" description: "Settings to configure whether members can perform certain actions, for example, create channels and add bots, in the team." ms.localizationpriority: medium-+ doc_type: resourcePageType
v1.0 Teammessagingsettings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teammessagingsettings.md
Title: "teamMessagingSettings resource type" description: "Settings to configure messaging and mentions in the team."-+ ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Teams Api Overview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teams-api-overview.md
Title: "Use the Microsoft Graph API to work with Microsoft Teams" description: "Microsoft Teams is a chat-based workspace in Microsoft 365 that provides built-in access to team-specific calendars, files, OneNote notes, Planner plans, and more." ms.localizationpriority: high-+ doc_type: conceptualPageType
v1.0 Teamsapp https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teamsapp.md
Title: "teamsApp resource type" description: "Represents an app in the Microsoft Teams app catalog."-+ ms.localizationpriority: high doc_type: resourcePageType
v1.0 Teamsappdefinition https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teamsappdefinition.md
Title: "teamsAppDefinition resource type" description: "Represents the details of one version of a teamsApp."-+ ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Teamsappinstalledstate https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teamsappinstalledstate.md
Title: "Members" description: "Describes the current installation status of a teamsApp."-+ ms.localizationpriority: medium doc_type: enumPageType
v1.0 Teamsasyncoperation https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teamsasyncoperation.md
Title: "teamsAsyncOperation resource type" description: "A Microsoft Teams async operation transcends the lifetime of a single API request. "-+ ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Teamsasyncoperationstatus https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teamsasyncoperationstatus.md
Title: "teamsAsyncOperationStatus enum type" description: "Describes the current status of a teamsAsyncOperation."-+ ms.localizationpriority: medium doc_type: enumPageType
v1.0 Teamsasyncoperationtype https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teamsasyncoperationtype.md
Title: "teamsAsyncOperationType enum type" description: "Types of teamsAsyncOperation."-+ ms.localizationpriority: medium doc_type: enumPageType
v1.0 Teamscatalogapp https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teamscatalogapp.md
Title: "teamsCatalogApp resource type" description: "see teamsApp."-+ ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Teamspecialization https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teamspecialization.md
Title: "teamSpecialization enum type" description: "Describes special use case for a team."-+ ms.localizationpriority: medium doc_type: enumPageType
v1.0 Teamstabconfiguration https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teamstabconfiguration.md
Title: "teamsTabConfiguration resource type (Open Type)" description: "The settings that determine the content of a tab."-+ ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Teamstemplate https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teamstemplate.md
Title: "teamsTemplate resource type" description: "Describes teamsTemplate entity."-+ ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Teamvisibilitytype https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teamvisibilitytype.md
Title: "Members" description: "Describes the visibility of a team. "-+ ms.localizationpriority: medium doc_type: enumPageType
v1.0 Teamwork https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/teamwork.md
A container for the range of Microsoft Teams functionalities that are available
|:|:--|:-| |id|string|The default teamwork identifier.| |isTeamsEnabled|Boolean|Indicates whether Microsoft Teams is enabled for the organization.|
-|region|string|Represents the region of the organization or the tenant. The **region** value can be any region supported by the Teams payload. The possible values are: `Americas`, `Europe and MiddleEast`, `Asia Pacific`, `UAE`, `Australia`, `Brazil`, `Canada`, `Switzerland`, `Germany`, `France`, `India`, `Japan`, `South Korea`, `Norway`, `Singapore`, `United Kingdom`, `South Africa`, `Sweden`, `Qatar`, `Poland`, `Italy`, `Israe`l, `USGov Community Cloud`, `USGov Community Cloud High`, `USGov Department of Defense`, and `China`.|
+|region|string|Represents the region of the organization or the tenant. The **region** value can be any region supported by the Teams payload. The possible values are: `Americas`, `Europe and MiddleEast`, `Asia Pacific`, `UAE`, `Australia`, `Brazil`, `Canada`, `Switzerland`, `Germany`, `France`, `India`, `Japan`, `South Korea`, `Norway`, `Singapore`, `United Kingdom`, `South Africa`, `Sweden`, `Qatar`, `Poland`, `Italy`, `Israel`, `Spain`, `Mexico`, `USGov Community Cloud`, `USGov Community Cloud High`, `USGov Department of Defense`, and `China`.|
## Relationships
v1.0 Termsexpiration https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/termsexpiration.md
Provides additional settings for the scheduled expiration of the agreement.
| frequency| Duration | Represents the frequency at which the terms will expire, after its first expiration as set in **startDateTime**. The value is represented in ISO 8601 format for durations. For example, `PT1M` represents a time period of one month.| | startDateTime|DateTimeOffset | The DateTime when the agreement is set to expire for all users. 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`.|
+## Relationships
+
+None.
## JSON representation
-Here's a JSON representation of this resource.
+The following JSON representation shows the resource type.
<!-- { "blockType": "resource",
v1.0 Timeslot https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/timeslot.md
Represents a time slot for a meeting.
|end|[dateTimeTimeZone](datetimetimezone.md)|The date, time, and time zone that a period ends. | |start|[dateTimeTimeZone](datetimetimezone.md)|The date, time, and time zone that a period begins.|
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Uploadsession https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/uploadsession.md
Namespace: microsoft.graph
The **uploadSession** resource provides information about how to upload large files to OneDrive, OneDrive for Business, or SharePoint document libraries, or to Outlook [event](event.md) and [message](message.md) items as attachments.
+## Properties
++
+| Property | Type |Description
+|:-|:|:
+| expirationDateTime | DateTimeOffset | The date and time in UTC that the upload session will expire. The complete file must be uploaded before this expiration time is reached.|
+| nextExpectedRanges | String collection | A collection of byte ranges that the server is missing for the file. These ranges are zero indexed and of the format "start-end" (for example "0-26" to indicate the first 27 bytes of the file). When uploading files as Outlook attachments, instead of a collection of ranges, this property always indicates a single value "{start}", the location in the file where the next upload should begin.|
+| uploadUrl | String | The URL endpoint that accepts PUT requests for byte ranges of the file.|
+
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
The following JSON representation shows the resource type.
} ```
-## Properties
--
-| Property | Type |Description
-|:-|:|:
-| expirationDateTime | DateTimeOffset | The date and time in UTC that the upload session will expire. The complete file must be uploaded before this expiration time is reached.
-| nextExpectedRanges | String collection | A collection of byte ranges that the server is missing for the file. These ranges are zero indexed and of the format "start-end" (for example "0-26" to indicate the first 27 bytes of the file). When uploading files as Outlook attachments, instead of a collection of ranges, this property always indicates a single value "{start}", the location in the file where the next upload should begin.
-| uploadUrl | String | The URL endpoint that accepts PUT requests for byte ranges of the file.
- ## Related content - [Attach large files to Outlook messages and events as attachments ](/graph/outlook-large-attachments)
v1.0 Useridentity https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/useridentity.md
Inherits from [identity](identity.md).
| ipAddress | String | Indicates the client IP address associated with the user performing the activity (audit log only).| | userPrincipalName | String | The **userPrincipalName** attribute of the user. |
+## Relationships
+
+None.
+ ## JSON representation The following JSON representation shows the resource type.
v1.0 Userteamwork https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/userteamwork.md
Represents a container for the range of Microsoft Teams functionalities that are
|:|:--|:-| |id| String|The unique identifier for the **userTeamwork** object.| |locale|String |Represents the location that a user selected in Microsoft Teams and doesn't follow the Office's locale setting. A userΓÇÖs locale is represented by their preferred language and country or region. For example, `en-us`. The language component follows two-letter codes as defined in [ISO 639-1](https://www.iso.org/iso/home/standards/language_codes.htm), and the country component follows two-letter codes as defined in [ISO 3166-1 alpha-2](https://www.iso.org/iso/country_codes.htm).|
-|region|string|Represents the region of the organization or the user. For users with multigeo licenses, the property contains the user's region (if available). For users without multigeo licenses, the property contains the organization's region.<br><br>The **region** value can be any region supported by the Teams payload. The possible values are: `Americas`, `Europe and MiddleEast`, `Asia Pacific`, `UAE`, `Australia`, `Brazil`, `Canada`, `Switzerland`, `Germany`, `France`, `India`, `Japan`, `South Korea`, `Norway`, `Singapore`, `United Kingdom`, `South Africa`, `Sweden`, `Qatar`, `Poland`, `Italy`, `Israe`l, `USGov Community Cloud`, `USGov Community Cloud High`, `USGov Department of Defense`, and `China`.|
+|region|string|Represents the region of the organization or the user. For users with multigeo licenses, the property contains the user's region (if available). For users without multigeo licenses, the property contains the organization's region.<br><br>The **region** value can be any region supported by the Teams payload. The possible values are: `Americas`, `Europe and MiddleEast`, `Asia Pacific`, `UAE`, `Australia`, `Brazil`, `Canada`, `Switzerland`, `Germany`, `France`, `India`, `Japan`, `South Korea`, `Norway`, `Singapore`, `United Kingdom`, `South Africa`, `Sweden`, `Qatar`, `Poland`, `Italy`, `Israel`, `Spain`, `Mexico`, `USGov Community Cloud`, `USGov Community Cloud High`, `USGov Department of Defense`, and `China`.|
## Relationships
v1.0 Virtualeventtownhall https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/virtualeventtownhall.md
Inherits from [virtualEvent](../resources/virtualevent.md).
| id | String | Unique identifier of the town hall. Inherited from [entity](../resources/entity.md). Read-only. | | invitedAttendees | [identity](../resources/identity.md) collection | The attendees invited to the town hall. The supported identities are: [communicationsUserIdentity](../resources/communicationsuseridentity.md) and [communicationsGuestIdentity](../resources/communicationsguestidentity.md). | | isInviteOnly | Boolean | Indicates whether the town hall is only open to invited people and groups within your organization. The **isInviteOnly** property can only be `true` if the value of the **audience** property is set to `organization`. |
+| settings | [virtualEventSettings](../resources/virtualeventsettings.md) | The virtual event settings. |
| startDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | Date and time when the town hall starts. The **timeZone** property _can_ be set to any of the time zones currently supported by Windows. For details on how to get all available time zones using PowerShell, see [Get-TimeZone](/powershell/module/microsoft.powershell.management/get-timezone#example-3-get-all-available-time-zones). Inherited from [virtualEvent](../resources/virtualevent.md). | | status | virtualEventStatus | Status of the town hall. Possible values are: `draft`, `published`, `canceled`, and `unknownFutureValue`. Inherited from [virtualEvent](../resources/virtualevent.md). |
The following JSON representation shows the resource type.
"id": "String (identifier)", "invitedAttendees": [{"@odata.type": "microsoft.graph.identity"}], "isInviteOnly": "Boolean",
+ "settings": {"@odata.type": "microsoft.graph.virtualEventSettings"},
"startDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"}, "status": "String" }
v1.0 Workbookrangesort https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/workbookrangesort.md
The following JSON representation shows the resource type.
The following example shows a request.
+# [HTTP](#tab/http)
<!--{ "blockType": "request", "name": "range_sort"
The following example shows a request.
GET https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/names/{name}/range/sort ```
+# [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 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/toc.yml a/api-reference/v1.0/toc.yml
items:
href: toc/device-and-app-management/toc.yml - name: Education href: toc/education/toc.yml
+ - name: Employee experience
+ href: toc/employee-experience/toc.yml
- name: Extensions href: toc/extensions/toc.yml displayName: Directory extensions, Schema extensions, Open extensions, On-premises extensions
v1.0 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/toc/backup-storage/toc.yml a/api-reference/v1.0/toc/backup-storage/toc.yml
items:
- name: Restore artifact href: ../../resources/restoreartifactbase.md items:
- - name: Granular mail box restore artifact
+ - name: Granular mailbox restore artifact
items:
- - name: Granular mail box restore artifact
+ - name: Granular mailbox restore artifact
href: ../../resources/granularmailboxrestoreartifact.md - name: List href: ../../api/exchangerestoresession-list-mailboxrestoreartifacts.md
v1.0 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/toc/employee-experience/toc.yml
+#
+# GENERATED FILE - DO NOT EDIT
+#
+items:
+- name: Employee engagement
+ items:
+ - name: Overview
+ href: ../../resources/engagement-api-overview.md
+ - name: Community
+ items:
+ - name: Community
+ href: ../../resources/community.md
+ - name: List
+ href: ../../api/employeeexperience-list-communities.md
+ - name: Create
+ href: ../../api/employeeexperience-post-communities.md
+ - name: Get
+ href: ../../api/community-get.md
+ - name: Update
+ href: ../../api/community-update.md
+ - name: Delete
+ href: ../../api/community-delete.md
+ - name: Engagement async operation
+ items:
+ - name: Engagement async operation
+ href: ../../resources/engagementasyncoperation.md
+ - name: Get
+ href: ../../api/engagementasyncoperation-get.md
v1.0 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/toc/files/toc.yml a/api-reference/v1.0/toc/files/toc.yml
items:
href: ../../api/filestoragecontainer-update-customproperty.md - name: Delete custom property href: ../../api/filestoragecontainer-delete-customproperty.md
+- name: Shared drive item
+ items:
+ - name: Shared drive item
+ href: ../../resources/shareddriveitem.md
+ - name: Use sharing links
+ href: ../../api/shares-get.md
v1.0 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/toc/identity-and-access/toc.yml a/api-reference/v1.0/toc/identity-and-access/toc.yml
items:
href: ../../api/directory-deleteditems-get.md - name: Restore href: ../../api/directory-deleteditems-restore.md
+ - name: App role assignment
+ items:
+ - name: App role assignment
+ href: ../../resources/approleassignment.md
+ - name: List app role assignments for a group
+ href: ../../api/group-list-approleassignments.md
+ - name: List app role assignments for a user
+ href: ../../api/user-list-approleassignments.md
+ - name: List app role assignments for a client service principal
+ href: ../../api/serviceprincipal-list-approleassignments.md
+ - name: List app role assignments for users, groups, and client service principals for a resource service principal
+ href: ../../api/serviceprincipal-list-approleassignedto.md
+ - name: Grant app role to a group
+ href: ../../api/group-post-approleassignments.md
+ - name: Grant app role to a user
+ href: ../../api/user-post-approleassignments.md
+ - name: Grant app role to a client service principal
+ href: ../../api/serviceprincipal-post-approleassignments.md
+ - name: Grant app role assignment to user, group, or client service principal for a resource service principal
+ href: ../../api/serviceprincipal-post-approleassignedto.md
+ - name: Get app role assignment
+ href: ../../api/approleassignment-get.md
+ - name: Delete app role assignment for a group
+ href: ../../api/group-delete-approleassignments.md
+ - name: Delete app role assignment for a user
+ href: ../../api/user-delete-approleassignments.md
+ - name: Delete app role assignment for a client service principal
+ href: ../../api/serviceprincipal-delete-approleassignments.md
+ - name: Delete app role assignment for user, group, or client service principal to a resource service principal
+ href: ../../api/serviceprincipal-delete-approleassignedto.md
- name: BitLocker recovery key items: - name: BitLocker recovery key
items:
href: ../../api/accesspackageassignmentrequest-get.md - name: Delete href: ../../api/accesspackageassignmentrequest-delete.md
- - name: Filter by current user
- href: ../../api/accesspackageassignmentrequest-filterbycurrentuser.md
- name: Cancel href: ../../api/accesspackageassignmentrequest-cancel.md
+ - name: Filter by current user
+ href: ../../api/accesspackageassignmentrequest-filterbycurrentuser.md
- name: Reprocess href: ../../api/accesspackageassignmentrequest-reprocess.md
+ - name: Resume
+ href: ../../api/accesspackageassignmentrequest-resume.md
- name: Access package catalog items: - name: Access package catalog
items:
href: ../../api/identitygovernance-lifecyclemanagementsettings-get.md - name: Update href: ../../api/identitygovernance-lifecyclemanagementsettings-update.md
+ - name: Insights
+ items:
+ - name: Insights
+ href: ../../resources/identitygovernance-insights.md
+ - name: Get top workflows summary
+ href: ../../api/identitygovernance-insights-topworkflowsprocessedsummary.md
+ - name: Get top tasks summary
+ href: ../../api/identitygovernance-insights-toptasksprocessedsummary.md
+ - name: Get workflows processed summary
+ href: ../../api/identitygovernance-insights-workflowsprocessedsummary.md
+ - name: Get workflows processed by category
+ href: ../../api/identitygovernance-insights-workflowsprocessedbycategory.md
- name: Complex types items: - name: Custom callout extension
items:
href: ../../api/identityuserflowattribute-delete.md - name: List attributes in a user flow href: ../../api/onattributecollectionexternalusersselfservicesignup-list-attributes.md
- - name: List attributes in a user flow
- href: ../../api/onattributecollectionexternalusersselfservicesignup-list-attributes.md
- name: Add attribute to a user flow href: ../../api/onattributecollectionexternalusersselfservicesignup-post-attributes.md - name: Remove attribute from a user flow
v1.0 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/toc/reports/toc.yml a/api-reference/v1.0/toc/reports/toc.yml
items:
items: - name: Overview href: ../../resources/report.md
+ - name: Admin report settings
+ items:
+ - name: Admin report settings
+ href: ../../resources/adminreportsettings.md
+ - name: Get
+ href: ../../api/adminreportsettings-get.md
+ - name: Update
+ href: ../../api/adminreportsettings-update.md
- name: Report root items: - name: Report root
v1.0 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/toc/security/toc.yml a/api-reference/v1.0/toc/security/toc.yml
items:
href: ../../api/security-ediscoverycase-delete-tags.md - name: List tags as hierarchy href: ../../api/security-ediscoveryreviewtag-ashierarchy.md
+- name: Identities
+ items:
+ - name: Health issue
+ items:
+ - name: Health issue
+ href: ../../resources/security-healthissue.md
+ - name: List
+ href: ../../api/security-identitycontainer-list-healthissues.md
+ - name: Get
+ href: ../../api/security-healthissue-get.md
+ - name: Update
+ href: ../../api/security-healthissue-update.md
+ - name: Complex types
+ items:
+ - name: Identity container
+ href: ../../resources/security-identitycontainer.md
- name: Information protection items: - name: Threat assessment
v1.0 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/toc/tasks-and-plans/toc.yml a/api-reference/v1.0/toc/tasks-and-plans/toc.yml
items:
items: - name: Planner plan href: ../../resources/plannerplan.md
- - name: Get plan
+ - name: Create
+ href: ../../api/planner-post-plans.md
+ - name: Get
href: ../../api/plannerplan-get.md
+ - name: Update
+ href: ../../api/plannerplan-update.md
+ - name: Delete
+ href: ../../api/plannerplan-delete.md
- name: List plan buckets href: ../../api/plannerplan-list-buckets.md - name: List plan tasks href: ../../api/plannerplan-list-tasks.md
- - name: Update plan
- href: ../../api/plannerplan-update.md
- - name: Delete plan
- href: ../../api/plannerplan-delete.md
- name: Planner plan details items: - name: Planner plan details
items:
items: - name: Planner task href: ../../resources/plannertask.md
- - name: Get task
+ - name: Create
+ href: ../../api/planner-post-tasks.md
+ - name: Get
href: ../../api/plannertask-get.md
- - name: Update task
+ - name: Update
href: ../../api/plannertask-update.md
- - name: Delete task
+ - name: Delete
href: ../../api/plannertask-delete.md - name: Planner task details items:
v1.0 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/toc/teamwork-and-communications/toc.yml a/api-reference/v1.0/toc/teamwork-and-communications/toc.yml
items:
items: - name: Call href: ../../resources/call.md
+ - name: Create
+ href: ../../api/application-post-calls.md
- name: Get href: ../../api/call-get.md - name: Delete/hang up
items:
href: ../../api/onlinemeeting-list-recordings.md - name: Get href: ../../api/callrecording-get.md
+ - name: Get delta by organizer
+ href: ../../api/callrecording-delta.md
+ - name: List recordings by organizer
+ href: ../../api/onlinemeeting-getallrecordings.md
- name: Call transcript items: - name: Call transcript
items:
href: ../../api/onlinemeeting-list-transcripts.md - name: Get transcript href: ../../api/calltranscript-get.md
+ - name: Get delta by organizer
+ href: ../../api/calltranscript-delta.md
+ - name: List transcripts by organizer
+ href: ../../api/onlinemeeting-getalltranscripts.md
- name: Virtual appointment items: - name: Get virtual appointment join link
v1.0 Toc.Mapping.Json https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/toc/toc.mapping.json a/api-reference/v1.0/toc/toc.mapping.json
"rubricQualitySelectedColumnModel" ] },
+ {
+ "name": "Employee experience",
+ "childNodes": [
+ {
+ "name": "Employee engagement",
+ "overview": "../../resources/engagement-api-overview.md",
+ "resources": [
+ "community",
+ "engagementAsyncOperation"
+ ]
+ }
+ ]
+ },
{ "name": "Extensions", "overview": "/graph/extensibility-overview?context=graph%2Fapi%2F1.0&preserve-view=true",
"driveItem", "bundle", "permission",
- "fileStorageContainer"
+ "fileStorageContainer",
+ "sharedDriveItem"
] }, {
"shouldSort": true, "resources": [ "administrativeUnit",
+ "appRoleAssignment",
"contract", "directory", "device",
"microsoft.graph.identityGovernance.workflowTemplate", "microsoft.graph.identityGovernance.taskDefinition", "microsoft.graph.identityGovernance.customTaskExtension",
- "microsoft.graph.identityGovernance.lifecycleManagementSettings"
+ "microsoft.graph.identityGovernance.lifecycleManagementSettings",
+ "microsoft.graph.identitygovernance.insights"
], "complexTypes": [ "azureAdPopTokenAuthentication",
"name": "Microsoft 365 usage reports", "overview": "../../resources/report.md", "resources": [
+ "adminReportSettings",
"reportRoot" ] },
"microsoft.graph.security.ediscoveryReviewTag" ] },
+ {
+ "name": "Identities",
+ "resources": [
+ "microsoft.graph.security.healthIssue"
+ ],
+ "complexTypes": [
+ "microsoft.graph.security.identityContainer"
+ ]
+ },
{ "name": "Information protection", "childNodes": [