Updates from: 08/24/2023 02:00:40
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Accesspackage Delete Incompatibleaccesspackage https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accesspackage-delete-incompatibleaccesspackage.md
DELETE https://graph.microsoft.com/beta/identityGovernance/entitlementManagement
[!INCLUDE [sample-code](../includes/snippets/php/remove-incompatibleaccesspackage-from-accesspackage-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/remove-incompatibleaccesspackage-from-accesspackage-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Accesspackageassignmentrequestworkflowextension Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accesspackageassignmentrequestworkflowextension-delete.md
DELETE /identityGovernance/entitlementManagement/accessPackageCatalogs/32efb28c-
[!INCLUDE [sample-code](../includes/snippets/php/delete-accesspackageassignmentrequestworkflowextension-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-accesspackageassignmentrequestworkflowextension-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Accesspackageassignmentworkflowextension Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accesspackageassignmentworkflowextension-delete.md
DELETE /identityGovernance/entitlementManagement/accessPackageCatalogs/32efb28c-
[!INCLUDE [sample-code](../includes/snippets/php/delete-accesspackageassignmentworkflowextension-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-accesspackageassignmentworkflowextension-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Accesspackagecatalog Post Accesspackagecustomworkflowextensions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accesspackagecatalog-post-accesspackagecustomworkflowextensions.md
Content-Type: application/json
[!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)
v1.0 Accessreview Addreviewer https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreview-addreviewer.md
Title: "Add accessReview reviewer (deprecated)" description: "In the Azure AD access reviews feature, update an existing accessReview object to add another user as a reviewer. This operation is only permitted for an access review that is not yet completed, and only for an access review where the reviewers are explicitly specified. This operation is not permitted for an access review in which users review their own access, and not intended for an access review in which the group owners are assigned as the reviewers. " ms.localizationpriority: medium-+ ms.prod: "governance" doc_type: apiPageType
v1.0 Accessreview Apply https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreview-apply.md
Title: "Apply accessReview (deprecated)" description: "In the Azure AD access reviews feature, apply the decisions of a completed accessReview. The target object can be either a one-time access review, or an instance of a recurring access review. " ms.localizationpriority: medium-+ ms.prod: "governance" doc_type: apiPageType
POST https://graph.microsoft.com/beta/accessReviews/2975E9B5-44CE-4E71-93D3-30F0
[!INCLUDE [sample-code](../includes/snippets/php/apply-accessreview-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/apply-accessreview-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Accessreview Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreview-create.md
Title: "Create accessReview (deprecated)" description: "In the Azure AD access reviews feature, create a new accessReview object." ms.localizationpriority: medium-+ ms.prod: "governance" doc_type: apiPageType
v1.0 Accessreview Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreview-delete.md
Title: "Delete accessReview (deprecated)" description: "In the Azure AD access reviews feature, delete an accessReview object." ms.localizationpriority: medium-+ ms.prod: "governance" doc_type: apiPageType
v1.0 Accessreview Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreview-get.md
Title: "Get accessReview (deprecated)" description: "In the Azure AD access reviews feature, retrieve an accessReview object." ms.localizationpriority: medium-+ ms.prod: "governance" doc_type: apiPageType
v1.0 Accessreview List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreview-list.md
Title: "List accessReviews (deprecated)" description: "Retrieve accessReview objects for a businessFlowTemplate." ms.localizationpriority: medium-+ ms.prod: "governance" doc_type: apiPageType
v1.0 Accessreview Listdecisions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreview-listdecisions.md
Title: "List accessReview decisions (deprecated)" description: "In the Azure AD access reviews feature, retrieve the decisions of an accessReview object." ms.localizationpriority: medium-+ ms.prod: "governance" doc_type: apiPageType
Content-type: application/json
## See also
-| Method | Return Type |Description|
+| Method | Return Type |Description|
|:|:--|:-|
-|[Get accessReview](accessreview-get.md) | [accessReview](../resources/accessreview.md) | Retrieve an access review. |
-|[List my accessReview decisions](accessreview-listmydecisions.md) | [accessReviewDecision](../resources/accessreviewdecision.md) collection| As a reviewer, get my decisions of an accessReview.|
-|[Send accessReview reminder](accessreview-sendreminder.md) | None. | Send a reminder to the reviewers of an accessReview. |
-|[Stop accessReview](accessreview-stop.md) | None. | Stop an accessReview. |
-|[Reset accessReview decisions](accessreview-reset.md) | None. | Reset the decisions in an in-progress accessReview.|
-|[Apply accessReview decisions](accessreview-apply.md) | None. | Apply the decisions from a completed accessReview.|
+|[Get accessReview](accessreview-get.md) | [accessReview](../resources/accessreview.md) | Retrieve an access review. |
+|[List my accessReview decisions](accessreview-listmydecisions.md) | [accessReviewDecision](../resources/accessreviewdecision.md) collection| As a reviewer, get my decisions of an accessReview.|
+|[Send accessReview reminder](accessreview-sendreminder.md) | None. | Send a reminder to the reviewers of an accessReview. |
+|[Stop accessReview](accessreview-stop.md) | None. | Stop an accessReview. |
+|[Reset accessReview decisions](accessreview-reset.md) | None. | Reset the decisions in an in-progress accessReview.|
+|[Apply accessReview decisions](accessreview-apply.md) | None. | Apply the decisions from a completed accessReview.|
<!--
v1.0 Accessreview Listmydecisions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreview-listmydecisions.md
Title: "List my accessReview decisions (deprecated)" description: "In the Azure AD access reviews feature, retrieve the decisions of an accessReview object for the calling user as reviewer." ms.localizationpriority: medium-+ ms.prod: "governance" doc_type: apiPageType
Content-type: application/json
## See also
-| Method | Return Type |Description|
+| Method | Return Type |Description|
|:|:--|:-|
-|[Get accessReview](accessreview-get.md) | [accessReview](../resources/accessreview.md) | Retrieve an access review. |
-|[List accessReview decisions](accessreview-listdecisions.md) | [accessReviewDecision](../resources/accessreviewdecision.md) collection| Retrieve all the decisions of an accessReview.|
+|[Get accessReview](accessreview-get.md) | [accessReview](../resources/accessreview.md) | Retrieve an access review. |
+|[List accessReview decisions](accessreview-listdecisions.md) | [accessReviewDecision](../resources/accessreviewdecision.md) collection| Retrieve all the decisions of an accessReview.|
<!--
v1.0 Accessreview Listreviewers https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreview-listreviewers.md
Title: "List accessReview reviewers (deprecated)" description: "In the Azure AD access reviews feature, retrieve the reviewers of an accessReview object." ms.localizationpriority: medium-+ ms.prod: "governance" doc_type: apiPageType
Content-type: application/json
## See also
-| Method | Return Type |Description|
+| Method | Return Type |Description|
|:|:--|:-|
-|[Get accessReview](accessreview-get.md) | [accessReview](../resources/accessreview.md) | Retrieve an access review. |
-|[Add accessReview reviewer](accessreview-addreviewer.md) | None. | Add a reviewer to an accessReview. |
-|[Remove accessReview reviewer](accessreview-removereviewer.md) | None. | Remove a reviewer from an accessReview. |
+|[Get accessReview](accessreview-get.md) | [accessReview](../resources/accessreview.md) | Retrieve an access review. |
+|[Add accessReview reviewer](accessreview-addreviewer.md) | None. | Add a reviewer to an accessReview. |
+|[Remove accessReview reviewer](accessreview-removereviewer.md) | None. | Remove a reviewer from an accessReview. |
<!--
v1.0 Accessreview Removereviewer https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreview-removereviewer.md
Title: "Remove accessReview reviewer (deprecated)" description: "Remove an access review reviewer." ms.localizationpriority: medium-+ ms.prod: "governance" doc_type: apiPageType
v1.0 Accessreview Reset https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreview-reset.md
Title: "Reset accessReview (deprecated)" description: "In the Azure AD access reviews feature, reset the decisions of a currently active accessReview. The target object can be either a one-time access review, or an instance of a recurring access review. Previous decisions are no longer recorded, but reviewers can continue to update decisions." ms.localizationpriority: medium-+ ms.prod: "governance" doc_type: apiPageType
v1.0 Accessreview Sendreminder https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreview-sendreminder.md
Title: "SendReminder accessReview" description: "In the Azure AD access reviews feature, send a reminder to the reviewers of a currently active accessReview. The target object can be either a one-time access review, or an instance of a recurring access review. " ms.localizationpriority: medium-+ ms.prod: "governance" doc_type: apiPageType
v1.0 Accessreview Stop https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreview-stop.md
Title: "Stop accessReview (deprecated)" description: "In the Azure AD access reviews feature, stop a currently active accessReview. The target object can be either a one-time access review, or an instance of a recurring access review. (To prevent a recurring access review from starting future instances, update it to change its scheduled end date). After the access review stops, reviewers can no longer give input, and the access review decisions can be applied." ms.localizationpriority: medium-+ ms.prod: "governance" doc_type: apiPageType
v1.0 Accessreview Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreview-update.md
Title: "Update accessReview (deprecated)" description: "In the Azure AD access reviews feature, update an existing accessReview object to change one or more of its properties." ms.localizationpriority: medium-+ ms.prod: "governance" doc_type: apiPageType
v1.0 Accessreviewhistorydefinition Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewhistorydefinition-get.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application|AccessReview.ReadWrite.All|
-The signed-in user must also be the creator of the associated review history definition, a Global Admin directory role member, or a Global Reader directory role member to retrieve the definition.
## HTTP request
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/historyDef
[!INCLUDE [sample-code](../includes/snippets/php/get-accessreviewhistorydefinition-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-accessreviewhistorydefinition-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Accessreviewhistorydefinition List Instances https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewhistorydefinition-list-instances.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application|AccessReview.ReadWrite.All|
-If the signed-in user is not a global administrator or a global reader, only the definitions that the signed-in user created will be returned.
## HTTP request
v1.0 Accessreviewhistoryinstance Generatedownloaduri https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewhistoryinstance-generatedownloaduri.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application|AccessReview.ReadWrite.All|
-To generate the link, the signed-in user must be either the creator of the associated review history definition, or assigned the *Global Administrator* or *Global Reader* [directory roles](/azure/active-directory/roles/permissions-reference).
## HTTP request
v1.0 Accessreviewinstance Applydecisions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewinstance-applydecisions.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application | AccessReview.ReadWrite.All | + ## HTTP request <!-- { "blockType": "ignored" } --> ```http
v1.0 Accessreviewinstance Batchrecorddecisions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewinstance-batchrecorddecisions.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported| |Application|AccessReview.ReadWrite.All| + ## HTTP request <!-- {
v1.0 Accessreviewinstance Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewinstance-get.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application | AccessReview.Read.All, AccessReview.ReadWrite.All |
-In order to call this API, the signed in user must also be in a directory role that permits them to read an access review, or the user can be assigned as a reviewer on the access review. For more details, see the role and permission requirements for [access reviews](../resources/accessreviewsv2-overview.md).
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Accessreviewinstance List Contactedreviewers https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewinstance-list-contactedreviewers.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application|AccessReview.Read.All, AccessReview.ReadWrite.All| + ## HTTP request <!-- {
v1.0 Accessreviewinstance List Decisions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewinstance-list-decisions.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application|AccessReview.Read.All, AccessReview.ReadWrite.All| + ## HTTP request <!-- {
v1.0 Accessreviewinstance List Stages https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewinstance-list-stages.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application|AccessReview.Read.All, AccessReview.ReadWrite.All| + ## HTTP request <!-- {
v1.0 Accessreviewinstance Resetdecisions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewinstance-resetdecisions.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application|AccessReview.ReadWrite.All| + ## HTTP request <!-- {
POST https://graph.microsoft.com/beta/identityGovernance/accessReviews/definitio
[!INCLUDE [sample-code](../includes/snippets/php/accessreviewinstance-resetdecisions-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/accessreviewinstance-resetdecisions-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Accessreviewinstance Sendreminder https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewinstance-sendreminder.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application | AccessReview.ReadWrite.All | + ## HTTP request <!-- { "blockType": "ignored" } --> ```http
v1.0 Accessreviewinstance Stop https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewinstance-stop.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application | AccessReview.ReadWrite.All | + ## HTTP request <!-- { "blockType": "ignored" } --> ```http
POST https://graph.microsoft.com/beta/identityGovernance/accessReviews/definitio
[!INCLUDE [sample-code](../includes/snippets/php/stop-accessreviewinstance-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/stop-accessreviewinstance-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Accessreviewinstance Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewinstance-update.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application | AccessReview.ReadWrite.All | + ## HTTP request <!-- {
v1.0 Accessreviewinstancedecisionitem Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewinstancedecisionitem-get.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application|AccessReview.Read.All, AccessReview.ReadWrite.All| + ## HTTP request To retrieve a decision on an accessReviewInstance:
v1.0 Accessreviewinstancedecisionitem Recordalldecisions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewinstancedecisionitem-recordalldecisions.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application | AccessReview.Read.All, AccessReview.ReadWrite.All | + ## HTTP request <!-- {
v1.0 Accessreviewinstancedecisionitem Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewinstancedecisionitem-update.md
One of the following permissions is required to call this API. Delegated permiss
|Delegated (work or school account) | AccessReview.ReadWrite.All | |Delegated (personal Microsoft account)|Not supported.| + ## HTTP request To update a decision on an accessReviewInstance:
Content-Type: application/json
[!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)
v1.0 Accessreviewscheduledefinition Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewscheduledefinition-delete.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application | AccessReview.ReadWrite.All | + ## HTTP request <!-- { "blockType": "ignored" } --> ```http
v1.0 Accessreviewscheduledefinition Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewscheduledefinition-get.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application | AccessReview.Read.All, AccessReview.ReadWrite.All |
-To call this API, the signed-in user must also be in a directory role that permits them to read an access review, or the user can be assigned as a reviewer on the access review. For more details, see the role and permission requirements for [access reviews](../resources/accessreviewsv2-overview.md).
+
+The calling user can also read access reviews whether they are assigned as a reviewer.
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Accessreviewscheduledefinition List Instances https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewscheduledefinition-list-instances.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (work or school account) | AccessReview.Read.All, AccessReview.ReadWrite.All | |Application | AccessReview.Read.All, AccessReview.ReadWrite.All |
-The signed-in user must also be in a directory role that permits them to read an access review. To view just the instances that the signed-in user is assigned the reviewer on, see [List pending access review instances](accessreviewinstance-pendingaccessreviewinstances.md)
+
+To view just the instances that the signed-in user is assigned the reviewer on, see [List pending access review instances](accessreviewinstance-pendingaccessreviewinstances.md)
## HTTP request <!-- { "blockType": "ignored" } -->
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definition
[!INCLUDE [sample-code](../includes/snippets/php/list-accessreviewinstance-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-accessreviewinstance-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Accessreviewscheduledefinition Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewscheduledefinition-update.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application | AccessReview.ReadWrite.All | + ## HTTP request <!-- { "blockType": "ignored" } --> ```http
v1.0 Accessreviewset List Definitions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewset-list-definitions.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application | AccessReview.Read.All, AccessReview.ReadWrite.All |
- The signed-in user must also be in a directory role that permits them to read an access review. See access review [role and application permission authorization checks](../resources/accessreviewsv2-overview.md#role-and-application-permission-authorization-checks).
## HTTP request
v1.0 Accessreviewset List Historydefinitions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewset-list-historydefinitions.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application|AccessReview.ReadWrite.All|
-If the signed-in user is not a Global Admin directory role member or a Global Reader directory role member, only the definitions that the signed-in user created will be returned.
## HTTP request
v1.0 Accessreviewset Post Definitions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewset-post-definitions.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application | AccessReview.ReadWrite.All |
-The signed-in user must also be in a directory role that permits them to create an access review. For more details, see the role and permission requirements for [access reviews](../resources/accessreviewsv2-overview.md).
## HTTP request <!-- { "blockType": "ignored" } -->
Content-type: application/json
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-type: application/json
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-type: application/json
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Accessreviewset Post Historydefinitions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewset-post-historydefinitions.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application|AccessReview.ReadWrite.All|
-The signed-in user must also be in a directory role that permits them to read an access review to retrieve any data. For more details, see the role and permission requirements for [access reviews](../resources/accessreviewsv2-overview.md).
## HTTP request
v1.0 Accessreviewstage Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewstage-get.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application | AccessReview.Read.All, AccessReview.ReadWrite.All | + ## HTTP request <!-- {
v1.0 Accessreviewstage List Decisions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewstage-list-decisions.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application|AccessReview.Read.All, AccessReview.ReadWrite.All| + ## HTTP request <!-- {
v1.0 Accessreviewstage Stop https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewstage-stop.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application | AccessReview.ReadWrite.All | + ## HTTP request <!-- {
v1.0 Accessreviewstage Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/accessreviewstage-update.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application | AccessReview.ReadWrite.All | + ## HTTP request <!-- {
v1.0 Addlargegalleryviewoperation Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/addlargegalleryviewoperation-get.md
GET https://graph.microsoft.com/beta/communications/calls/57dab8b1-894c-409a-b24
[!INCLUDE [sample-code](../includes/snippets/php/get-addlargegalleryviewoperation-1-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-addlargegalleryviewoperation-1-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Administrativeunit Delete Scopedrolemembers https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/administrativeunit-delete-scopedrolemembers.md
DELETE https://graph.microsoft.com/beta/administrativeUnits/{id}/scopedRoleMembe
[!INCLUDE [sample-code](../includes/snippets/php/delete-scopedrolemember-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-scopedrolemember-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Administrativeunit Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/administrativeunit-delete.md
DELETE https://graph.microsoft.com/beta/administrativeUnits/{id}
[!INCLUDE [sample-code](../includes/snippets/php/delete-administrativeunit-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-administrativeunit-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Administrativeunit Get Scopedrolemembers https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/administrativeunit-get-scopedrolemembers.md
GET https://graph.microsoft.com/beta/administrativeUnits/{id}/scopedRoleMembers/
[!INCLUDE [sample-code](../includes/snippets/php/get-scopedrolemember-1-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-scopedrolemember-1-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Administrativeunit List Scopedrolemembers https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/administrativeunit-list-scopedrolemembers.md
GET https://graph.microsoft.com/beta/administrativeUnits/{id}/scopedRoleMembers
[!INCLUDE [sample-code](../includes/snippets/php/get-scopedrolemember-2-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-scopedrolemember-2-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Administrativeunit Post Members https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/administrativeunit-post-members.md
Content-type: application/json
[!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)
v1.0 Adminwindowsupdates List Updatableassets Azureaddevice https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/adminwindowsupdates-list-updatableassets-azureaddevice.md
GET https://graph.microsoft.com/beta/admin/windows/updates/updatableAssets/micro
[!INCLUDE [sample-code](../includes/snippets/php/list-azureaddevice-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-azureaddevice-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Alert Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/alert-get.md
GET https://graph.microsoft.com/beta/security/alerts/{id}
[!INCLUDE [sample-code](../includes/snippets/php/get-alert-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-alert-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Alert List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/alert-list.md
GET https://graph.microsoft.com/beta/security/alerts
[!INCLUDE [sample-code](../includes/snippets/php/get-alerts-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-alerts-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Alert Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/alert-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-alert-1-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-alert-1-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Prefer: return=representation
[!INCLUDE [sample-code](../includes/snippets/php/update-alert-2-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-alert-2-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Alert Updatealerts https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/alert-updatealerts.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/alert-updatealerts-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/alert-updatealerts-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Allowedvalue Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/allowedvalue-update.md
Content-length: 80
[!INCLUDE [sample-code](../includes/snippets/php/update-allowedvalue-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-allowedvalue-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Appcredentialsigninactivity Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/appcredentialsigninactivity-get.md
GET https://graph.microsoft.com/beta/reports/appCredentialSignInActivities/ODNmN
[!INCLUDE [sample-code](../includes/snippets/php/get-appcredentialsigninactivity-1-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-appcredentialsigninactivity-1-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Application Addpassword https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/application-addpassword.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/application-addpassword-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/application-addpassword-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Application List Extensionproperty https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/application-list-extensionproperty.md
Title: "List extensionProperties (directory extensions)" description: "Retrieve a list of directory extension definitions." ms.localizationpriority: medium-+ ms.prod: "extensions" doc_type: "apiPageType"
v1.0 Application List Federatedidentitycredentials https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/application-list-federatedidentitycredentials.md
Title: "List federatedIdentityCredentials" description: "Get a list of the federatedIdentityCredential objects and their properties."-+ ms.localizationpriority: medium ms.prod: "applications" doc_type: apiPageType
v1.0 Application List Tokenissuancepolicies https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/application-list-tokenissuancepolicies.md
GET https://graph.microsoft.com/beta/applications/{id}/tokenIssuancePolicies
[!INCLUDE [sample-code](../includes/snippets/php/list-tokenissuancepolicies-on-application-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-tokenissuancepolicies-on-application-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Application List Tokenlifetimepolicies https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/application-list-tokenlifetimepolicies.md
GET https://graph.microsoft.com/beta/applications/3ccc9971-9ae7-45d6-8de8-263fd2
[!INCLUDE [sample-code](../includes/snippets/php/list-tokenlifetimepolicies-on-application-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-tokenlifetimepolicies-on-application-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Application Post Extensionproperty https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/application-post-extensionproperty.md
Title: "Create extensionProperty (directory extension)" description: "Create a new directory extension." ms.localizationpriority: medium-+ ms.prod: "extensions" doc_type: "apiPageType"
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-extensionproperty-from-application-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-extensionproperty-from-application-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Application Post Federatedidentitycredentials https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/application-post-federatedidentitycredentials.md
Title: "Create federatedIdentityCredential" description: "Create a new federatedIdentityCredential object for an application."-+ ms.localizationpriority: medium ms.prod: "applications" doc_type: apiPageType
v1.0 Application Post Onlinemeetings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/application-post-onlinemeetings.md
Content-Type: application/json
[!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)
v1.0 Application Post Tokenissuancepolicies https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/application-post-tokenissuancepolicies.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-tokenissuancepolicy-from-application-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-tokenissuancepolicy-from-application-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Application Setverifiedpublisher https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/application-setverifiedpublisher.md
Title: "application: setVerifiedPublisher" description: "Set the verified publisher of an application." ms.localizationpriority: medium-+ ms.prod: "applications" doc_type: "apiPageType"
POST /applications(appId='{appId}')/setVerifiedPublisher
In the request body, provide the following required properties.
-| Property | Type |Description|
+| Property | Type |Description|
|:|:--|:-| | verifiedPublisherId | string | The Microsoft Partner Network ID (MPNID) of the verified publisher to be set on the application, from the publisher's Partner Center account. |
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/application-setverifiedpublisher-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/application-setverifiedpublisher-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Application Unsetverifiedpublisher https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/application-unsetverifiedpublisher.md
Title: "application: unsetVerifiedPublisher" description: "Unset the verified publisher of an application." ms.localizationpriority: medium-+ ms.prod: "applications" doc_type: "apiPageType"
v1.0 Applicationsignindetailedsummary Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/applicationsignindetailedsummary-get.md
GET https://graph.microsoft.com/beta/reports/applicationSignInDetailedSummary/{i
[!INCLUDE [sample-code](../includes/snippets/php/get-applicationsignindetailedsummary-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-applicationsignindetailedsummary-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Applicationtemplate Instantiate https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/applicationtemplate-instantiate.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/applicationtemplate-instantiate-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/applicationtemplate-instantiate-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Appmanagementpolicy List Appliesto https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/appmanagementpolicy-list-appliesto.md
GET https://graph.microsoft.com/beta/policies/appManagementPolicies/{id}/applies
[!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)
v1.0 Attachment Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/attachment-get.md
GET https://graph.microsoft.com/beta/me/messages/AAMkADA1M-zAAA=/attachments/AAM
[!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)
v1.0 Attacksimulationoperation Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/attacksimulationoperation-get.md
GET https://graph.microsoft.com/beta/security/attackSimulation/operations/f1b138
[!INCLUDE [sample-code](../includes/snippets/php/get-attacksimulationoperation-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-attacksimulationoperation-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Attacksimulationroot List Payloads https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/attacksimulationroot-list-payloads.md
GET https://graph.microsoft.com/beta/security/attackSimulation/payloads?$filter=
[!INCLUDE [sample-code](../includes/snippets/php/list-payload-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-payload-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Attacksimulationroot List Simulationautomations https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/attacksimulationroot-list-simulationautomations.md
GET https://graph.microsoft.com/beta/security/attackSimulation/simulationAutomat
[!INCLUDE [sample-code](../includes/snippets/php/list-simulationautomation-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-simulationautomation-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Attacksimulationroot List Simulations https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/attacksimulationroot-list-simulations.md
GET https://graph.microsoft.com/beta/security/attackSimulation/simulations
[!INCLUDE [sample-code](../includes/snippets/php/list-simulation-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-simulation-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Attacksimulationroot Post Simulation https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/attacksimulationroot-post-simulation.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-simulation-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-simulation-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Attendancerecord List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/attendancerecord-list.md
GET https://graph.microsoft.com/beta/me/onlineMeetings/{meetingId}/attendanceRep
[!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)
v1.0 Audioroutinggroup Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/audioroutinggroup-delete.md
DELETE https://graph.microsoft.com/beta/communications/calls/{id}/audioRoutingGr
[!INCLUDE [sample-code](../includes/snippets/php/delete-audioroutinggroup-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-audioroutinggroup-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Authentication List Emailmethods https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/authentication-list-emailmethods.md
Title: "List emailAuthenticationMethods" description: "Get a list of the emailAuthenticationMethod objects and their properties."-+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
v1.0 Authentication List Methods https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/authentication-list-methods.md
Title: "List methods" description: "Retrieve a list of authentication methods registered to a user." ms.localizationpriority: medium-+ ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
v1.0 Authentication List Passwordmethods https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/authentication-list-passwordmethods.md
Title: "List passwordMethods" description: "Retrieve a list of passwordauthenticationmethod objects." ms.localizationpriority: medium-+ ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
v1.0 Authentication List Phonemethods https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/authentication-list-phonemethods.md
Title: "List phoneMethods" description: "Retrieve a list of phone authentication method objects." ms.localizationpriority: medium-+ ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
v1.0 Authentication List Softwareoathmethods https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/authentication-list-softwareoathmethods.md
Title: "List softwareOathMethods" description: "Retrieve a list of a user's softwareOathAuthenticationMethods objects and their properties."-+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: apiPageType
v1.0 Authentication Post Emailmethods https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/authentication-post-emailmethods.md
Title: "Create emailAuthenticationMethod" description: "Create a new emailAuthenticationMethod object."-+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
v1.0 Authentication Post Phonemethods https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/authentication-post-phonemethods.md
Title: "Create phoneAuthenticationMethod" description: "Add a new phone authentication method." ms.localizationpriority: medium-+ ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
v1.0 Authenticationcontextclassreference Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/authenticationcontextclassreference-delete.md
Title: "Delete authenticationContextClassReference" description: "Delete an authenticationContextClassReference object."-+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: apiPageType
v1.0 Authenticationcontextclassreference Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/authenticationcontextclassreference-get.md
Title: "Get authenticationContextClassReference" description: "Retrieve the properties and relationships of a authenticationContextClassReference object." ms.localizationpriority: medium-+ ms.prod: "identity-and-sign-in" doc_type: apiPageType
v1.0 Authenticationcontextclassreference Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/authenticationcontextclassreference-update.md
Title: "Update authenticationContextClassReference" description: "Update the properties of a authenticationContextClassReference object." ms.localizationpriority: medium-+ ms.prod: "identity-and-sign-in" doc_type: apiPageType
v1.0 Authenticationeventlistener Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/authenticationeventlistener-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-authenticationeventlistener-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-authenticationeventlistener-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Authenticationmethod Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/authenticationmethod-get.md
Title: "Get authenticationMethod" description: "Retrieve the properties and relationships of an authenticationMethod object." ms.localizationpriority: medium-+ ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
v1.0 Authenticationmethod Resetpassword https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/authenticationmethod-resetpassword.md
Title: "passwordAuthenticationMethod: resetPassword" description: "Reset a user's password" ms.localizationpriority: medium-+ ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
v1.0 Authenticationmethodspolicy Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/authenticationmethodspolicy-get.md
GET https://graph.microsoft.com/beta/policies/authenticationMethodsPolicy
[!INCLUDE [sample-code](../includes/snippets/php/get-authenticationmethodspolicy-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-authenticationmethodspolicy-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Authenticationoperation Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/authenticationoperation-get.md
Title: "Get authentication operation" description: "Retrieve the properties and relationships of an operation object." ms.localizationpriority: medium-+ ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
v1.0 Authenticationstrengthpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/authenticationstrengthpolicy-update.md
Title: "Update authenticationStrengthPolicy" description: "Update the properties of an authenticationStrengthPolicy object."-+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: apiPageType
v1.0 B2cidentityuserflow Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/b2cidentityuserflow-delete.md
DELETE https://graph.microsoft.com/beta/identity/b2cUserFlows/{id}
[!INCLUDE [sample-code](../includes/snippets/php/delete-b2cuserflows-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-b2cuserflows-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 B2cidentityuserflow Post Identityproviders https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/b2cidentityuserflow-post-identityproviders.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-b2cuserflows-identityprovider-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-b2cuserflows-identityprovider-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 B2xidentityuserflow Get Apiconnectorconfiguration https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/b2xidentityuserflow-get-apiconnectorconfiguration.md
GET https://graph.microsoft.com/beta/identity/b2xUserFlows/B2X_1_testuserflow/ap
[!INCLUDE [sample-code](../includes/snippets/php/get-b2xuserflows-apiconnectorconfiguration-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-b2xuserflows-apiconnectorconfiguration-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 B2xidentityuserflow Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/b2xidentityuserflow-get.md
GET https://graph.microsoft.com/beta/identity/b2xUserFlows/{id}
[!INCLUDE [sample-code](../includes/snippets/php/get-b2xuserflows-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-b2xuserflows-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 B2xidentityuserflow List Languages https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/b2xidentityuserflow-list-languages.md
GET https://graph.microsoft.com/beta/identity/b2xUserFlows/B2X_1_PartnerSignUp/l
[!INCLUDE [sample-code](../includes/snippets/php/get-userflowlanguageconfiguration-2-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-userflowlanguageconfiguration-2-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 B2xidentityuserflow List Userattributeassignments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/b2xidentityuserflow-list-userattributeassignments.md
GET https://graph.microsoft.com/beta/identity/b2xUserFlows/{id}/userAttributeAss
[!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)
v1.0 B2xidentityuserflow Post Userattributeassignments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/b2xidentityuserflow-post-userattributeassignments.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-identityuserflowattributeassignment-from--2-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-identityuserflowattributeassignment-from--2-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 B2xidentityuserflow Put Apiconnectorconfiguration https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/b2xidentityuserflow-put-apiconnectorconfiguration.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/put-b2xuserflows-apiconnectorconfiguration-postfederationsignup-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/put-b2xuserflows-apiconnectorconfiguration-postfederationsignup-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/put-b2xuserflows-apiconnectorconfiguration-postattributecollection-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/put-b2xuserflows-apiconnectorconfiguration-postattributecollection-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/put-b2xuserflows-apiconnectorconfiguration-disable-postattributecollection-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/put-b2xuserflows-apiconnectorconfiguration-disable-postattributecollection-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Basesitepage List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/basesitepage-list.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } -->
-```http
+```msgraph-interactive
GET /sites/{site-id}/pages ```
v1.0 Bitlocker List Recoverykeys https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/bitlocker-list-recoverykeys.md
Title: "List recoveryKeys" description: "Get a list of the bitlockerRecoveryKey objects and their properties."-+ ms.localizationpriority: medium ms.prod: "directory-management" doc_type: apiPageType
v1.0 Bitlockerrecoverykey Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/bitlockerrecoverykey-get.md
Title: "Get bitlockerRecoveryKey" description: "Retrieve the properties and relationships of a bitlockerRecoveryKey object."-+ ms.localizationpriority: medium ms.prod: "directory-management" doc_type: apiPageType
v1.0 Bookingbusiness List Appointments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/bookingbusiness-list-appointments.md
GET https://graph.microsoft.com/beta/bookingBusinesses/contosolunchdelivery@cont
[!INCLUDE [sample-code](../includes/snippets/php/get-appointments-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-appointments-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Bookingbusiness List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/bookingbusiness-list.md
GET https://graph.microsoft.com/beta/bookingBusinesses?query=Adventure
[!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)
v1.0 Bookingcustomquestion Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/bookingcustomquestion-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-bookingcustomquestion-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-bookingcustomquestion-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Bookingservice Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/bookingservice-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-bookingservice-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-bookingservice-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Bundle Additem https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/bundle-additem.md
-+ Title: "Add item to a bundle" description: "Add item to a bundle of driveItems." ms.localizationpriority: medium
v1.0 Bundle Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/bundle-delete.md
-+ Title: "Delete bundle" description: "Delete a bundle of driveItems." ms.localizationpriority: medium
v1.0 Bundle Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/bundle-get.md
-+ Title: "Get bundle" description: "Get a bundle of driveItems." ms.localizationpriority: medium
v1.0 Bundle List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/bundle-list.md
-+ Title: "List bundles" description: "List the bundles in a user's drive." ms.localizationpriority: medium
v1.0 Bundle Removeitem https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/bundle-removeitem.md
-+ Title: "Remove item from bundle" description: "Remove item from a bundle of driveItems." ms.localizationpriority: medium
v1.0 Bundle Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/bundle-update.md
-+ Title: Update a bundle description: Update a bundle of driveItems ms.localizationpriority: medium
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/rename-bundle-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/rename-bundle-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Businessflowtemplate List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/businessflowtemplate-list.md
description: "In the Azure AD access reviews feature, list all the businessFlowT
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # List businessFlowTemplates (deprecated)
Content-type: application/json
## See also
-| Method | Return Type |Description|
+| Method | Return Type |Description|
|:|:--|:-|
-|[Create accessReview](accessreview-create.md) | [accessReview](../resources/accessreview.md) | Create a new accessReview. |
+|[Create accessReview](accessreview-create.md) | [accessReview](../resources/accessreview.md) | Create a new accessReview. |
v1.0 Calendar Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/calendar-get.md
GET https://graph.microsoft.com/beta/me/calendar
[!INCLUDE [sample-code](../includes/snippets/php/get-calendar-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-calendar-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Calendar List Calendarview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/calendar-list-calendarview.md
GET https://graph.microsoft.com/beta/me/calendar/calendarView?startDateTime=2017
[!INCLUDE [sample-code](../includes/snippets/php/get-calendarview-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-calendarview-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Call List Contentsharingsessions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/call-list-contentsharingsessions.md
GET https://graph.microsoft.com/beta/communications/calls/7531d31f-d10d-44de-802
[!INCLUDE [sample-code](../includes/snippets/php/get-contentsharingsessions-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-contentsharingsessions-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Callrecording Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/callrecording-delta.md
+
+ Title: "callRecording: delta"
+description: "Get a set of callRecording resources that have been 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 that have been 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 that have been added since the last synchronization. Typically, you would 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 `@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`).
+
+State tokens are completely opaque to the client. To proceed with a round of change tracking, simply 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 that have been added after acquiring `@odata.deltaLink`.
+
+For more information, see the [delta query](/graph/delta-query-overview) documentation.
+
+## Permissions
+
+The following permissions are required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account)| Not supported |
+|Delegated (personal Microsoft account) | Not supported |
+|Application | OnlineMeetingRecording.Read.All |
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+```http
+GET /users/{id}/onlineMeetings/getAllRecordings/delta?$filter=meetingOrganizerId%20eq%20'{id}'
+```
+>**Note:** If you don't specify a **meetingOrganizerId**, the request fails.
+
+## 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, 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. |
+
+## Request headers
+| Header | Value |
+|||
+| Authorization | Bearer {token}. Required. |
+
+## 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'll do in the [next round to get additional recordings](#example-2-next-round-to-get-additional-recordings).
+
+#### Initial request
+
+In this example, the call recordings are being synchronized for the first time, so the initial sync request does not include any state token. This round will return all recordings available at the time.
+
+<!-- { "blockType": "ignored" } -->
+```http
+GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllRecordings/delta?$filter=meetingOrganizerId%20eq%20'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.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.callRecording",
+ "isCollection": true
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callRecording)",
+ "@odata.count": 2,
+ "@odata.nextLink": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeeting/getAllRecordings?$skiptoken=GGXvkS7mbjFAe9Uidm2D70e58K-BOnoJadAqkZEJmoLprr5eSP1hQPlb3dJ1AVz3xCYKxov6hSEJhsasyg",
+ "value":[
+ {
+ "@odata.type": "#microsoft.graph.callRecording",
+ "meetingId": "MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19OMUUxWTFJME56QXRabVF5T0MxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy",
+ "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "recordingContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19OMUUxWTFJME56QXRabVF5T0MxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy/recordings/MSMjMCMjZDExYWQ2OGEtMWVhYS00MGFjLWJkZWItMTExNjMyNjExYzRl/content",
+ "createdDateTime": "2023-08-03T22:29:42.6514074Z",
+ "id": "MSMjMCMjZDExYWQ2OGEtMWVhYS00MGFjLWJkZWItMTExNjMyNjExYzRl"
+ },
+ {
+ "@odata.type": "#microsoft.graph.callRecording",
+ "meetingId": "MSo4YjA5MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19OMUUxWTFJME56QXRabVF5T0MxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy",
+ "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "recordingContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSo4YjA5MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19OMUUxWTFJME56QXRabVF5T0MxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy/recordings/MSMjMCMjZDExYWQ3OGEtMWVhYS00MGFjLWJkZWItMTExNjMyNjExYzRl/content",
+ "createdDateTime": "2023-08-05T11:24:30.6414074Z",
+ "id": "MSMjMCMjZDExYWQ3OGEtMWVhYS00MGFjLWJkZWItMTExNjMyNjExYzRl"
+ }
+ ]
+}
+```
+
+#### 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/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeeting/getAllRecordings?$skiptoken=GGXvkS7mbjFAe9Uidm2D70e58K-BOnoJadAqkZEJmoLprr5eSP1hQPlb3dJ1AVz3xCYKxov6hSEJhsasyg
+```
+
+#### Second response
+
+The second response returns the next 2 call recordings and a `@odata.nextLink` property with a `skipToken` which indicates there are more recordings.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.callRecording",
+ "isCollection": true
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callRecording)",
+ "@odata.count": 2,
+ "@odata.nextLink": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeeting/getAllRecordings?$skiptoken=GGXve9Uidm2D70kS7mbjFAe58K-BOnPlb3dJ1AVz3xCYmoLprr5eSP1hQKxov6hSEJhsasyg",
+ "value":[
+ {
+ "@odata.type": "#microsoft.graph.callRecording",
+ "meetingId": "MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19IMU4xMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy",
+ "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "recordingContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19IMU4xMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy/recordings/MSMjMCMjZDMzYWQzM2EtMmVhYS0zM2FjLWJkZWItMjMzNjMyNjExYzRl/content",
+ "createdDateTime": "2023-08-11T21:29:42.6514074Z",
+ "id": "MSMjMCMjZDMzYWQzM2EtMmVhYS0zM2FjLWJkZWItMjMzNjMyNjExYzRl"
+ },
+ {
+ "@odata.type": "#microsoft.graph.callRecording",
+ "meetingId": "MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19BQkMxRDFEMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy",
+ "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "recordingContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19BQkMxRDFEMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy/recordings/MSMjMCMjZDIyYWQyMmEtMmVhYS0yMmFjLWJkZWItMjIyNjMyNjExYzRl/content",
+ "createdDateTime": "2023-08-12T11:24:30.6414074Z",
+ "id": "MSMjMCMjZDIyYWQyMmEtMmVhYS0yMmFjLWJkZWItMjIyNjMyNjExYzRl"
+ }
+ ]
+}
+```
+
+#### 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/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeeting/getAllRecordings?$skiptoken=GGXve9Uidm2D70kS7mbjFAe58K-BOnPlb3dJ1AVz3xCYmoLprr5eSP1hQKxov6hSEJhsasyg
+```
++
+#### 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 have been 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
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callRecording)",
+ "@odata.count": 1,
+ "@odata.deltaLink": "https://graph.microsoft.com/betik_JIC44iCZpv-GLiA2VnFuE5yG-kCEBROb2iaPT_y_eMWVQtBO_ejzzyIxl00ji-tQ3HzAbW4liZAVG88lO3nG_6-MBFoHY1n8y21YUzjocG-Cn1tCNeeLPLTzIe5Dw.EP9gLiCoF2CE_e6l_m1bTk2aokD9KcgfgfcLGqd1r_4",
+ "value":[
+ {
+ "@odata.type": "#microsoft.graph.callRecording",
+ "meetingId": "MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19IMU4xMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy",
+ "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "recordingContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19IMU4xMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy/recordings/MSMjMCMjZDMzYWQzM2EtMmVhYS0zM2FjLWJkZWItMjMzNjMyNjExYzRl/content",
+ "createdDateTime": "2023-08-11T21:29:42.6514074Z",
+ "id": "MSMjMCMjZDMzYWQzM2EtMmVhYS0zM2FjLWJkZWItMjMzNjMyNjExYzRl"
+ }
+ ]
+}
+```
+
+### Example 2: Next round to get additional recordings
+
+Using the `@odata.deltaLink` from the last request in the last round, you can get only those recordings that have been added since the `@odata.deltaLink` was acquired.
+
+#### Request
+
+<!-- { "blockType": "ignored" } -->
+```http
+GET https://graph.microsoft.com/betik_JIC44iCZpv-GLiA2VnFuE5yG-kCEBROb2iaPT_y_eMWVQtBO_ejzzyIxl00ji-tQ3HzAbW4liZAVG88lO3nG_6-MBFoHY1n8y21YUzjocG-Cn1tCNeeLPLTzIe5Dw.EP9gLiCoF2CE_e6l_m1bTk2aokD9KcgfgfcLGqd1r_4
+```
++
+#### Response
+
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.callRecording",
+ "isCollection": true
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callRecording)",
+ "@odata.deltaLink": "https://graph.microsoft.com/betik_JIC44iCZpv-GLiA2VnFuE5yG-kCEBROb2iaPT_yjz2nsMoh1gXNtXii7s78HapCi5woifXqwXlVNxICh8wUUnvE2gExsa8eZ2Vy_ch5rVIhm067_1mUPML3iYUVyg.3o0rhgaBUduuxOr98An5pjBDP5JjKUiVWku3flSiOsk",
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.callRecording",
+ "meetingId": "MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19IMU4xMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy",
+ "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "recordingContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19IMU4xMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy/recordings/MSMjMCMjZDMzYWQzM2EtMmVhYS0zM2FjLWJkZWItMjMzNjMyNjExYzRl/content",
+ "createdDateTime": "2023-08-11T21:29:42.6514074Z",
+ "id": "MSMjMCMjZDMzYWQzM2EtMmVhYS0zM2FjLWJkZWItMjMzNjMyNjExYzRl"
+ }
+ ]
+}
+```
v1.0 Callrecording Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/callrecording-get.md
The following example shows how to get a single recording of an online meeting.
The following is an example of the request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_callRecording",
The following is an example of the request.
GET https://graph.microsoft.com/beta/users/b935e675-5e67-48b9-8d45-249d5f88e964/onlineMeetings/MSpiOTM1ZTY3NS01ZTY3LTQ4YjktOGQ0NS0yNDlkNWY4OGU5NjQqMCoqMTk6bWVldGluZ19ZbU0zTnpJNU9USXRZakU0WlMwME1tUTNMVGt6TVRRdFkyWm1PRGRtWmpsaVptRTNAdGhyZWFkLnYy/recordings/7e31db25-bc6e-4fd8-96c7-e01264e9b6fc ```
+# [C#](#tab/csharp)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+++ #### Response The following is an example of the response.
The following example shows how to get the content of a single recording of an o
The following is an example of the request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_callRecording_content",
The following is an example of the request.
GET https://graph.microsoft.com/beta/users/b935e675-5e67-48b9-8d45-249d5f88e964/onlineMeetings/MSpiOTM1ZTY3NS01ZTY3LTQ4YjktOGQ0NS0yNDlkNWY4OGU5NjQqMCoqMTk6bWVldGluZ19ZbU0zTnpJNU9USXRZakU0WlMwME1tUTNMVGt6TVRRdFkyWm1PRGRtWmpsaVptRTNAdGhyZWFkLnYy/recordings/7e31db25-bc6e-4fd8-96c7-e01264e9b6fc/content ```
+# [C#](#tab/csharp)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+++ #### Response The following example contains bytes for the recording in the response body. The `content-type` header specifies the type of the recording content. The negative offsets indicate that the recording began while the conversation was ongoing.
v1.0 Calltranscript Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/calltranscript-delta.md
+
+ Title: "callTranscript: delta"
+description: "Get a set of callTranscript resources that have been 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 that have been 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 a given user, and incremental synchronization that gets transcripts that have been 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 either:
+
+- 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`).
+
+State tokens are completely opaque to the client. To proceed with a round of change tracking, simply 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 that have been added after acquiring `@odata.deltaLink`..
+
+For more information, see the [delta query](/graph/delta-query-overview) documentation.
+
+## Permissions
+
+The following permissions are required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account)| Not supported |
+|Delegated (personal Microsoft account) | Not supported |
+|Application | OnlineMeetingTranscript.Read.All |
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+```http
+GET /users/{id}/onlineMeetings/getAllTranscripts/delta?$filter=meetingOrganizerId%20eq%20'{id}'
+```
+>**Note:** If you don't specify a **meetingOrganizerId**, the request fails.
+
+## 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, 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. |
+
+## Request headers
+| Header | Value |
+|||
+| Authorization | Bearer {token}. Required. |
+
+## 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'll do in the [next round to get additional transcripts](#example-2-next-round-to-get-additional-transcripts).
+
+#### Initial request
+
+In this example, the call transcripts are being synchronized for the first time, so the initial sync request does not include any state token. This round will return all transcripts available at the time.
+
+<!-- { "blockType": "ignored" } -->
+```http
+GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllTranscripts/delta?$filter=meetingOrganizerId%20eq%20'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.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.callTranscript",
+ "isCollection": true
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callTranscript)",
+ "@odata.count": 2,
+ "@odata.nextLink": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeeting/getAllTranscripts?$skiptoken=GGXvkS7mbjFAe9Uidm2D70e58K-BOnoJadAqkZEJmoLprr5eSP1hQPlb3dJ1AVz3xCYKxov6hSEJhsasyg",
+ "value":[
+ {
+ "@odata.type": "#microsoft.graph.callTranscript",
+ "meetingId": "MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19OMUUxWTFJME56QXRabVF5T0MxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy",
+ "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "transcriptContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19OMUUxWTFJME56QXRabVF5T0MxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy/transcripts/MSMjMCMjZDExYWQ2OGEtMWVhYS00MGFjLWJkZWItMTExNjMyNjExYzRl/content",
+ "createdDateTime": "2023-08-03T22:29:42.6514074Z",
+ "id": "MSMjMCMjZDExYWQ2OGEtMWVhYS00MGFjLWJkZWItMTExNjMyNjExYzRl"
+ },
+ {
+ "@odata.type": "#microsoft.graph.callTranscript",
+ "meetingId": "MSo4YjA5MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19OMUUxWTFJME56QXRabVF5T0MxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy",
+ "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "transcriptContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSo4YjA5MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19OMUUxWTFJME56QXRabVF5T0MxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy/transcripts/MSMjMCMjZDExYWQ3OGEtMWVhYS00MGFjLWJkZWItMTExNjMyNjExYzRl/content",
+ "createdDateTime": "2023-08-05T11:24:30.6414074Z",
+ "id": "MSMjMCMjZDExYWQ3OGEtMWVhYS00MGFjLWJkZWItMTExNjMyNjExYzRl"
+ }
+ ]
+}
+```
+
+#### 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/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeeting/getAllTranscripts?$skiptoken=GGXvkS7mbjFAe9Uidm2D70e58K-BOnoJadAqkZEJmoLprr5eSP1hQPlb3dJ1AVz3xCYKxov6hSEJhsasyg
+```
+
+#### Second response
+
+The second response returns the next 2 call transcripts and a `@odata.nextLink` property with a `skipToken` which indicates there are more transcripts.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.callTranscript",
+ "isCollection": true
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callTranscript)",
+ "@odata.count": 2,
+ "@odata.nextLink": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeeting/getAllTranscripts?$skiptoken=GGXve9Uidm2D70kS7mbjFAe58K-BOnPlb3dJ1AVz3xCYmoLprr5eSP1hQKxov6hSEJhsasyg",
+ "value":[
+ {
+ "@odata.type": "#microsoft.graph.callTranscript",
+ "meetingId": "MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19IMU4xMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy",
+ "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "transcriptContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19IMU4xMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy/transcripts/MSMjMCMjZDMzYWQzM2EtMmVhYS0zM2FjLWJkZWItMjMzNjMyNjExYzRl/content",
+ "createdDateTime": "2023-08-11T21:29:42.6514074Z",
+ "id": "MSMjMCMjZDMzYWQzM2EtMmVhYS0zM2FjLWJkZWItMjMzNjMyNjExYzRl"
+ },
+ {
+ "@odata.type": "#microsoft.graph.callTranscript",
+ "meetingId": "MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19BQkMxRDFEMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy",
+ "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "transcriptContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19BQkMxRDFEMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy/transcripts/MSMjMCMjZDIyYWQyMmEtMmVhYS0yMmFjLWJkZWItMjIyNjMyNjExYzRl/content",
+ "createdDateTime": "2023-08-12T11:24:30.6414074Z",
+ "id": "MSMjMCMjZDIyYWQyMmEtMmVhYS0yMmFjLWJkZWItMjIyNjMyNjExYzRl"
+ }
+ ]
+}
+```
+
+#### 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/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeeting/getAllTranscripts?$skiptoken=GGXve9Uidm2D70kS7mbjFAe58K-BOnPlb3dJ1AVz3xCYmoLprr5eSP1hQKxov6hSEJhsasyg
+```
+
+#### 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 have been 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
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callTranscript)",
+ "@odata.count": 1,
+ "@odata.deltaLink": "https://graph.microsoft.com/betik_JIC44iCZpv-GLiA2VnFuE5yG-kCEBROb2iaPT_y_eMWVQtBO_ejzzyIxl00ji-tQ3HzAbW4liZAVG88lO3nG_6-MBFoHY1n8y21YUzjocG-Cn1tCNeeLPLTzIe5Dw.EP9gLiCoF2CE_e6l_m1bTk2aokD9KcgfgfcLGqd1r_4",
+ "value":[
+ {
+ "@odata.type": "#microsoft.graph.callTranscript",
+ "meetingId": "MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19IMU4xMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy",
+ "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "transcriptContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19IMU4xMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy/transcripts/MSMjMCMjZDMzYWQzM2EtMmVhYS0zM2FjLWJkZWItMjMzNjMyNjExYzRl/content",
+ "createdDateTime": "2023-08-11T21:29:42.6514074Z",
+ "id": "MSMjMCMjZDMzYWQzM2EtMmVhYS0zM2FjLWJkZWItMjMzNjMyNjExYzRl"
+ }
+ ]
+}
+```
+
+### Example 2: Next round to get additional transcripts
+
+Using the `@odata.deltaLink` from the last request in the last round, you can get only those transcripts that have been added since the `@odata.deltaLink` was acquired.
+
+#### Request
+
+<!-- { "blockType": "ignored" } -->
+```http
+GET https://graph.microsoft.com/betik_JIC44iCZpv-GLiA2VnFuE5yG-kCEBROb2iaPT_y_eMWVQtBO_ejzzyIxl00ji-tQ3HzAbW4liZAVG88lO3nG_6-MBFoHY1n8y21YUzjocG-Cn1tCNeeLPLTzIe5Dw.EP9gLiCoF2CE_e6l_m1bTk2aokD9KcgfgfcLGqd1r_4
+```
++
+#### Response
+
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.callTranscript",
+ "isCollection": true
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(callTranscript)",
+ "@odata.deltaLink": "https://graph.microsoft.com/betik_JIC44iCZpv-GLiA2VnFuE5yG-kCEBROb2iaPT_yjz2nsMoh1gXNtXii7s78HapCi5woifXqwXlVNxICh8wUUnvE2gExsa8eZ2Vy_ch5rVIhm067_1mUPML3iYUVyg.3o0rhgaBUduuxOr98An5pjBDP5JjKUiVWku3flSiOsk",
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.callTranscript",
+ "meetingId": "MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19IMU4xMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy",
+ "meetingOrganizerId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "transcriptContentUrl": "https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/MSo4YjA4MWVmNi00NzkyLTRkZWYtYjJjOS1jMzYzYTFiZjQxZDUqMCoqMTk6bWVldGluZ19IMU4xMlgxSTBOekF0Wm1ReU8xQzIxMU5HWTFMV0UwTTJFdFpXTTFOVFkxWW1Rd05HTTBAdGhyZWFkLnYy/transcripts/MSMjMCMjZDMzYWQzM2EtMmVhYS0zM2FjLWJkZWItMjMzNjMyNjExYzRl/content",
+ "createdDateTime": "2023-08-11T21:29:42.6514074Z",
+ "id": "MSMjMCMjZDMzYWQzM2EtMmVhYS0zM2FjLWJkZWItMjMzNjMyNjExYzRl"
+ }
+ ]
+}
+```
v1.0 Calltranscript Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/calltranscript-get.md
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/
[!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)
v1.0 Channel Post https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/channel-post.md
Content-type: application/json
+> **Note:** To add a guest account to the channel, for the **roles** property, use the value `guest`.
+ #### Response The following is an example of the response.
Content-Type: application/json
[!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)
Content-type: application/json
+> **Note:** To add a guest account to the channel, for the **roles** property, use the value `guest`.
+ #### Response The following is an example of the response.
Content-type: application/json
[!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)
Content-type: application/json
+> **Note:** To add a guest account to the channel, for the **roles** property, use the value `guest`.
+ #### Response The following is an example of the response.
v1.0 Channel Provisionemail https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/channel-provisionemail.md
POST https://graph.microsoft.com/beta/teams/893075dd-2487-4122-925f-022c42e20265
[!INCLUDE [sample-code](../includes/snippets/php/channel-provisionemail-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/channel-provisionemail-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Chat Delete Members https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/chat-delete-members.md
DELETE https://graph.microsoft.com/beta/chats/19:cf66807577b149cca1b7af0c32eec12
[!INCLUDE [sample-code](../includes/snippets/php/delete-members-from-chat-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-members-from-chat-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Chat Delete Tabs https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/chat-delete-tabs.md
DELETE https://graph.microsoft.com/beta/chats/19:ea28e88c00e94c7786b065394a61f29
[!INCLUDE [sample-code](../includes/snippets/php/delete-tab-in-chat-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-tab-in-chat-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Chat Get Installedapps https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/chat-get-installedapps.md
GET https://graph.microsoft.com/beta/chats/19%5bd86ec7f6b247d3b9e519b0bfef5d03%4
[!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)
v1.0 Chat Get Tabs https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/chat-get-tabs.md
GET https://graph.microsoft.com/beta/chats/19:ea28e88c00e94c7786b065394a61f296@t
[!INCLUDE [sample-code](../includes/snippets/php/get-tab-in-chat-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-tab-in-chat-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Chat Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/chat-get.md
GET https://graph.microsoft.com/beta/chats/19:b8577894a63548969c5c92bb9c80c5e1@t
[!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)
v1.0 Chat Hideforuser https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/chat-hideforuser.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/chat-hideforuser-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/chat-hideforuser-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Chat List Messages https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/chat-list-messages.md
GET https://graph.microsoft.com/beta/chats/19:2da4c29f6d7041eca70b638b43d45437@t
[!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)
v1.0 Chat List Operations https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/chat-list-operations.md
GET https://graph.microsoft.com/beta/chats/19:c253a29b5f694b55a6baad8e83510af7@t
[!INCLUDE [sample-code](../includes/snippets/php/list-chat-operations-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-chat-operations-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Chat List Permissiongrants https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/chat-list-permissiongrants.md
Content-type: application/json
``` ## See also-- [List permission grants of a team](team-list-permissionGrants.md)-- [List permission grants of a group](group-list-permissionGrants.md)+
+- [List permission grants of a group](group-list-permissiongrants.md)
+- [List permission grants of a team](team-list-permissiongrants.md)
+- [List permission grants of a user](user-list-permissiongrants.md)
v1.0 Chat List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/chat-list.md
Content-type: application/json
] } -->+
+### Example 6: List all chats where the app is installed
+
+#### Request
+
+The following is an example of the request.
++
+```http
+GET https://graph.microsoft.com/beta/users/e652dd92-dd63-4fcc-b5b2-2005681e8e9f/chats?$filter=installedApps/any(a:a/teamsApp/id eq '608d8644-acb1-4ab0-bca5-66fbb6ed62aa')
+```
+++
+#### Response
+
+The following is an example of the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#chats",
+ "@odata.count": 1,
+ "value": [
+ {
+ "id": "19:e652dd92-dd63-4fcc-b5b2-2005681e8e9f_734601fc-bbcd-4a30-9092-3c89f8d788cb@unq.gbl.spaces",
+ "topic": null,
+ "createdDateTime": "2023-03-03T11:32:33.631Z",
+ "lastUpdatedDateTime": "2023-06-08T06:02:19.072Z",
+ "chatType": "oneOnOne",
+ "webUrl": "https://teams.microsoft.com/l/chat/19%3Ae652dd92-dd63-4fcc-b5b2-2005681e8e9f_734601fc-bbcd-4a30-9092-3c89f8d788cb%40unq.gbl.spaces/0?tenantId=aa923623-ae61-49ee-b401-81f414b6ad5a",
+ "tenantId": "aa923623-ae61-49ee-b401-81f414b6ad5a",
+ "onlineMeetingInfo": null,
+ "viewpoint": {
+ "isHidden": false,
+ "lastMessageReadDateTime": "2023-06-29T10:22:15.024Z"
+ }
+ }
+ ]
+
+}
+```
v1.0 Chat Patch Tabs https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/chat-patch-tabs.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-tabs-in-chat-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-tabs-in-chat-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Chat Post Installedapps https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/chat-post-installedapps.md
Content-Type: application/json
[!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)
v1.0 Chat Post Messages https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/chat-post-messages.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/post-chatmessages-1-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-chatmessages-1-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Chat Post https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/chat-post.md
Content-Type: application/json
[!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)
v1.0 Chat Sendactivitynotification https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/chat-sendactivitynotification.md
Content-Type: application/json
[!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)
Content-Type: application/json
[!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)
v1.0 Chatmessage Post https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/chatmessage-post.md
Content-type: application/json
[!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)
v1.0 Chatmessage Softdelete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/chatmessage-softdelete.md
POST https://graph.microsoft.com/beta/teams/172b0cce-e65d-44ce-9a49-91d9f2e8593a
[!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)
v1.0 Chatmessagehostedcontent Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/chatmessagehostedcontent-get.md
GET https://graph.microsoft.com/beta/chats/19:2da4c29f6d7041eca70b638b43d45437@t
[!INCLUDE [sample-code](../includes/snippets/php/get-hostedcontentchatmessage-1-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-hostedcontentchatmessage-1-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
GET https://graph.microsoft.com/beta/chats/19:2da4c29f6d7041eca70b638b43d45437@t
[!INCLUDE [sample-code](../includes/snippets/php/get-hostedcontentchatmessage-2-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-hostedcontentchatmessage-2-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Checklistitem Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/checklistitem-get.md
GET https://graph.microsoft.com/beta/me/todo/lists/AAMkADliMmU5YjJlLTVmMmQtNGQzN
[!INCLUDE [sample-code](../includes/snippets/php/get-checklistitem-1-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-checklistitem-1-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
GET https://graph.microsoft.com/beta/me/tasks/lists/AAMkADliMmU5YjJlLTVmMmQtNGQz
[!INCLUDE [snippet-not-available](../includes/snippets/snippet-not-available.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [Python](#tab/python) [!INCLUDE [snippet-not-available](../includes/snippets/snippet-not-available.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Claimsmappingpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/claimsmappingpolicy-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-claimsmappingpolicy-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-claimsmappingpolicy-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Cloudpc Endgraceperiod https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/cloudpc-endgraceperiod.md
POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/
[!INCLUDE [sample-code](../includes/snippets/php/endgraceperiod-cloudpc-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/endgraceperiod-cloudpc-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Cloudpc Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/cloudpc-get.md
GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/9
[!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)
v1.0 Cloudpc Getshiftworkcloudpcaccessstate https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/cloudpc-getshiftworkcloudpcaccessstate.md
GET https://graph.microsoft.com/beta/me/cloudPCs/{cloudPCId}/getShiftWorkCloudPc
[!INCLUDE [sample-code](../includes/snippets/php/cloudpcgetshiftworkcloudpcaccessstate-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/cloudpcgetshiftworkcloudpcaccessstate-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Cloudpc Getsupportedcloudpcremoteactions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/cloudpc-getsupportedcloudpcremoteactions.md
GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/8
[!INCLUDE [sample-code](../includes/snippets/php/cloudpc-getsupportedcloudpcremoteactions-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-getsupportedcloudpcremoteactions-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Cloudpc Retrypartneragentinstallation https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/cloudpc-retrypartneragentinstallation.md
POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/
[!INCLUDE [sample-code](../includes/snippets/php/cloudpc-retrypartneragentinstallation-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-retrypartneragentinstallation-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Cloudpcauditevent Getauditactivitytypes https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/cloudpcauditevent-getauditactivitytypes.md
GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/auditEvent
[!INCLUDE [sample-code](../includes/snippets/php/cloudpcauditevent-getauditactivitytypes-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/cloudpcauditevent-getauditactivitytypes-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Cloudpconpremisesconnection Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/cloudpconpremisesconnection-delete.md
DELETE https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/onPremi
[!INCLUDE [sample-code](../includes/snippets/php/delete-onpremisesconnections-from-virtualendpoint-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-onpremisesconnections-from-virtualendpoint-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Cloudpconpremisesconnection Updateaddomainpassword https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/cloudpconpremisesconnection-updateaddomainpassword.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/cloudpconpremisesconnection-updateaddomainpassword-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/cloudpconpremisesconnection-updateaddomainpassword-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Cloudpcprovisioningpolicy Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/cloudpcprovisioningpolicy-delete.md
DELETE https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/provisi
[!INCLUDE [sample-code](../includes/snippets/php/delete-provisioningpolicies-from-virtualendpoint-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-provisioningpolicies-from-virtualendpoint-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Cloudpcreports Getremoteconnectionhistoricalreports https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/cloudpcreports-getremoteconnectionhistoricalreports.md
Content-length: 199
[!INCLUDE [sample-code](../includes/snippets/php/cloudpcreportsthisgetremoteconnectionhistoricalreports-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/cloudpcreportsthisgetremoteconnectionhistoricalreports-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/mainapi-reference/beta/api/cloudpcshareduseserviceplan-get.md
GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/sharedUseS
[!INCLUDE [sample-code](../includes/snippets/php/get-cloudpcshareduseserviceplan-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-cloudpcshareduseserviceplan-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Conditionalaccesspolicy Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/conditionalaccesspolicy-delete.md
Title: "Delete conditionalAccessPolicy" description: "Delete a conditionalAccessPolicy." ms.localizationpriority: medium-+ ms.prod: "identity-and-sign-in" doc_type: apiPageType
v1.0 Conditionalaccesspolicy Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/conditionalaccesspolicy-get.md
Title: "Get conditionalAccessPolicy" description: "Retrieve the properties and relationships of a conditionalAccessPolicy object." ms.localizationpriority: medium-+ ms.prod: "identity-and-sign-in" doc_type: apiPageType
v1.0 Conditionalaccesspolicy Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/conditionalaccesspolicy-update.md
Title: "Update conditionalAccessPolicy" description: "Update the properties of a conditionalAccessPolicy object." ms.localizationpriority: medium-+ ms.prod: "identity-and-sign-in" doc_type: apiPageType
v1.0 Conditionalaccessroot List Authenticationcontextclassreferences https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/conditionalaccessroot-list-authenticationcontextclassreferences.md
Title: "List authenticationContextClassReferences" description: "Retrieve a list of authenticationContextClassReference objects." ms.localizationpriority: medium-+ ms.prod: "identity-and-sign-in" doc_type: apiPageType
v1.0 Conditionalaccessroot List Namedlocations https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/conditionalaccessroot-list-namedlocations.md
Title: "List namedLocations" description: "Get a list of namedLocation objects." ms.localizationpriority: medium-+ ms.prod: "identity-and-sign-in" doc_type: apiPageType
GET https://graph.microsoft.com/beta/identity/conditionalAccess/namedLocations?$
[!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)
v1.0 Conditionalaccessroot List Policies https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/conditionalaccessroot-list-policies.md
Title: "List policies" description: "Retrieve a list of conditionalAccessPolicy objects." ms.localizationpriority: medium-+ ms.prod: "identity-and-sign-in" doc_type: apiPageType
v1.0 Conditionalaccessroot Post Authenticationcontextclassreferences https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/conditionalaccessroot-post-authenticationcontextclassreferences.md
Title: "Create authenticationContextClassReference" description: "Create a new authenticationContextClassReference." ms.localizationpriority: medium-+ ms.prod: "identity-and-sign-in" doc_type: apiPageType
v1.0 Conditionalaccessroot Post Namedlocations https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/conditionalaccessroot-post-namedlocations.md
Title: "Create namedLocation" description: "Create a new namedLocation." ms.localizationpriority: medium-+ ms.prod: "identity-and-sign-in" doc_type: apiPageType
v1.0 Conditionalaccessroot Post Policies https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/conditionalaccessroot-post-policies.md
Title: "Create conditionalAccessPolicy" description: "Create a new conditionalAccessPolicy." ms.localizationpriority: medium-+ ms.prod: "identity-and-sign-in" doc_type: apiPageType
Content-type: application/json
[!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)
v1.0 Connectedorganization Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/connectedorganization-get.md
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/co
[!INCLUDE [sample-code](../includes/snippets/php/get-connectedorganization-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-connectedorganization-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Connectedorganization Post Externalsponsors https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/connectedorganization-post-externalsponsors.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-externalsponsor-from-connectedorganization-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-externalsponsor-from-connectedorganization-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Connector Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/connector-get.md
Title: "Get connector" description: "Retrieve the properties of a connector object." ms.localizationpriority: medium-+ ms.prod: "applications" doc_type: "apiPageType"
v1.0 Connector List Memberof https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/connector-list-memberof.md
Title: "List memberOf" description: "Retrieve the connectorgroup the connector is a member of." ms.localizationpriority: medium-+ ms.prod: "applications" doc_type: "apiPageType"
GET https://graph.microsoft.com/beta/onPremisesPublishingProfiles/applicationPro
[!INCLUDE [sample-code](../includes/snippets/php/connector-get-memberof-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/connector-get-memberof-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Connector List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/connector-list.md
Title: "List connectors" description: "Retrieve a list of connector objects." ms.localizationpriority: medium-+ ms.prod: "applications" doc_type: "apiPageType"
v1.0 Connector Post Memberof https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/connector-post-memberof.md
Title: "Add Connector to connectorGroup" description: "Use this API to add a connector to a new connectorGroup." ms.localizationpriority: medium-+ ms.prod: "applications" doc_type: "apiPageType"
v1.0 Connectorgroup Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/connectorgroup-delete.md
Title: "Delete connectorGroup" description: "Delete a connectorGroup." ms.localizationpriority: medium-+ ms.prod: "applications" doc_type: "apiPageType"
v1.0 Connectorgroup Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/connectorgroup-get.md
Title: "Get connectorGroup" description: "Retrieve the properties of a connectorGroup object." ms.localizationpriority: medium-+ ms.prod: "applications" doc_type: "apiPageType"
v1.0 Connectorgroup List Applications https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/connectorgroup-list-applications.md
Title: "List applications" description: "Retrieve a list of application objects associated with the connectorGroup." ms.localizationpriority: medium-+ ms.prod: "applications" doc_type: "apiPageType"
v1.0 Connectorgroup List Members https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/connectorgroup-list-members.md
Title: "List members" description: "Retrieve a list of connector objects associated with a connectorGroup." ms.localizationpriority: medium-+ ms.prod: "applications" doc_type: "apiPageType"
v1.0 Connectorgroup List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/connectorgroup-list.md
Title: "List connectorGroups" description: "Retrieve a list of connectorgroup objects." ms.localizationpriority: medium-+ ms.prod: "applications" doc_type: "apiPageType"
GET https://graph.microsoft.com/beta/onPremisesPublishingProfiles/applicationPro
[!INCLUDE [sample-code](../includes/snippets/php/get-connectorgroups-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-connectorgroups-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Connectorgroup Post Applications https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/connectorgroup-post-applications.md
Title: "Assign a connectorGroup to an application" description: "Use this API to assign a connectorGroup to an application" ms.localizationpriority: medium-+ ms.prod: "applications" doc_type: "apiPageType"
v1.0 Connectorgroup Post Connectorgroups https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/connectorgroup-post-connectorgroups.md
Title: "Create connectorGroup" description: "Use this API to create a new connectorGroup." ms.localizationpriority: medium-+ ms.prod: "applications" doc_type: "apiPageType"
v1.0 Connectorgroup Post Members https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/connectorgroup-post-members.md
Title: "Add connector to connectorGroup" description: "Use this API to add a connector to a connectorGroup." ms.localizationpriority: medium-+ ms.prod: "applications" doc_type: "apiPageType"
v1.0 Connectorgroup Post https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/connectorgroup-post.md
Title: "Create connectorGroup" description: "Create a connectorGroup object." ms.localizationpriority: medium-+ ms.prod: "applications" doc_type: "apiPageType"
v1.0 Connectorgroup Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/connectorgroup-update.md
Title: "Update connectorGroups" description: "Update the properties of connectorgroup object." ms.localizationpriority: medium-+ ms.prod: "applications" doc_type: "apiPageType"
v1.0 Contactfolder List Childfolders https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/contactfolder-list-childfolders.md
GET https://graph.microsoft.com/beta/me/contactFolders/{id}/childFolders
[!INCLUDE [sample-code](../includes/snippets/php/contactfolder-get-childfolders-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/contactfolder-get-childfolders-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Contactfolder List Contacts https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/contactfolder-list-contacts.md
GET https://graph.microsoft.com/beta/me/contactFolders/{id}/contacts
[!INCLUDE [sample-code](../includes/snippets/php/contactfolder-get-contacts-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/contactfolder-get-contacts-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Contenttype Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/contenttype-get.md
GET https://graph.microsoft.com/beta/sites/{site-id}/contentTypes/{contentType-i
[!INCLUDE [sample-code](../includes/snippets/php/get-contenttype-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-contenttype-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Contenttype Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/contenttype-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-contenttype-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-contenttype-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Contract List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/contract-list.md
GET https://graph.microsoft.com/beta/contracts
[!INCLUDE [sample-code](../includes/snippets/php/get-contract-2-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-contract-2-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Conversationmember Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/conversationmember-update.md
content-length: 26
[!INCLUDE [sample-code](../includes/snippets/php/update-conversation-member-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-conversation-member-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/mainapi-reference/beta/api/conversationmembers-add.md
Content-Type: application/json
[!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)
v1.0 Conversationthread Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/conversationthread-get.md
GET https://graph.microsoft.com/beta/groups/{id}/threads/{id}
[!INCLUDE [sample-code](../includes/snippets/php/get-conversationthread-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-conversationthread-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Countrynamedlocation Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/countrynamedlocation-delete.md
Title: "Delete countryNamedLocation" description: "Delete a countryNamedLocation object." ms.localizationpriority: medium-+ ms.prod: "identity-and-sign-in" doc_type: apiPageType
v1.0 Countrynamedlocation Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/countrynamedlocation-get.md
Title: "Get countryNamedLocation" description: "Retrieve the properties and relationships of a countryNamedlocation object." ms.localizationpriority: medium-+ ms.prod: "identity-and-sign-in" doc_type: apiPageType
v1.0 Countrynamedlocation Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/countrynamedlocation-update.md
Title: "Update countryNamedlocation" description: "Update the properties of a countryNamedLocation object." ms.localizationpriority: medium-+ ms.prod: "identity-and-sign-in" doc_type: apiPageType
v1.0 Crosstenantaccesspolicyconfigurationdefault Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/crosstenantaccesspolicyconfigurationdefault-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-crosstenantaccesspolicyconfigurationdefault-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-crosstenantaccesspolicyconfigurationdefault-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Crosstenantaccesspolicyconfigurationpartner Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/crosstenantaccesspolicyconfigurationpartner-update.md
Content-Type: application/json
[!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)
v1.0 Crosstenantidentitysyncpolicypartner Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/crosstenantidentitysyncpolicypartner-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-crosstenantidentitysyncpolicypartner-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-crosstenantidentitysyncpolicypartner-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Customsecurityattributedefinition Post Allowedvalues https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/customsecurityattributedefinition-post-allowedvalues.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-allowedvalue-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-allowedvalue-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Delegatedadminrelationship Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/delegatedadminrelationship-delete.md
If-Match: W/"JyI0NzAwNjg0NS0wMDAwLTE5MDAtMDAwMC02MGY0Yjg4MzAwMDAiJw=="
[!INCLUDE [sample-code](../includes/snippets/php/delete-delegatedadminrelationship-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-delegatedadminrelationship-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Delegatedadminrelationship List Operations https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/delegatedadminrelationship-list-operations.md
GET https://graph.microsoft.com/beta/tenantRelationships/delegatedAdminRelations
[!INCLUDE [sample-code](../includes/snippets/php/list-delegatedadminrelationshipoperation-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-delegatedadminrelationshipoperation-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Device List Transitivememberof https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/device-list-transitivememberof.md
GET https://graph.microsoft.com/beta/devices/{id}/transitiveMemberOf
[!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)
ConsistencyLevel: eventual
[!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)
v1.0 Directory Deleteditems Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/directory-deleteditems-get.md
GET https://graph.microsoft.com/beta/directory/deleteditems/46cc6179-19d0-473e-9
[!INCLUDE [sample-code](../includes/snippets/php/get-directory-deleteditem-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-directory-deleteditem-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Directory List Administrativeunits https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/directory-list-administrativeunits.md
GET https://graph.microsoft.com/beta/administrativeUnits
[!INCLUDE [sample-code](../includes/snippets/php/get-administrativeunits-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-administrativeunits-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Directory List Customsecurityattributedefinitions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/directory-list-customsecurityattributedefinitions.md
GET https://graph.microsoft.com/beta/directory/customSecurityAttributeDefinition
[!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)
v1.0 Directory List Recommendation https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/directory-list-recommendation.md
Title: "List recommendations" description: "Get a list of the recommendation objects and their properties."-+ ms.localizationpriority: medium doc_type: apiPageType
v1.0 Directoryaudit Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/directoryaudit-get.md
Title: "Get directoryAudit" description: "Describes the get method of the directoryAudit resource (entity) from the Microsoft Graph API (beta version)." ms.localizationpriority: medium-+ ms.prod: "identity-and-access-reports" doc_type: apiPageType
v1.0 Directoryaudit List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/directoryaudit-list.md
Title: "List directoryAudits" description: "Get the list of audit logs generated by Azure Active Directory (Azure AD)." ms.localizationpriority: medium-+ ms.prod: "identity-and-access-reports" doc_type: apiPageType
GET https://graph.microsoft.com/beta/auditLogs/directoryAudits
[!INCLUDE [sample-code](../includes/snippets/php/get-directoryaudits-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-directoryaudits-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Directoryobject Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/directoryobject-delete.md
DELETE https://graph.microsoft.com/beta/directoryObjects/ffab4dce-9b82-49a6-b7c7
[!INCLUDE [sample-code](../includes/snippets/php/delete-directoryobject-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-directoryobject-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Directoryobject Getmembergroups https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/directoryobject-getmembergroups.md
Namespace: microsoft.graph
Return all the group IDs for the groups that the specified [user](../resources/user.md), [group](../resources/group.md), [service principal](../resources/serviceprincipal.md), [organizational contact](../resources/orgcontact.md), [device](../resources/device.md), or [directory object](../resources/directoryobject.md) is a member of. This function is transitive.
+This API returns up to 11,000 group IDs. If more than 11,000 results are available, it returns a `400 Bad Request` error with the `Directory_ResultSizeLimitExceeded` error code. As a workaround, use the [List group transitive memberOf](../api/group-list-transitivememberof.md) API.
+ ## 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).
POST /devices/{id}/getMemberGroups
## Request body In the request body, provide a JSON object with the following parameters.
-| Parameter | Type |Description|
+| Parameter | Type |Description|
|:|:--|:-| |securityEnabledOnly|Boolean| `true` to specify that only security groups that the entity is a member of should be returned; `false` to specify that all groups and directory roles that the entity is a member of should be returned. `true` can be specified only for users or service principals to return security-enabled groups. |
Content-type: application/json
[!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)
v1.0 Directoryrole List Scopedmembers https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/directoryrole-list-scopedmembers.md
GET https://graph.microsoft.com/beta/directoryRoles/41d12a2f-caa8-4e3e-ba14-05e5
[!INCLUDE [sample-code](../includes/snippets/php/get-scopedmembers-directoryrole-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-scopedmembers-directoryrole-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Directoryrole List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/directoryrole-list.md
GET https://graph.microsoft.com/beta/directoryRoles
[!INCLUDE [sample-code](../includes/snippets/php/get-directoryroles-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-directoryroles-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Directoryrole Post Directoryroles https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/directoryrole-post-directoryroles.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-directoryrole-from-directoryroles-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-directoryrole-from-directoryroles-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Directoryrole Post Members https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/directoryrole-post-members.md
Content-type: application/json
[!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)
v1.0 Directoryroletemplate List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/directoryroletemplate-list.md
GET https://graph.microsoft.com/beta/directoryRoleTemplates
[!INCLUDE [sample-code](../includes/snippets/php/get-directoryroletemplates-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-directoryroletemplates-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Directorysetting Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/directorysetting-delete.md
Title: "Delete directorySetting" description: "Delete a directory setting."-+ ms.localizationpriority: medium ms.prod: "directory-management" doc_type: apiPageType
v1.0 Directorysetting Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/directorysetting-get.md
Title: "Get directorySetting" description: "Retrieve the properties of a specific directory setting object."-+ ms.localizationpriority: medium ms.prod: "directory-management" doc_type: apiPageType
GET https://graph.microsoft.com/beta/settings/f0b2d6f5-097d-4177-91af-a24e530b53
[!INCLUDE [sample-code](../includes/snippets/php/get-directorysetting-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-directorysetting-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Directorysetting Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/directorysetting-update.md
Title: "Update directorySetting" description: "Update the properties of a specific directory setting object."-+ ms.localizationpriority: medium ms.prod: "directory-management" doc_type: apiPageType
PATCH /groups/{groupId}/settings/{directorySettingId}
## Request body In the request body, supply the values for relevant fields that should be updated.
-| Property | Type |Description|
+| Property | Type |Description|
|:|:--|:-| | values | [settingValue](../resources/settingvalue.md) collection | The updated set of values. NOTE: You must supply the entire collection set. You cannot update a single set of values. |
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-directorysetting-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-directorysetting-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Directorysettingtemplate Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/directorysettingtemplate-get.md
Title: "Get a directory setting template" description: "Allows retrieval of the properties of the directorySettingTemplate object, including the available settings and their defaults." ms.localizationpriority: medium-+ ms.prod: "directory-management" doc_type: apiPageType
v1.0 Directorysettingtemplate List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/directorysettingtemplate-list.md
Title: "List directorySettingTemplates" description: "This operation retrieves the list of available directorySettingTemplates objects." ms.localizationpriority: medium-+ ms.prod: "directory-management" doc_type: apiPageType
v1.0 Documentsetversion Restore https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/documentsetversion-restore.md
POST https://graph.microsoft.com/beta/sites/root/lists/Documents/items/2/documen
[!INCLUDE [sample-code](../includes/snippets/php/documentsetversionthisrestore-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/documentsetversionthisrestore-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Domain List Domainnamereferences https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/domain-list-domainnamereferences.md
GET https://graph.microsoft.com/beta/domains/contoso.com/domainNameReferences
[!INCLUDE [sample-code](../includes/snippets/php/get-domainnamereferences-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-domainnamereferences-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Domain List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/domain-list.md
GET https://graph.microsoft.com/beta/domains
[!INCLUDE [sample-code](../includes/snippets/php/get-domains-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-domains-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Drive Get Specialfolder https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/drive-get-specialfolder.md
-+ description: "Use the special collection to access a special folder by name." Title: Get Special Folders ms.localizationpriority: medium
This method returns a `200 OK` response code and a [driveItem](../resources/driv
You can use this method of addressing a special folder inline with additional calls to properties or relationships on the driveItem.
-## Examples
+## Examples
### Example 1: Get special folder by name
v1.0 Drive Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/drive-get.md
-+ description: "Retrieve the properties and relationships of a Drive resource." Last updated 09/10/2017 Title: Get Drive
v1.0 Drive List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/drive-list.md
-+ description: "Retrieve the list of Drive resources available for a target User, Group, or Site." Last updated 09/10/2017 Title: List Drives
GET /me/drives
### Response
-<!-- { "blockType": "response",
+<!-- { "blockType": "response",
"@odata.type": "Collection(microsoft.graph.drive)", "truncated": true } -->
v1.0 Drive Post Bundles https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/drive-post-bundles.md
-+ Title: Create bundle description: Create a bundle of driveItems ms.localizationpriority: medium
v1.0 Drive Recent https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/drive-recent.md
-+ description: "List a set of items that have been recently used by the signed in user." Last updated 09/10/2017 Title: List Recent Files
GET /me/drive/recent
[!INCLUDE [sample-code](../includes/snippets/php/view-recent-files-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/view-recent-files-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
GET /me/drive/recent
### Response
-<!-- {
+<!-- {
"blockType": "response", "@odata.type": "Collection(microsoft.graph.driveItem)", "truncated": true
Content-Type: application/json
## Remarks
-Some driveItems returned from the **recent** action will include the **remoteItem** facet which indicates they are items from another drive.
+Some driveItems returned from the **recent** action will include the **remoteItem** facet which indicates they are items from another drive.
To access the original driveItem object, you will need to make a request using the information provided in **remoteItem** in the following format: <!-- { "blockType": "ignored", "name": "drives-get-remoteitem" } -->
v1.0 Drive Sharedwithme https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/drive-sharedwithme.md
-+ description: "Get a list of driveItem objects that have been shared with the owner of a drive." Title: "drive: sharedWithMe" ms.localizationpriority: medium
v1.0 Driveitem Checkin https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/driveitem-checkin.md
-+ description: "Check in a checked out DriveItem resource, which makes the version of the document available to others." Title: "driveItem: checkin" ms.localizationpriority: medium
v1.0 Driveitem Checkout https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/driveitem-checkout.md
-+ description: "Check out a driveItem resource to prevent others from editing the document, and your changes from being visible until the documented is checked-in." Title: "driveItem: checkout" ms.localizationpriority: medium
v1.0 Driveitem Copy https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/driveitem-copy.md
-+ description: "Asynchronously creates a copy of an [driveItem][item-resource] (including any children), under a new parent item or with a new name." Last updated 09/10/2017 Title: "driveItem: copy"
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/copy-item-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/copy-item-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Driveitem Createlink https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/driveitem-createlink.md
-+ description: "You can use createLink action to share a DriveItem via a sharing link." Title: "driveItem: createLink" ms.localizationpriority: medium
v1.0 Driveitem Createuploadsession https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/driveitem-createuploadsession.md
-+ description: "Create an upload session to allow your app to upload files up to the maximum file size." Title: "driveItem: createUploadSession" ms.localizationpriority: medium
The following example controls the behavior if the filename is already taken, an
### Request
-The response to this request will provide the details of the newly created [uploadSession](../resources/uploadsession.md), which includes the URL used for uploading the parts of the file.
+The response to this request will provide the details of the newly created [uploadSession](../resources/uploadsession.md), which includes the URL used for uploading the parts of the file.
>**Note:** The {item-path} must contain the name of the item that's specified in the request body.
You can upload the entire file, or split the file into multiple byte ranges, as
The fragments of the file must be uploaded sequentially in order. Uploading fragments out of order will result in an error.
-**Note:** If your app splits a file into multiple byte ranges, the size of each byte range **MUST** be a multiple of 320 KiB (327,680 bytes).
+**Note:** If your app splits a file into multiple byte ranges, the size of each byte range **MUST** be a multiple of 320 KiB (327,680 bytes).
Using a fragment size that does not divide evenly by 320 KiB will result in errors committing some files. ### Example
Content-Type: application/json
``` Your app can use the **nextExpectedRanges** value to determine where to start the next byte range.
-You may see multiple ranges specified, indicating parts of the file that the server has not yet received.
+You may see multiple ranges specified, indicating parts of the file that the server has not yet received.
This is useful if you need to resume a transfer that was interrupted and your client is unsure of the state on the service.
-You should always determine the size of your byte ranges according to the best practices below.
+You should always determine the size of your byte ranges according to the best practices below.
Do not assume that **nextExpectedRanges** will return ranges of proper size for a byte range to upload. The **nextExpectedRanges** property indicates ranges of the file that have not been received and not a pattern for how your app should upload the file.
Content-Type: application/json
* The `nextExpectedRanges` property won't always list all of the missing ranges. * On successful fragment writes, it will return the next range to start from (eg. "523-").
-* On failures when the client sent a fragment the server had already received, the server will respond with `HTTP 416 Requested Range Not Satisfiable`.
+* On failures when the client sent a fragment the server had already received, the server will respond with `HTTP 416 Requested Range Not Satisfiable`.
You can [request upload status](#resuming-an-in-progress-upload) to get a more detailed list of missing ranges. * Including the Authorization header when issuing the `PUT` call may result in a `HTTP 401 Unauthorized` response. The Authorization header and bearer token should only be sent when issuing the `POST` during the first step. It should be not be included when issueing the `PUT`.
Now that your app knows where to start the upload from, resume the upload by fol
## Handle upload errors
-When the last byte range of a file is uploaded, it is possible for an error to occur.
+When the last byte range of a file is uploaded, it is possible for an error to occur.
This can be due to a name conflict or quota limitation being exceeded. The upload session will be preserved until the expiration time, which allows your app to recover the upload by explicitly committing the upload session.
v1.0 Driveitem Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/driveitem-delete.md
-+ description: "Delete a DriveItem by using its ID or path." Last updated 09/10/2017 Title: Delete a file or folder
v1.0 Driveitem Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/driveitem-delta.md
-+ description: "Track changes in a drive item and its children over time." Last updated 09/10/2017 Title: "driveItem: delta"
Namespace: microsoft.graph
Track changes in a [driveItem](../resources/driveitem.md) and its children over time.
-Your app begins by calling `delta` without any parameters.
+Your app begins by calling `delta` without any parameters.
The service starts enumerating the drive's hierarchy, returning pages of items and either an `@odata.nextLink` or an `@odata.deltaLink`, as described below. Your app should continue calling with the `@odata.nextLink` until you no longer see an `@odata.nextLink` returned, or you see a response with an empty set of changes. After you have finished receiving all the changes, you may apply them to your local state. To check for changes in the future, call `delta` again with the `@odata.deltaLink` from the previous response.
-Deleted items are returned with the [`deleted` facet](../resources/deleted.md).
-Items with this property set should be removed from your local state.
+Deleted items are returned with the [`deleted` facet](../resources/deleted.md).
+Items with this property set should be removed from your local state.
**Note:** you should only delete a folder locally if it is empty after syncing all the changes.
This can be useful if your app only wants to know about changes, and doesn't nee
To retrieve the latest deltaLink, call `delta` with a query string parameter `?token=latest`. > **Note:** If you are trying to maintain a full local representation of the items in a folder or a drive, you must use `delta` for the initial enumeration.
-Other approaches, such as paging through the `children` collection of a folder, are not guaranteed to return every single item if any writes take place during the enumeration.
+Other approaches, such as paging through the `children` collection of a folder, are not guaranteed to return every single item if any writes take place during the enumeration.
Using `delta` is the only way to guarantee that you've read all of the data you need to. #### Request
GET /me/drive/root/delta?token=2021-09-29T20%3A00%3A00Z
[!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)
Content-type: application/json
* Delta query will not return some DriveItem properties, depending on the operation and service type, as shown in the following tables. **OneDrive for Business**
-
+ | Operation type | Properties omitted by delta query | ||-| | Create/Modify | `ctag` |
Content-type: application/json
**OneDrive (consumer)**
-
+ | Operation type | Properties omitted by delta query | ||-| | Create/Modify | n/a |
v1.0 Driveitem Get Content Format https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/driveitem-get-content-format.md
-+ description: "Use this API to retrieve the contents of an item in a specific format." Last updated 09/10/2017 Title: Convert to other formats
v1.0 Driveitem Get Content https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/driveitem-get-content.md
-+ description: "Download the contents of the primary stream (file) of a driveItem. Only driveItems with the file property can be downloaded." Title: Download a file ms.localizationpriority: medium
v1.0 Driveitem Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/driveitem-get.md
-+ description: "Retrieve the metadata for a DriveItem in a Drive by file system path or ID." Title: Get driveItem ms.localizationpriority: medium
v1.0 Driveitem Invite https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/driveitem-invite.md
-+ description: "Sends a sharing invitation for a DriveItem." Last updated 09/10/2017 Title: Send an invite to access an item
When inviting multiple recipients, it's possible for the notification to succeed
In this case, the service returns a partial success response with an HTTP status code of 207. When partial success is returned, the response for each failed recipient will contain an `error` object with information about what went wrong and how to fix it.
-Here is an example of the partial response.
+Here is an example of the partial response.
<!-- { "blockType": "response", "@odata.type": "Collection(microsoft.graph.permission)", "truncated": true } -->
Content-type: application/json
"message":"Account verification needed to unblock sending emails.", "localizedMessage": "Kontobestätigung erforderlich, um das Senden von E-Mails zu entsperren.", "fixItUrl":"http://g.live.com/8SESkydrive/VerifyAccount",
- "innererror":{
- "code":"accountVerificationRequired"
+ "innererror":{
+ "code":"accountVerificationRequired"
} } },
Content-type: application/json
} ``` ### SendNotification errors
-The following are some additional errors that your app might encounter within the nested `innererror` objects when sending notification fails.
+The following are some additional errors that your app might encounter within the nested `innererror` objects when sending notification fails.
Apps are not required to handle these. | Code | Description
v1.0 Driveitem List Children https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/driveitem-list-children.md
-+ description: "Return a collection of DriveItems in the children relationship of a DriveItem." Last updated 09/10/2017 Title: List the contents of a folder
GET /drives/{drive-id}/root:/{path-relative-to-root}:/children
If successful, this method returns the list of items in the children collection of the target item. The children collection will be composed of [driveItem][item-resource] resources.
-<!-- { "blockType": "response",
- "@odata.type": "Collection(microsoft.graph.driveItem)",
+<!-- { "blockType": "response",
+ "@odata.type": "Collection(microsoft.graph.driveItem)",
"truncated": true, "name": [ "list-children-root", "list-children", "list-children-from-path" ] } -->
v1.0 Driveitem List Permissions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/driveitem-list-permissions.md
-+ description: "List the effective sharing permissions of on a driveItem." Last updated 09/10/2017 Title: List who has access to a file
v1.0 Driveitem List Thumbnails https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/driveitem-list-thumbnails.md
-+ description: "Retrieve a collection of ThumbnailSet resources for a DriveItem resource." Last updated 09/10/2017 Title: Retrieve thumbnails for a file or folder
GET /me/drive/items/{item-id}/thumbnails
-This returns an array of available **thumbnailSets** for the item.
+This returns an array of available **thumbnailSets** for the item.
Any item in a drive can have zero or more thumbnails. **Note:** You can use the _select_ query string parameter to control which thumbnail sizes are returned in the **ThumbnailSet**.
GET /me/drive/items/{item-id}/thumbnails?select=c300x400_crop
[!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)
v1.0 Driveitem List Versions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/driveitem-list-versions.md
description: "OneDrive and SharePoint can be configured to retain the history fo
ms.localizationpriority: medium ms.prod: "sharepoint" doc_type: apiPageType-+ # List versions of a driveItem
v1.0 Driveitem Move https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/driveitem-move.md
-+ description: "To move a DriveItem to a new parent item, your app requests to update the parentReference of the DriveItem to move." Last updated 09/10/2017 Title: Move a file or folder
v1.0 Driveitem Post Children https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/driveitem-post-children.md
-+ description: "Create a new folder or DriveItem in a Drive with a specified parent item or path." Last updated 09/10/2017 Title: Create a new folder
v1.0 Driveitem Preview https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/driveitem-preview.md
description: "This action allows you to obtain short-lived embeddable URLs for a
ms.localizationpriority: medium ms.prod: "sharepoint" doc_type: apiPageType-+ # driveItem: preview
v1.0 Driveitem Put Content https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/driveitem-put-content.md
-+ description: "The simple upload API allows you to provide the contents of a new file or update the contents of an existing file in a single API call. " Last updated 09/10/2017 Title: Upload small files
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-The simple upload API allows you to provide the contents of a new file or update the contents of an existing file in a single API call.
+The simple upload API allows you to provide the contents of a new file or update the contents of an existing file in a single API call.
This method only supports files up to 4MB in size. To upload large files see [Upload large files with an upload session](driveitem-createuploadsession.md).
v1.0 Driveitem Restore https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/driveitem-restore.md
Title: "driveItem: restore" description: "Restore a driveItem that has been deleted and is currently in the recycle bin." ms.localizationpriority: medium-+ ms.prod: files doc_type: "apiPageType"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Restore a [driveItem](../resources/driveitem.md) that has been deleted and is currently in the recycle bin.
+Restore a [driveItem](../resources/driveitem.md) that has been deleted and is currently in the recycle bin.
>**Note**: This functionality is currently only available for OneDrive Personal.
v1.0 Driveitem Search https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/driveitem-search.md
-+ description: "Search the hierarchy of items for items matching a query." Last updated 09/10/2017 Title: Search for files
GET /me/drive/search(q='Contoso Project')
### Response Responses when searching from the **drive** resource may include items outside of the drive (items shared with the current user).
-These items will include the [**remoteItem**](../resources/remoteitem.md) facet to indicate they are stored outside of the target drive.
+These items will include the [**remoteItem**](../resources/remoteitem.md) facet to indicate they are stored outside of the target drive.
<!-- { "blockType": "response", "truncated": true, "@odata.type": "Collection(microsoft.graph.driveItem)" } -->
v1.0 Driveitem Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/driveitem-update.md
-+ description: "Update the metadata for a DriveItem by ID or path." Last updated 09/10/2017 Title: Update a file or folder
v1.0 Driveitemversion Get Contents https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/driveitemversion-get-contents.md
-+ description: "Retrieve the contents of a specific version of a driveItem. " Last updated 09/10/2017 Title: Download a previous version
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve the contents of a specific version of a [driveItem](../resources/driveitem.md).
+Retrieve the contents of a specific version of a [driveItem](../resources/driveitem.md).
>**Note:** Getting the content of the current version is not supported. Instead, use the [driveItem content endpoint](driveitem-get-content.md).
v1.0 Driveitemversion Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/driveitemversion-get.md
description: "Retrieve the metadata for a specific version of a DriveItem."
ms.localizationpriority: medium ms.prod: "sharepoint" doc_type: apiPageType-+ # Get a DriveItemVersion resource (preview)
v1.0 Driveitemversion Restore https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/driveitemversion-restore.md
-+ description: "Restore a previous version of a DriveItem to be the current version. This will create a new version with the contents of the previous version, but preserves all existing versions of the file." Last updated 09/10/2017 Title: Restore a previous version
v1.0 Ediscovery Case Reopen https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/ediscovery-case-reopen.md
POST https://graph.microsoft.com/beta/compliance/ediscovery/cases/061b9a92-8926-
[!INCLUDE [sample-code](../includes/snippets/php/case-reopen-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/case-reopen-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Ediscovery Legalhold Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/ediscovery-legalhold-get.md
GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/{caseId}/legalH
[!INCLUDE [sample-code](../includes/snippets/php/get-legalhold-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-legalhold-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Ediscovery Legalhold Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/ediscovery-legalhold-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-legalhold-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-legalhold-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Ediscovery Noncustodialdatasource List Datasource https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/ediscovery-noncustodialdatasource-list-datasource.md
GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/5b840b94-f821-4
[!INCLUDE [sample-code](../includes/snippets/php/list-datasource-noncustodialdatasources-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-datasource-noncustodialdatasources-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Ediscovery Reviewsetquery Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/ediscovery-reviewsetquery-get.md
GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/2eef613a-ca2d-4
[!INCLUDE [sample-code](../includes/snippets/php/get-reviewsetquery-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-reviewsetquery-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Ediscovery Sourcecollection Post Additionalsources https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/ediscovery-sourcecollection-post-additionalsources.md
Content-Type: application/json
[!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)
v1.0 Ediscovery Unifiedgroupsource Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/ediscovery-unifiedgroupsource-get.md
GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/4c8f8f70-7785-4
[!INCLUDE [sample-code](../includes/snippets/php/get-unifiedgroupsource-2-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-unifiedgroupsource-2-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Ediscovery Usersource Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/ediscovery-usersource-get.md
GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/4c8f8f70-7785-4
[!INCLUDE [sample-code](../includes/snippets/php/get-usersource-2-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-usersource-2-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Educationassignment Activate https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationassignment-activate.md
POST https://graph.microsoft.com/beta/education/classes/ffac078e-1b63-42d0-bc2a-
[!INCLUDE [sample-code](../includes/snippets/php/post-activateassignment-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-activateassignment-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Educationassignment Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationassignment-get.md
Prefer: include-unknown-enum-members
[!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)
v1.0 Educationassignment List Submissions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationassignment-list-submissions.md
Prefer: include-unknown-enum-members
[!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)
v1.0 Educationassignment Setupresourcesfolder https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationassignment-setupresourcesfolder.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/educationassignment-setupresourcesfolder-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/educationassignment-setupresourcesfolder-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Educationassignmentresource Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationassignmentresource-delete.md
DELETE https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a85
[!INCLUDE [sample-code](../includes/snippets/php/delete-educationassignmentresource-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-educationassignmentresource-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Educationassignmentresource Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationassignmentresource-get.md
GET https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f
[!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)
v1.0 Educationassignmentsettings Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationassignmentsettings-update.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Update the properties of an [educationAssignmentSettings](../resources/educationassignmentsettings.md) object. Only Teachers can update these settings.
+Update the properties of an [educationAssignmentSettings](../resources/educationassignmentsettings.md) object. Only teachers can update these settings.
## 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).
If successful, this method returns a `200 OK` response code and an updated [educ
#### Request
+The following is an example of the request.
+ # [HTTP](#tab/http) <!-- { "blockType": "request",
Content-Type: application/json
### Response
-**Note:** The response object shown here might be shortened for readability.
+
+The following is an example of the response.
+
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
Content-Type: application/json
"submissionAnimationDisabled": true } ```+ ### Example 2: Create grading categories #### Request The following is an example of the request. - # [HTTP](#tab/http) <!-- { "blockType": "request",
v1.0 Educationcategory Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationcategory-get.md
GET https://graph.microsoft.com/beta/education/classes/dacbf757-888d-42ae-b701-5
[!INCLUDE [sample-code](../includes/snippets/php/get-class-category-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-class-category-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Educationclass Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationclass-delta.md
GET https://graph.microsoft.com/beta/education/classes/delta
[!INCLUDE [sample-code](../includes/snippets/php/educationclass-delta-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/educationclass-delta-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Educationclass List Modules https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationclass-list-modules.md
+
+ Title: "List class modules"
+description: "Retrieve a list of module objects."
+
+ms.localizationpriority: medium
++
+# List class modules
+
+Namespace: microsoft.graph
++
+Retrieve a list of [module](../resources/educationmodule.md) objects. Only teachers, students, and applications with application permissions can perform this operation.
+
+A teacher or an application with application permissions can see all module objects for the class. Students can only see published modules.
+
+## 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).
+
+| Permission type | Permissions (from least to most privileged) |
+| :- | :-- |
+| Delegated (work or school account) | EduCurricula.Read, EduCurricula.ReadWrite |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | EduCurricula.Read.All, EduCurricula.ReadWrite.All |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+```http
+GET /education/classes/{id}/modules
+```
+
+## Optional query parameters
+This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+
+The available `$expand` option for this method is: `resources`.
+
+## Request headers
+
+| Header | Value |
+| : | : |
+| Authorization | Bearer {token}. Required. |
+
+## 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 [educationModule](../resources/educationmodule.md) objects in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_modules_for_classID"
+}-->
+
+```http
+GET https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/modules
+```
+
+### Response
+
+The following is an example of the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationModule",
+ "isCollection": true
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/modules",
+ "value": [
+ {
+ "displayName": "Module 1",
+ "description": "<div style=\"font-family: inherit; font-size: inherit; color: inherit; background-color: inherit;\">Description for module 1 updated</div>",
+ "resourcesFolderUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F2UVvTgEnTKi0GO59dbCL/items/01VANVJQZUN7H5IXZPURF3DDZKOAEHN6ZW",
+ "isPinned": false,
+ "status": "draft",
+ "createdDateTime": "2023-07-19T22:18:24.0753841Z",
+ "lastModifiedDateTime": "2023-07-19T22:38:03.8575605Z",
+ "id": "5955f965-99aa-4fba-ad88-e291afeaf81d",
+ "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
+ }
+ }
+ },
+ {
+ "displayName": "Module 4",
+ "description": "<div style=\"font-family: inherit; font-size: inherit; color: inherit; background-color: inherit;\">description for module 4</div>",
+ "resourcesFolderUrl": null,
+ "isPinned": false,
+ "status": "published",
+ "createdDateTime": "2023-07-20T17:24:54.6405196Z",
+ "lastModifiedDateTime": "2023-07-20T17:32:25.4635665Z",
+ "id": "4ae4afc7-af22-45c1-9f11-cee40a60c967",
+ "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 Educationclass Post Module https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationclass-post-module.md
+
+ Title: "Create educationModule"
+description: "Create a draft classwork module."
+ms.localizationpriority: medium
+++
+# Create educationModule
+
+Namespace: microsoft.graph
++
+Create a new [module](../resources/educationmodule.md) in a [class](../resources/educationclass.md).
+
+Only teachers in a class can create a module. Modules start in the `draft` state, which means that students will not see the modules until publication.
+
+## 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).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | EduCurricula.ReadWrite |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+```http
+POST /education/classes/{id}/modules
+```
+
+## Request headers
+| Header | Value |
+|:|:--|
+| Authorization | Bearer {token}. Required. |
+| Content-Type | application/json. Required. |
+
+## Request body
+In the request body, supply a JSON representation of an [educationModule](../resources/educationmodule.md) object.
+
+## Response
+If successful, this method returns a `201 OK` response code and an [educationModule](../resources/educationmodule.md) object in the request body.
+
+## Example
+
+### Request
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "create_educationmodule_from_educationclass"
+}-->
+```http
+POST https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/modules
+Content-type: application/json
+
+{
+ "displayName":"Module 2",
+ "description": "Description for Module 2"
+}
+```
+
+### Response
+The following is an example of the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationModule"
+} -->
+```http
+HTTP/1.1 201 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/modules/$entity",
+ "displayName": "Module 2",
+ "description": "Description for Module 2",
+ "resourcesFolderUrl": null,
+ "isPinned": false,
+ "status": "draft",
+ "createdDateTime": "2023-06-21T17:25:44.1277744Z",
+ "lastModifiedDateTime": "2023-06-21T17:25:44.1494968Z",
+ "id": "ba8e4215-4fb2-4dba-abe7-a8f2585177d3",
+ "createdBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "4aa81579-714a-4f46-8a05-605558455fa1",
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "4aa81579-714a-4f46-8a05-605558455fa1",
+ "displayName": null
+ }
+ }
+}
+```
v1.0 Educationclass Post Teachers https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationclass-post-teachers.md
In the request body, supply a JSON representation of an [educationUser](../resou
If successful, this method returns a `204 No Content` response code and an [educationClass](../resources/educationclass.md) object in the response body. ## Example
-##### Request
+### Request
The following is an example of the request. # [HTTP](#tab/http)
Content-type: application/json
-##### Response
+### Response
The following is an example of the response. <!-- Add the educationClass object to the response -->
HTTP/1.1 204 No Content
] } -->--
v1.0 Educationgradingcategory Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationgradingcategory-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-gradingcategoties-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-gradingcategoties-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Educationmodule Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationmodule-delete.md
+
+ Title: "Delete educationModule"
+description: "Delete an existing module. Only teachers within a class can delete modules."
+
+ms.localizationpriority: medium
++
+# Delete educationModule
+
+Namespace: microsoft.graph
++
+Delete an existing [module](../resources/educationmodule.md) in a [class](../resources/educationclass.md). Only teachers within a class can delete modules.
+
+## 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).
+
+| Permission type | Permissions (from least to most privileged) |
+| :- | : |
+| Delegated (work or school account) | EduCurricula.ReadWrite |
+| Delegated (personal Microsoft account) | Not Supported. |
+| Application | Not supported. |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+DELETE /education/classes/{id}/modules/{id}
+```
+
+## Request headers
+
+| Header | Value |
+| : | : |
+| Authorization | Bearer {token}. Required. |
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
+
+## Example
+
+### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "delete_educationmodule_1"
+}-->
+
+```http
+DELETE https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/modules/ba8e4215-4fb2-4dba-abe7-a8f2585177d3
+```
+
+### Response
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+} -->
+
+```http
+HTTP/1.1 204 No Content
+```
v1.0 Educationmodule Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationmodule-get.md
+
+ Title: "Get educationModule"
+description: "Get the properties and relationships of a module."
+
+ms.localizationpriority: medium
++
+# Get educationModule
+
+Namespace: microsoft.graph
++
+Get the properties and relationships of a [module](../resources/educationModule.md). Only teachers, students, and applications with application permissions can perform this operation.
+
+Students can only see published modules; teachers and applications with application permissions can see all modules in a class.
+
+## 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).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | EduCurricula.Read, EduCurricula.ReadWrite |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | EduCurricula.Read.All, EduCurricula.ReadWrite.All |
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+```http
+GET /education/classes/{id}/modules/{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).
+
+## Request headers
+| Header | Value |
+|:|:--|
+| Authorization | Bearer {token}. Required. |
+
+## Request body
+Don't supply a request body for this method.
+
+## Response
+If successful, this method returns a `200 OK` response code and an [educationModule](../resources/educationModule.md) object in the response body.
+
+## Example
+### Request
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_educationModule"
+}-->
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/modules/72a3879f-af73-4179-8a0e-4cb29c0fa369
+```
+
+### Response
+The following is an example of the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationModule"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('cff47bf3-791b-4b0a-ad6b-92fa66917cc7')/modules/$entity",
+ "displayName": "Math Practice - Fall",
+ "description": "Description for Math Practice - Fall",
+ "resourcesFolderUrl": "https://graph.microsoft.com/v1.0/drives/b!G2qSPDsXR0y4Bb2vODednawfynEIaD1OvPVeH4wbOp_3GV_mcV9MRLur9XlH200N/items/01IVG3LZKSPUPNBJYGQJCJUNG5SOCCD5DF",
+ "isPinned": false,
+ "status": "draft",
+ "createdDateTime": "2023-07-24T22:02:06.8286097Z",
+ "lastModifiedDateTime": "2023-07-24T22:02:44.2906308Z",
+ "id": "72a3879f-af73-4179-8a0e-4cb29c0fa369",
+ "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 Educationmodule List Resources https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationmodule-list-resources.md
+
+ Title: "List module resources"
+description: "Get all the resources associated with a module."
+
+ms.localizationpriority: medium
++
+# List module resources
+
+Namespace: microsoft.graph
++
+Get all the [educationModuleResource](../resources/educationmoduleresource.md) objects associated with a [module](../resources/educationmodule.md). Only teachers, students, and applications with application permissions can perform this operation.
+
+## 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).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | EduCurricula.Read, EduCurricula.ReadWrite |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | EduCurricula.Read.All, EduCurricula.ReadWrite.All |
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+```http
+GET /education/classes/{id}/modules/{id}/resources
+```
+
+## Optional query parameters
+
+This method supports the `$expand` OData query parameter to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
++
+## Request headers
+| Header | Value |
+|:|:--|
+| Authorization | Bearer {token}. Required. |
+
+## 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 [educationModuleResource](../resources/educationmoduleresource.md) objects in the response body.
+
+## Example
+### Request
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_moduleresources_1"
+}-->
+```http
+GET https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/modules/ba8e4215-4fb2-4dba-abe7-a8f2585177d3/resources
+```
+
+### Response
+The following is an example of the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationModuleResource",
+ "isCollection": true
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/modules('74b318fa-e882-4dad-8e1c-dab091b12fe7')/resources",
+ "value": [{
+ "id": "291f3577-7e48-4faa-8bde-f0b9bbdab5eb",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationLinkResource",
+ "displayName": "2023-07-26T21_22_29_804Z",
+ "createdDateTime": "2023-07-25T21:22:30.1455092Z",
+ "lastModifiedDateTime": "2023-07-25T21:22:30.1455106Z",
+ "link": "https://www.bing.com",
+ "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
+ }
+ }
+ }
+ },
+ {
+ "id": "bfbf27cb-2316-47f0-81d4-7bb028f01964",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationLinkedAssignmentResource",
+ "displayName": "2023-07-26T21_22_48_707Z",
+ "createdDateTime": "2023-07-25T21:22:49.2808156Z",
+ "lastModifiedDateTime": "2023-07-25T21:22:49.2808174Z",
+ "url": "https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignments/b563da70-710e-4a9b-ba86-94a4d73e5d21/",
+ "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
+ }
+ }
+ }
+ },
+ {
+ "id": "151c668c-6c77-495e-a28e-c02fa155375a",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationWordResource",
+ "displayName": "test_2023-07-26T21_22_51_471Z.docx",
+ "createdDateTime": "2023-07-25T21:22:53.549826Z",
+ "lastModifiedDateTime": "2023-07-25T21:22:53.5498285Z",
+ "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F2UVvTgEnTKi0GO59dbCL/items/01VANVJQ23DHK5BYNOKJCZOUJZJBOAOUZP",
+ "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 Educationmodule Pin https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationmodule-pin.md
+
+ Title: "educationModule: pin"
+description: "Pin an educationModule in the classwork list."
+ms.localizationpriority: medium
+++
+# educationModule: pin
+
+Namespace: microsoft.graph
++
+Pin an [educationModule](../resources/educationmodule.md) in the classwork list. This action sets the **isPinned** property to **true** for an [educationModule](../resources/educationmodule.md).
+
+Only teachers can perform this action and only one module at a time can be pinned in the classwork list.
+
+## 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).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | EduCurricula.ReadWrite |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+```http
+POST /education/classes/{id}/modules/{id}/pin
+
+```
+## Request headers
+| Header | Value |
+|:|:--|
+| Authorization | Bearer {token}. Required. |
+
+## Request body
+Don't supply a request body for this method.
+
+## Response
+If successful, this method returns a `200 Ok` response code and an [educationModule](../resources/educationmodule.md) object in the response body.
+
+## Example
+The following example shows how to call this API.
+
+### Request
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "sampleKeys": ["37d99af7-cfc5-4e3b-8566-f7d40e4a2070","ba8e4215-4fb2-4dba-abe7-a8f2585177d3"],
+ "name": "educationmodule_pin_1"
+}-->
+
+```http
+POST https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/modules/ba8e4215-4fb2-4dba-abe7-a8f2585177d3/pin
+```
+
+### Response
+The following is an example of a response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationModule"
+} -->
+
+```http
+HTTP/1.1 200 Ok
+
+{
+ "@odata.context": "https://graph.microsoft.com/$metadata#educationModule",
+ "@odata.type": "#microsoft.graph.educationModule",
+ "displayName": "Module 3",
+ "description": "Description for Module 3",
+ "resourcesFolderUrl": null,
+ "isPinned": true,
+ "status": "draft",
+ "createdDateTime": "2023-06-21T17:25:44.1277744Z",
+ "lastModifiedDateTime": "2023-06-21T17:41:17.3790932Z",
+ "id": "ba8e4215-4fb2-4dba-abe7-a8f2585177d3",
+ "createdBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "4aa81579-714a-4f46-8a05-605558455fa1",
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "4aa81579-714a-4f46-8a05-605558455fa1",
+ "displayName": null
+ }
+ }
+}
+```
v1.0 Educationmodule Post Resources https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationmodule-post-resources.md
+
+ Title: "Create educationModuleResource"
+description: "Create an education module resource."
+ms.localizationpriority: medium
+++
+# Create educationModuleResource
+
+Namespace: microsoft.graph
++
+Create a [resource](../resources/educationmoduleresource.md) in a [module](../resources/educationmodule.md). Only teachers can perform this operation.
+
+You can create the following types of module resources:
+
+- [educationChannelResource](../resources/educationchannelresource.md)
+- [educationExcelResource](../resources/educationexcelresource.md)
+- [educationFileResource](../resources/educationfileresource.md)
+- [educationLinkResource](../resources/educationlinkresource.md)
+- [educationLinkedAssignmentResource](../resources/educationlinkedassignmentresource.md)
+- [educationMediaResource](../resources/educationmediaresource.md)
+- [educationPowerPointResource](../resources/educationpowerpointresource.md)
+- [educationWordResource](../resources/educationwordresource.md)
+
+Every resource has an **@odata.type** property to indicate which type of resource is being created.
+
+> [!IMPORTANT]
+> To upload a module resource, you need to first [set up the resources folder](../api/educationmodule-setupresourcesfolder.md) for the [educationModule](../resources/educationmodule.md) where the files will be uploaded.
+
+## 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).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | EduCurricula.ReadWrite |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+```http
+POST /education/classes/{class-id}/modules/{module-id}/resources
+```
+## Request headers
+| Header | Value |
+|:|:--|
+| Authorization | Bearer {token}. Required. |
+| Content-Type | application/json |
+
+## Request body
+In the request body, supply a JSON representation of one of the following resource types:
+
+- [educationChannelResource](../resources/educationchannelresource.md)
+- [educationExcelResource](../resources/educationexcelresource.md)
+- [educationFileResource](../resources/educationfileresource.md)
+- [educationLinkResource](../resources/educationlinkresource.md)
+- [educationLinkedAssignmentResource](../resources/educationlinkedassignmentresource.md)
+- [educationMediaResource](../resources/educationmediaresource.md)
+- [educationPowerPointResource](../resources/educationpowerpointresource.md)
+- [educationWordResource](../resources/educationwordresource.md)
+
+>**Note:** You can't use this operation to create an [educationExternalResource](../resources/educationexternalresource.md).
+
+## Response
+If successful, this method returns a `201 Created` response code and an [educationModuleResource](../resources/educationmoduleresource.md) object in the response body.
+
+## Examples
+### Example 1: Create an educationLinkResource
+#### Request
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "create_educationlinkresource_from_educationmodule"
+}-->
+```http
+POST https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/modules/74b318fa-e882-4dad-8e1c-dab091b12fe7/resources
+Content-type: application/json
+
+{
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationLinkResource",
+ "displayName":"Bing site",
+ "link": "https://www.bing.com"
+ }
+}
+```
+
+#### Response
+The following is an example of the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationLinkResource"
+} -->
+```http
+HTTP/1.1 201 Created
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/modules('74b318fa-e882-4dad-8e1c-dab091b12fe7')/resources/$entity",
+ "id": "291f3577-7e48-4faa-8bde-f0b9bbdab5eb",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationLinkResource",
+ "displayName": "Bing site",
+ "createdDateTime": "2023-07-25T21:22:30.1455092Z",
+ "lastModifiedDateTime": "2023-07-25T21:22:30.1455106Z",
+ "link": "https://www.bing.com",
+ "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
+ }
+ }
+ }
+}
+```
+
+### Example 2: Create an educationWordResource
+#### Request
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "create_educationwordresource_from_educationmodule"
+}-->
+```http
+POST https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/modules/74b318fa-e882-4dad-8e1c-dab091b12fe7/resources
+Content-type: application/json
+
+{
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationWordResource",
+ "displayName": "test_word_file.docx",
+ "file" :{
+ "odataid":"https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F2UVvTgEnTKi0GO59dbCL/items/01VANVJQ23DHK5BYNOKJCZOUJZJBOAOUZP"
+ }
+ }
+}
+```
+
+#### Response
+The following is an example of the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationWordResource"
+} -->
+```http
+HTTP/1.1 201 Created
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/modules('74b318fa-e882-4dad-8e1c-dab091b12fe7')/resources/$entity",
+ "id": "151c668c-6c77-495e-a28e-c02fa155375a",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationWordResource",
+ "displayName": "test_word_file.docx",
+ "createdDateTime": "2023-07-25T21:22:53.549826Z",
+ "lastModifiedDateTime": "2023-07-25T21:22:53.5498285Z",
+ "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F2UVvTgEnTKi0GO59dbCL/items/01VANVJQ23DHK5BYNOKJCZOUJZJBOAOUZP",
+ "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
+ }
+ }
+ }
+}
+```
+
+### Example 3: Create an educationFileResource
+#### Request
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "create_educationfileresource_from_educationmodule"
+}-->
+```http
+POST https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/modules/74b318fa-e882-4dad-8e1c-dab091b12fe7/resources
+Content-type: application/json
+
+{
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationFileResource",
+ "displayName": "test_pdf_file.pdf",
+ "file" :{
+ "odataid":"https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F2UVvTgEnTKi0GO59dbCL/items/01VANVJQZLJG2P74OLQ5FL5EXU3VY6BFSQ"
+ }
+ }
+}
+```
+
+#### Response
+The following is an example of the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationFileResource"
+} -->
+```http
+HTTP/1.1 201 Created
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/modules('74b318fa-e882-4dad-8e1c-dab091b12fe7')/resources/$entity",
+ "id": "fdf9d241-4737-4966-8914-90f832135ed7",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationFileResource",
+ "displayName": "test_pdf_file.pdf",
+ "createdDateTime": "2023-07-25T21:22:55.4340491Z",
+ "lastModifiedDateTime": "2023-07-25T21:22:55.4340527Z",
+ "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F2UVvTgEnTKi0GO59dbCL/items/01VANVJQZLJG2P74OLQ5FL5EXU3VY6BFSQ",
+ "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
+ }
+ }
+ }
+}
+```
+
+### Example 4: Create an educationExcelResource
+#### Request
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "create_educationexcelresource_from_educationmodule"
+}-->
+```http
+POST https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/modules/74b318fa-e882-4dad-8e1c-dab091b12fe7/resources
+Content-type: application/json
+
+{
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationExcelResource",
+ "displayName": "test_excel_file.xlsx",
+ "file" :{
+ "odataid":"https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F2UVvTgEnTKi0GO59dbCL/items/01VANVJQZLIO353OYQOBCIFCJGKBSLB4DK"
+ }
+ }
+}
+```
+
+#### Response
+The following is an example of the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationExcelResource"
+} -->
+```http
+HTTP/1.1 201 Created
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/modules('74b318fa-e882-4dad-8e1c-dab091b12fe7')/resources/$entity",
+ "id": "13544dd3-7f42-42f6-a1d5-62da1885d7bc",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationExcelResource",
+ "displayName": "test_excel_file.xlsx",
+ "createdDateTime": "2023-07-25T21:22:56.6099823Z",
+ "lastModifiedDateTime": "2023-07-25T21:22:56.6099861Z",
+ "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F2UVvTgEnTKi0GO59dbCL/items/01VANVJQZLIO353OYQOBCIFCJGKBSLB4DK",
+ "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
+ }
+ }
+ }
+}
+```
+
+### Example 5: Create an educationPowerPointResource
+#### Request
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "create_educationpowerpointresource_from_educationmodule"
+}-->
+```http
+POST https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/modules/74b318fa-e882-4dad-8e1c-dab091b12fe7/resources
+Content-type: application/json
+
+{
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationPowerPointResource",
+ "displayName":"ppt_test.pptx",
+ "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F2UVvTgEnTKi0GO59dbCL/items/01VANVJQZEG2AM23OQ5NA2LFTHERBABBK6"
+ }
+}
+```
+
+#### Response
+The following is an example of the response.
+
+>**Note:** The response object shown here might be shortened for readability.
++
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationPowerPointResource"
+} -->
+```http
+HTTP/1.1 201 Created
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/modules('74b318fa-e882-4dad-8e1c-dab091b12fe7')/resources/$entity",
+ "id": "4d112f68-0351-40ae-8adc-adfd14f320b3",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationPowerPointResource",
+ "displayName": "ppt_test.pptx",
+ "createdDateTime": "2023-07-25T21:22:58.1097081Z",
+ "lastModifiedDateTime": "2023-07-25T21:22:58.1097107Z",
+ "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F2UVvTgEnTKi0GO59dbCL/items/01VANVJQZEG2AM23OQ5NA2LFTHERBABBK6",
+ "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
+ }
+ }
+ }
+}
+```
+
+### Example 6: Create an educationMediaResource
+#### Request
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "create_educationmediaresource_from_educationmodule"
+}-->
+```http
+POST https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/modules/74b318fa-e882-4dad-8e1c-dab091b12fe7/resources
+Content-type: application/json
+
+{
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationMediaResource",
+ "displayName":"media-resource.PNG",
+ "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F2UVvTgEnTKi0GO59dbCL/items/01VANVJQ3IYW2FOZYQNBELS7N4RRREIMVK"
+ }
+}
+```
+
+#### Response
+The following is an example of the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationMediaResource"
+} -->
+```http
+HTTP/1.1 201 Created
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/modules('74b318fa-e882-4dad-8e1c-dab091b12fe7')/resources/$entity",
+ "id": "17d1ed4d-ba9e-483e-82d2-c0e1826a288f",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationMediaResource",
+ "displayName": "media-resource.PNG",
+ "createdDateTime": "2023-07-25T21:22:59.0845073Z",
+ "lastModifiedDateTime": "2023-07-25T21:22:59.0845089Z",
+ "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F2UVvTgEnTKi0GO59dbCL/items/01VANVJQ3IYW2FOZYQNBELS7N4RRREIMVK",
+ "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
+ }
+ }
+ }
+}
+```
+
+### Example 7: Create an educationChannelResource
+#### Request
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "create_educationChannelResource_from_educationmodule"
+}-->
+```http
+POST https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/modules/1618dfb0-3ff2-4edf-8d5c-b8f81df00e80/resources
+Content-type: application/json
+
+{
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationChannelResource",
+ "url": "https://graph.microsoft.com/v1.0/teams/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/channels/19:4gSkXJRlsCMnZvBzAcyXGdsGtcQV0AJWtfvQp_a6Fi81@thread.tacv2",
+ "displayName": "General"
+ }
+}
+```
+
+#### Response
+The following is an example of the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationChannelResource"
+} -->
+```http
+HTTP/1.1 201 Created
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/modules('74b318fa-e882-4dad-8e1c-dab091b12fe7')/resources/$entity",
+ "id": "360e073a-89ef-4f2f-835f-3b060a96f62d",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationChannelResource",
+ "displayName": "General",
+ "createdDateTime": "2023-07-25T21:23:01.6740431Z",
+ "lastModifiedDateTime": "2023-07-25T21:23:01.6740457Z",
+ "url": "https://graph.microsoft.com/v1.0/teams/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/channels/19:4gSkXJRlsCMnZvBzAcyXGdsGtcQV0AJWtfvQp_a6Fi81@thread.tacv2",
+ "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
+ }
+ }
+ }
+}
+```
+
+### Example 8: Create an educationLinkedAssignmentResource
+#### Request
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "create_educationLinkedAssignmentResource_from_educationmodule"
+}-->
+```http
+POST https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/modules/74b318fa-e882-4dad-8e1c-dab091b12fe7/resources
+Content-type: application/json
+
+{
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationLinkedAssignmentResource",
+ "displayName":"Existing_Assignment",
+ "url": "https://graph.microsoft.com/v1.0/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignments/b563da70-710e-4a9b-ba86-94a4d73e5d21"
+ }
+}
+```
+
+#### Response
+The following is an example of the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationLinkedAssignmentResource"
+} -->
+```http
+HTTP/1.1 201 Created
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/modules('74b318fa-e882-4dad-8e1c-dab091b12fe7')/resources/$entity",
+ "id": "bfbf27cb-2316-47f0-81d4-7bb028f01964",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationLinkedAssignmentResource",
+ "displayName": "Existing_Assignment",
+ "createdDateTime": "2023-07-25T21:22:49.2808156Z",
+ "lastModifiedDateTime": "2023-07-25T21:22:49.2808174Z",
+ "url": "https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignments/b563da70-710e-4a9b-ba86-94a4d73e5d21/",
+ "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 Educationmodule Publish https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationmodule-publish.md
+
+ Title: "educationModule: publish"
+description: "Change the state of an educationModule from its original draft status to the published status."
+ms.localizationpriority: medium
+++
+# educationModule: publish
+
+Namespace: microsoft.graph
++
+Change the state of an [educationModule](../resources/educationmodule.md) from its original `draft` status to the `published` status.
+
+Only teachers in the class can perform this operation. When a module is in draft status, students will not see the module. When you call this API, the module appears in the student's classwork list.
+
+## 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).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | EduCurricula.ReadWrite |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+```http
+POST /education/classes/{id}/modules/{id}/publish
+
+```
+## Request headers
+| Header | Value |
+|:|:--|
+| Authorization | Bearer {token}. Required. |
+
+## Request body
+Don't supply a request body for this method.
+
+## Response
+If successful, this method returns a `200 Ok` response code and an [educationModule](../resources/educationmodule.md) object in the response body.
+
+## Example
+The following example shows how to call this API.
+
+### Request
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "sampleKeys": ["37d99af7-cfc5-4e3b-8566-f7d40e4a2070","ba8e4215-4fb2-4dba-abe7-a8f2585177d3"],
+ "name": "educationmodule_publish_1"
+}-->
+
+```http
+POST https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/modules/ba8e4215-4fb2-4dba-abe7-a8f2585177d3/publish
+```
+
+### Response
+The following is an example of a response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationModule"
+} -->
+
+```http
+HTTP/1.1 200 Ok
+
+{
+ "@odata.context": "https://graph.microsoft.com/$metadata#educationModule",
+ "@odata.type": "#microsoft.graph.educationModule",
+ "displayName": "Module 4",
+ "description": "Description for Module 4",
+ "resourcesFolderUrl": null,
+ "isPinned": true,
+ "status": "published",
+ "createdDateTime": "2023-06-21T17:25:44.1277744Z",
+ "lastModifiedDateTime": "2023-06-21T17:43:14.7269771Z",
+ "id": "ba8e4215-4fb2-4dba-abe7-a8f2585177d3",
+ "createdBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "4aa81579-714a-4f46-8a05-605558455fa1",
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "4aa81579-714a-4f46-8a05-605558455fa1",
+ "displayName": null
+ }
+ }
+}
+```
v1.0 Educationmodule Setupresourcesfolder https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationmodule-setupresourcesfolder.md
+
+ Title: "educationModule: setUpResourcesFolder"
+description: "Create a SharePoint folder to upload files for a given educationModule."
+ms.localizationpriority: medium
+++
+# educationModule: setUpResourcesFolder
+
+Namespace: microsoft.graph
++
+Create a SharePoint folder to upload files for a given [educationModule](../resources/educationmodule.md). Only teachers can perform this operation.
+
+The teacher determines what resources to upload to the SharePoint folder for the module.
+
+## 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).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | EduCurricula.ReadWrite |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+```http
+POST /education/classes/{classId}/modules/{{moduleId}}/setUpResourcesFolder
+```
+
+## Request headers
+| Header | Value |
+|:|:--|
+| Authorization | Bearer {token}. Required. |
+| Content-Type | application/json. Required. |
+
+## Request body
+In the request body, supply an empty JSON object `{}` for this method.
+
+## Response
+If successful, this method returns a `200 OK` response code and an [educationModule](../resources/educationmodule.md) object in the request body.
+
+## Examples
+
+### Request
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "educationmodule_setupresourcesfolder"
+}-->
+```http
+POST https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/modules/ba8e4215-4fb2-4dba-abe7-a8f2585177d3/setUpResourcesFolder
+Content-type: application/json
+
+{
+}
+```
+
+### Response
+The following is an example of the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationModule"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/$metadata#educationModule",
+ "@odata.type": "#microsoft.graph.educationModule",
+ "displayName": "Module 4",
+ "description": "Description for Module 4",
+ "resourcesFolderUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F2UVvTgEnTKi0GO59dbCL/items/01VANVJQ7ODS65Z665DBH3QGZ5UYZQOP2S",
+ "isPinned": true,
+ "status": "published",
+ "createdDateTime": "2023-06-21T17:25:44.1277744Z",
+ "lastModifiedDateTime": "2023-06-21T18:14:29.7542529Z",
+ "id": "ba8e4215-4fb2-4dba-abe7-a8f2585177d3",
+ "createdBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "4aa81579-714a-4f46-8a05-605558455fa1",
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "4aa81579-714a-4f46-8a05-605558455fa1",
+ "displayName": null
+ }
+ }
+}
+```
v1.0 Educationmodule Unpin https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationmodule-unpin.md
+
+ Title: "educationModule: unpin"
+description: "Unpin an educationModule in the classwork list."
+ms.localizationpriority: medium
+++
+# educationModule: unpin
+
+Namespace: microsoft.graph
++
+Unpin an [educationModule](../resources/educationmodule.md) in the classwork list. This action sets the **isPinned** property to **false** for an [educationModule](../resources/educationmodule.md).
+
+Only teachers in the class can perform this operation.
+
+## 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).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | EduCurricula.ReadWrite |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+```http
+POST /education/classes/{id}/modules/{id}/unpin
+
+```
+## Request headers
+| Header | Value |
+|:|:--|
+| Authorization | Bearer {token}. Required. |
+
+## Request body
+Don't supply a request body for this method.
+
+## Response
+If successful, this method returns a `200 Ok` response code and an [educationModule](../resources/educationmodule.md) object in the response body.
+
+## Example
+The following example shows how to call this API.
+
+### Request
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "sampleKeys": ["37d99af7-cfc5-4e3b-8566-f7d40e4a2070","ba8e4215-4fb2-4dba-abe7-a8f2585177d3"],
+ "name": "educationmodule_unpin_1"
+}-->
+
+```http
+POST https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/modules/ba8e4215-4fb2-4dba-abe7-a8f2585177d3/unpin
+```
+
+### Response
+The following is an example of a response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationModule"
+} -->
+
+```http
+HTTP/1.1 200 Ok
+
+{
+ "@odata.context": "https://graph.microsoft.com/$metadata#educationModule",
+ "@odata.type": "#microsoft.graph.educationModule",
+ "displayName": "Module 4",
+ "description": "Description for Module 4",
+ "resourcesFolderUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F2UVvTgEnTKi0GO59dbCL/items/01VANVJQ7ODS65Z665DBH3QGZ5UYZQOP2S",
+ "isPinned": false,
+ "status": "published",
+ "createdDateTime": "2023-06-21T17:25:44.1277744Z",
+ "lastModifiedDateTime": "2023-06-21T18:18:49.1101173Z",
+ "id": "ba8e4215-4fb2-4dba-abe7-a8f2585177d3",
+ "createdBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "4aa81579-714a-4f46-8a05-605558455fa1",
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "4aa81579-714a-4f46-8a05-605558455fa1",
+ "displayName": null
+ }
+ }
+}
+```
v1.0 Educationmodule Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationmodule-update.md
+
+ Title: "Update educationModule"
+description: "Update an educationModule object."
+ms.localizationpriority: medium
+++
+# Update educationModule
+
+Namespace: microsoft.graph
++
+Update an [educationModule](../resources/educationmodule.md) object in a [class](../resources/educationclass.md).
+
+Only teachers in the class can perform this operation. Note that you can't use a PATCH request to change the status of a module. Use the [publish](../api/educationmodule-publish.md) action to change the module status.
+
+## 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).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | EduCurricula.ReadWrite |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+```http
+PATCH /education/classes/{class-id}/modules/{module-id}
+```
+
+## Request headers
+| Header | Value |
+|:|:--|
+| Authorization | Bearer {token}. Required. |
+| Content-Type | application/json |
+
+## Request body
+In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
+
+| Property | Type |Description|
+|:-|:-|:-|
+|displayName|String| Name of module. |
+|description|String| Description of the module. |
+
+## Response
+If successful, this method returns a `200 OK` response code and an updated [educationModule](../resources/educationmodule.md) object in the response body.
+
+## Example
+### Request
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "update_educationmodule"
+}-->
+```http
+PATCH https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/modules/ba8e4215-4fb2-4dba-abe7-a8f2585177d3
+Content-type: application/json
+
+{
+ "displayName": "New_Module5 updated",
+ "description": "updated for description"
+}
+```
+
+### Response
+The following is an example of the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationModule"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/$metadata#education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/modules/$entity",
+ "displayName": "New_Module5 updated",
+ "description": "updated for description",
+ "resourcesFolderUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F2UVvTgEnTKi0GO59dbCL/items/01VANVJQ7ODS65Z665DBH3QGZ5UYZQOP2S",
+ "isPinned": false,
+ "status": "published",
+ "createdDateTime": "2023-06-21T17:25:44.1277744Z",
+ "lastModifiedDateTime": "2023-06-21T18:21:39.8114768Z",
+ "id": "ba8e4215-4fb2-4dba-abe7-a8f2585177d3",
+ "createdBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "4aa81579-714a-4f46-8a05-605558455fa1",
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "4aa81579-714a-4f46-8a05-605558455fa1",
+ "displayName": null
+ }
+ }
+}
+```
v1.0 Educationmoduleresource Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationmoduleresource-delete.md
+
+ Title: "Delete educationModuleResource"
+description: "Delete a specific resource attached to a module."
+
+ms.localizationpriority: medium
++
+# Delete educationModuleResource
+
+Namespace: microsoft.graph
++
+Delete a specific [educationModuleResource](../resources/educationmoduleresource.md) attached to a [module](../resources/educationmodule.md). Only teachers in the class can remove a resource.
+
+## 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).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | EduCurricula.ReadWrite |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+```http
+DELETE /education/classes/{class-id}/modules/{module-id}/resources/{resource-id}
+
+```
+## Request headers
+| Header | Value |
+|:|:--|
+| Authorization | Bearer {token}. Required. |
+
+## Request body
+Don't supply a request body for this method.
++
+## Response
+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
+
+## Example
+### Request
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "delete_educationmoduleresource"
+}-->
+```http
+DELETE https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/modules/dc1af5c4-8211-4e5d-92e6-f006477c2740/resources/7a686854-6d85-4fc0-9729-e36af26f7deb
+```
+
+### Response
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+} -->
+```http
+HTTP/1.1 204 No Content
+```
v1.0 Educationmoduleresource Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationmoduleresource-get.md
+
+ Title: "Get educationModuleResource"
+description: "Get the properties of a specific resource on a module."
+
+ms.localizationpriority: medium
++
+# Get educationModuleResource
+
+Namespace: microsoft.graph
++
+Get the properties of a [resource](../resources/educationmoduleresource.md) associated with a [module](../resources/educationmodule.md). Only teachers, students, and applications with application permissions can perform this operation.
+
+## 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).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | EduCurricula.Read, EduCurricula.ReadWrite |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | EduCurricula.Read.All, EduCurricula.ReadWrite.All |
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+```http
+GET /education/classes/{class-id}/modules/{module-id}/resources/{resource-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).
++
+## Request headers
+| Header | Value |
+|:|:--|
+| Authorization | Bearer {token}. Required. |
+
+## Request body
+Don't supply a request body for this method.
+
+## Response
+If successful, this method returns a `200 OK` response code and an [educationModuleResource](../resources/educationmoduleresource.md) object in the response body.
+
+## Examples
+### Example 1: Get an educationWordResource
+#### Request
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_educationmoduleresource_e1"
+}-->
+```http
+GET https://graph.microsoft.com/beta/education/classes/cff47bf3-791b-4b0a-ad6b-92fa66917cc7/modules/72a3879f-af73-4179-8a0e-4cb29c0fa369/resources/3b0198d2-590b-497f-ada6-35e2ba841879
+```
+
+#### Response
+The following is an example of the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationWordResource"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('cff47bf3-791b-4b0a-ad6b-92fa66917cc7')/modules('72a3879f-af73-4179-8a0e-4cb29c0fa369')/resources/$entity",
+ "id": "3b0198d2-590b-497f-ada6-35e2ba841879",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationWordResource",
+ "displayName": "test_2023-07-25T22_02_34_134Z.docx",
+ "createdDateTime": "2023-07-24T22:02:37.3803976Z",
+ "lastModifiedDateTime": "2023-07-24T22:02:37.3804005Z",
+ "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!G2qSPDsXR0y4Bb2vODednawfynEIaD1OvPVeH4wbOp_3GV_mcV9MRLur9XlH200N/items/01IVG3LZKVUHVKYNV6RBEK3LBYR2VLXOEM",
+ "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
+ }
+ }
+ }
+}
+
+```
+
+### Example 2: Get an educationLinkResource
+#### Request
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_educationlinkresource_from_educationmodule_e2"
+}-->
+```http
+GET https://graph.microsoft.com/beta/education/classes/cff47bf3-791b-4b0a-ad6b-92fa66917cc7/modules/72a3879f-af73-4179-8a0e-4cb29c0fa369/resources/5958ce41-9b9d-4e60-b8a6-5a4e7c41045c
+```
+
+#### Response
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationLinkResource"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('cff47bf3-791b-4b0a-ad6b-92fa66917cc7')/modules('72a3879f-af73-4179-8a0e-4cb29c0fa369')/resources/$entity",
+ "id": "5958ce41-9b9d-4e60-b8a6-5a4e7c41045c",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationLinkResource",
+ "displayName": "2023-07-25T22_02_13_541Z",
+ "createdDateTime": "2023-07-24T22:02:16.067095Z",
+ "lastModifiedDateTime": "2023-07-24T22:02:16.0670968Z",
+ "link": "https://www.bing.com",
+ "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
+ }
+ }
+ }
+}
+```
+
+### Example 3: Get an educationExcelResource
+#### Request
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_educationexcelresource_from_educationmodule_e3"
+}-->
+```http
+GET https://graph.microsoft.com/beta/education/classes/cff47bf3-791b-4b0a-ad6b-92fa66917cc7/modules/72a3879f-af73-4179-8a0e-4cb29c0fa369/resources/7a1c6461-2a2e-43b9-b8b4-bea316b7802b
+```
+
+#### Response
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationExcelResource"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('cff47bf3-791b-4b0a-ad6b-92fa66917cc7')/modules('72a3879f-af73-4179-8a0e-4cb29c0fa369')/resources/$entity",
+ "id": "7a1c6461-2a2e-43b9-b8b4-bea316b7802b",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationExcelResource",
+ "displayName": "test_2023-07-25T22_02_36_665Z.xlsx",
+ "createdDateTime": "2023-07-24T22:02:39.7182968Z",
+ "lastModifiedDateTime": "2023-07-24T22:02:39.7182995Z",
+ "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!G2qSPDsXR0y4Bb2vODednawfynEIaD1OvPVeH4wbOp_3GV_mcV9MRLur9XlH200N/items/01IVG3LZNHXFDGXMLE5VB3DUFKI5NKTDHS",
+ "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
+ }
+ }
+ }
+}
+```
+
+### Example 4: Get an educationPowerPointResource
+#### Request
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_educationpowerpointresource_from_educationmodule_e4"
+}-->
+```http
+GET https://graph.microsoft.com/beta/education/classes/cff47bf3-791b-4b0a-ad6b-92fa66917cc7/modules/72a3879f-af73-4179-8a0e-4cb29c0fa369/resources/18e00c9f-0292-4a5b-be67-47edebe676a2
+```
+
+#### Response
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationPowerPointResource"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('cff47bf3-791b-4b0a-ad6b-92fa66917cc7')/modules('72a3879f-af73-4179-8a0e-4cb29c0fa369')/resources/$entity",
+ "id": "18e00c9f-0292-4a5b-be67-47edebe676a2",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationPowerPointResource",
+ "displayName": "PptTest_2023-07-25T22_02_37_776Z.pptx",
+ "createdDateTime": "2023-07-24T22:02:41.1120038Z",
+ "lastModifiedDateTime": "2023-07-24T22:02:41.1120064Z",
+ "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!G2qSPDsXR0y4Bb2vODednawfynEIaD1OvPVeH4wbOp_3GV_mcV9MRLur9XlH200N/items/01IVG3LZNMSPWWUYRRXVGIMDFREOBVH52L",
+ "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
+ }
+ }
+ }
+}
+```
+
+### Example 5: Get an educationFileResource
+#### Request
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_educationfileresource_from_educationmodule_e5"
+}-->
+```http
+GET https://graph.microsoft.com/beta/education/classes/cff47bf3-791b-4b0a-ad6b-92fa66917cc7/modules/72a3879f-af73-4179-8a0e-4cb29c0fa369/resources/f5d4ac54-10ae-48f1-9e8b-6e961f490652
+```
+
+#### Response
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationFileResource"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('cff47bf3-791b-4b0a-ad6b-92fa66917cc7')/modules('72a3879f-af73-4179-8a0e-4cb29c0fa369')/resources/$entity",
+ "id": "f5d4ac54-10ae-48f1-9e8b-6e961f490652",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationFileResource",
+ "displayName": "test_2023-07-25T22_02_35_445Z.csv",
+ "createdDateTime": "2023-07-24T22:02:38.6052639Z",
+ "lastModifiedDateTime": "2023-07-24T22:02:38.6052675Z",
+ "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!G2qSPDsXR0y4Bb2vODednawfynEIaD1OvPVeH4wbOp_3GV_mcV9MRLur9XlH200N/items/01IVG3LZKHCVZECOHRIJDINECGB5LHPCJU",
+ "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
+ }
+ }
+ }
+}
+```
+
+### Example 6: Get an educationMediaResource
+#### Request
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_educationmediaresource_from_educationmodule_e6"
+}-->
+```http
+GET https://graph.microsoft.com/beta/education/classes/cff47bf3-791b-4b0a-ad6b-92fa66917cc7/modules/72a3879f-af73-4179-8a0e-4cb29c0fa369/resources/2bca0c1d-0bc6-4783-9451-1ba29b73421e
+```
+
+#### Response
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationMediaResource"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('cff47bf3-791b-4b0a-ad6b-92fa66917cc7')/modules('72a3879f-af73-4179-8a0e-4cb29c0fa369')/resources/$entity",
+ "id": "2bca0c1d-0bc6-4783-9451-1ba29b73421e",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationMediaResource",
+ "displayName": "MediaResource_2023-07-25T22_02_39_107Z.PNG",
+ "createdDateTime": "2023-07-24T22:02:41.9950633Z",
+ "lastModifiedDateTime": "2023-07-24T22:02:41.995065Z",
+ "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!G2qSPDsXR0y4Bb2vODednawfynEIaD1OvPVeH4wbOp_3GV_mcV9MRLur9XlH200N/items/01IVG3LZOYDB2FBK6DONA37DJ2VP6DNU4P",
+ "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
+ }
+ }
+ }
+}
+```
+
+### Example 7: Get an educationChannelResource
+#### Request
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_educationchannelresource_from_educationmodule_e6"
+}-->
+```http
+GET https://graph.microsoft.com/beta/education/classes/cff47bf3-791b-4b0a-ad6b-92fa66917cc7/modules/72a3879f-af73-4179-8a0e-4cb29c0fa369/resources/e123d8c6-29cd-4855-b1b6-9c6475290b1b
+```
+
+#### Response
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationChannelResource"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('cff47bf3-791b-4b0a-ad6b-92fa66917cc7')/modules('72a3879f-af73-4179-8a0e-4cb29c0fa369')/resources/$entity",
+ "id": "e123d8c6-29cd-4855-b1b6-9c6475290b1b",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationChannelResource",
+ "displayName": "General",
+ "createdDateTime": "2023-07-24T22:02:44.2287362Z",
+ "lastModifiedDateTime": "2023-07-24T22:02:44.2287383Z",
+ "url": "https://graph.microsoft.com/v1.0/teams/cff47bf3-791b-4b0a-ad6b-92fa66917cc7/channels/19:ad85e4c2f99f4df491971b12c40284a8@thread.tacv2",
+ "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
+ }
+ }
+ }
+}
+```
+
+### Example 8: Get an educationLinkedAssignmentResource
+#### Request
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_educationlinkedassignmentresource_from_educationmodule_e6"
+}-->
+```http
+GET https://graph.microsoft.com/beta/education/classes/cff47bf3-791b-4b0a-ad6b-92fa66917cc7/modules/72a3879f-af73-4179-8a0e-4cb29c0fa369/resources/c7a52867-11e9-4fb3-ae81-ce7d1fe0fd55
+```
+
+#### Response
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationLinkedAssignmentResource"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('cff47bf3-791b-4b0a-ad6b-92fa66917cc7')/modules('72a3879f-af73-4179-8a0e-4cb29c0fa369')/resources/$entity",
+ "id": "c7a52867-11e9-4fb3-ae81-ce7d1fe0fd55",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationLinkedAssignmentResource",
+ "displayName": "2023-07-25T22_02_31_674Z",
+ "createdDateTime": "2023-07-24T22:02:34.3183458Z",
+ "lastModifiedDateTime": "2023-07-24T22:02:34.3183472Z",
+ "url": "https://graph.microsoft.com/beta/education/classes/cff47bf3-791b-4b0a-ad6b-92fa66917cc7/assignments/5f54e105-606b-49e0-868d-39fd32db4c61/",
+ "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 Educationmoduleresource Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationmoduleresource-update.md
+
+ Title: "Update educationModuleResource"
+description: "Update an education module resource."
+ms.localizationpriority: medium
+++
+# Update educationModuleResource
+
+Namespace: microsoft.graph
++
+Update a [resource](../resources/educationmoduleresource.md) in a [module](../resources/educationmodule.md). Only teachers can perform this operation.
+
+The only one property that can be updated is **displayName**, for all resource types.
+
+## 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).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | EduCurricula.ReadWrite |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+```http
+PATCH /education/classes/{class-id}/modules/{module-id}/resources/{resource-id}
+```
+## Request headers
+| Header | Value |
+|:|:--|
+| Authorization | Bearer {token}. Required. |
+| Content-Type | application/json |
+
+## Request body
+In the request body, supply the new value for the **displayName** field that will be updated.
+
+## Response
+If successful, this method returns a `200 OK` response code and an [educationModuleResource](../resources/educationmoduleresource.md) object in the response body.
+
+## Examples
+### Request
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "create_educationmoduleresource_patch"
+}-->
+```http
+PATCH https://graph.microsoft.com/beta/education/classes/0b78e924-9623-49d8-b444-23bfabafa4fe/modules/fa1f6b67-7da6-458d-82fd-0d671df7bc31/resources/2fb5e262-611b-4672-8f55-1236b7f2804a
+Content-type: application/json
+
+{
+ "resource": {
+ "displayName" : "new pdf file patched.pdf"
+ }
+}
+```
+
+### Response
+The following is an example of the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationExcelResource"
+} -->
+```http
+HTTP/1.1 200 Ok
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('0b78e924-9623-49d8-b444-23bfabafa4fe')/modules('fa1f6b67-7da6-458d-82fd-0d671df7bc31')/resources/$entity",
+ "id": "2fb5e262-611b-4672-8f55-1236b7f2804a",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationFileResource",
+ "displayName": "new pdf file patched.pdf",
+ "createdDateTime": "2023-04-19T20:56:36.6529565Z",
+ "lastModifiedDateTime": "2023-04-19T20:56:36.6529598Z",
+ "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!b8MR4rrk6kK793yj5m0azKvekbG46dBGsI2G7Vlzar_XjshebPh4RIbAjeFl67oU/items/01LGT6P7HL7I7CL2W3VNAYPD67G6SBIEB7",
+ "createdBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "93f30bbf-7f10-4dbb-a5bd-b59f75d4f690",
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "93f30bbf-7f10-4dbb-a5bd-b59f75d4f690",
+ "displayName": null
+ }
+ }
+ }
+}
+```
v1.0 Educationroot List Users https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationroot-list-users.md
GET https://graph.microsoft.com/beta/education/users
[!INCLUDE [sample-code](../includes/snippets/php/educationroot-get-users-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/educationroot-get-users-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Educationroot Post Classes https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationroot-post-classes.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-educationclass-from-educationroot-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-educationclass-from-educationroot-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Educationschool Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationschool-delta.md
GET https://graph.microsoft.com/beta/education/schools/delta
[!INCLUDE [sample-code](../includes/snippets/php/educationschool-delta-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/educationschool-delta-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Educationschool Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationschool-get.md
GET https://graph.microsoft.com/beta/education/schools/10001
[!INCLUDE [sample-code](../includes/snippets/php/get-educationschool-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-educationschool-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Educationschool List Classes https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationschool-list-classes.md
GET https://graph.microsoft.com/beta/education/schools/10002/classes
[!INCLUDE [sample-code](../includes/snippets/php/get-classes-2-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-classes-2-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Educationsubmission Post Resources https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationsubmission-post-resources.md
Content-type: application/json
[!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)
v1.0 Educationsubmission Unsubmit https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationsubmission-unsubmit.md
POST https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-
[!INCLUDE [sample-code](../includes/snippets/php/educationsubmission-unsubmit-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/educationsubmission-unsubmit-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Educationsynchronizationprofile Reset https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationsynchronizationprofile-reset.md
POST https://graph.microsoft.com/beta/education/synchronizationProfiles/{id}/res
[!INCLUDE [sample-code](../includes/snippets/php/post-educationsynchronizationprofile-reset-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-educationsynchronizationprofile-reset-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Educationuser List Classes https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/educationuser-list-classes.md
GET https://graph.microsoft.com/beta/education/me/classes
[!INCLUDE [sample-code](../includes/snippets/php/get-classes-3-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-classes-3-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Emailauthenticationmethod Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/emailauthenticationmethod-delete.md
Title: "Delete emailAuthenticationMethod" description: "Deletes an emailAuthenticationMethod object."-+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
v1.0 Emailauthenticationmethod Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/emailauthenticationmethod-get.md
Title: "Get emailAuthenticationMethod" description: "Read the properties and relationships of an emailAuthenticationMethod object."-+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
v1.0 Emailauthenticationmethod Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/emailauthenticationmethod-update.md
Title: "Update emailAuthenticationMethod" description: "Update the properties of an emailAuthenticationMethod object."-+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
v1.0 Emailauthenticationmethodconfiguration Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/emailauthenticationmethodconfiguration-delete.md
Title: "Delete emailAuthenticationMethodConfiguration" description: "Deletes an emailAuthenticationMethodConfiguration object."-+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
v1.0 Emailauthenticationmethodconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/emailauthenticationmethodconfiguration-get.md
Title: "Get emailAuthenticationMethodConfiguration" description: "Read the properties and relationships of an emailAuthenticationMethodConfiguration object."-+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
v1.0 Emailauthenticationmethodconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/emailauthenticationmethodconfiguration-update.md
Title: "Update emailAuthenticationMethodConfiguration" description: "Update the properties of an emailAuthenticationMethodConfiguration object."-+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-emailauthenticationmethodconfiguration-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-emailauthenticationmethodconfiguration-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Entitlementmanagement List Accesspackageassignmentpolicies https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/entitlementmanagement-list-accesspackageassignmentpolicies.md
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
[!INCLUDE [sample-code](../includes/snippets/php/get-accesspackageassignmentpolicies-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-accesspackageassignmentpolicies-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Entitlementmanagement List Accesspackagecatalogs https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/entitlementmanagement-list-accesspackagecatalogs.md
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
[!INCLUDE [sample-code](../includes/snippets/php/get-accesspackagecatalogs-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-accesspackagecatalogs-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Entitlementmanagement Post Accesspackageresourcerequests https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/entitlementmanagement-post-accesspackageresourcerequests.md
Content-type: application/json
[!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)
v1.0 Event Post Attachments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/event-post-attachments.md
Content-type: application/json
[!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)
v1.0 Event Snoozereminder https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/event-snoozereminder.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/event-snoozereminder-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/event-snoozereminder-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Extensionproperty Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/extensionproperty-delete.md
Title: "Delete extensionProperty (directory extension)" description: "Delete a directory extension definition." ms.localizationpriority: medium-+ ms.prod: "extensions" doc_type: "apiPageType"
v1.0 Externalconnectors Externalconnection Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/externalconnectors-externalconnection-get.md
GET https://graph.microsoft.com/beta/external/connections/contosohr
[!INCLUDE [sample-code](../includes/snippets/php/get-connection-byid-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-connection-byid-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Externalconnectors Externalconnection Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/externalconnectors-externalconnection-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-connection-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-connection-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Featurerolloutpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/featurerolloutpolicy-get.md
GET https://graph.microsoft.com/beta/policies/featureRolloutPolicies/df85e4d9-e8
[!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)
v1.0 Federatedidentitycredential Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/federatedidentitycredential-delete.md
Title: "Delete federatedIdentityCredential" description: "Deletes a federatedIdentityCredential object."-+ ms.localizationpriority: medium ms.prod: "applications" doc_type: apiPageType
v1.0 Federatedidentitycredential Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/federatedidentitycredential-get.md
Title: "Get federatedIdentityCredential" description: "Read the properties and relationships of a federatedIdentityCredential object."-+ ms.localizationpriority: medium ms.prod: "applications" doc_type: apiPageType
v1.0 Federatedidentitycredential Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/federatedidentitycredential-update.md
Title: "Update federatedIdentityCredential" description: "Update the properties of a federatedIdentityCredential object."-+ ms.localizationpriority: medium ms.prod: "applications" doc_type: apiPageType
v1.0 Fido2authenticationmethod Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/fido2authenticationmethod-delete.md
Title: "Delete fido2AuthenticationMethod" description: "Deletes a fido2AuthenticationMethod object."-+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
v1.0 Fido2authenticationmethod Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/fido2authenticationmethod-get.md
Title: "Get fido2AuthenticationMethod" description: "Read the properties and relationships of a fido2AuthenticationMethod object."-+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
v1.0 Fido2authenticationmethod List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/fido2authenticationmethod-list.md
Title: "List fido2AuthenticationMethod" description: "Retrieve a list of the fido2AuthenticationMethod objects and their properties."-+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: apiPageType
v1.0 Fido2authenticationmethodconfiguration Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/fido2authenticationmethodconfiguration-delete.md
Title: "Delete fido2AuthenticationMethodConfiguration" description: "Delete a fido2AuthenticationMethodConfiguration object."-+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
v1.0 Fido2authenticationmethodconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/fido2authenticationmethodconfiguration-get.md
Title: "Get fido2AuthenticationMethodConfiguration" description: "Read the properties and relationships of a fido2AuthenticationMethodConfiguration object."-+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
v1.0 Fido2authenticationmethodconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/fido2authenticationmethodconfiguration-update.md
Title: "Update fido2AuthenticationMethodConfiguration" description: "Update the properties of a fido2AuthenticationMethodConfiguration object."-+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
v1.0 Group Delta https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/group-delta.md
GET https://graph.microsoft.com/beta/groups/delta?$select=displayName,descriptio
[!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)
Prefer: return=minimal
[!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)
v1.0 Group Get Conversation https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/group-get-conversation.md
GET https://graph.microsoft.com/beta/groups/02bd9fd6-8f93-4758-87c3-1fb73740a315
[!INCLUDE [sample-code](../includes/snippets/php/get-group-conversation-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-group-conversation-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Group Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/group-get.md
GET https://graph.microsoft.com/beta/groups/b320ee12-b1cd-4cca-b648-a437be61c5cd
[!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)
v1.0 Group List Permissiongrants https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/group-list-permissiongrants.md
GET https://graph.microsoft.com/beta/groups/14c981a4-dca9-4565-bae6-e13ada8861be
[!INCLUDE [sample-code](../includes/snippets/php/group-list-permission-grants-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/group-list-permission-grants-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-type: application/json
] } ```+
+## See also
+
+- [List permission grants of a chat](chat-list-permissiongrants.md)
+- [List permission grants of a team](team-list-permissiongrants.md)
+- [List permission grants of a user](user-list-permissiongrants.md)
v1.0 Group List Settings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/group-list-settings.md
Title: "List settings" description: "Retrieve a list of directory setting objects."-+ ms.localizationpriority: medium ms.prod: "directory-management" doc_type: apiPageType
v1.0 Group List Transitivememberof https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/group-list-transitivememberof.md
GET /groups/{id}/transitiveMemberOf
## Optional query parameters
-This method supports the [OData query parameters](/graph/query-parameters) to help customize the response, including `$search`, `$count`, and `$filter`. OData cast is also enabled, for example, you can cast to get just the transitive group members of a group. You can use `$search` on the **displayName** property. When items are added or updated for this resource, they are specially indexed for use with the `$count` and `$search` query parameters. There can be a slight delay between when an item is added or updated and when it is available in the index.
+This method supports the `$count`, `$expand`, `$filter`, `$orderby`, `$search`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. OData cast is also enabled, for example, you can cast to get just the transitive group members of a group. The default and maximum page sizes are 100 and 999 group objects respectively.
+
+Some queries are supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
## Request headers
v1.0 Group List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/group-list.md
GET https://graph.microsoft.com/beta/groups
[!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)
GET https://graph.microsoft.com/beta/groups?$filter=mailEnabled eq false and sec
[!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)
v1.0 Group Post Conversations https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/group-post-conversations.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-conversation-from-group-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-conversation-from-group-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Group Retryserviceprovisioning https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/group-retryserviceprovisioning.md
POST https://graph.microsoft.com/beta/groups/{id}/retryServiceProvisioning
[!INCLUDE [sample-code](../includes/snippets/php/group-retryserviceprovisioning-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/group-retryserviceprovisioning-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Group Update Thread https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/group-update-thread.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-group-thread-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-group-thread-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Identityapiconnector Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/identityapiconnector-create.md
Content-Type: application/json
[!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)
v1.0 Identityapiconnector Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/identityapiconnector-get.md
GET https://graph.microsoft.com/beta/identity/apiConnectors/{id}
[!INCLUDE [sample-code](../includes/snippets/php/get-identityapiconnector-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-identityapiconnector-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Identityapiconnector Uploadclientcertificate https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/identityapiconnector-uploadclientcertificate.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/identityapiconnector-uploadclientcertificate-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/identityapiconnector-uploadclientcertificate-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Identitycontainer List B2xuserflows https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/identitycontainer-list-b2xuserflows.md
GET https://graph.microsoft.com/beta/identity/b2xUserFlows
[!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)
GET https://graph.microsoft.com/beta/identity/b2xUserFlows?$expand=identityProvi
[!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)
v1.0 Identitygovernance Deleteditemcontainer Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/identitygovernance-deletedItemcontainer-delete.md
DELETE https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/de
[!INCLUDE [sample-code](../includes/snippets/php/lifecycleworkflows-delete-deleteditems-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/lifecycleworkflows-delete-deleteditems-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Identitygovernance Deleteditemcontainer Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/identitygovernance-deleteditemcontainer-get.md
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/delet
[!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)
v1.0 Identitygovernance Lifecyclemanagementsettings Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/identitygovernance-lifecyclemanagementsettings-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/lifecycleworkflows-update-lifecyclemanagementsettings-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/lifecycleworkflows-update-lifecyclemanagementsettings-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Identitygovernance Run List Taskprocessingresults https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/identitygovernance-run-list-taskprocessingresults.md
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workf
[!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)
v1.0 Identitygovernance Task Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/identitygovernance-task-get.md
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workf
[!INCLUDE [sample-code](../includes/snippets/php/lifecycleworkflows-get-workflowversion-task-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/lifecycleworkflows-get-workflowversion-task-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Identitygovernance Userprocessingresult List Taskprocessingresults https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/identitygovernance-userprocessingresult-list-taskprocessingresults.md
GET https://graph.microsoft.com/beta/IdentityGovernance/lifecycleWorkflows/workf
[!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)
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workf
[!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)
v1.0 Identitygovernance Userprocessingresult Summary https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/identitygovernance-userprocessingresult-summary.md
GET https://graph.microsoft.com/beta/IdentityGovernance/lifecycleWorkflows/workf
[!INCLUDE [sample-code](../includes/snippets/php/lifecycleworkflows-userprocessingresultthissummary-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/lifecycleworkflows-userprocessingresultthissummary-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Identitygovernance Workflow Createnewversion https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/identitygovernance-workflow-createnewversion.md
Content-length: 631
[!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)
v1.0 Identitygovernance Workflow List Versions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/identitygovernance-workflow-list-versions.md
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workf
[!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)
v1.0 Identitygovernance Workflow Restore https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/identitygovernance-workflow-restore.md
POST https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/dele
[!INCLUDE [sample-code](../includes/snippets/php/lifecycleworkflows-workflowthisrestore-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/lifecycleworkflows-workflowthisrestore-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Identityprotectionroot List Riskyserviceprincipals https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/identityprotectionroot-list-riskyserviceprincipals.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application|IdentityRiskyServicePrincipal.Read.All, IdentityRiskyServicePrincipal.ReadWrite.All| + ## HTTP request <!-- {
v1.0 Identityprotectionroot List Serviceprincipalriskdetections https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/identityprotectionroot-list-serviceprincipalriskdetections.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application|IdentityRiskEvent.Read.All| + ## HTTP request <!-- {
GET https://graph.microsoft.com/beta/identityProtection/servicePrincipalRiskDete
[!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)
v1.0 Identityprovider Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/identityprovider-update.md
Content-type: application/json
[!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)
v1.0 Identityproviderbase Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/identityproviderbase-delete.md
DELETE https://graph.microsoft.com/beta/identity/identityProviders/{id}
[!INCLUDE [sample-code](../includes/snippets/php/delete-identityprovider-for-id-specified-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-identityprovider-for-id-specified-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Identityproviderbase Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/identityproviderbase-get.md
GET https://graph.microsoft.com/beta/identity/identityProviders/MSASignup-OAUTH
[!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)
GET https://graph.microsoft.com/beta/identity/identityProviders/OIDC-V1-test-icm
[!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)
GET https://graph.microsoft.com/beta/identity/identityProviders/Apple-Managed-OI
[!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)
v1.0 Identitysecuritydefaultsenforcementpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/identitysecuritydefaultsenforcementpolicy-get.md
Title: "Get identitySecurityDefaultsEnforcementPolicy" description: "Retrieve the properties and relationships of identitysecuritydefaultsenforcementpolicy object." ms.localizationpriority: medium-+ ms.prod: "identity-and-sign-in" doc_type: apiPageType
v1.0 Identitysecuritydefaultsenforcementpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/identitysecuritydefaultsenforcementpolicy-update.md
Title: "Update identitySecurityDefaultsEnforcementPolicy" description: "Update the properties of an identitySecurityDefaultsEnforcementPolicy object." ms.localizationpriority: medium-+ ms.prod: "identity-and-sign-in" doc_type: apiPageType
v1.0 Identityuserflow Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/identityuserflow-delete.md
DELETE https://graph.microsoft.com/beta/identity/userFlows/{id}
[!INCLUDE [sample-code](../includes/snippets/php/delete-identityuserflow-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-identityuserflow-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Impactedresource Complete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/impactedresource-complete.md
Title: "impactedResource: complete" description: "Complete an impactedResource object and update its status to completedByUser."-+ ms.localizationpriority: medium doc_type: apiPageType
v1.0 Impactedresource Dismiss https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/impactedresource-dismiss.md
Title: "impactedResource: dismiss" description: "Dismiss a recommendationResource object and update its status to dismissed."-+ ms.localizationpriority: medium doc_type: apiPageType
v1.0 Impactedresource Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/impactedresource-get.md
Title: "Get impactedResource" description: "Read the properties and relationships of an impactedResource object."-+ ms.localizationpriority: medium doc_type: apiPageType
v1.0 Impactedresource Postpone https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/impactedresource-postpone.md
Title: "impactedResource: postpone" description: "Postpone action on an impactedResource object to a specified future date and time."-+ ms.localizationpriority: medium doc_type: apiPageType
v1.0 Impactedresource Reactivate https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/impactedresource-reactivate.md
Title: "impactedResource: reactivate" description: "Reactivate an accidentally dismissed, completed, or postponed impactedResource object."-+ ms.localizationpriority: medium doc_type: apiPageType
POST https://graph.microsoft.com/beta/directory/recommendations/0cb31920-84b9-47
[!INCLUDE [sample-code](../includes/snippets/php/impactedresourcethisreactivate-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/impactedresourcethisreactivate-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Inboundshareduserprofile Removepersonaldata https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/inboundshareduserprofile-removepersonaldata.md
POST https://graph.microsoft.com/beta/directory/inboundSharedUserProfiles/c228b2
[!INCLUDE [sample-code](../includes/snippets/php/inboundshareuserprofile-removepersonaldata-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/inboundshareuserprofile-removepersonaldata-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Industrydata Azuredatalakeconnector Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/industrydata-azuredatalakeconnector-get.md
GET https://graph.microsoft.com/beta/external/industryData/dataConnectors/51dca0
[!INCLUDE [sample-code](../includes/snippets/php/get-azuredatalakeconnector-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/get-azuredatalakeconnector-e1-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Industrydata Azuredatalakeconnector Post https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/industrydata-azuredatalakeconnector-post.md
Content-length: 104
[!INCLUDE [sample-code](../includes/snippets/php/create-azuredatalakeconnector-from-dataconnectors-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-azuredatalakeconnector-from-dataconnectors-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Industrydata Industrydatarun Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/industrydata-industrydatarun-get.md
GET https://graph.microsoft.com/beta/external/industryData/runs/918d4a8f-599b-4f
[!INCLUDE [sample-code](../includes/snippets/php/get-industrydatarun-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-industrydatarun-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Industrydata Sourcesystemdefinition List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/industrydata-sourcesystemdefinition-list.md
GET https://graph.microsoft.com/beta/external/industryData/sourceSystems
[!INCLUDE [sample-code](../includes/snippets/php/list-sourcesystemdefinition-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-sourcesystemdefinition-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Industrydata Sourcesystemdefinition Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/industrydata-sourcesystemdefinition-update.md
Content-length: 250
[!INCLUDE [sample-code](../includes/snippets/php/update-sourcesystemdefinition-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-sourcesystemdefinition-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Industrydata Yeartimeperioddefinition List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/industrydata-yeartimeperioddefinition-list.md
GET https://graph.microsoft.com/beta/external/industryData/years
[!INCLUDE [sample-code](../includes/snippets/php/list-yeartimeperioddefinition-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-yeartimeperioddefinition-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Industrydata Yeartimeperioddefinition Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/industrydata-yeartimeperioddefinition-update.md
Content-length: 242
[!INCLUDE [sample-code](../includes/snippets/php/update-yeartimeperioddefinition-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-yeartimeperioddefinition-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Insightssettings Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/insightssettings-update.md
Content-type: application/json
[!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)
v1.0 Intune Androidforwork Androiddeviceownerenrollmentprofile Createtoken https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-androidforwork-androiddeviceownerenrollmentprofile-createtoken.md
Title: "createToken action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|tokenValidityInSeconds|Int32|Not yet documented|
+|tokenValidityInSeconds|Int32||
v1.0 Intune Androidforwork Androiddeviceownerenrollmentprofile Getdefaultteamsdevicenongmsenrollmentprofile https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-androidforwork-androiddeviceownerenrollmentprofile-getdefaultteamsdevicenongmsenrollmentprofile.md
Title: "getDefaultTeamsDeviceNonGmsEnrollmentProfile action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|enrollmentMode|[androidDeviceOwnerEnrollmentMode](../resources/intune-androidforwork-androiddeviceownerenrollmentmode.md)|Not yet documented|
-|devicePublicKey|String|Not yet documented|
-|userId|String|Not yet documented|
+|enrollmentMode|[androidDeviceOwnerEnrollmentMode](../resources/intune-androidforwork-androiddeviceownerenrollmentmode.md)||
+|devicePublicKey|String||
+|userId|String||
v1.0 Intune Androidforwork Androiddeviceownerenrollmentprofile Revoketoken https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-androidforwork-androiddeviceownerenrollmentprofile-revoketoken.md
Title: "revokeToken action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Androidforwork Androidforworkenrollmentprofile Createtoken https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-androidforwork-androidforworkenrollmentprofile-createtoken.md
Title: "createToken action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|tokenValidityInSeconds|Int32|Not yet documented|
+|tokenValidityInSeconds|Int32||
v1.0 Intune Androidforwork Androidforworkenrollmentprofile Revoketoken https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-androidforwork-androidforworkenrollmentprofile-revoketoken.md
Title: "revokeToken action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Androidforwork Androidforworksettings Completesignup https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-androidforwork-androidforworksettings-completesignup.md
Title: "completeSignup action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|enterpriseToken|String|Not yet documented|
+|enterpriseToken|String||
v1.0 Intune Androidforwork Androidforworksettings Requestsignupurl https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-androidforwork-androidforworksettings-requestsignupurl.md
Title: "requestSignupUrl action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|hostName|String|Not yet documented|
+|hostName|String||
v1.0 Intune Androidforwork Androidforworksettings Syncapps https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-androidforwork-androidforworksettings-syncapps.md
Title: "syncApps action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Androidforwork Androidforworksettings Unbind https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-androidforwork-androidforworksettings-unbind.md
Title: "unbind action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Androidforwork Androidmanagedstoreaccountenterprisesettings Addapps https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-androidforwork-androidmanagedstoreaccountenterprisesettings-addapps.md
Title: "addApps action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|productIds|String collection|Not yet documented|
+|productIds|String collection||
v1.0 Intune Androidforwork Androidmanagedstoreaccountenterprisesettings Approveapps https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-androidforwork-androidmanagedstoreaccountenterprisesettings-approveapps.md
Title: "approveApps action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|packageIds|String collection|Not yet documented|
-|approveAllPermissions|Boolean|Not yet documented|
+|packageIds|String collection||
+|approveAllPermissions|Boolean||
v1.0 Intune Androidforwork Androidmanagedstoreaccountenterprisesettings Completesignup https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-androidforwork-androidmanagedstoreaccountenterprisesettings-completesignup.md
Title: "completeSignup action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|enterpriseToken|String|Not yet documented|
+|enterpriseToken|String||
v1.0 Intune Androidforwork Androidmanagedstoreaccountenterprisesettings Requestsignupurl https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-androidforwork-androidmanagedstoreaccountenterprisesettings-requestsignupurl.md
Title: "requestSignupUrl action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|hostName|String|Not yet documented|
+|hostName|String||
v1.0 Intune Androidforwork Androidmanagedstoreaccountenterprisesettings Syncapps https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-androidforwork-androidmanagedstoreaccountenterprisesettings-syncapps.md
Title: "syncApps action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Androidforwork Androidmanagedstoreaccountenterprisesettings Unbind https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-androidforwork-androidmanagedstoreaccountenterprisesettings-unbind.md
Title: "unbind action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Androidfotaservice Devicemanagementreports Getzebrafotadeploymentreport https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-androidfotaservice-devicemanagementreports-getzebrafotadeploymentreport.md
Title: "getZebraFotaDeploymentReport action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|name|String|Not yet documented|
-|select|String collection|Not yet documented|
-|search|String|Not yet documented|
-|groupBy|String collection|Not yet documented|
-|orderBy|String collection|Not yet documented|
-|skip|Int32|Not yet documented|
-|top|Int32|Not yet documented|
-|sessionId|String|Not yet documented|
-|filter|String|Not yet documented|
+|name|String||
+|select|String collection||
+|search|String||
+|groupBy|String collection||
+|orderBy|String collection||
+|skip|Int32||
+|top|Int32||
+|sessionId|String||
+|filter|String||
v1.0 Intune Androidfotaservice Zebrafotaconnector Approvefotaapps https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-androidfotaservice-zebrafotaconnector-approvefotaapps.md
Title: "approveFotaApps action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Androidfotaservice Zebrafotaconnector Connect https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-androidfotaservice-zebrafotaconnector-connect.md
Title: "connect action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Androidfotaservice Zebrafotaconnector Disconnect https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-androidfotaservice-zebrafotaconnector-disconnect.md
Title: "disconnect action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Androidfotaservice Zebrafotaconnector Hasactivedeployments https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-androidfotaservice-zebrafotaconnector-hasactivedeployments.md
Title: "hasActiveDeployments action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Androidfotaservice Zebrafotadeployment Cancel https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-androidfotaservice-zebrafotadeployment-cancel.md
Title: "cancel action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Apps Androidlobapp Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-androidlobapp-create.md
The following table shows the properties that are required when you create the a
|versionName|String|The version name of Android Line of Business (LoB) app.| |versionCode|String|The version code of Android Line of Business (LoB) app.| |identityVersion|String|The identity version. This property is being deprecated in 2302(February 2023).|
+|targetedPlatforms|[androidTargetedPlatforms](../resources/intune-apps-androidtargetedplatforms.md)|The platforms to which the application can be targeted. If not specified, will defauilt to Android Device Administrator. Possible values are: `androidDeviceAdministrator`, `androidOpenSourceProject`, `unknownFutureValue`.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps Content-type: application/json
-Content-length: 1510
+Content-length: 1562
{ "@odata.type": "#microsoft.graph.androidLobApp",
Content-length: 1510
}, "versionName": "Version Name value", "versionCode": "Version Code value",
- "identityVersion": "Identity Version value"
+ "identityVersion": "Identity Version value",
+ "targetedPlatforms": "androidOpenSourceProject"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 1682
+Content-Length: 1734
{ "@odata.type": "#microsoft.graph.androidLobApp",
Content-Length: 1682
}, "versionName": "Version Name value", "versionCode": "Version Code value",
- "identityVersion": "Identity Version value"
+ "identityVersion": "Identity Version value",
+ "targetedPlatforms": "androidOpenSourceProject"
} ```
v1.0 Intune Apps Androidlobapp Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-androidlobapp-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1809
+Content-Length: 1863
{ "value": {
Content-Length: 1809
}, "versionName": "Version Name value", "versionCode": "Version Code value",
- "identityVersion": "Identity Version value"
+ "identityVersion": "Identity Version value",
+ "targetedPlatforms": "androidOpenSourceProject"
} } ```
v1.0 Intune Apps Androidlobapp List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-androidlobapp-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1931
+Content-Length: 1987
{ "value": [
Content-Length: 1931
}, "versionName": "Version Name value", "versionCode": "Version Code value",
- "identityVersion": "Identity Version value"
+ "identityVersion": "Identity Version value",
+ "targetedPlatforms": "androidOpenSourceProject"
} ] }
v1.0 Intune Apps Androidlobapp Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-androidlobapp-update.md
The following table shows the properties that are required when you create the [
|versionName|String|The version name of Android Line of Business (LoB) app.| |versionCode|String|The version code of Android Line of Business (LoB) app.| |identityVersion|String|The identity version. This property is being deprecated in 2302(February 2023).|
+|targetedPlatforms|[androidTargetedPlatforms](../resources/intune-apps-androidtargetedplatforms.md)|The platforms to which the application can be targeted. If not specified, will defauilt to Android Device Administrator. Possible values are: `androidDeviceAdministrator`, `androidOpenSourceProject`, `unknownFutureValue`.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId} Content-type: application/json
-Content-length: 1510
+Content-length: 1562
{ "@odata.type": "#microsoft.graph.androidLobApp",
Content-length: 1510
}, "versionName": "Version Name value", "versionCode": "Version Code value",
- "identityVersion": "Identity Version value"
+ "identityVersion": "Identity Version value",
+ "targetedPlatforms": "androidOpenSourceProject"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1682
+Content-Length: 1734
{ "@odata.type": "#microsoft.graph.androidLobApp",
Content-Length: 1682
}, "versionName": "Version Name value", "versionCode": "Version Code value",
- "identityVersion": "Identity Version value"
+ "identityVersion": "Identity Version value",
+ "targetedPlatforms": "androidOpenSourceProject"
} ```
v1.0 Intune Apps Enterprisecodesigningcertificate Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-enterprisecodesigningcertificate-create.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|DeviceManagementApps.ReadWrite.All|
+|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementApps.ReadWrite.All|
+|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
## HTTP Request <!-- {
v1.0 Intune Apps Enterprisecodesigningcertificate Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-enterprisecodesigningcertificate-delete.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|DeviceManagementApps.ReadWrite.All|
+|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementApps.ReadWrite.All|
+|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
## HTTP Request <!-- {
v1.0 Intune Apps Enterprisecodesigningcertificate Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-enterprisecodesigningcertificate-get.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
+|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
+|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
## HTTP Request <!-- {
v1.0 Intune Apps Enterprisecodesigningcertificate List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-enterprisecodesigningcertificate-list.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
+|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
+|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
## HTTP Request <!-- {
v1.0 Intune Apps Enterprisecodesigningcertificate Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-enterprisecodesigningcertificate-update.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|DeviceManagementApps.ReadWrite.All|
+|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementApps.ReadWrite.All|
+|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
## HTTP Request <!-- {
v1.0 Intune Apps Macosdmgapp Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-macosdmgapp-create.md
The following table shows the properties that are required when you create the m
|committedContentVersion|String|The internal committed content version. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |fileName|String|The name of the main Lob application file. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |size|Int64|The total size, including all uploaded files. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)|
-|primaryBundleId|String|The primary CFBundleIdentifier of the DMG.|
-|primaryBundleVersion|String|The primary CFBundleVersion of the DMG.|
-|includedApps|[macOSIncludedApp](../resources/intune-apps-macosincludedapp.md) collection|The list of apps expected to be installed by the DMG.|
-|ignoreVersionDetection|Boolean|A value indicating whether the app's version will be used to detect the app after it is installed on a device. Set this to true for apps that use a self-update feature. Set this to false to install the app when it is not already installed on the device, or if the deploying app's version number does not match the version that's already installed on the device.|
-|minimumSupportedOperatingSystem|[macOSMinimumOperatingSystem](../resources/intune-apps-macosminimumoperatingsystem.md)|The value for the minimum applicable operating system.|
+|primaryBundleId|String|The bundleId of the primary .app in the DMG (Apple Disk Image). This maps to the CFBundleIdentifier in the app's bundle configuration.|
+|primaryBundleVersion|String|The version of the primary .app in the DMG (Apple Disk Image). This maps to the CFBundleShortVersion in the app's bundle configuration.|
+|includedApps|[macOSIncludedApp](../resources/intune-apps-macosincludedapp.md) collection|The list of .apps expected to be installed by the DMG (Apple Disk Image)|
+|ignoreVersionDetection|Boolean|When TRUE, indicates that the app's version will NOT be used to detect if the app is installed on a device. When FALSE, indicates that the app's version will be used to detect if the app is installed on a device. Set this to true for apps that use a self update feature. The default value is FALSE.|
+|minimumSupportedOperatingSystem|[macOSMinimumOperatingSystem](../resources/intune-apps-macosminimumoperatingsystem.md)|ComplexType macOSMinimumOperatingSystem that indicates the minimum operating system applicable for the application.|
v1.0 Intune Apps Macosdmgapp Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-macosdmgapp-update.md
The following table shows the properties that are required when you create the [
|committedContentVersion|String|The internal committed content version. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |fileName|String|The name of the main Lob application file. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |size|Int64|The total size, including all uploaded files. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)|
-|primaryBundleId|String|The primary CFBundleIdentifier of the DMG.|
-|primaryBundleVersion|String|The primary CFBundleVersion of the DMG.|
-|includedApps|[macOSIncludedApp](../resources/intune-apps-macosincludedapp.md) collection|The list of apps expected to be installed by the DMG.|
-|ignoreVersionDetection|Boolean|A value indicating whether the app's version will be used to detect the app after it is installed on a device. Set this to true for apps that use a self-update feature. Set this to false to install the app when it is not already installed on the device, or if the deploying app's version number does not match the version that's already installed on the device.|
-|minimumSupportedOperatingSystem|[macOSMinimumOperatingSystem](../resources/intune-apps-macosminimumoperatingsystem.md)|The value for the minimum applicable operating system.|
+|primaryBundleId|String|The bundleId of the primary .app in the DMG (Apple Disk Image). This maps to the CFBundleIdentifier in the app's bundle configuration.|
+|primaryBundleVersion|String|The version of the primary .app in the DMG (Apple Disk Image). This maps to the CFBundleShortVersion in the app's bundle configuration.|
+|includedApps|[macOSIncludedApp](../resources/intune-apps-macosincludedapp.md) collection|The list of .apps expected to be installed by the DMG (Apple Disk Image)|
+|ignoreVersionDetection|Boolean|When TRUE, indicates that the app's version will NOT be used to detect if the app is installed on a device. When FALSE, indicates that the app's version will be used to detect if the app is installed on a device. Set this to true for apps that use a self update feature. The default value is FALSE.|
+|minimumSupportedOperatingSystem|[macOSMinimumOperatingSystem](../resources/intune-apps-macosminimumoperatingsystem.md)|ComplexType macOSMinimumOperatingSystem that indicates the minimum operating system applicable for the application.|
v1.0 Intune Apps Macoslobapp Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-macoslobapp-create.md
The following table shows the properties that are required when you create the m
|childApps|[macOSLobChildApp](../resources/intune-apps-macoslobchildapp.md) collection|List of ComplexType macOSLobChildApp objects. Represents the apps expected to be installed by the package.| |md5HashChunkSize|Int32|The chunk size for MD5 hash. This is '0' or empty if the package was uploaded directly. If the Intune App Wrapping Tool is used to create a .intunemac, this value can be found inside the Detection.xml file.| |md5Hash|String collection|The MD5 hash codes. This is empty if the package was uploaded directly. If the Intune App Wrapping Tool is used to create a .intunemac, this value can be found inside the Detection.xml file.|
-|ignoreVersionDetection|Boolean|When TRUE, indicates that the app's version will NOT be used to detect if the app is installed on a device. When FALSE, indicates that the app's version will be used to detect if the app is installed on a device. Set this to true for apps that use a self update feature.|
-|installAsManaged|Boolean|When TRUE, indicates that the app will be installed as managed (requires macOS 11.0 and other managed package restrictions). When FALSE, indicates that the app will be installed as unmanaged.|
+|ignoreVersionDetection|Boolean|When TRUE, indicates that the app's version will NOT be used to detect if the app is installed on a device. When FALSE, indicates that the app's version will be used to detect if the app is installed on a device. Set this to true for apps that use a self update feature. The default value is FALSE.|
+|installAsManaged|Boolean|When TRUE, indicates that the app will be installed as managed (requires macOS 11.0 and other managed package restrictions). When FALSE, indicates that the app will be installed as unmanaged. The default value is FALSE.|
v1.0 Intune Apps Macoslobapp Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-macoslobapp-update.md
The following table shows the properties that are required when you create the [
|childApps|[macOSLobChildApp](../resources/intune-apps-macoslobchildapp.md) collection|List of ComplexType macOSLobChildApp objects. Represents the apps expected to be installed by the package.| |md5HashChunkSize|Int32|The chunk size for MD5 hash. This is '0' or empty if the package was uploaded directly. If the Intune App Wrapping Tool is used to create a .intunemac, this value can be found inside the Detection.xml file.| |md5Hash|String collection|The MD5 hash codes. This is empty if the package was uploaded directly. If the Intune App Wrapping Tool is used to create a .intunemac, this value can be found inside the Detection.xml file.|
-|ignoreVersionDetection|Boolean|When TRUE, indicates that the app's version will NOT be used to detect if the app is installed on a device. When FALSE, indicates that the app's version will be used to detect if the app is installed on a device. Set this to true for apps that use a self update feature.|
-|installAsManaged|Boolean|When TRUE, indicates that the app will be installed as managed (requires macOS 11.0 and other managed package restrictions). When FALSE, indicates that the app will be installed as unmanaged.|
+|ignoreVersionDetection|Boolean|When TRUE, indicates that the app's version will NOT be used to detect if the app is installed on a device. When FALSE, indicates that the app's version will be used to detect if the app is installed on a device. Set this to true for apps that use a self update feature. The default value is FALSE.|
+|installAsManaged|Boolean|When TRUE, indicates that the app will be installed as managed (requires macOS 11.0 and other managed package restrictions). When FALSE, indicates that the app will be installed as unmanaged. The default value is FALSE.|
v1.0 Intune Apps Macoswebclip Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-macoswebclip-create.md
+
+ Title: "Create macOSWebClip"
+description: "Create a new macOSWebClip object."
+
+localization_priority: Normal
++
+# Create macOSWebClip
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Create a new [macOSWebClip](../resources/intune-apps-macoswebclip.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).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceAppManagement/mobileApps
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+In the request body, supply a JSON representation for the macOSWebClip object.
+
+The following table shows the properties that are required when you create the macOSWebClip.
+
+|Property|Type|Description|
+|:|:|:|
+|id|String|Key of the entity. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|displayName|String|The admin provided or imported title of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|description|String|The description of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|publisher|String|The publisher of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|largeIcon|[mimeContent](../resources/intune-shared-mimecontent.md)|The large icon, to be displayed in the app details and used for upload of the icon. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|createdDateTime|DateTimeOffset|The date and time the app was created. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|lastModifiedDateTime|DateTimeOffset|The date and time the app was last modified. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|isFeatured|Boolean|The value indicating whether the app is marked as featured by the admin. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|privacyInformationUrl|String|The privacy statement Url. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|informationUrl|String|The more information Url. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|owner|String|The owner of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|developer|String|The developer of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|notes|String|Notes for the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|uploadState|Int32|The upload state. Possible values are: 0 - `Not Ready`, 1 - `Ready`, 2 - `Processing`. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|publishingState|[mobileAppPublishingState](../resources/intune-apps-mobileapppublishingstate.md)|The publishing state for the app. The app cannot be assigned unless the app is published. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md). Possible values are: `notPublished`, `processing`, `published`.|
+|isAssigned|Boolean|The value indicating whether the app is assigned to at least one group. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|roleScopeTagIds|String collection|List of scope tag ids for this mobile app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|appUrl|String|The web app URL starting with http:// or https://, such as https://learn.microsoft.com/mem/.|
+|fullScreenEnabled|Boolean|Whether or not to open the web clip as a full-screen web app. Defaults to false. If TRUE, opens the web clip as a full-screen web app. If FALSE, the web clip opens inside of another app.|
+|preComposedIconEnabled|Boolean|Whether or not the icon for the app is precomosed. Defaults to false. If TRUE, prevents SpringBoard from adding "shine" to the icon. If FALSE, SpringBoard can add "shine".|
+++
+## Response
+If successful, this method returns a `201 Created` response code and a [macOSWebClip](../resources/intune-apps-macoswebclip.md) object in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps
+Content-type: application/json
+Content-length: 877
+
+{
+ "@odata.type": "#microsoft.graph.macOSWebClip",
+ "displayName": "Display Name value",
+ "description": "Description value",
+ "publisher": "Publisher value",
+ "largeIcon": {
+ "@odata.type": "microsoft.graph.mimeContent",
+ "type": "Type value",
+ "value": "dmFsdWU="
+ },
+ "isFeatured": true,
+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
+ "informationUrl": "https://example.com/informationUrl/",
+ "owner": "Owner value",
+ "developer": "Developer value",
+ "notes": "Notes value",
+ "uploadState": 11,
+ "publishingState": "processing",
+ "isAssigned": true,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ],
+ "dependentAppCount": 1,
+ "supersedingAppCount": 3,
+ "supersededAppCount": 2,
+ "appUrl": "https://example.com/appUrl/",
+ "fullScreenEnabled": true,
+ "preComposedIconEnabled": true
+}
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+Content-Length: 1049
+
+{
+ "@odata.type": "#microsoft.graph.macOSWebClip",
+ "id": "fb267ec6-7ec6-fb26-c67e-26fbc67e26fb",
+ "displayName": "Display Name value",
+ "description": "Description value",
+ "publisher": "Publisher value",
+ "largeIcon": {
+ "@odata.type": "microsoft.graph.mimeContent",
+ "type": "Type value",
+ "value": "dmFsdWU="
+ },
+ "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
+ "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
+ "isFeatured": true,
+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
+ "informationUrl": "https://example.com/informationUrl/",
+ "owner": "Owner value",
+ "developer": "Developer value",
+ "notes": "Notes value",
+ "uploadState": 11,
+ "publishingState": "processing",
+ "isAssigned": true,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ],
+ "dependentAppCount": 1,
+ "supersedingAppCount": 3,
+ "supersededAppCount": 2,
+ "appUrl": "https://example.com/appUrl/",
+ "fullScreenEnabled": true,
+ "preComposedIconEnabled": true
+}
+```
v1.0 Intune Apps Macoswebclip Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-macoswebclip-delete.md
+
+ Title: "Delete macOSWebClip"
+description: "Deletes a macOSWebClip."
+
+localization_priority: Normal
++
+# Delete macOSWebClip
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Deletes a [macOSWebClip](../resources/intune-apps-macoswebclip.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).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /deviceAppManagement/mobileApps/{mobileAppId}
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns a `204 No Content` response code.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 204 No Content
+```
v1.0 Intune Apps Macoswebclip Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-macoswebclip-get.md
+
+ Title: "Get macOSWebClip"
+description: "Read properties and relationships of the macOSWebClip object."
+
+localization_priority: Normal
++
+# Get macOSWebClip
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Read properties and relationships of the [macOSWebClip](../resources/intune-apps-macoswebclip.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).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /deviceAppManagement/mobileApps/{mobileAppId}
+```
+
+## Optional query parameters
+This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns a `200 OK` response code and [macOSWebClip](../resources/intune-apps-macoswebclip.md) object in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+GET https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 1128
+
+{
+ "value": {
+ "@odata.type": "#microsoft.graph.macOSWebClip",
+ "id": "fb267ec6-7ec6-fb26-c67e-26fbc67e26fb",
+ "displayName": "Display Name value",
+ "description": "Description value",
+ "publisher": "Publisher value",
+ "largeIcon": {
+ "@odata.type": "microsoft.graph.mimeContent",
+ "type": "Type value",
+ "value": "dmFsdWU="
+ },
+ "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
+ "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
+ "isFeatured": true,
+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
+ "informationUrl": "https://example.com/informationUrl/",
+ "owner": "Owner value",
+ "developer": "Developer value",
+ "notes": "Notes value",
+ "uploadState": 11,
+ "publishingState": "processing",
+ "isAssigned": true,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ],
+ "dependentAppCount": 1,
+ "supersedingAppCount": 3,
+ "supersededAppCount": 2,
+ "appUrl": "https://example.com/appUrl/",
+ "fullScreenEnabled": true,
+ "preComposedIconEnabled": true
+ }
+}
+```
v1.0 Intune Apps Macoswebclip List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-macoswebclip-list.md
+
+ Title: "List macOSWebClips"
+description: "List properties and relationships of the macOSWebClip objects."
+
+localization_priority: Normal
++
+# List macOSWebClips
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+List properties and relationships of the [macOSWebClip](../resources/intune-apps-macoswebclip.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).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /deviceAppManagement/mobileApps
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns a `200 OK` response code and a collection of [macOSWebClip](../resources/intune-apps-macoswebclip.md) objects in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+GET https://graph.microsoft.com/beta/deviceAppManagement/mobileApps
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 1202
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.macOSWebClip",
+ "id": "fb267ec6-7ec6-fb26-c67e-26fbc67e26fb",
+ "displayName": "Display Name value",
+ "description": "Description value",
+ "publisher": "Publisher value",
+ "largeIcon": {
+ "@odata.type": "microsoft.graph.mimeContent",
+ "type": "Type value",
+ "value": "dmFsdWU="
+ },
+ "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
+ "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
+ "isFeatured": true,
+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
+ "informationUrl": "https://example.com/informationUrl/",
+ "owner": "Owner value",
+ "developer": "Developer value",
+ "notes": "Notes value",
+ "uploadState": 11,
+ "publishingState": "processing",
+ "isAssigned": true,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ],
+ "dependentAppCount": 1,
+ "supersedingAppCount": 3,
+ "supersededAppCount": 2,
+ "appUrl": "https://example.com/appUrl/",
+ "fullScreenEnabled": true,
+ "preComposedIconEnabled": true
+ }
+ ]
+}
+```
v1.0 Intune Apps Macoswebclip Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-macoswebclip-update.md
+
+ Title: "Update macOSWebClip"
+description: "Update the properties of a macOSWebClip object."
+
+localization_priority: Normal
++
+# Update macOSWebClip
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Update the properties of a [macOSWebClip](../resources/intune-apps-macoswebclip.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).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /deviceAppManagement/mobileApps/{mobileAppId}
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+In the request body, supply a JSON representation for the [macOSWebClip](../resources/intune-apps-macoswebclip.md) object.
+
+The following table shows the properties that are required when you create the [macOSWebClip](../resources/intune-apps-macoswebclip.md).
+
+|Property|Type|Description|
+|:|:|:|
+|id|String|Key of the entity. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|displayName|String|The admin provided or imported title of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|description|String|The description of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|publisher|String|The publisher of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|largeIcon|[mimeContent](../resources/intune-shared-mimecontent.md)|The large icon, to be displayed in the app details and used for upload of the icon. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|createdDateTime|DateTimeOffset|The date and time the app was created. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|lastModifiedDateTime|DateTimeOffset|The date and time the app was last modified. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|isFeatured|Boolean|The value indicating whether the app is marked as featured by the admin. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|privacyInformationUrl|String|The privacy statement Url. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|informationUrl|String|The more information Url. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|owner|String|The owner of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|developer|String|The developer of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|notes|String|Notes for the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|uploadState|Int32|The upload state. Possible values are: 0 - `Not Ready`, 1 - `Ready`, 2 - `Processing`. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|publishingState|[mobileAppPublishingState](../resources/intune-apps-mobileapppublishingstate.md)|The publishing state for the app. The app cannot be assigned unless the app is published. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md). Possible values are: `notPublished`, `processing`, `published`.|
+|isAssigned|Boolean|The value indicating whether the app is assigned to at least one group. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|roleScopeTagIds|String collection|List of scope tag ids for this mobile app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|appUrl|String|The web app URL starting with http:// or https://, such as https://learn.microsoft.com/mem/.|
+|fullScreenEnabled|Boolean|Whether or not to open the web clip as a full-screen web app. Defaults to false. If TRUE, opens the web clip as a full-screen web app. If FALSE, the web clip opens inside of another app.|
+|preComposedIconEnabled|Boolean|Whether or not the icon for the app is precomosed. Defaults to false. If TRUE, prevents SpringBoard from adding "shine" to the icon. If FALSE, SpringBoard can add "shine".|
+++
+## Response
+If successful, this method returns a `200 OK` response code and an updated [macOSWebClip](../resources/intune-apps-macoswebclip.md) object in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}
+Content-type: application/json
+Content-length: 877
+
+{
+ "@odata.type": "#microsoft.graph.macOSWebClip",
+ "displayName": "Display Name value",
+ "description": "Description value",
+ "publisher": "Publisher value",
+ "largeIcon": {
+ "@odata.type": "microsoft.graph.mimeContent",
+ "type": "Type value",
+ "value": "dmFsdWU="
+ },
+ "isFeatured": true,
+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
+ "informationUrl": "https://example.com/informationUrl/",
+ "owner": "Owner value",
+ "developer": "Developer value",
+ "notes": "Notes value",
+ "uploadState": 11,
+ "publishingState": "processing",
+ "isAssigned": true,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ],
+ "dependentAppCount": 1,
+ "supersedingAppCount": 3,
+ "supersededAppCount": 2,
+ "appUrl": "https://example.com/appUrl/",
+ "fullScreenEnabled": true,
+ "preComposedIconEnabled": true
+}
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 1049
+
+{
+ "@odata.type": "#microsoft.graph.macOSWebClip",
+ "id": "fb267ec6-7ec6-fb26-c67e-26fbc67e26fb",
+ "displayName": "Display Name value",
+ "description": "Description value",
+ "publisher": "Publisher value",
+ "largeIcon": {
+ "@odata.type": "microsoft.graph.mimeContent",
+ "type": "Type value",
+ "value": "dmFsdWU="
+ },
+ "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
+ "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
+ "isFeatured": true,
+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
+ "informationUrl": "https://example.com/informationUrl/",
+ "owner": "Owner value",
+ "developer": "Developer value",
+ "notes": "Notes value",
+ "uploadState": 11,
+ "publishingState": "processing",
+ "isAssigned": true,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ],
+ "dependentAppCount": 1,
+ "supersedingAppCount": 3,
+ "supersededAppCount": 2,
+ "appUrl": "https://example.com/appUrl/",
+ "fullScreenEnabled": true,
+ "preComposedIconEnabled": true
+}
+```
v1.0 Intune Apps Managedandroidlobapp Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-managedandroidlobapp-create.md
The following table shows the properties that are required when you create the m
|versionName|String|The version name of managed Android Line of Business (LoB) app.| |versionCode|String|The version code of managed Android Line of Business (LoB) app.| |identityVersion|String|The identity version. This property is being deprecated in 2302(February 2023).|
+|targetedPlatforms|[androidTargetedPlatforms](../resources/intune-apps-androidtargetedplatforms.md)|The platforms to which the application can be targeted. If not specified, will defauilt to Android Device Administrator. Possible values are: `androidDeviceAdministrator`, `androidOpenSourceProject`, `unknownFutureValue`.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps Content-type: application/json
-Content-length: 1588
+Content-length: 1640
{ "@odata.type": "#microsoft.graph.managedAndroidLobApp",
Content-length: 1588
}, "versionName": "Version Name value", "versionCode": "Version Code value",
- "identityVersion": "Identity Version value"
+ "identityVersion": "Identity Version value",
+ "targetedPlatforms": "androidOpenSourceProject"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 1760
+Content-Length: 1812
{ "@odata.type": "#microsoft.graph.managedAndroidLobApp",
Content-Length: 1760
}, "versionName": "Version Name value", "versionCode": "Version Code value",
- "identityVersion": "Identity Version value"
+ "identityVersion": "Identity Version value",
+ "targetedPlatforms": "androidOpenSourceProject"
} ```
v1.0 Intune Apps Managedandroidlobapp Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-managedandroidlobapp-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1891
+Content-Length: 1945
{ "value": {
Content-Length: 1891
}, "versionName": "Version Name value", "versionCode": "Version Code value",
- "identityVersion": "Identity Version value"
+ "identityVersion": "Identity Version value",
+ "targetedPlatforms": "androidOpenSourceProject"
} } ```
v1.0 Intune Apps Managedandroidlobapp List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-managedandroidlobapp-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 2017
+Content-Length: 2073
{ "value": [
Content-Length: 2017
}, "versionName": "Version Name value", "versionCode": "Version Code value",
- "identityVersion": "Identity Version value"
+ "identityVersion": "Identity Version value",
+ "targetedPlatforms": "androidOpenSourceProject"
} ] }
v1.0 Intune Apps Managedandroidlobapp Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-managedandroidlobapp-update.md
The following table shows the properties that are required when you create the [
|versionName|String|The version name of managed Android Line of Business (LoB) app.| |versionCode|String|The version code of managed Android Line of Business (LoB) app.| |identityVersion|String|The identity version. This property is being deprecated in 2302(February 2023).|
+|targetedPlatforms|[androidTargetedPlatforms](../resources/intune-apps-androidtargetedplatforms.md)|The platforms to which the application can be targeted. If not specified, will defauilt to Android Device Administrator. Possible values are: `androidDeviceAdministrator`, `androidOpenSourceProject`, `unknownFutureValue`.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId} Content-type: application/json
-Content-length: 1588
+Content-length: 1640
{ "@odata.type": "#microsoft.graph.managedAndroidLobApp",
Content-length: 1588
}, "versionName": "Version Name value", "versionCode": "Version Code value",
- "identityVersion": "Identity Version value"
+ "identityVersion": "Identity Version value",
+ "targetedPlatforms": "androidOpenSourceProject"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1760
+Content-Length: 1812
{ "@odata.type": "#microsoft.graph.managedAndroidLobApp",
Content-Length: 1760
}, "versionName": "Version Name value", "versionCode": "Version Code value",
- "identityVersion": "Identity Version value"
+ "identityVersion": "Identity Version value",
+ "targetedPlatforms": "androidOpenSourceProject"
} ```
v1.0 Intune Apps Manageddevicemobileappconfiguration Assign https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-manageddevicemobileappconfiguration-assign.md
Title: "assign action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|assignments|[managedDeviceMobileAppConfigurationAssignment](../resources/intune-apps-manageddevicemobileappconfigurationassignment.md) collection|Not yet documented|
+|assignments|[managedDeviceMobileAppConfigurationAssignment](../resources/intune-apps-manageddevicemobileappconfigurationassignment.md) collection||
v1.0 Intune Apps Mobileapp Createcatalogapp https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-mobileapp-createcatalogapp.md
Title: "createCatalogApp action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|mobileApp|[mobileApp](../resources/intune-shared-mobileapp.md)|Not yet documented|
-|relationships|[mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md) collection|Not yet documented|
-|mobileAppAssignments|[mobileAppAssignment](../resources/intune-apps-mobileappassignment.md) collection|Not yet documented|
+|mobileApp|[mobileApp](../resources/intune-shared-mobileapp.md)||
+|relationships|[mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md) collection||
+|mobileAppAssignments|[mobileAppAssignment](../resources/intune-apps-mobileappassignment.md) collection||
v1.0 Intune Apps Mobileapp Getpublishingconstraints https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-mobileapp-getpublishingconstraints.md
Title: "getPublishingConstraints function"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Apps Mobileapp Validatexml https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-mobileapp-validatexml.md
Title: "validateXml action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|officeConfigurationXml|Binary|Not yet documented|
+|officeConfigurationXml|Binary||
v1.0 Intune Apps Win32lobapp Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-win32lobapp-create.md
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps Content-type: application/json
-Content-length: 3487
+Content-length: 3518
{ "@odata.type": "#microsoft.graph.win32LobApp",
Content-length: 3487
"installExperience": { "@odata.type": "microsoft.graph.win32LobAppInstallExperience", "runAsAccount": "user",
+ "maxRunTimeInMinutes": 3,
"deviceRestartBehavior": "allow" }, "returnCodes": [
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 3659
+Content-Length: 3690
{ "@odata.type": "#microsoft.graph.win32LobApp",
Content-Length: 3659
"installExperience": { "@odata.type": "microsoft.graph.win32LobAppInstallExperience", "runAsAccount": "user",
+ "maxRunTimeInMinutes": 3,
"deviceRestartBehavior": "allow" }, "returnCodes": [
v1.0 Intune Apps Win32lobapp Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-win32lobapp-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 3904
+Content-Length: 3937
{ "value": {
Content-Length: 3904
"installExperience": { "@odata.type": "microsoft.graph.win32LobAppInstallExperience", "runAsAccount": "user",
+ "maxRunTimeInMinutes": 3,
"deviceRestartBehavior": "allow" }, "returnCodes": [
v1.0 Intune Apps Win32lobapp List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-win32lobapp-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 4144
+Content-Length: 4179
{ "value": [
Content-Length: 4144
"installExperience": { "@odata.type": "microsoft.graph.win32LobAppInstallExperience", "runAsAccount": "user",
+ "maxRunTimeInMinutes": 3,
"deviceRestartBehavior": "allow" }, "returnCodes": [
v1.0 Intune Apps Win32lobapp Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-win32lobapp-update.md
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId} Content-type: application/json
-Content-length: 3487
+Content-length: 3518
{ "@odata.type": "#microsoft.graph.win32LobApp",
Content-length: 3487
"installExperience": { "@odata.type": "microsoft.graph.win32LobAppInstallExperience", "runAsAccount": "user",
+ "maxRunTimeInMinutes": 3,
"deviceRestartBehavior": "allow" }, "returnCodes": [
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 3659
+Content-Length: 3690
{ "@odata.type": "#microsoft.graph.win32LobApp",
Content-Length: 3659
"installExperience": { "@odata.type": "microsoft.graph.win32LobAppInstallExperience", "runAsAccount": "user",
+ "maxRunTimeInMinutes": 3,
"deviceRestartBehavior": "allow" }, "returnCodes": [
v1.0 Intune Apps Windowsuniversalappx Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-windowsuniversalappx-create.md
The following table shows the properties that are required when you create the w
|committedContentVersion|String|The internal committed content version. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |fileName|String|The name of the main Lob application file. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |size|Int64|The total size, including all uploaded files. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)|
-|applicableArchitectures|[windowsArchitecture](../resources/intune-apps-windowsarchitecture.md)|The Windows architecture(s) for which this app can run on. Possible values are: `none`, `x86`, `x64`, `arm`, `neutral`, `arm64`.|
-|applicableDeviceTypes|[windowsDeviceType](../resources/intune-apps-windowsdevicetype.md)|The Windows device type(s) for which this app can run on. Possible values are: `none`, `desktop`, `mobile`, `holographic`, `team`.|
-|identityName|String|The Identity Name.|
-|identityPublisherHash|String|The Identity Publisher Hash.|
-|identityResourceIdentifier|String|The Identity Resource Identifier.|
-|isBundle|Boolean|Whether or not the app is a bundle.|
-|minimumSupportedOperatingSystem|[windowsMinimumOperatingSystem](../resources/intune-apps-windowsminimumoperatingsystem.md)|The value for the minimum applicable operating system.|
-|identityVersion|String|The identity version.|
+|applicableArchitectures|[windowsArchitecture](../resources/intune-apps-windowsarchitecture.md)|The Windows architecture(s) for which this app can run on. Possible values are: `none`, `x86`, `x64`, `arm`, `neutral`; default value is `none`. Possible values are: `none`, `x86`, `x64`, `arm`, `neutral`, `arm64`.|
+|applicableDeviceTypes|[windowsDeviceType](../resources/intune-apps-windowsdevicetype.md)|The Windows device type(s) for which this app can run on. Possible values are: `none`, `desktop`, `mobile`, `holographic`, `team`; default value is `none`. Possible values are: `none`, `desktop`, `mobile`, `holographic`, `team`, `unknownFutureValue`.|
+|identityName|String|The Identity Name of the app, parsed from the appx file when it is uploaded through the Intune MEM console. For example: "Contoso.DemoApp".|
+|identityPublisherHash|String|The Identity Publisher Hash of the app, parsed from the appx file when it is uploaded through the Intune MEM console. For example: "AB82CD0XYZ".|
+|identityResourceIdentifier|String|The Identity Resource Identifier of the app, parsed from the appx file when it is uploaded through the Intune MEM console. For example: "TestResourceId".|
+|isBundle|Boolean|Whether or not the app is a bundle. If TRUE, app is a bundle; if FALSE, app is not a bundle.|
+|minimumSupportedOperatingSystem|[windowsMinimumOperatingSystem](../resources/intune-apps-windowsminimumoperatingsystem.md)|The value for the minimum applicable Windows operating system.|
+|identityVersion|String|The Identity Version of the app, parsed from the appx file when it is uploaded through the Intune MEM console. For example: "1.0.0.0".|
v1.0 Intune Apps Windowsuniversalappx Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-apps-windowsuniversalappx-update.md
The following table shows the properties that are required when you create the [
|committedContentVersion|String|The internal committed content version. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |fileName|String|The name of the main Lob application file. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |size|Int64|The total size, including all uploaded files. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)|
-|applicableArchitectures|[windowsArchitecture](../resources/intune-apps-windowsarchitecture.md)|The Windows architecture(s) for which this app can run on. Possible values are: `none`, `x86`, `x64`, `arm`, `neutral`, `arm64`.|
-|applicableDeviceTypes|[windowsDeviceType](../resources/intune-apps-windowsdevicetype.md)|The Windows device type(s) for which this app can run on. Possible values are: `none`, `desktop`, `mobile`, `holographic`, `team`.|
-|identityName|String|The Identity Name.|
-|identityPublisherHash|String|The Identity Publisher Hash.|
-|identityResourceIdentifier|String|The Identity Resource Identifier.|
-|isBundle|Boolean|Whether or not the app is a bundle.|
-|minimumSupportedOperatingSystem|[windowsMinimumOperatingSystem](../resources/intune-apps-windowsminimumoperatingsystem.md)|The value for the minimum applicable operating system.|
-|identityVersion|String|The identity version.|
+|applicableArchitectures|[windowsArchitecture](../resources/intune-apps-windowsarchitecture.md)|The Windows architecture(s) for which this app can run on. Possible values are: `none`, `x86`, `x64`, `arm`, `neutral`; default value is `none`. Possible values are: `none`, `x86`, `x64`, `arm`, `neutral`, `arm64`.|
+|applicableDeviceTypes|[windowsDeviceType](../resources/intune-apps-windowsdevicetype.md)|The Windows device type(s) for which this app can run on. Possible values are: `none`, `desktop`, `mobile`, `holographic`, `team`; default value is `none`. Possible values are: `none`, `desktop`, `mobile`, `holographic`, `team`, `unknownFutureValue`.|
+|identityName|String|The Identity Name of the app, parsed from the appx file when it is uploaded through the Intune MEM console. For example: "Contoso.DemoApp".|
+|identityPublisherHash|String|The Identity Publisher Hash of the app, parsed from the appx file when it is uploaded through the Intune MEM console. For example: "AB82CD0XYZ".|
+|identityResourceIdentifier|String|The Identity Resource Identifier of the app, parsed from the appx file when it is uploaded through the Intune MEM console. For example: "TestResourceId".|
+|isBundle|Boolean|Whether or not the app is a bundle. If TRUE, app is a bundle; if FALSE, app is not a bundle.|
+|minimumSupportedOperatingSystem|[windowsMinimumOperatingSystem](../resources/intune-apps-windowsminimumoperatingsystem.md)|The value for the minimum applicable Windows operating system.|
+|identityVersion|String|The Identity Version of the app, parsed from the appx file when it is uploaded through the Intune MEM console. For example: "1.0.0.0".|
v1.0 Intune Auditing Auditevent Getauditactivitytypes https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-auditing-auditevent-getauditactivitytypes.md
Title: "getAuditActivityTypes function"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this function.
|Property|Type|Description| |:|:|:|
-|category|String|Not yet documented|
+|category|String||
v1.0 Intune Auditing Auditevent Getauditcategories https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-auditing-auditevent-getauditcategories.md
Title: "getAuditCategories function"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Books Managedebook Assign https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-books-managedebook-assign.md
Title: "assign action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|managedEBookAssignments|[managedEBookAssignment](../resources/intune-books-managedebookassignment.md) collection|Not yet documented|
+|managedEBookAssignments|[managedEBookAssignment](../resources/intune-books-managedebookassignment.md) collection||
v1.0 Intune Chromebooksync Chromeosonboardingsettings Connect https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-chromebooksync-chromeosonboardingsettings-connect.md
Title: "connect action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|ownerUserPrincipalName|String|Not yet documented|
-|ownerAccessToken|String|Not yet documented|
+|ownerUserPrincipalName|String||
+|ownerAccessToken|String||
v1.0 Intune Chromebooksync Chromeosonboardingsettings Disconnect https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-chromebooksync-chromeosonboardingsettings-disconnect.md
Title: "disconnect action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Deviceconfig Androiddeviceownergeneraldeviceconfiguration Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-androiddeviceownergeneraldeviceconfiguration-create.md
The following table shows the properties that are required when you create the a
|workProfilePasswordRequireUnlock|[androidDeviceOwnerRequiredPasswordUnlock](../resources/intune-deviceconfig-androiddeviceownerrequiredpasswordunlock.md)|Indicates the timeout period after which a work profile must be unlocked using a form of strong authentication. Possible values are: `deviceDefault`, `daily`, `unkownFutureValue`.| |locateDeviceUserlessDisabled|Boolean|Indicates whether or not LocateDevice for userless (COSU) devices is disabled.| |locateDeviceLostModeEnabled|Boolean|Indicates whether or not LocateDevice for devices with lost mode (COBO, COPE) is enabled.|
+|androidDeviceOwnerDelegatedScopeAppSettings|[androidDeviceOwnerDelegatedScopeAppSetting](../resources/intune-deviceconfig-androiddeviceownerdelegatedscopeappsetting.md) collection|Specifies the list of managed apps with app details and its associated delegated scope(s). This collection can contain a maximum of 500 elements.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations Content-type: application/json
-Content-length: 10171
+Content-length: 10640
{ "@odata.type": "#microsoft.graph.androidDeviceOwnerGeneralDeviceConfiguration",
Content-length: 10171
"workProfilePasswordRequiredType": "required", "workProfilePasswordRequireUnlock": "daily", "locateDeviceUserlessDisabled": true,
- "locateDeviceLostModeEnabled": true
+ "locateDeviceLostModeEnabled": true,
+ "androidDeviceOwnerDelegatedScopeAppSettings": [
+ {
+ "@odata.type": "microsoft.graph.androidDeviceOwnerDelegatedScopeAppSetting",
+ "appDetail": {
+ "@odata.type": "microsoft.graph.appListItem",
+ "name": "Name value",
+ "publisher": "Publisher value",
+ "appStoreUrl": "https://example.com/appStoreUrl/",
+ "appId": "App Id value"
+ },
+ "appScopes": [
+ "certificateInstall"
+ ]
+ }
+ ]
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 10343
+Content-Length: 10812
{ "@odata.type": "#microsoft.graph.androidDeviceOwnerGeneralDeviceConfiguration",
Content-Length: 10343
"workProfilePasswordRequiredType": "required", "workProfilePasswordRequireUnlock": "daily", "locateDeviceUserlessDisabled": true,
- "locateDeviceLostModeEnabled": true
+ "locateDeviceLostModeEnabled": true,
+ "androidDeviceOwnerDelegatedScopeAppSettings": [
+ {
+ "@odata.type": "microsoft.graph.androidDeviceOwnerDelegatedScopeAppSetting",
+ "appDetail": {
+ "@odata.type": "microsoft.graph.appListItem",
+ "name": "Name value",
+ "publisher": "Publisher value",
+ "appStoreUrl": "https://example.com/appStoreUrl/",
+ "appId": "App Id value"
+ },
+ "appScopes": [
+ "certificateInstall"
+ ]
+ }
+ ]
} ```
v1.0 Intune Deviceconfig Androiddeviceownergeneraldeviceconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-androiddeviceownergeneraldeviceconfiguration-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 10890
+Content-Length: 11389
{ "value": {
Content-Length: 10890
"workProfilePasswordRequiredType": "required", "workProfilePasswordRequireUnlock": "daily", "locateDeviceUserlessDisabled": true,
- "locateDeviceLostModeEnabled": true
+ "locateDeviceLostModeEnabled": true,
+ "androidDeviceOwnerDelegatedScopeAppSettings": [
+ {
+ "@odata.type": "microsoft.graph.androidDeviceOwnerDelegatedScopeAppSetting",
+ "appDetail": {
+ "@odata.type": "microsoft.graph.appListItem",
+ "name": "Name value",
+ "publisher": "Publisher value",
+ "appStoreUrl": "https://example.com/appStoreUrl/",
+ "appId": "App Id value"
+ },
+ "appScopes": [
+ "certificateInstall"
+ ]
+ }
+ ]
} } ```
v1.0 Intune Deviceconfig Androiddeviceownergeneraldeviceconfiguration List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-androiddeviceownergeneraldeviceconfiguration-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 11432
+Content-Length: 11961
{ "value": [
Content-Length: 11432
"workProfilePasswordRequiredType": "required", "workProfilePasswordRequireUnlock": "daily", "locateDeviceUserlessDisabled": true,
- "locateDeviceLostModeEnabled": true
+ "locateDeviceLostModeEnabled": true,
+ "androidDeviceOwnerDelegatedScopeAppSettings": [
+ {
+ "@odata.type": "microsoft.graph.androidDeviceOwnerDelegatedScopeAppSetting",
+ "appDetail": {
+ "@odata.type": "microsoft.graph.appListItem",
+ "name": "Name value",
+ "publisher": "Publisher value",
+ "appStoreUrl": "https://example.com/appStoreUrl/",
+ "appId": "App Id value"
+ },
+ "appScopes": [
+ "certificateInstall"
+ ]
+ }
+ ]
} ] }
v1.0 Intune Deviceconfig Androiddeviceownergeneraldeviceconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-androiddeviceownergeneraldeviceconfiguration-update.md
The following table shows the properties that are required when you create the [
|workProfilePasswordRequireUnlock|[androidDeviceOwnerRequiredPasswordUnlock](../resources/intune-deviceconfig-androiddeviceownerrequiredpasswordunlock.md)|Indicates the timeout period after which a work profile must be unlocked using a form of strong authentication. Possible values are: `deviceDefault`, `daily`, `unkownFutureValue`.| |locateDeviceUserlessDisabled|Boolean|Indicates whether or not LocateDevice for userless (COSU) devices is disabled.| |locateDeviceLostModeEnabled|Boolean|Indicates whether or not LocateDevice for devices with lost mode (COBO, COPE) is enabled.|
+|androidDeviceOwnerDelegatedScopeAppSettings|[androidDeviceOwnerDelegatedScopeAppSetting](../resources/intune-deviceconfig-androiddeviceownerdelegatedscopeappsetting.md) collection|Specifies the list of managed apps with app details and its associated delegated scope(s). This collection can contain a maximum of 500 elements.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId} Content-type: application/json
-Content-length: 10171
+Content-length: 10640
{ "@odata.type": "#microsoft.graph.androidDeviceOwnerGeneralDeviceConfiguration",
Content-length: 10171
"workProfilePasswordRequiredType": "required", "workProfilePasswordRequireUnlock": "daily", "locateDeviceUserlessDisabled": true,
- "locateDeviceLostModeEnabled": true
+ "locateDeviceLostModeEnabled": true,
+ "androidDeviceOwnerDelegatedScopeAppSettings": [
+ {
+ "@odata.type": "microsoft.graph.androidDeviceOwnerDelegatedScopeAppSetting",
+ "appDetail": {
+ "@odata.type": "microsoft.graph.appListItem",
+ "name": "Name value",
+ "publisher": "Publisher value",
+ "appStoreUrl": "https://example.com/appStoreUrl/",
+ "appId": "App Id value"
+ },
+ "appScopes": [
+ "certificateInstall"
+ ]
+ }
+ ]
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 10343
+Content-Length: 10812
{ "@odata.type": "#microsoft.graph.androidDeviceOwnerGeneralDeviceConfiguration",
Content-Length: 10343
"workProfilePasswordRequiredType": "required", "workProfilePasswordRequireUnlock": "daily", "locateDeviceUserlessDisabled": true,
- "locateDeviceLostModeEnabled": true
+ "locateDeviceLostModeEnabled": true,
+ "androidDeviceOwnerDelegatedScopeAppSettings": [
+ {
+ "@odata.type": "microsoft.graph.androidDeviceOwnerDelegatedScopeAppSetting",
+ "appDetail": {
+ "@odata.type": "microsoft.graph.appListItem",
+ "name": "Name value",
+ "publisher": "Publisher value",
+ "appStoreUrl": "https://example.com/appStoreUrl/",
+ "appId": "App Id value"
+ },
+ "appScopes": [
+ "certificateInstall"
+ ]
+ }
+ ]
} ```
v1.0 Intune Deviceconfig Androiddeviceownervpnconfiguration Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-androiddeviceownervpnconfiguration-create.md
The following table shows the properties that are required when you create the a
|alwaysOn|Boolean|Whether or not to enable always-on VPN connection.| |alwaysOnLockdown|Boolean|If always-on VPN connection is enabled, whether or not to lock network traffic when that VPN is disconnected.| |microsoftTunnelSiteId|String|Microsoft Tunnel site ID.|
+|proxyExclusionList|String collection|List of hosts to exclude using the proxy on connections for. These hosts can use wildcards such as *.example.com.|
|customData|[keyValue](../resources/intune-deviceconfig-keyvalue.md) collection|Custom data to define key/value pairs specific to a VPN provider. This collection can contain a maximum of 25 elements.| |customKeyValueData|[keyValuePair](../resources/intune-deviceconfig-keyvaluepair.md) collection|Custom data to define key/value pairs specific to a VPN provider. This collection can contain a maximum of 25 elements.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations Content-type: application/json
-Content-length: 2383
+Content-length: 2450
{ "@odata.type": "#microsoft.graph.androidDeviceOwnerVpnConfiguration",
Content-length: 2383
"alwaysOn": true, "alwaysOnLockdown": true, "microsoftTunnelSiteId": "Microsoft Tunnel Site Id value",
+ "proxyExclusionList": [
+ "Proxy Exclusion List value"
+ ],
"customData": [ { "@odata.type": "microsoft.graph.keyValue",
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 2555
+Content-Length: 2622
{ "@odata.type": "#microsoft.graph.androidDeviceOwnerVpnConfiguration",
Content-Length: 2555
"alwaysOn": true, "alwaysOnLockdown": true, "microsoftTunnelSiteId": "Microsoft Tunnel Site Id value",
+ "proxyExclusionList": [
+ "Proxy Exclusion List value"
+ ],
"customData": [ { "@odata.type": "microsoft.graph.keyValue",
v1.0 Intune Deviceconfig Androiddeviceownervpnconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-androiddeviceownervpnconfiguration-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 2734
+Content-Length: 2807
{ "value": {
Content-Length: 2734
"alwaysOn": true, "alwaysOnLockdown": true, "microsoftTunnelSiteId": "Microsoft Tunnel Site Id value",
+ "proxyExclusionList": [
+ "Proxy Exclusion List value"
+ ],
"customData": [ { "@odata.type": "microsoft.graph.keyValue",
v1.0 Intune Deviceconfig Androiddeviceownervpnconfiguration List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-androiddeviceownervpnconfiguration-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 2908
+Content-Length: 2987
{ "value": [
Content-Length: 2908
"alwaysOn": true, "alwaysOnLockdown": true, "microsoftTunnelSiteId": "Microsoft Tunnel Site Id value",
+ "proxyExclusionList": [
+ "Proxy Exclusion List value"
+ ],
"customData": [ { "@odata.type": "microsoft.graph.keyValue",
v1.0 Intune Deviceconfig Androiddeviceownervpnconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-androiddeviceownervpnconfiguration-update.md
The following table shows the properties that are required when you create the [
|alwaysOn|Boolean|Whether or not to enable always-on VPN connection.| |alwaysOnLockdown|Boolean|If always-on VPN connection is enabled, whether or not to lock network traffic when that VPN is disconnected.| |microsoftTunnelSiteId|String|Microsoft Tunnel site ID.|
+|proxyExclusionList|String collection|List of hosts to exclude using the proxy on connections for. These hosts can use wildcards such as *.example.com.|
|customData|[keyValue](../resources/intune-deviceconfig-keyvalue.md) collection|Custom data to define key/value pairs specific to a VPN provider. This collection can contain a maximum of 25 elements.| |customKeyValueData|[keyValuePair](../resources/intune-deviceconfig-keyvaluepair.md) collection|Custom data to define key/value pairs specific to a VPN provider. This collection can contain a maximum of 25 elements.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId} Content-type: application/json
-Content-length: 2383
+Content-length: 2450
{ "@odata.type": "#microsoft.graph.androidDeviceOwnerVpnConfiguration",
Content-length: 2383
"alwaysOn": true, "alwaysOnLockdown": true, "microsoftTunnelSiteId": "Microsoft Tunnel Site Id value",
+ "proxyExclusionList": [
+ "Proxy Exclusion List value"
+ ],
"customData": [ { "@odata.type": "microsoft.graph.keyValue",
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 2555
+Content-Length: 2622
{ "@odata.type": "#microsoft.graph.androidDeviceOwnerVpnConfiguration",
Content-Length: 2555
"alwaysOn": true, "alwaysOnLockdown": true, "microsoftTunnelSiteId": "Microsoft Tunnel Site Id value",
+ "proxyExclusionList": [
+ "Proxy Exclusion List value"
+ ],
"customData": [ { "@odata.type": "microsoft.graph.keyValue",
v1.0 Intune Deviceconfig Androidforworkgeneraldeviceconfiguration Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-androidforworkgeneraldeviceconfiguration-create.md
The following table shows the properties that are required when you create the a
|workProfileBlockPersonalAppInstallsFromUnknownSources|Boolean|Prevent app installations from unknown sources in the personal profile.| |workProfileAccountUse|[androidWorkProfileAccountUse](../resources/intune-deviceconfig-androidworkprofileaccountuse.md)|Control user's ability to add accounts in work profile including Google accounts. Possible values are: `allowAllExceptGoogleAccounts`, `blockAll`, `allowAll`, `unknownFutureValue`.| |allowedGoogleAccountDomains|String collection|Determine domains allow-list for accounts that can be added to work profile.|
+|blockUnifiedPasswordForWorkProfile|Boolean|Prevent using unified password for unlocking device and work profile.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations Content-type: application/json
-Content-length: 3296
+Content-length: 3343
{ "@odata.type": "#microsoft.graph.androidForWorkGeneralDeviceConfiguration",
Content-length: 3296
"workProfileAccountUse": "blockAll", "allowedGoogleAccountDomains": [ "Allowed Google Account Domains value"
- ]
+ ],
+ "blockUnifiedPasswordForWorkProfile": true
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 3468
+Content-Length: 3515
{ "@odata.type": "#microsoft.graph.androidForWorkGeneralDeviceConfiguration",
Content-Length: 3468
"workProfileAccountUse": "blockAll", "allowedGoogleAccountDomains": [ "Allowed Google Account Domains value"
- ]
+ ],
+ "blockUnifiedPasswordForWorkProfile": true
} ```
v1.0 Intune Deviceconfig Androidforworkgeneraldeviceconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-androidforworkgeneraldeviceconfiguration-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 3647
+Content-Length: 3696
{ "value": {
Content-Length: 3647
"workProfileAccountUse": "blockAll", "allowedGoogleAccountDomains": [ "Allowed Google Account Domains value"
- ]
+ ],
+ "blockUnifiedPasswordForWorkProfile": true
} } ```
v1.0 Intune Deviceconfig Androidforworkgeneraldeviceconfiguration List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-androidforworkgeneraldeviceconfiguration-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 3821
+Content-Length: 3872
{ "value": [
Content-Length: 3821
"workProfileAccountUse": "blockAll", "allowedGoogleAccountDomains": [ "Allowed Google Account Domains value"
- ]
+ ],
+ "blockUnifiedPasswordForWorkProfile": true
} ] }
v1.0 Intune Deviceconfig Androidforworkgeneraldeviceconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-androidforworkgeneraldeviceconfiguration-update.md
The following table shows the properties that are required when you create the [
|workProfileBlockPersonalAppInstallsFromUnknownSources|Boolean|Prevent app installations from unknown sources in the personal profile.| |workProfileAccountUse|[androidWorkProfileAccountUse](../resources/intune-deviceconfig-androidworkprofileaccountuse.md)|Control user's ability to add accounts in work profile including Google accounts. Possible values are: `allowAllExceptGoogleAccounts`, `blockAll`, `allowAll`, `unknownFutureValue`.| |allowedGoogleAccountDomains|String collection|Determine domains allow-list for accounts that can be added to work profile.|
+|blockUnifiedPasswordForWorkProfile|Boolean|Prevent using unified password for unlocking device and work profile.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId} Content-type: application/json
-Content-length: 3296
+Content-length: 3343
{ "@odata.type": "#microsoft.graph.androidForWorkGeneralDeviceConfiguration",
Content-length: 3296
"workProfileAccountUse": "blockAll", "allowedGoogleAccountDomains": [ "Allowed Google Account Domains value"
- ]
+ ],
+ "blockUnifiedPasswordForWorkProfile": true
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 3468
+Content-Length: 3515
{ "@odata.type": "#microsoft.graph.androidForWorkGeneralDeviceConfiguration",
Content-Length: 3468
"workProfileAccountUse": "blockAll", "allowedGoogleAccountDomains": [ "Allowed Google Account Domains value"
- ]
+ ],
+ "blockUnifiedPasswordForWorkProfile": true
} ```
v1.0 Intune Deviceconfig Androidworkprofilegeneraldeviceconfiguration Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-androidworkprofilegeneraldeviceconfiguration-create.md
The following table shows the properties that are required when you create the a
|workProfileBlockPersonalAppInstallsFromUnknownSources|Boolean|Prevent app installations from unknown sources in the personal profile.| |workProfileAccountUse|[androidWorkProfileAccountUse](../resources/intune-deviceconfig-androidworkprofileaccountuse.md)|Control user's ability to add accounts in work profile including Google accounts. Possible values are: `allowAllExceptGoogleAccounts`, `blockAll`, `allowAll`, `unknownFutureValue`.| |allowedGoogleAccountDomains|String collection|Determine domains allow-list for accounts that can be added to work profile.|
+|blockUnifiedPasswordForWorkProfile|Boolean|Prevent using unified password for unlocking device and work profile.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations Content-type: application/json
-Content-length: 3358
+Content-length: 3405
{ "@odata.type": "#microsoft.graph.androidWorkProfileGeneralDeviceConfiguration",
Content-length: 3358
"workProfileAccountUse": "blockAll", "allowedGoogleAccountDomains": [ "Allowed Google Account Domains value"
- ]
+ ],
+ "blockUnifiedPasswordForWorkProfile": true
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 3530
+Content-Length: 3577
{ "@odata.type": "#microsoft.graph.androidWorkProfileGeneralDeviceConfiguration",
Content-Length: 3530
"workProfileAccountUse": "blockAll", "allowedGoogleAccountDomains": [ "Allowed Google Account Domains value"
- ]
+ ],
+ "blockUnifiedPasswordForWorkProfile": true
} ```
v1.0 Intune Deviceconfig Androidworkprofilegeneraldeviceconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-androidworkprofilegeneraldeviceconfiguration-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 3711
+Content-Length: 3760
{ "value": {
Content-Length: 3711
"workProfileAccountUse": "blockAll", "allowedGoogleAccountDomains": [ "Allowed Google Account Domains value"
- ]
+ ],
+ "blockUnifiedPasswordForWorkProfile": true
} } ```
v1.0 Intune Deviceconfig Androidworkprofilegeneraldeviceconfiguration List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-androidworkprofilegeneraldeviceconfiguration-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 3887
+Content-Length: 3938
{ "value": [
Content-Length: 3887
"workProfileAccountUse": "blockAll", "allowedGoogleAccountDomains": [ "Allowed Google Account Domains value"
- ]
+ ],
+ "blockUnifiedPasswordForWorkProfile": true
} ] }
v1.0 Intune Deviceconfig Androidworkprofilegeneraldeviceconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-androidworkprofilegeneraldeviceconfiguration-update.md
The following table shows the properties that are required when you create the [
|workProfileBlockPersonalAppInstallsFromUnknownSources|Boolean|Prevent app installations from unknown sources in the personal profile.| |workProfileAccountUse|[androidWorkProfileAccountUse](../resources/intune-deviceconfig-androidworkprofileaccountuse.md)|Control user's ability to add accounts in work profile including Google accounts. Possible values are: `allowAllExceptGoogleAccounts`, `blockAll`, `allowAll`, `unknownFutureValue`.| |allowedGoogleAccountDomains|String collection|Determine domains allow-list for accounts that can be added to work profile.|
+|blockUnifiedPasswordForWorkProfile|Boolean|Prevent using unified password for unlocking device and work profile.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId} Content-type: application/json
-Content-length: 3358
+Content-length: 3405
{ "@odata.type": "#microsoft.graph.androidWorkProfileGeneralDeviceConfiguration",
Content-length: 3358
"workProfileAccountUse": "blockAll", "allowedGoogleAccountDomains": [ "Allowed Google Account Domains value"
- ]
+ ],
+ "blockUnifiedPasswordForWorkProfile": true
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 3530
+Content-Length: 3577
{ "@odata.type": "#microsoft.graph.androidWorkProfileGeneralDeviceConfiguration",
Content-Length: 3530
"workProfileAccountUse": "blockAll", "allowedGoogleAccountDomains": [ "Allowed Google Account Domains value"
- ]
+ ],
+ "blockUnifiedPasswordForWorkProfile": true
} ```
v1.0 Intune Deviceconfig Androidworkprofilevpnconfiguration Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-androidworkprofilevpnconfiguration-create.md
The following table shows the properties that are required when you create the a
|alwaysOn|Boolean|Whether or not to enable always-on VPN connection.| |alwaysOnLockdown|Boolean|If always-on VPN connection is enabled, whether or not to lock network traffic when that VPN is disconnected.| |microsoftTunnelSiteId|String|Microsoft Tunnel site ID.|
+|proxyExclusionList|String collection|List of hosts to exclude using the proxy on connections for. These hosts can use wildcards such as *.example.com.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations Content-type: application/json
-Content-length: 2422
+Content-length: 2489
{ "@odata.type": "#microsoft.graph.androidWorkProfileVpnConfiguration",
Content-length: 2422
], "alwaysOn": true, "alwaysOnLockdown": true,
- "microsoftTunnelSiteId": "Microsoft Tunnel Site Id value"
+ "microsoftTunnelSiteId": "Microsoft Tunnel Site Id value",
+ "proxyExclusionList": [
+ "Proxy Exclusion List value"
+ ]
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 2594
+Content-Length: 2661
{ "@odata.type": "#microsoft.graph.androidWorkProfileVpnConfiguration",
Content-Length: 2594
], "alwaysOn": true, "alwaysOnLockdown": true,
- "microsoftTunnelSiteId": "Microsoft Tunnel Site Id value"
+ "microsoftTunnelSiteId": "Microsoft Tunnel Site Id value",
+ "proxyExclusionList": [
+ "Proxy Exclusion List value"
+ ]
} ```
v1.0 Intune Deviceconfig Androidworkprofilevpnconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-androidworkprofilevpnconfiguration-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 2775
+Content-Length: 2848
{ "value": {
Content-Length: 2775
], "alwaysOn": true, "alwaysOnLockdown": true,
- "microsoftTunnelSiteId": "Microsoft Tunnel Site Id value"
+ "microsoftTunnelSiteId": "Microsoft Tunnel Site Id value",
+ "proxyExclusionList": [
+ "Proxy Exclusion List value"
+ ]
} } ```
v1.0 Intune Deviceconfig Androidworkprofilevpnconfiguration List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-androidworkprofilevpnconfiguration-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 2951
+Content-Length: 3030
{ "value": [
Content-Length: 2951
], "alwaysOn": true, "alwaysOnLockdown": true,
- "microsoftTunnelSiteId": "Microsoft Tunnel Site Id value"
+ "microsoftTunnelSiteId": "Microsoft Tunnel Site Id value",
+ "proxyExclusionList": [
+ "Proxy Exclusion List value"
+ ]
} ] }
v1.0 Intune Deviceconfig Androidworkprofilevpnconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-androidworkprofilevpnconfiguration-update.md
The following table shows the properties that are required when you create the [
|alwaysOn|Boolean|Whether or not to enable always-on VPN connection.| |alwaysOnLockdown|Boolean|If always-on VPN connection is enabled, whether or not to lock network traffic when that VPN is disconnected.| |microsoftTunnelSiteId|String|Microsoft Tunnel site ID.|
+|proxyExclusionList|String collection|List of hosts to exclude using the proxy on connections for. These hosts can use wildcards such as *.example.com.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId} Content-type: application/json
-Content-length: 2422
+Content-length: 2489
{ "@odata.type": "#microsoft.graph.androidWorkProfileVpnConfiguration",
Content-length: 2422
], "alwaysOn": true, "alwaysOnLockdown": true,
- "microsoftTunnelSiteId": "Microsoft Tunnel Site Id value"
+ "microsoftTunnelSiteId": "Microsoft Tunnel Site Id value",
+ "proxyExclusionList": [
+ "Proxy Exclusion List value"
+ ]
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 2594
+Content-Length: 2661
{ "@odata.type": "#microsoft.graph.androidWorkProfileVpnConfiguration",
Content-Length: 2594
], "alwaysOn": true, "alwaysOnLockdown": true,
- "microsoftTunnelSiteId": "Microsoft Tunnel Site Id value"
+ "microsoftTunnelSiteId": "Microsoft Tunnel Site Id value",
+ "proxyExclusionList": [
+ "Proxy Exclusion List value"
+ ]
} ```
v1.0 Intune Deviceconfig Devicecompliancepolicy Getdevicesscheduledtoretire https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-devicecompliancepolicy-getdevicesscheduledtoretire.md
Title: "getDevicesScheduledToRetire function"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Deviceconfig Devicecompliancepolicy Getnoncompliantdevicestoretire https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-devicecompliancepolicy-getnoncompliantdevicestoretire.md
Title: "getNoncompliantDevicesToRetire action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|name|String|Not yet documented|
-|select|String collection|Not yet documented|
-|search|String|Not yet documented|
-|groupBy|String collection|Not yet documented|
-|orderBy|String collection|Not yet documented|
-|skip|Int32|Not yet documented|
-|top|Int32|Not yet documented|
-|sessionId|String|Not yet documented|
-|filter|String|Not yet documented|
+|name|String||
+|select|String collection||
+|search|String||
+|groupBy|String collection||
+|orderBy|String collection||
+|skip|Int32||
+|top|Int32||
+|sessionId|String||
+|filter|String||
v1.0 Intune Deviceconfig Devicecompliancepolicy Setscheduledretirestate https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-devicecompliancepolicy-setscheduledretirestate.md
Title: "setScheduledRetireState action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|scopedToAllDevices|Boolean|Not yet documented|
-|state|[scheduledRetireState](../resources/intune-deviceconfig-scheduledretirestate.md)|Not yet documented|
-|managedDeviceIds|String collection|Not yet documented|
+|scopedToAllDevices|Boolean||
+|state|[scheduledRetireState](../resources/intune-deviceconfig-scheduledretirestate.md)||
+|managedDeviceIds|String collection||
v1.0 Intune Deviceconfig Devicecompliancepolicy Validatecompliancescript https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-devicecompliancepolicy-validatecompliancescript.md
Title: "validateComplianceScript action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|deviceCompliancePolicyScript|[deviceCompliancePolicyScript](../resources/intune-deviceconfig-devicecompliancepolicyscript.md)|Not yet documented|
+|deviceCompliancePolicyScript|[deviceCompliancePolicyScript](../resources/intune-deviceconfig-devicecompliancepolicyscript.md)||
v1.0 Intune Deviceconfig Deviceconfiguration Getomasettingplaintextvalue https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-deviceconfiguration-getomasettingplaintextvalue.md
Title: "getOmaSettingPlainTextValue function"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this function.
|Property|Type|Description| |:|:|:|
-|secretReferenceValueId|String|Not yet documented|
+|secretReferenceValueId|String||
v1.0 Intune Deviceconfig Devicemanagement Enableandroiddeviceadministratorenrollment https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-devicemanagement-enableandroiddeviceadministratorenrollment.md
Title: "enableAndroidDeviceAdministratorEnrollment action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Deviceconfig Hardwareconfiguration Assign https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-hardwareconfiguration-assign.md
Title: "assign action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|hardwareConfigurationAssignments|[hardwareConfigurationAssignment](../resources/intune-deviceconfig-hardwareconfigurationassignment.md) collection|Not yet documented|
+|hardwareConfigurationAssignments|[hardwareConfigurationAssignment](../resources/intune-deviceconfig-hardwareconfigurationassignment.md) collection||
v1.0 Intune Deviceconfig Hardwareconfiguration Assignhardwareconfiguration https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-hardwareconfiguration-assignhardwareconfiguration.md
Title: "assignHardwareConfiguration action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|hardwareConfigurationAssignments|[hardwareConfigurationAssignment](../resources/intune-deviceconfig-hardwareconfigurationassignment.md) collection|Not yet documented|
+|hardwareConfigurationAssignments|[hardwareConfigurationAssignment](../resources/intune-deviceconfig-hardwareconfigurationassignment.md) collection||
v1.0 Intune Deviceconfig Windows10compliancepolicy Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-windows10compliancepolicy-create.md
The following table shows the properties that are required when you create the w
|deviceThreatProtectionRequiredSecurityLevel|[deviceThreatProtectionLevel](../resources/intune-deviceconfig-devicethreatprotectionlevel.md)|Require Device Threat Protection minimum risk level to report noncompliance. Possible values are: `unavailable`, `secured`, `low`, `medium`, `high`, `notSet`.| |configurationManagerComplianceRequired|Boolean|Require to consider SCCM Compliance state into consideration for Intune Compliance State.| |tpmRequired|Boolean|Require Trusted Platform Module(TPM) to be present.|
-|deviceCompliancePolicyScript|[deviceCompliancePolicyScript](../resources/intune-deviceconfig-devicecompliancepolicyscript.md)|Not yet documented|
+|deviceCompliancePolicyScript|[deviceCompliancePolicyScript](../resources/intune-deviceconfig-devicecompliancepolicyscript.md)||
v1.0 Intune Deviceconfig Windows10compliancepolicy Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-windows10compliancepolicy-update.md
The following table shows the properties that are required when you create the [
|deviceThreatProtectionRequiredSecurityLevel|[deviceThreatProtectionLevel](../resources/intune-deviceconfig-devicethreatprotectionlevel.md)|Require Device Threat Protection minimum risk level to report noncompliance. Possible values are: `unavailable`, `secured`, `low`, `medium`, `high`, `notSet`.| |configurationManagerComplianceRequired|Boolean|Require to consider SCCM Compliance state into consideration for Intune Compliance State.| |tpmRequired|Boolean|Require Trusted Platform Module(TPM) to be present.|
-|deviceCompliancePolicyScript|[deviceCompliancePolicyScript](../resources/intune-deviceconfig-devicecompliancepolicyscript.md)|Not yet documented|
+|deviceCompliancePolicyScript|[deviceCompliancePolicyScript](../resources/intune-deviceconfig-devicecompliancepolicyscript.md)||
v1.0 Intune Deviceconfig Windows10pfximportcertificateprofile Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-windows10pfximportcertificateprofile-create.md
The following table shows the properties that are required when you create the w
|description|String|Admin provided description of the Device Configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)|
-|keyStorageProvider|[keyStorageProviderOption](../resources/intune-shared-keystorageprovideroption.md)|Not yet documented. Possible values are: `useTpmKspOtherwiseUseSoftwareKsp`, `useTpmKspOtherwiseFail`, `usePassportForWorkKspOtherwiseFail`, `useSoftwareKsp`.|
+|keyStorageProvider|[keyStorageProviderOption](../resources/intune-shared-keystorageprovideroption.md)|. Possible values are: `useTpmKspOtherwiseUseSoftwareKsp`, `useTpmKspOtherwiseFail`, `usePassportForWorkKspOtherwiseFail`, `useSoftwareKsp`.|
v1.0 Intune Deviceconfig Windows10pfximportcertificateprofile Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-windows10pfximportcertificateprofile-update.md
The following table shows the properties that are required when you create the [
|description|String|Admin provided description of the Device Configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |displayName|String|Admin provided name of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)| |version|Int32|Version of the device configuration. Inherited from [deviceConfiguration](../resources/intune-shared-deviceconfiguration.md)|
-|keyStorageProvider|[keyStorageProviderOption](../resources/intune-shared-keystorageprovideroption.md)|Not yet documented. Possible values are: `useTpmKspOtherwiseUseSoftwareKsp`, `useTpmKspOtherwiseFail`, `usePassportForWorkKspOtherwiseFail`, `useSoftwareKsp`.|
+|keyStorageProvider|[keyStorageProviderOption](../resources/intune-shared-keystorageprovideroption.md)|. Possible values are: `useTpmKspOtherwiseUseSoftwareKsp`, `useTpmKspOtherwiseFail`, `usePassportForWorkKspOtherwiseFail`, `useSoftwareKsp`.|
v1.0 Intune Deviceconfig Windowscertificateprofilebase Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfig-windowscertificateprofilebase-get.md
- Title: "Get windowsCertificateProfileBase"
-description: "Read properties and relationships of the windowsCertificateProfileBase object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Get windowsCertificateProfileBase
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Read properties and relationships of the [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.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).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All|
-
-## HTTP Request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-GET /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windows10VpnConfiguration/identityCertificate
-GET /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsWiredNetworkConfiguration/identityCertificateForClientAuthentication
-GET /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsWifiEnterpriseEAPConfiguration/identityCertificateForClientAuthentication
-GET /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsWiredNetworkConfiguration/secondaryIdentityCertificateForClientAuthentication
-```
-
-## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
-
-## Request headers
-|Header|Value|
-|:|:|
-|Authorization|Bearer &lt;token&gt; Required.|
-|Accept|application/json|
-
-## Request body
-Do not supply a request body for this method.
-
-## Response
-If successful, this method returns a `200 OK` response code and [windowsCertificateProfileBase](../resources/intune-deviceconfig-windowscertificateprofilebase.md) object in the response body.
-
-## Example
-
-### Request
-Here is an example of the request.
-``` http
-GET https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windows10VpnConfiguration/identityCertificate
-```
-
-### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-Content-Length: 1576
-
-{
- "value": {
- "@odata.type": "#microsoft.graph.windowsCertificateProfileBase",
- "id": "c0979ce1-9ce1-c097-e19c-97c0e19c97c0",
- "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "roleScopeTagIds": [
- "Role Scope Tag Ids value"
- ],
- "supportsScopeTags": true,
- "deviceManagementApplicabilityRuleOsEdition": {
- "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
- "osEditionTypes": [
- "windows10EnterpriseN"
- ],
- "name": "Name value",
- "ruleType": "exclude"
- },
- "deviceManagementApplicabilityRuleOsVersion": {
- "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
- "minOSVersion": "Min OSVersion value",
- "maxOSVersion": "Max OSVersion value",
- "name": "Name value",
- "ruleType": "exclude"
- },
- "deviceManagementApplicabilityRuleDeviceMode": {
- "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
- "deviceMode": "sModeConfiguration",
- "name": "Name value",
- "ruleType": "exclude"
- },
- "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
- "description": "Description value",
- "displayName": "Display Name value",
- "version": 7,
- "renewalThresholdPercentage": 10,
- "keyStorageProvider": "useTpmKspOtherwiseFail",
- "subjectNameFormat": "commonNameIncludingEmail",
- "subjectAlternativeNameType": "emailAddress",
- "certificateValidityPeriodValue": 14,
- "certificateValidityPeriodScale": "months"
- }
-}
-```
v1.0 Intune Deviceconfigv2 Devicemanagementcompliancepolicy Assign https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfigv2-devicemanagementcompliancepolicy-assign.md
Title: "assign action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|assignments|[deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) collection|Not yet documented|
+|assignments|[deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) collection||
v1.0 Intune Deviceconfigv2 Devicemanagementcompliancepolicy Setscheduledactions https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfigv2-devicemanagementcompliancepolicy-setscheduledactions.md
Title: "setScheduledActions action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|scheduledActions|[deviceManagementComplianceScheduledActionForRule](../resources/intune-deviceconfigv2-devicemanagementcompliancescheduledactionforrule.md) collection|Not yet documented|
+|scheduledActions|[deviceManagementComplianceScheduledActionForRule](../resources/intune-deviceconfigv2-devicemanagementcompliancescheduledactionforrule.md) collection||
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Assign https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-assign.md
Title: "assign action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|assignments|[deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) collection|Not yet documented|
+|assignments|[deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) collection||
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Createcopy https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-createcopy.md
Title: "createCopy action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|displayName|String|Not yet documented|
-|description|String|Not yet documented|
+|displayName|String||
+|description|String||
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Reorder https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-reorder.md
Title: "reorder action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|priority|Int32|Not yet documented|
+|priority|Int32||
v1.0 Intune Deviceconfigv2 Devicemanagementreusablepolicysetting Clone https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceconfigv2-devicemanagementreusablepolicysetting-clone.md
Title: "clone action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Deviceintent Devicemanagementintent Assign https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceintent-devicemanagementintent-assign.md
Title: "assign action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|assignments|[deviceManagementIntentAssignment](../resources/intune-deviceintent-devicemanagementintentassignment.md) collection|Not yet documented|
+|assignments|[deviceManagementIntentAssignment](../resources/intune-deviceintent-devicemanagementintentassignment.md) collection||
v1.0 Intune Deviceintent Devicemanagementintent Compare https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceintent-devicemanagementintent-compare.md
Title: "compare function"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this function.
|Property|Type|Description| |:|:|:|
-|templateId|String|Not yet documented|
+|templateId|String||
v1.0 Intune Deviceintent Devicemanagementintent Createcopy https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceintent-devicemanagementintent-createcopy.md
Title: "createCopy action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|displayName|String|Not yet documented|
-|description|String|Not yet documented|
+|displayName|String||
+|description|String||
v1.0 Intune Deviceintent Devicemanagementintent Getcustomizedsettings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceintent-devicemanagementintent-getcustomizedsettings.md
Title: "getCustomizedSettings function"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Deviceintent Devicemanagementintent Migratetotemplate https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceintent-devicemanagementintent-migratetotemplate.md
Title: "migrateToTemplate action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|newTemplateId|String|Not yet documented|
-|preserveCustomValues|Boolean|Not yet documented|
+|newTemplateId|String||
+|preserveCustomValues|Boolean||
v1.0 Intune Deviceintent Devicemanagementintent Updatesettings https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceintent-devicemanagementintent-updatesettings.md
Title: "updateSettings action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|settings|[deviceManagementSettingInstance](../resources/intune-deviceintent-devicemanagementsettinginstance.md) collection|Not yet documented|
+|settings|[deviceManagementSettingInstance](../resources/intune-deviceintent-devicemanagementsettinginstance.md) collection||
v1.0 Intune Deviceintent Devicemanagementtemplate Compare https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceintent-devicemanagementtemplate-compare.md
Title: "compare function"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this function.
|Property|Type|Description| |:|:|:|
-|templateId|String|Not yet documented|
+|templateId|String||
v1.0 Intune Deviceintent Devicemanagementtemplate Createinstance https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceintent-devicemanagementtemplate-createinstance.md
Title: "createInstance action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|displayName|String|Not yet documented|
-|description|String|Not yet documented|
-|settingsDelta|[deviceManagementSettingInstance](../resources/intune-deviceintent-devicemanagementsettinginstance.md) collection|Not yet documented|
-|roleScopeTagIds|String collection|Not yet documented|
+|displayName|String||
+|description|String||
+|settingsDelta|[deviceManagementSettingInstance](../resources/intune-deviceintent-devicemanagementsettinginstance.md) collection||
+|roleScopeTagIds|String collection||
v1.0 Intune Deviceintent Devicemanagementtemplate Importoffice365deviceconfigurationpolicies https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-deviceintent-devicemanagementtemplate-importoffice365deviceconfigurationpolicies.md
Title: "importOffice365DeviceConfigurationPolicies action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Devices Applepushnotificationcertificate Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-applepushnotificationcertificate-update.md
The following table shows the properties that are required when you create the [
|certificateUploadStatus|String|The certificate upload status.| |certificateUploadFailureReason|String|The reason the certificate upload failed.| |certificateSerialNumber|String|Certificate serial number. This property is read-only.|
-|certificate|String|Not yet documented|
+|certificate|String||
v1.0 Intune Devices Applogcollectionrequest Createdownloadurl https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-applogcollectionrequest-createdownloadurl.md
Title: "createDownloadUrl action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Devices Datasharingconsent Consenttodatasharing https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-datasharingconsent-consenttodatasharing.md
Title: "consentToDataSharing action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Devices Devicecustomattributeshellscript Assign https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-devicecustomattributeshellscript-assign.md
Title: "assign action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|deviceManagementScriptGroupAssignments|[deviceManagementScriptGroupAssignment](../resources/intune-devices-devicemanagementscriptgroupassignment.md) collection|Not yet documented|
-|deviceManagementScriptAssignments|[deviceManagementScriptAssignment](../resources/intune-devices-devicemanagementscriptassignment.md) collection|Not yet documented|
+|deviceManagementScriptGroupAssignments|[deviceManagementScriptGroupAssignment](../resources/intune-devices-devicemanagementscriptgroupassignment.md) collection||
+|deviceManagementScriptAssignments|[deviceManagementScriptAssignment](../resources/intune-devices-devicemanagementscriptassignment.md) collection||
v1.0 Intune Devices Devicehealthscript Areglobalscriptsavailable https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-devicehealthscript-areglobalscriptsavailable.md
Title: "areGlobalScriptsAvailable function"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Devices Devicehealthscript Enableglobalscripts https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-devicehealthscript-enableglobalscripts.md
Title: "enableGlobalScripts action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Devices Devicehealthscript Getremediationsummary https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-devicehealthscript-getremediationsummary.md
Title: "getRemediationSummary function"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Devices Devicehealthscript Updateglobalscript https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-devicehealthscript-updateglobalscript.md
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|version|String|Not yet documented|
+|version|String||
v1.0 Intune Devices Devicelogcollectionresponse Createdownloadurl https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-devicelogcollectionresponse-createdownloadurl.md
Title: "createDownloadUrl action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Devices Devicemanagement Getcomanageddevicessummary https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-devicemanagement-getcomanageddevicessummary.md
Title: "getComanagedDevicesSummary function"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Devices Devicemanagement Getcomanagementeligibledevicessummary https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-devicemanagement-getcomanagementeligibledevicessummary.md
Title: "getComanagementEligibleDevicesSummary function"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Devices Devicemanagement Userexperienceanalyticssummarizeddevicescopes https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-devicemanagement-userexperienceanalyticssummarizeddevicescopes.md
Title: "userExperienceAnalyticsSummarizedDeviceScopes function"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Devices Devicemanagement Userexperienceanalyticssummarizeworkfromanywheredevices https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-devicemanagement-userexperienceanalyticssummarizeworkfromanywheredevices.md
Title: "userExperienceAnalyticsSummarizeWorkFromAnywhereDevices function"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Devices Deviceshellscript Assign https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-deviceshellscript-assign.md
Title: "assign action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|deviceManagementScriptGroupAssignments|[deviceManagementScriptGroupAssignment](../resources/intune-devices-devicemanagementscriptgroupassignment.md) collection|Not yet documented|
-|deviceManagementScriptAssignments|[deviceManagementScriptAssignment](../resources/intune-devices-devicemanagementscriptassignment.md) collection|Not yet documented|
+|deviceManagementScriptGroupAssignments|[deviceManagementScriptGroupAssignment](../resources/intune-devices-devicemanagementscriptgroupassignment.md) collection||
+|deviceManagementScriptAssignments|[deviceManagementScriptAssignment](../resources/intune-devices-devicemanagementscriptassignment.md) collection||
v1.0 Intune Devices Manageddevice Activatedeviceesim https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-manageddevice-activatedeviceesim.md
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|carrierUrl|String|Not yet documented|
+|carrierUrl|String||
v1.0 Intune Devices Manageddevice Appdiagnostics https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-manageddevice-appdiagnostics.md
Title: "appDiagnostics function"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this function.
|Property|Type|Description| |:|:|:|
-|upn|String|Not yet documented|
+|upn|String||
v1.0 Intune Devices Manageddevice Cleanwindowsdevice https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-manageddevice-cleanwindowsdevice.md
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|keepUserData|Boolean|Not yet documented|
+|keepUserData|Boolean||
v1.0 Intune Devices Manageddevice Createdevicelogcollectionrequest https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-manageddevice-createdevicelogcollectionrequest.md
Title: "createDeviceLogCollectionRequest action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|templateType|[deviceLogCollectionRequest](../resources/intune-devices-devicelogcollectionrequest.md)|Not yet documented|
+|templateType|[deviceLogCollectionRequest](../resources/intune-devices-devicelogcollectionrequest.md)||
v1.0 Intune Devices Manageddevice Deleteuserfromsharedappledevice https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-manageddevice-deleteuserfromsharedappledevice.md
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|userPrincipalName|String|Not yet documented|
+|userPrincipalName|String||
v1.0 Intune Devices Manageddevice Deprovision https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-manageddevice-deprovision.md
Title: "deprovision action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|deprovisionReason|String|Not yet documented|
+|deprovisionReason|String||
v1.0 Intune Devices Manageddevice Disable https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-manageddevice-disable.md
Title: "disable action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Devices Manageddevice Downloadappdiagnostics https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-manageddevice-downloadappdiagnostics.md
Title: "downloadAppDiagnostics action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|request|[powerliftDownloadRequest](../resources/intune-devices-powerliftdownloadrequest.md)|Not yet documented|
+|request|[powerliftDownloadRequest](../resources/intune-devices-powerliftdownloadrequest.md)||
v1.0 Intune Devices Manageddevice Enablelostmode https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-manageddevice-enablelostmode.md
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|message|String|Not yet documented|
-|phoneNumber|String|Not yet documented|
-|footer|String|Not yet documented|
+|message|String||
+|phoneNumber|String||
+|footer|String||
v1.0 Intune Devices Manageddevice Executeaction https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-manageddevice-executeaction.md
Title: "executeAction action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|actionName|[managedDeviceRemoteAction](../resources/intune-devices-manageddeviceremoteaction.md)|Not yet documented|
-|keepEnrollmentData|Boolean|Not yet documented|
-|keepUserData|Boolean|Not yet documented|
-|persistEsimDataPlan|Boolean|Not yet documented|
-|deviceIds|String collection|Not yet documented|
-|notificationTitle|String|Not yet documented|
-|notificationBody|String|Not yet documented|
-|deviceName|String|Not yet documented|
-|carrierUrl|String|Not yet documented|
-|deprovisionReason|String|Not yet documented|
-|organizationalUnitPath|String|Not yet documented|
+|actionName|[managedDeviceRemoteAction](../resources/intune-devices-manageddeviceremoteaction.md)||
+|keepEnrollmentData|Boolean||
+|keepUserData|Boolean||
+|persistEsimDataPlan|Boolean||
+|deviceIds|String collection||
+|notificationTitle|String||
+|notificationBody|String||
+|deviceName|String||
+|carrierUrl|String||
+|deprovisionReason|String||
+|organizationalUnitPath|String||
v1.0 Intune Devices Manageddevice Getfilevaultkey https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-manageddevice-getfilevaultkey.md
Title: "getFileVaultKey function"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Devices Manageddevice Initiateondemandproactiveremediation https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-manageddevice-initiateondemandproactiveremediation.md
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|scriptPolicyId|String|Not yet documented|
+|scriptPolicyId|String||
v1.0 Intune Devices Manageddevice Movedevicestoou https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-manageddevice-movedevicestoou.md
Title: "moveDevicesToOU action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|deviceIds|Guid collection|Not yet documented|
-|organizationalUnitPath|String|Not yet documented|
+|deviceIds|Guid collection||
+|organizationalUnitPath|String||
v1.0 Intune Devices Manageddevice Playlostmodesound https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-manageddevice-playlostmodesound.md
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|durationInMinutes|String|Not yet documented|
+|durationInMinutes|String||
v1.0 Intune Devices Manageddevice Reenable https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-manageddevice-reenable.md
Title: "reenable action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Devices Manageddevice Rotatefilevaultkey https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-manageddevice-rotatefilevaultkey.md
Title: "rotateFileVaultKey action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Devices Manageddevice Sendcustomnotificationtocompanyportal https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-manageddevice-sendcustomnotificationtocompanyportal.md
Title: "sendCustomNotificationToCompanyPortal action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|notificationTitle|String|Not yet documented|
-|notificationBody|String|Not yet documented|
+|notificationTitle|String||
+|notificationBody|String||
v1.0 Intune Devices Manageddevice Setdevicename https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-manageddevice-setdevicename.md
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|deviceName|String|Not yet documented|
+|deviceName|String||
v1.0 Intune Devices Manageddevice Syncdevice https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-manageddevice-syncdevice.md
Title: "syncDevice action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Devices Manageddevice Triggerconfigurationmanageraction https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-manageddevice-triggerconfigurationmanageraction.md
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|configurationManagerAction|[configurationManagerAction](../resources/intune-devices-configurationmanageraction.md)|Not yet documented|
+|configurationManagerAction|[configurationManagerAction](../resources/intune-devices-configurationmanageraction.md)||
v1.0 Intune Devices Manageddevice Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-manageddevice-update.md
The following table shows the properties that are required when you create the [
|specificationVersion|String|Specification version. This property is read-only.| |joinType|[joinType](../resources/intune-devices-jointype.md)|Device join type. Possible values are: `unknown`, `azureADJoined`, `azureADRegistered`, `hybridAzureADJoined`.| |skuFamily|String|Device sku family|
+|securityPatchLevel|String|This indicates the security patch level of the operating system. These special updates contain important security fixes. For iOS/MacOS they are in (a) format. For android its in 2017-08-07 format. This property is read-only.|
|skuNumber|Int32|Device sku number, see also: https://learn.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only.| |managementFeatures|[managedDeviceManagementFeatures](../resources/intune-devices-manageddevicemanagementfeatures.md)|Device management features. Possible values are: `none`, `microsoftManagedDesktop`.| |chromeOSDeviceInfo|[chromeOSDeviceProperty](../resources/intune-devices-chromeosdeviceproperty.md) collection|List of properties of the ChromeOS Device. Default is an empty list. To retrieve actual values GET call needs to be made, with device id and included in select parameter.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/managedDevices/{managedDeviceId} Content-type: application/json
-Content-length: 9138
+Content-length: 9193
{ "@odata.type": "#microsoft.graph.managedDevice",
Content-length: 9138
"specificationVersion": "Specification Version value", "joinType": "azureADJoined", "skuFamily": "Sku Family value",
+ "securityPatchLevel": "Security Patch Level value",
"skuNumber": 9, "managementFeatures": "microsoftManagedDesktop", "chromeOSDeviceInfo": [
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 9187
+Content-Length: 9242
{ "@odata.type": "#microsoft.graph.managedDevice",
Content-Length: 9187
"specificationVersion": "Specification Version value", "joinType": "azureADJoined", "skuFamily": "Sku Family value",
+ "securityPatchLevel": "Security Patch Level value",
"skuNumber": 9, "managementFeatures": "microsoftManagedDesktop", "chromeOSDeviceInfo": [
v1.0 Intune Devices Manageddevice Updatewindowsdeviceaccount https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-manageddevice-updatewindowsdeviceaccount.md
Title: "updateWindowsDeviceAccount action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|updateWindowsDeviceAccountActionParameter|[updateWindowsDeviceAccountActionParameter](../resources/intune-devices-updatewindowsdeviceaccountactionparameter.md)|Not yet documented|
+|updateWindowsDeviceAccountActionParameter|[updateWindowsDeviceAccountActionParameter](../resources/intune-devices-updatewindowsdeviceaccountactionparameter.md)||
v1.0 Intune Devices Manageddevice Windowsdefenderscan https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-manageddevice-windowsdefenderscan.md
Title: "windowsDefenderScan action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|quickScan|Boolean|Not yet documented|
+|quickScan|Boolean||
v1.0 Intune Devices Manageddevice Windowsdefenderupdatesignatures https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-manageddevice-windowsdefenderupdatesignatures.md
Title: "windowsDefenderUpdateSignatures action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Devices Manageddevice Wipe https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-manageddevice-wipe.md
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|keepEnrollmentData|Boolean|Not yet documented|
-|keepUserData|Boolean|Not yet documented|
-|macOsUnlockCode|String|Not yet documented|
-|obliterationBehavior|[obliterationBehavior](../resources/intune-devices-obliterationbehavior.md)|Not yet documented|
-|persistEsimDataPlan|Boolean|Not yet documented|
-|useProtectedWipe|Boolean|Not yet documented|
+|keepEnrollmentData|Boolean||
+|keepUserData|Boolean||
+|macOsUnlockCode|String||
+|obliterationBehavior|[obliterationBehavior](../resources/intune-devices-obliterationbehavior.md)||
+|persistEsimDataPlan|Boolean||
+|useProtectedWipe|Boolean||
v1.0 Intune Devices Remoteactionaudit Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-remoteactionaudit-create.md
The following table shows the properties that are required when you create the r
|deviceDisplayName|String|Intune device name.| |userName|String|\[deprecated\] Please use InitiatedByUserPrincipalName instead.| |initiatedByUserPrincipalName|String|User who initiated the device action, format is UPN.|
-|action|[remoteAction](../resources/intune-devices-remoteaction.md)|The action name. Possible values are: `unknown`, `factoryReset`, `removeCompanyData`, `resetPasscode`, `remoteLock`, `enableLostMode`, `disableLostMode`, `locateDevice`, `rebootNow`, `recoverPasscode`, `cleanWindowsDevice`, `logoutSharedAppleDeviceActiveUser`, `quickScan`, `fullScan`, `windowsDefenderUpdateSignatures`, `factoryResetKeepEnrollmentData`, `updateDeviceAccount`, `automaticRedeployment`, `shutDown`, `rotateBitLockerKeys`, `rotateFileVaultKey`, `getFileVaultKey`, `setDeviceName`, `activateDeviceEsim`, `deprovision`, `disable`, `reenable`, `moveDeviceToOrganizationalUnit`, `initiateMobileDeviceManagementKeyRecovery`, `initiateOnDemandProactiveRemediation`, `rotateLocalAdminPassword`, `unknownFutureValue`.|
+|action|[remoteAction](../resources/intune-devices-remoteaction.md)|The action name. Possible values are: `unknown`, `factoryReset`, `removeCompanyData`, `resetPasscode`, `remoteLock`, `enableLostMode`, `disableLostMode`, `locateDevice`, `rebootNow`, `recoverPasscode`, `cleanWindowsDevice`, `logoutSharedAppleDeviceActiveUser`, `quickScan`, `fullScan`, `windowsDefenderUpdateSignatures`, `factoryResetKeepEnrollmentData`, `updateDeviceAccount`, `automaticRedeployment`, `shutDown`, `rotateBitLockerKeys`, `rotateFileVaultKey`, `getFileVaultKey`, `setDeviceName`, `activateDeviceEsim`, `deprovision`, `disable`, `reenable`, `moveDeviceToOrganizationalUnit`, `initiateMobileDeviceManagementKeyRecovery`, `initiateOnDemandProactiveRemediation`, `rotateLocalAdminPassword`, `unknownFutureValue`, `launchRemoteHelp`, `revokeAppleVppLicenses`, `removeDeviceFirmwareConfigurationInterfaceManagement`.|
|requestDateTime|DateTimeOffset|Time when the action was issued, given in UTC.| |deviceOwnerUserPrincipalName|String|Upn of the device owner.| |deviceIMEI|String|IMEI of the device.|
v1.0 Intune Devices Remoteactionaudit Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-remoteactionaudit-update.md
The following table shows the properties that are required when you create the [
|deviceDisplayName|String|Intune device name.| |userName|String|\[deprecated\] Please use InitiatedByUserPrincipalName instead.| |initiatedByUserPrincipalName|String|User who initiated the device action, format is UPN.|
-|action|[remoteAction](../resources/intune-devices-remoteaction.md)|The action name. Possible values are: `unknown`, `factoryReset`, `removeCompanyData`, `resetPasscode`, `remoteLock`, `enableLostMode`, `disableLostMode`, `locateDevice`, `rebootNow`, `recoverPasscode`, `cleanWindowsDevice`, `logoutSharedAppleDeviceActiveUser`, `quickScan`, `fullScan`, `windowsDefenderUpdateSignatures`, `factoryResetKeepEnrollmentData`, `updateDeviceAccount`, `automaticRedeployment`, `shutDown`, `rotateBitLockerKeys`, `rotateFileVaultKey`, `getFileVaultKey`, `setDeviceName`, `activateDeviceEsim`, `deprovision`, `disable`, `reenable`, `moveDeviceToOrganizationalUnit`, `initiateMobileDeviceManagementKeyRecovery`, `initiateOnDemandProactiveRemediation`, `rotateLocalAdminPassword`, `unknownFutureValue`.|
+|action|[remoteAction](../resources/intune-devices-remoteaction.md)|The action name. Possible values are: `unknown`, `factoryReset`, `removeCompanyData`, `resetPasscode`, `remoteLock`, `enableLostMode`, `disableLostMode`, `locateDevice`, `rebootNow`, `recoverPasscode`, `cleanWindowsDevice`, `logoutSharedAppleDeviceActiveUser`, `quickScan`, `fullScan`, `windowsDefenderUpdateSignatures`, `factoryResetKeepEnrollmentData`, `updateDeviceAccount`, `automaticRedeployment`, `shutDown`, `rotateBitLockerKeys`, `rotateFileVaultKey`, `getFileVaultKey`, `setDeviceName`, `activateDeviceEsim`, `deprovision`, `disable`, `reenable`, `moveDeviceToOrganizationalUnit`, `initiateMobileDeviceManagementKeyRecovery`, `initiateOnDemandProactiveRemediation`, `rotateLocalAdminPassword`, `unknownFutureValue`, `launchRemoteHelp`, `revokeAppleVppLicenses`, `removeDeviceFirmwareConfigurationInterfaceManagement`.|
|requestDateTime|DateTimeOffset|Time when the action was issued, given in UTC.| |deviceOwnerUserPrincipalName|String|Upn of the device owner.| |deviceIMEI|String|IMEI of the device.|
v1.0 Intune Devices Tenantattachrbac Enable https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-tenantattachrbac-enable.md
Title: "enable action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|enable|Boolean|Not yet documented|
+|enable|Boolean||
v1.0 Intune Devices Tenantattachrbac Getstate https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-tenantattachrbac-getstate.md
Title: "getState function"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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 Devices Userexperienceanalyticsbatteryhealthdeviceperformance Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-userexperienceanalyticsbatteryhealthdeviceperformance-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 490
+Content-Length: 553
{ "value": {
Content-Length: 490
"maxCapacityPercentage": 5, "estimatedRuntimeInMinutes": 9, "batteryAgeInDays": 0,
+ "fullBatteryDrainCount": 5,
+ "deviceBatteryCount": 2,
"deviceBatteryHealthScore": 8, "healthStatus": "insufficientData" }
v1.0 Intune Devices Userexperienceanalyticsbatteryhealthdeviceperformance List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-userexperienceanalyticsbatteryhealthdeviceperformance-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 526
+Content-Length: 593
{ "value": [
Content-Length: 526
"maxCapacityPercentage": 5, "estimatedRuntimeInMinutes": 9, "batteryAgeInDays": 0,
+ "fullBatteryDrainCount": 5,
+ "deviceBatteryCount": 2,
"deviceBatteryHealthScore": 8, "healthStatus": "insufficientData" }
v1.0 Intune Devices Userexperienceanalyticsbatteryhealthmodelperformance Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-userexperienceanalyticsbatteryhealthmodelperformance-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 419
+Content-Length: 626
{ "value": {
Content-Length: 419
"averageMaxCapacityPercentage": 12, "averageEstimatedRuntimeInMinutes": 0, "averageBatteryAgeInDays": 7,
- "modelBatteryHealthScore": 7
+ "meanFullBatteryDrainCount": 9,
+ "medianMaxCapacityPercentage": 11,
+ "medianEstimatedRuntimeInMinutes": 15,
+ "medianFullBatteryDrainCount": 11,
+ "modelBatteryHealthScore": 7,
+ "modelHealthStatus": "insufficientData"
} } ```
v1.0 Intune Devices Userexperienceanalyticsbatteryhealthmodelperformance List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-userexperienceanalyticsbatteryhealthmodelperformance-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 451
+Content-Length: 668
{ "value": [
Content-Length: 451
"averageMaxCapacityPercentage": 12, "averageEstimatedRuntimeInMinutes": 0, "averageBatteryAgeInDays": 7,
- "modelBatteryHealthScore": 7
+ "meanFullBatteryDrainCount": 9,
+ "medianMaxCapacityPercentage": 11,
+ "medianEstimatedRuntimeInMinutes": 15,
+ "medianFullBatteryDrainCount": 11,
+ "modelBatteryHealthScore": 7,
+ "modelHealthStatus": "insufficientData"
} ] }
v1.0 Intune Devices Userexperienceanalyticsbatteryhealthosperformance Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-userexperienceanalyticsbatteryhealthosperformance-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 394
+Content-Length: 630
{ "value": {
Content-Length: 394
"osBuildNumber": "Os Build Number value", "averageMaxCapacityPercentage": 12, "averageEstimatedRuntimeInMinutes": 0,
- "averageBatteryAgeInDays": 7
+ "averageBatteryAgeInDays": 7,
+ "meanFullBatteryDrainCount": 9,
+ "medianMaxCapacityPercentage": 11,
+ "medianEstimatedRuntimeInMinutes": 15,
+ "medianFullBatteryDrainCount": 11,
+ "osBatteryHealthScore": 4,
+ "osHealthStatus": "insufficientData"
} } ```
v1.0 Intune Devices Userexperienceanalyticsbatteryhealthosperformance List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-userexperienceanalyticsbatteryhealthosperformance-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 424
+Content-Length: 672
{ "value": [
Content-Length: 424
"osBuildNumber": "Os Build Number value", "averageMaxCapacityPercentage": 12, "averageEstimatedRuntimeInMinutes": 0,
- "averageBatteryAgeInDays": 7
+ "averageBatteryAgeInDays": 7,
+ "meanFullBatteryDrainCount": 9,
+ "medianMaxCapacityPercentage": 11,
+ "medianEstimatedRuntimeInMinutes": 15,
+ "medianFullBatteryDrainCount": 11,
+ "osBatteryHealthScore": 4,
+ "osHealthStatus": "insufficientData"
} ] }
v1.0 Intune Devices Userexperienceanalyticsdeviceperformance Summarizedeviceperformancedevices https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-userexperienceanalyticsdeviceperformance-summarizedeviceperformancedevices.md
Title: "summarizeDevicePerformanceDevices function"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this function.
|Property|Type|Description| |:|:|:|
-|summarizeBy|[userExperienceAnalyticsSummarizedBy](../resources/intune-devices-userexperienceanalyticssummarizedby.md)|Not yet documented|
+|summarizeBy|[userExperienceAnalyticsSummarizedBy](../resources/intune-devices-userexperienceanalyticssummarizedby.md)||
v1.0 Intune Devices Userexperienceanalyticsdevicescope Triggerdevicescopeaction https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-userexperienceanalyticsdevicescope-triggerdevicescopeaction.md
Title: "triggerDeviceScopeAction action"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
-|actionName|deviceScopeAction|Not yet documented|
-|deviceScopeId|String|Not yet documented|
+|actionName|deviceScopeAction||
+|deviceScopeId|String||
v1.0 Intune Devices Userexperienceanalyticsdevicestartupprocessperformance Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-userexperienceanalyticsdevicestartupprocessperformance-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 426
+Content-Length: 369
{ "value": {
Content-Length: 426
"publisher": "Publisher value", "deviceCount": 11, "medianImpactInMs": 0,
- "totalImpactInMs": 15,
- "medianImpactInMs2": 1,
- "totalImpactInMs2": 0
+ "totalImpactInMs": 15
} } ```
v1.0 Intune Devices Userexperienceanalyticsdevicestartupprocessperformance List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-userexperienceanalyticsdevicestartupprocessperformance-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 460
+Content-Length: 399
{ "value": [
Content-Length: 460
"publisher": "Publisher value", "deviceCount": 11, "medianImpactInMs": 0,
- "totalImpactInMs": 15,
- "medianImpactInMs2": 1,
- "totalImpactInMs2": 0
+ "totalImpactInMs": 15
} ] }
v1.0 Intune Devices Userexperienceanalyticsdevicetimelineevent Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-userexperienceanalyticsdevicetimelineevent-get.md
- Title: "Get userExperienceAnalyticsDeviceTimelineEvent"
-description: "Read properties and relationships of the userExperienceAnalyticsDeviceTimelineEvent object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Get userExperienceAnalyticsDeviceTimelineEvent
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Read properties and relationships of the [userExperienceAnalyticsDeviceTimelineEvent](../resources/intune-devices-userexperienceanalyticsdevicetimelineevent.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).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All|
-
-## HTTP Request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-GET /deviceManagement/userExperienceAnalyticsDeviceTimelineEvent/{userExperienceAnalyticsDeviceTimelineEventId}
-```
-
-## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
-
-## Request headers
-|Header|Value|
-|:|:|
-|Authorization|Bearer &lt;token&gt; Required.|
-|Accept|application/json|
-
-## Request body
-Do not supply a request body for this method.
-
-## Response
-If successful, this method returns a `200 OK` response code and [userExperienceAnalyticsDeviceTimelineEvent](../resources/intune-devices-userexperienceanalyticsdevicetimelineevent.md) object in the response body.
-
-## Example
-
-### Request
-Here is an example of the request.
-``` http
-GET https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsDeviceTimelineEvent/{userExperienceAnalyticsDeviceTimelineEventId}
-```
-
-### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-Content-Length: 405
-
-{
- "value": {
- "@odata.type": "#microsoft.graph.userExperienceAnalyticsDeviceTimelineEvent",
- "id": "beed65bb-65bb-beed-bb65-edbebb65edbe",
- "deviceId": "Device Id value",
- "eventDateTime": "2016-12-31T23:59:23.3984029-08:00",
- "eventLevel": "verbose",
- "eventSource": "Event Source value",
- "eventName": "Event Name value",
- "eventDetails": "Event Details value"
- }
-}
-```
v1.0 Intune Devices Userexperienceanalyticsdevicetimelineevent List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-userexperienceanalyticsdevicetimelineevent-list.md
- Title: "List userExperienceAnalyticsDeviceTimelineEvents"
-description: "List properties and relationships of the userExperienceAnalyticsDeviceTimelineEvent objects."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# List userExperienceAnalyticsDeviceTimelineEvents
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-List properties and relationships of the [userExperienceAnalyticsDeviceTimelineEvent](../resources/intune-devices-userexperienceanalyticsdevicetimelineevent.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).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All|
-
-## HTTP Request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-GET /deviceManagement/userExperienceAnalyticsDeviceTimelineEvent
-```
-
-## Request headers
-|Header|Value|
-|:|:|
-|Authorization|Bearer &lt;token&gt; Required.|
-|Accept|application/json|
-
-## Request body
-Do not supply a request body for this method.
-
-## Response
-If successful, this method returns a `200 OK` response code and a collection of [userExperienceAnalyticsDeviceTimelineEvent](../resources/intune-devices-userexperienceanalyticsdevicetimelineevent.md) objects in the response body.
-
-## Example
-
-### Request
-Here is an example of the request.
-``` http
-GET https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsDeviceTimelineEvent
-```
-
-### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-Content-Length: 435
-
-{
- "value": [
- {
- "@odata.type": "#microsoft.graph.userExperienceAnalyticsDeviceTimelineEvent",
- "id": "beed65bb-65bb-beed-bb65-edbebb65edbe",
- "deviceId": "Device Id value",
- "eventDateTime": "2016-12-31T23:59:23.3984029-08:00",
- "eventLevel": "verbose",
- "eventSource": "Event Source value",
- "eventName": "Event Name value",
- "eventDetails": "Event Details value"
- }
- ]
-}
-```
v1.0 Intune Devices Userexperienceanalyticsregressionsummary Summarizedeviceregressionperformance https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-userexperienceanalyticsregressionsummary-summarizedeviceregressionperformance.md
Title: "summarizeDeviceRegressionPerformance function"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this function.
|Property|Type|Description| |:|:|:|
-|summarizeBy|[userExperienceAnalyticsSummarizedBy](../resources/intune-devices-userexperienceanalyticssummarizedby.md)|Not yet documented|
+|summarizeBy|[userExperienceAnalyticsSummarizedBy](../resources/intune-devices-userexperienceanalyticssummarizedby.md)||
v1.0 Intune Devices Userexperienceanalyticsremoteconnection Summarizedeviceremoteconnection https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-userexperienceanalyticsremoteconnection-summarizedeviceremoteconnection.md
Title: "summarizeDeviceRemoteConnection function"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this function.
|Property|Type|Description| |:|:|:|
-|summarizeBy|[userExperienceAnalyticsSummarizedBy](../resources/intune-devices-userexperienceanalyticssummarizedby.md)|Not yet documented|
+|summarizeBy|[userExperienceAnalyticsSummarizedBy](../resources/intune-devices-userexperienceanalyticssummarizedby.md)||
v1.0 Intune Devices Userexperienceanalyticsresourceperformance Summarizedeviceresourceperformance https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-userexperienceanalyticsresourceperformance-summarizedeviceresourceperformance.md
Title: "summarizeDeviceResourcePerformance function"
-description: "Not yet documented"
+description: ""
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+ ## 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).
The following table shows the parameters that can be used with this function.
|Property|Type|Description| |:|:|:|
-|summarizeBy|[userExperienceAnalyticsSummarizedBy](../resources/intune-devices-userexperienceanalyticssummarizedby.md)|Not yet documented|
+|summarizeBy|[userExperienceAnalyticsSummarizedBy](../resources/intune-devices-userexperienceanalyticssummarizedby.md)||
v1.0 Intune Devices Windowsmanageddevice Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-windowsmanageddevice-create.md
The following table shows the properties that are required when you create the w
|specificationVersion|String|Specification version. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |joinType|[joinType](../resources/intune-devices-jointype.md)|Device join type Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `azureADJoined`, `azureADRegistered`, `hybridAzureADJoined`.| |skuFamily|String|Device sku family Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|securityPatchLevel|String|This indicates the security patch level of the operating system. These special updates contain important security fixes. For iOS/MacOS they are in (a) format. For android its in 2017-08-07 format. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|skuNumber|Int32|Device sku number, see also: https://learn.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |managementFeatures|[managedDeviceManagementFeatures](../resources/intune-devices-manageddevicemanagementfeatures.md)|Device management features Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `none`, `microsoftManagedDesktop`.| |chromeOSDeviceInfo|[chromeOSDeviceProperty](../resources/intune-devices-chromeosdeviceproperty.md) collection|List of properties of the ChromeOS Device. Default is an empty list. To retrieve actual values GET call needs to be made, with device id and included in select parameter. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/managedDevices Content-type: application/json
-Content-length: 9145
+Content-length: 9200
{ "@odata.type": "#microsoft.graph.windowsManagedDevice",
Content-length: 9145
"specificationVersion": "Specification Version value", "joinType": "azureADJoined", "skuFamily": "Sku Family value",
+ "securityPatchLevel": "Security Patch Level value",
"skuNumber": 9, "managementFeatures": "microsoftManagedDesktop", "chromeOSDeviceInfo": [
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 9194
+Content-Length: 9249
{ "@odata.type": "#microsoft.graph.windowsManagedDevice",
Content-Length: 9194
"specificationVersion": "Specification Version value", "joinType": "azureADJoined", "skuFamily": "Sku Family value",
+ "securityPatchLevel": "Security Patch Level value",
"skuNumber": 9, "managementFeatures": "microsoftManagedDesktop", "chromeOSDeviceInfo": [
v1.0 Intune Devices Windowsmanageddevice Get https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-windowsmanageddevice-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 9637
+Content-Length: 9694
{ "value": {
Content-Length: 9637
"specificationVersion": "Specification Version value", "joinType": "azureADJoined", "skuFamily": "Sku Family value",
+ "securityPatchLevel": "Security Patch Level value",
"skuNumber": 9, "managementFeatures": "microsoftManagedDesktop", "chromeOSDeviceInfo": [
v1.0 Intune Devices Windowsmanageddevice List https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-windowsmanageddevice-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 10075
+Content-Length: 10134
{ "value": [
Content-Length: 10075
"specificationVersion": "Specification Version value", "joinType": "azureADJoined", "skuFamily": "Sku Family value",
+ "securityPatchLevel": "Security Patch Level value",
"skuNumber": 9, "managementFeatures": "microsoftManagedDesktop", "chromeOSDeviceInfo": [
v1.0 Intune Devices Windowsmanageddevice Update https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-devices-windowsmanageddevice-update.md
The following table shows the properties that are required when you create the [
|specificationVersion|String|Specification version. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |joinType|[joinType](../resources/intune-devices-jointype.md)|Device join type Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `azureADJoined`, `azureADRegistered`, `hybridAzureADJoined`.| |skuFamily|String|Device sku family Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|securityPatchLevel|String|This indicates the security patch level of the operating system. These special updates contain important security fixes. For iOS/MacOS they are in (a) format. For android its in 2017-08-07 format. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|skuNumber|Int32|Device sku number, see also: https://learn.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |managementFeatures|[managedDeviceManagementFeatures](../resources/intune-devices-manageddevicemanagementfeatures.md)|Device management features Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `none`, `microsoftManagedDesktop`.| |chromeOSDeviceInfo|[chromeOSDeviceProperty](../resources/intune-devices-chromeosdeviceproperty.md) collection|List of properties of the ChromeOS Device. Default is an empty list. To retrieve actual values GET call needs to be made, with device id and included in select parameter. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/managedDevices/{managedDeviceId} Content-type: application/json
-Content-length: 9145
+Content-length: 9200
{ "@odata.type": "#microsoft.graph.windowsManagedDevice",
Content-length: 9145
"specificationVersion": "Specification Version value", "joinType": "azureADJoined", "skuFamily": "Sku Family value",
+ "securityPatchLevel": "Security Patch Level value",
"skuNumber": 9, "managementFeatures": "microsoftManagedDesktop", "chromeOSDeviceInfo": [
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 9194
+Content-Length: 9249
{ "@odata.type": "#microsoft.graph.windowsManagedDevice",
Content-Length: 9194
"specificationVersion": "Specification Version value", "joinType": "azureADJoined", "skuFamily": "Sku Family value",
+ "securityPatchLevel": "Security Patch Level value",
"skuNumber": 9, "managementFeatures": "microsoftManagedDesktop", "chromeOSDeviceInfo": [
v1.0 Intune Enrollment Activedirectorywindowsautopilotdeploymentprofile Create https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-enrollment-activedirectorywindowsautopilotdeploymentprofile-create.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|DeviceManagementServiceConfig.ReadWrite.All|
+|Delegated (work or school account)|DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All|
|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementServiceConfig.ReadWrite.All|
+|Application|DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All|
## HTTP Request <!-- {
v1.0 Intune Enrollment Activedirectorywindowsautopilotdeploymentprofile Delete https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/mainapi-reference/beta/api/intune-enrollment-activedirectorywindowsautopilotdeploymentprofile-delete.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|DeviceManagementServiceConfig.ReadWrite.All|
+|Delegated (work or school account)|DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All|
|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementServiceConfig.ReadWrite.All|
+|Application|DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWri