Updates from: 07/24/2023 04:54:44
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Accesspackage Delete Incompatibleaccesspackage https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackage-delete-incompatibleaccesspackage.md
DELETE https://graph.microsoft.com/beta/identityGovernance/entitlementManagement
[!INCLUDE [sample-code](../includes/snippets/powershell/remove-incompatibleaccesspackage-from-accesspackage-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accesspackage Delete Incompatiblegroup https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackage-delete-incompatiblegroup.md
DELETE https://graph.microsoft.com/beta/identityGovernance/entitlementManagement
[!INCLUDE [sample-code](../includes/snippets/powershell/remove-incompatiblegroup-from-accesspackage-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accesspackage Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackage-delete.md
DELETE https://graph.microsoft.com/beta/identityGovernance/entitlementManagement
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-accesspackage-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accesspackage Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackage-filterbycurrentuser.md
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
[!INCLUDE [sample-code](../includes/snippets/php/accesspackage-filterbycurrentuser-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Accesspackage Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackage-get.md
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accesspackage-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accesspackage Getapplicablepolicyrequirements https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackage-getapplicablepolicyrequirements.md
POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/a
[!INCLUDE [sample-code](../includes/snippets/powershell/accesspackage-getapplicablepolicyrequirements-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
POST /identityGovernance/entitlementManagement/accessPackages/b15419bb-5ffc-ea11
[!INCLUDE [snippet-not-available](../includes/snippets/snippet-not-available.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --
+# [Python](#tab/python)
+ #### Response
v1.0 Accesspackage List Accesspackageresourcerolescopes https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackage-list-accesspackageresourcerolescopes.md
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accesspackageresourcerolescopes-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accesspackage List Accesspackagesincompatiblewith https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackage-list-accesspackagesincompatiblewith.md
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accesspackagesincompatiblewith-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accesspackage List Incompatibleaccesspackages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackage-list-incompatibleaccesspackages.md
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
[!INCLUDE [sample-code](../includes/snippets/powershell/get-incompatibleaccesspackages-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accesspackage List Incompatiblegroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackage-list-incompatiblegroups.md
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
[!INCLUDE [sample-code](../includes/snippets/powershell/get-incompatiblegroups-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accesspackage Movetocatalog https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackage-movetocatalog.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/accesspackagethismovetocatalog-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accesspackage Post Accesspackageresourcerolescopes https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackage-post-accesspackageresourcerolescopes.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-accesspackageresourcerolescope-from-accesspackage-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-accesspackageresourcerolescope-from-accesspackage2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Accesspackage Post Incompatibleaccesspackage https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackage-post-incompatibleaccesspackage.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/add-incompatibleaccesspackage-to-accesspackage-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accesspackage Post Incompatiblegroup https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackage-post-incompatiblegroup.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/add-incompatiblegroup-to-accesspackage-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accesspackage Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackage-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-accesspackage-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accesspackageassignment Additionalaccess https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackageassignment-additionalaccess.md
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
[!INCLUDE [sample-code](../includes/snippets/powershell/accesspackageassignment-additionalaccess-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accesspackageassignment Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackageassignment-filterbycurrentuser.md
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
[!INCLUDE [sample-code](../includes/snippets/php/accesspackageassignment-filterbycurrentuser-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Accesspackageassignmentpolicy Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackageassignmentpolicy-delete.md
DELETE https://graph.microsoft.com/beta/identityGovernance/entitlementManagement
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-accesspackageassignmentpolicy-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accesspackageassignmentpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackageassignmentpolicy-get.md
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accesspackageassignmentpolicy-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accesspackageassignmentpolicy-expand-customextensionhandlers-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accesspackageassignmentpolicy-expand-customextensionstagesettings-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Accesspackageassignmentpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackageassignmentpolicy-update.md
The following table shows the properties that are required when you update an [a
|Property|Type|Description| |:|:|:|
-|displayName|String|The display name of the policy.|
-|description|String|The description of the policy.|
-|canExtend|Boolean|Indicates whether a user can extend the access package assignment duration after approval.|
-|durationInDays|Int32|The number of days in which assignments from this policy last until they are expired.|
-|expirationDateTime|DateTimeOffset|The expiration date for assignments created in this policy. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`|
-|requestorSettings|[requestorSettings](../resources/requestorsettings.md)|Who can request this access package from this policy.|
-|requestApprovalSettings|[approvalSettings](../resources/approvalsettings.md)|Who must approve requests for access package in this policy.|
-|accessReviewSettings|[assignmentReviewSettings](../resources/assignmentreviewsettings.md)|Who must review, and how often, the assignments to the access package from this policy. This property is null if reviews are not required.|
+|displayName|String|The display name of the policy. Required.|
+|description|String|The description of the policy. Required.|
+|canExtend|Boolean|Indicates whether a user can extend the access package assignment duration after approval. Required.|
+|durationInDays|Int32|The number of days in which assignments from this policy last until they are expired. Required.|
+|expirationDateTime|DateTimeOffset|The expiration date for assignments created in this policy. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Required.|
+|requestorSettings|[requestorSettings](../resources/requestorsettings.md)|Who can request this access package from this policy. Required.|
+|requestApprovalSettings|[approvalSettings](../resources/approvalsettings.md)|Who must approve requests for access package in this policy. Required.|
+|accessReviewSettings|[assignmentReviewSettings](../resources/assignmentreviewsettings.md)|Who must review, and how often, the assignments to the access package from this policy. This property is null if reviews are not required. Required.|
## Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-accesspackageassignmentpolicy-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-accesspackageassignmentpolicy-delete-customextensionhandlers-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-accesspackageassignmentpolicy-delete-customextensionstagesettings-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Accesspackageassignmentrequest Cancel https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackageassignmentrequest-cancel.md
POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/a
[!INCLUDE [sample-code](../includes/snippets/php/accesspackageassignmentrequest-cancel-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accesspackageassignmentrequest Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackageassignmentrequest-delete.md
DELETE https://graph.microsoft.com/beta/identityGovernance/entitlementManagement
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-accesspackageassignmentrequest-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accesspackageassignmentrequest Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackageassignmentrequest-filterbycurrentuser.md
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
[!INCLUDE [sample-code](../includes/snippets/php/accesspackageassignmentrequest-filterbycurrentuser-ontarget-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Accesspackageassignmentrequest Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackageassignmentrequest-get.md
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accesspackageassignmentrequest-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
Content-type: application/json
"type": "notSpecified" } },
- "customExtensionHandlerInstances": [
+ "customExtensionCalloutInstances": [
{
- "status": "requestReceived",
+ "status": "callbackReceived",
"externalCorrelationId": "08585600902100964604743022906CU13", "customExtensionId": "e59ef33d-7bc4-4b15-8d3c-01153de8a498",
- "stage": "assignmentRequestCreated"
+ "id": "3C49CE50-E02C-4254-81E6-834328DF72DC",
+ "detail": "Request has been allowed"
} ] }
v1.0 Accesspackageassignmentrequest Resume https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackageassignmentrequest-resume.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/accesspackageassignmentrequestthisresume-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Accesspackageassignmentrequestworkflowextension Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackageassignmentrequestworkflowextension-delete.md
DELETE /identityGovernance/entitlementManagement/accessPackageCatalogs/32efb28c-
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-accesspackageassignmentrequestworkflowextension-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] -
+# [Python](#tab/python)
+ ### Response The following is an example of the response
v1.0 Accesspackageassignmentrequestworkflowextension Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackageassignmentrequestworkflowextension-get.md
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accesspackageassignmentrequestworkflowextension-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accesspackageassignmentrequestworkflowextension Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackageassignmentrequestworkflowextension-update.md
Content-Type: application/json
} ```
-# [C#](#tab/csharp)
-
-# [Go](#tab/go)
- # [Java](#tab/java) [!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/javascript/update-accesspackageassignmentrequestworkflowextension-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PHP](#tab/php)
- ### Response
v1.0 Accesspackageassignmentresourcerole Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackageassignmentresourcerole-get.md
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accesspackageassignmentresourcerole-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accesspackageassignmentworkflowextension Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackageassignmentworkflowextension-delete.md
DELETE /identityGovernance/entitlementManagement/accessPackageCatalogs/32efb28c-
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-accesspackageassignmentworkflowextension-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] -
+# [Python](#tab/python)
+ ### Response The following is an example of the response
v1.0 Accesspackageassignmentworkflowextension Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackageassignmentworkflowextension-get.md
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accesspackageassignmentworkflowextension-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accesspackageassignmentworkflowextension Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackageassignmentworkflowextension-update.md
Content-Type: application/json
} ```
-# [C#](#tab/csharp)
-
-# [Go](#tab/go)
- # [Java](#tab/java) [!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/javascript/update-accesspackageassignmentworkflowextension-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PHP](#tab/php)
- ### Response
v1.0 Accesspackagecatalog Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackagecatalog-delete.md
DELETE https://graph.microsoft.com/beta/identityGovernance/entitlementManagement
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-accesspackagecatalog-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accesspackagecatalog Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackagecatalog-get.md
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accesspackagecatalog-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accesspackagecatalog List Accesspackagecustomworkflowextensions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackagecatalog-list-accesspackagecustomworkflowextensions.md
GET /identityGovernance/entitlementManagement/accessPackageCatalogs/32efb28c-9a7
[!INCLUDE [sample-code](../includes/snippets/powershell/list-accesspackagecustomworkflowextension-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accesspackagecatalog List Accesspackageresourceroles https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackagecatalog-list-accesspackageresourceroles.md
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accesspackageresourceroles-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accesspackageresourceroles2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Accesspackagecatalog List Accesspackageresources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackagecatalog-list-accesspackageresources.md
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accesspackageresources-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accesspackagecatalog List Customaccesspackageworkflowextensions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackagecatalog-list-customaccesspackageworkflowextensions.md
GET /identityGovernance/entitlementManagement/accessPackageCatalogs/32efb28c-9a7
[!INCLUDE [sample-code](../includes/snippets/php/list-customaccesspackageworkflowextension-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - ### Response >**Note:** The response object shown here might be shortened for readability. <!-- {
v1.0 Accesspackagecatalog Post Accesspackagecustomworkflowextensions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackagecatalog-post-accesspackagecustomworkflowextensions.md
POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/a
Content-Type: application/json {
- "value":{
- "@odata.type":"#microsoft.graph.accessPackageAssignmentRequestWorkflowExtension",
- "displayName":"test_action_0124_email",
- "description":"this is for graph testing only",
- "endpointConfiguration":{
- "@odata.type":"#microsoft.graph.logicAppTriggerEndpointConfiguration",
- "subscriptionId":"38ab2ccc-3747-4567-b36b-9478f5602f0d",
- "resourceGroupName":"test",
- "logicAppWorkflowName":"elm-extension-email"
- },
- "authenticationConfiguration":{
- "@odata.type":"#microsoft.graph.azureAdPopTokenAuthentication"
- },
- "callbackConfiguration":{
- "@odata.type":"microsoft.graph.customExtensionCallbackConfiguration",
- "durationBeforeTimeout":"PT1H"
- }
- }
+ "@odata.type": "#microsoft.graph.accessPackageAssignmentRequestWorkflowExtension",
+ "displayName": "test_action_0124_email",
+ "description": "this is for graph testing only",
+ "endpointConfiguration": {
+ "@odata.type": "#microsoft.graph.logicAppTriggerEndpointConfiguration",
+ "subscriptionId": "38ab2ccc-3747-4567-b36b-9478f5602f0d",
+ "resourceGroupName": "test",
+ "logicAppWorkflowName": "elm-extension-email"
+ },
+ "authenticationConfiguration": {
+ "@odata.type": "#microsoft.graph.azureAdPopTokenAuthentication"
+ },
+ "callbackConfiguration": {
+ "@odata.type": "microsoft.graph.customExtensionCallbackConfiguration",
+ "durationBeforeTimeout": "PT1H"
+ }
} ```
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-accesspackageassignmentrequestworkflowextension-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-accesspackageassignmentworkflowextension-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Accesspackagecatalog Post Customaccesspackageworkflowextensions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackagecatalog-post-customaccesspackageworkflowextensions.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-customaccesspackageworkflowextension--powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accesspackagecatalog Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackagecatalog-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-accesspackagecatalog-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accesspackageresourceenvironment Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackageresourceenvironment-get.md
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accesspackageresourceenvironment-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accesspackagesubject Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackagesubject-get.md
+
+ Title: "Get accessPackageSubject"
+description: "Get the properties of an accessPackageSubject object."
+
+ms.localizationpriority: medium
++
+# Get accessPackageSubject
+
+Namespace: microsoft.graph
++
+Get an existing [accessPackageSubject](../resources/accesspackagesubject.md) object properties.
+
+## Permissions
+
+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) | EntitlementManagement.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | EntitlementManagement.ReadWrite.All |
+
+## HTTP request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+```http
+GET /identityGovernance/entitlementManagement/subjects(objectId='{objectIdOfUser}')
+```
+
+## Request headers
+
+| Name |Description|
+|:-|:-|
+| Authorization | Bearer \{token\}. Required. |
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and the requested [accessPackageSubject](../resources/accesspackagesubject.md) object in the response body.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "get_accesspackagesubject"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/subjects(objectId='{objectIdOfUser}')
+```
+
+### 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.accessPackageSubject"
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/entitlementManagement/subjects/$entity",
+ "connectedOrganizationId": null,
+ "id": "120fd4a0-95a7-49d2-9389-ed6f3c025c74",
+ "objectId": "a382de66-b7bb-4c30-82b7-306c6ae6a4ae",
+ "altSecId": null,
+ "displayName": "Accessibility Test",
+ "principalName": "accessibility@contosodeb.onmicrosoft.com",
+ "email": "accessibility@contosodeb.onmicrosoft.com",
+ "onPremisesSecurityIdentifier": null,
+ "type": "User",
+ "subjectLifecycle": "governed"
+}
+```
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Get accessPackageSubject",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": [
+ ]
+}
+-->
v1.0 Accesspackagesubject Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackagesubject-update.md
+
+ Title: "Update accessPackageSubject"
+description: "Update the properties of an accessPackageSubject object."
+
+ms.localizationpriority: medium
++
+# Update accessPackageSubject
+
+Namespace: microsoft.graph
++
+Update an existing [accessPackageSubject](../resources/accesspackagesubject.md) object to change the subject lifecycle.
+
+## Permissions
+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) | EntitlementManagement.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | EntitlementManagement.ReadWrite.All |
+
+## HTTP request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+```http
+PATCH /identityGovernance/entitlementManagement/subjects(objectId='{objectIdOfUser}')
+```
+
+## Request headers
+
+Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
++
+|Property|Type|Description|
+|:|:|:|
+|subjectLifecycle|accessPackageSubjectLifecycle|The lifecycle of the subject user, if a guest. The possible values are: `notDefined`, `notGoverned`, `governed`.|
+
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "update_accesspackagesubject"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/subjects(objectId='{objectIdOfUser}')
+Content-Type: application/json
+
+{
+ "subjectLifecycle":"governed"
+}
+```
+
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Update accessPackageSubject",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": [
+ ]
+}
+-->
v1.0 Accessreview Addreviewer https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreview-addreviewer.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/add-accessreview-reviewer-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Accessreview Apply https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreview-apply.md
POST https://graph.microsoft.com/beta/accessReviews/2975E9B5-44CE-4E71-93D3-30F0
[!INCLUDE [sample-code](../includes/snippets/powershell/apply-accessreview-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accessreview Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreview-create.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-accessreview-from-accessreviews-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accessreview Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreview-delete.md
DELETE https://graph.microsoft.com/beta/accessReviews/2975E9B5-44CE-4E71-93D3-30
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-accessreview-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Accessreview Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreview-get.md
GET https://graph.microsoft.com/beta/accessReviews/2b83cc42-09db-46f6-8c6e-16fec
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accessreview-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Accessreview List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreview-list.md
GET https://graph.microsoft.com/beta/accessReviews?$filter=businessFlowTemplateI
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accessreviews-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Accessreview Listdecisions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreview-listdecisions.md
GET https://graph.microsoft.com/beta/accessReviews/2b83cc42-09db-46f6-8c6e-16fec
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accessreview-decisions-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Accessreview Listmydecisions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreview-listmydecisions.md
GET https://graph.microsoft.com/beta/accessReviews/2b83cc42-09db-46f6-8c6e-16fec
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accessreview-decisions-2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Accessreview Listreviewers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreview-listreviewers.md
GET https://graph.microsoft.com/beta/accessReviews/2b83cc42-09db-46f6-8c6e-16fec
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accessreview-reviewers-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Accessreview Removereviewer https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreview-removereviewer.md
DELETE https://graph.microsoft.com/beta/accessReviews/2b83cc42-09db-46f6-8c6e-16
[!INCLUDE [sample-code](../includes/snippets/powershell/remove-accessreview-reviewer-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Accessreview Reset https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreview-reset.md
POST https://graph.microsoft.com/beta/accessReviews/2975E9B5-44CE-4E71-93D3-30F0
[!INCLUDE [sample-code](../includes/snippets/powershell/reset-accessreview-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Accessreview Sendreminder https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreview-sendreminder.md
POST https://graph.microsoft.com/beta/accessReviews/2975E9B5-44CE-4E71-93D3-30F0
[!INCLUDE [sample-code](../includes/snippets/powershell/sendreminder-accessreview-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Accessreview Stop https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreview-stop.md
POST https://graph.microsoft.com/beta/accessReviews/2975E9B5-44CE-4E71-93D3-30F0
[!INCLUDE [sample-code](../includes/snippets/powershell/stop-accessreview-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Accessreview Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreview-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-accessreview-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Accessreviewhistorydefinition Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewhistorydefinition-get.md
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/historyDef
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accessreviewhistorydefinition-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accessreviewhistorydefinition List Instances https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewhistorydefinition-list-instances.md
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/historyDef
[!INCLUDE [sample-code](../includes/snippets/powershell/list-accessreviewhistoryinstance-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accessreviewhistoryinstance Generatedownloaduri https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewhistoryinstance-generatedownloaduri.md
POST https://graph.microsoft.com/beta/identityGovernance/accessReviews/historyDe
[!INCLUDE [sample-code](../includes/snippets/powershell/accessreviewhistoryinstance-generatedownloaduri-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accessreviewinstance Acceptrecommendations https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewinstance-acceptrecommendations.md
POST https://graph.microsoft.com/beta/me/pendingAccessReviewInstances/70a68410-6
[!INCLUDE [sample-code](../includes/snippets/powershell/acceptrecommendations-accessreviewinstance-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accessreviewinstance Applydecisions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewinstance-applydecisions.md
POST https://graph.microsoft.com/beta/identityGovernance/accessReviews/definitio
[!INCLUDE [sample-code](../includes/snippets/powershell/accessreviewinstance-applydecisions-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accessreviewinstance Batchrecorddecisions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewinstance-batchrecorddecisions.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/accessreviewinstance-batchrecorddecisions-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accessreviewinstance Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewinstance-filterbycurrentuser.md
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definition
[!INCLUDE [sample-code](../includes/snippets/php/accessreviewinstance-filterbycurrentuser-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Accessreviewinstance Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewinstance-get.md
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definition
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accessreviewinstance-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accessreviewinstance List Contactedreviewers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewinstance-list-contactedreviewers.md
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definition
[!INCLUDE [sample-code](../includes/snippets/powershell/list-accessreviewinstance-contactedreviewers-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accessreviewinstance List Decisions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewinstance-list-decisions.md
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definition
[!INCLUDE [sample-code](../includes/snippets/powershell/list-accessreviewinstancedecisionitem-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/decisions/
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell)+
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definition
[!INCLUDE [sample-code](../includes/snippets/powershell/list-accessreviewinstancedecisionitem-expandinsights-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Accessreviewinstance List Stages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewinstance-list-stages.md
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definition
[!INCLUDE [sample-code](../includes/snippets/powershell/list-accessreviewstage-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accessreviewinstance Pendingaccessreviewinstances https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewinstance-pendingaccessreviewinstances.md
GET https://graph.microsoft.com/beta/me/pendingAccessReviewInstances?$expand=def
[!INCLUDE [sample-code](../includes/snippets/php/list-accessreviewinstance-pendingapproval-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accessreviewinstance Resetdecisions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewinstance-resetdecisions.md
POST https://graph.microsoft.com/beta/identityGovernance/accessReviews/definitio
[!INCLUDE [sample-code](../includes/snippets/powershell/accessreviewinstance-resetdecisions-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accessreviewinstance Sendreminder https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewinstance-sendreminder.md
POST https://graph.microsoft.com/beta/identityGovernance/accessReviews/definitio
[!INCLUDE [sample-code](../includes/snippets/powershell/sendreminder-accessreview-2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accessreviewinstance Stop https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewinstance-stop.md
POST https://graph.microsoft.com/beta/identityGovernance/accessReviews/definitio
[!INCLUDE [sample-code](../includes/snippets/powershell/stop-accessreviewinstance-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accessreviewinstance Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewinstance-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-accessreviewinstance-e1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accessreviewinstancedecisionitem Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewinstancedecisionitem-filterbycurrentuser.md
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definition
[!INCLUDE [sample-code](../includes/snippets/php/accessreviewinstancedecisionitem-filterbycurrentuser-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definition
[!INCLUDE [sample-code](../includes/snippets/php/accessreviewinstancedecisionitem-filterbycurrentuser-2-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Accessreviewinstancedecisionitem Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewinstancedecisionitem-get.md
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definition
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accessreviewinstancedecisionitem-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definition
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accessreviewstage-accessreviewinstancedecisionitem-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Accessreviewinstancedecisionitem Listpendingapproval https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewinstancedecisionitem-listpendingapproval.md
GET https://graph.microsoft.com/beta/me/pendingAccessReviewInstances/70a68410-67
[!INCLUDE [sample-code](../includes/snippets/php/list-accessreviewinstancedecisionitem-pendingapproval-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accessreviewinstancedecisionitem Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewinstancedecisionitem-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-accessreviewdefinitioninstancedecisionsitem-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-accessreviewdefinitioninstancedecisionsstage-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Accessreviewpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewpolicy-get.md
GET https://graph.microsoft.com/beta/policies/accessReviewPolicy
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accessreviewpolicy-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/policy
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accessreviewpolicy-2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accessreviewpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewpolicy-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-accessreviewpolicy-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-accessreviewpolicy-2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accessreviewscheduledefinition Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewscheduledefinition-delete.md
DELETE https://graph.microsoft.com/beta/identityGovernance/accessReviews/definit
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-accessreviewscheduledefinition-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accessreviewscheduledefinition Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewscheduledefinition-filterbycurrentuser.md
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definition
[!INCLUDE [sample-code](../includes/snippets/php/accessreviewscheduledefinition-filterbycurrentuser-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Accessreviewscheduledefinition Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewscheduledefinition-get.md
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definition
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accessreviewscheduledefinition-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accessreviewscheduledefinition List Instances https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewscheduledefinition-list-instances.md
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definition
[!INCLUDE [sample-code](../includes/snippets/powershell/list-accessreviewinstance-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accessreviewscheduledefinition Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewscheduledefinition-update.md
Content-type: application/json
} ```
-# [C#](#tab/csharp)
-
-# [Go](#tab/go)
- # [Java](#tab/java) [!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/javascript/update-accessreviewscheduledefinition-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PHP](#tab/php)
- ### Response
v1.0 Accessreviewset List Definitions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewset-list-definitions.md
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definition
[!INCLUDE [sample-code](../includes/snippets/powershell/list-accessreviewscheduledefinition-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definition
[!INCLUDE [sample-code](../includes/snippets/powershell/list-accessreviewscheduledefinition-allgroups-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Accessreviewset List Historydefinitions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewset-list-historydefinitions.md
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/historyDef
[!INCLUDE [sample-code](../includes/snippets/powershell/list-accessreviewhistorydefinition-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accessreviewset Post Historydefinitions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewset-post-historydefinitions.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-accessreviewhistorydefinition-from--powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accessreviewstage Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewstage-filterbycurrentuser.md
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definition
[!INCLUDE [sample-code](../includes/snippets/php/accessreviewstage-filterbycurrentuser-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Accessreviewstage Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewstage-get.md
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definition
[!INCLUDE [sample-code](../includes/snippets/powershell/get-accessreviewstage-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accessreviewstage List Decisions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewstage-list-decisions.md
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definition
[!INCLUDE [sample-code](../includes/snippets/powershell/list-stage-accessreviewinstancedecisionitem-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accessreviewstage Stop https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewstage-stop.md
POST https://graph.microsoft.com/beta/identityGovernance/accessReviews/definitio
[!INCLUDE [sample-code](../includes/snippets/powershell/accessreviewstage-stop-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Accessreviewstage Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewstage-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-accessreviewstage-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Activities List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/activities-list.md
GET /sites/{site-id}/lists/{list-id}/items/{item-id}/activities
GET https://graph.microsoft.com/beta/me/drive/activities ```
+# [C#](#tab/csharp)
+
+# [Go](#tab/go)
+ # [Java](#tab/java) [!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
GET https://graph.microsoft.com/beta/me/drive/activities
[!INCLUDE [sample-code](../includes/snippets/javascript/list-activities-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ ### Response
v1.0 Activitybasedtimeoutpolicy Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/activitybasedtimeoutpolicy-delete.md
DELETE https://graph.microsoft.com/beta/policies/activityBasedTimeoutPolicies/{i
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-activitybasedtimeoutpolicy-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Activitybasedtimeoutpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/activitybasedtimeoutpolicy-get.md
GET https://graph.microsoft.com/beta/policies/activityBasedTimeoutPolicies/{id}
[!INCLUDE [sample-code](../includes/snippets/powershell/get-activitybasedtimeoutpolicy-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Activitybasedtimeoutpolicy List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/activitybasedtimeoutpolicy-list.md
GET https://graph.microsoft.com/beta/policies/activityBasedTimeoutPolicies
[!INCLUDE [sample-code](../includes/snippets/powershell/get-activitybasedtimeoutpolicies-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Activitybasedtimeoutpolicy Post Activitybasedtimeoutpolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/activitybasedtimeoutpolicy-post-activitybasedtimeoutpolicies.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-activitybasedtimeoutpolicy-from-activitybasedtimeoutpolicies-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Activitybasedtimeoutpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/activitybasedtimeoutpolicy-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-activitybasedtimeoutpolicy-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Activitystatistics List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/activitystatistics-list.md
GET https://graph.microsoft.com/beta/me/analytics/activitystatistics
[!INCLUDE [sample-code](../includes/snippets/powershell/get-activitystatistics-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Addlargegalleryviewoperation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/addlargegalleryviewoperation-get.md
GET https://graph.microsoft.com/beta/communications/calls/57dab8b1-894c-409a-b24
[!INCLUDE [sample-code](../includes/snippets/powershell/get-addlargegalleryviewoperation-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Adminappsandservices Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminappsandservices-get.md
+
+ Title: "Get adminAppsAndServices"
+description: "Read the properties and relationships of a Microsoft Graph adminAppsAndServices object."
+
+ms.localizationpriority: medium
++
+# Get adminAppsAndServices
+Namespace: microsoft.graph
++
+Read the properties and relationships of a [adminAppsAndServices](../resources/adminappsandservices.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)|OrgSettings-AppsAndServices.Read.All, OrgSettings-AppsAndServices.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|OrgSettings-AppsAndServices.Read.All, OrgSettings-AppsAndServices.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/appsAndServices
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [adminAppsAndServices](../resources/adminappsandservices.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_adminappsandservices"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/admin/appsAndServices
+```
+
+# [C#](#tab/csharp)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
++++
+### 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.adminAppsAndServices"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": {
+ "@odata.type": "#microsoft.graph.adminAppsAndServices",
+ "id": "c079f617-c04e-c14f-0750-cb2f87064342",
+ "settings": {
+ "@odata.type": "microsoft.graph.appsAndServicesSettings",
+ "isOfficeStoreEnabled": false,
+ "isAppAndServicesTrialEnabled": true
+ }
+ }
+}
+```
+
v1.0 Adminappsandservices Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminappsandservices-update.md
+
+ Title: "Update adminAppsAndServices"
+description: "Update the properties of a Microsoft Graph adminAppsAndServices object."
+
+ms.localizationpriority: medium
++
+# Update adminAppsAndServices
+Namespace: microsoft.graph
++
+Update the properties of a [adminAppsAndServices](../resources/adminappsandservices.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)|OrgSettings-AppsAndServices.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|OrgSettings-AppsAndServices.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /admin/appsAndServices
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
++
+|Property|Type|Description|
+|:|:|:|
+|settings|[appsAndServicesSettings](../resources/appsandservicessettings.md)|Company-wide settings for apps and services. Required.|
+++
+## Response
+
+If successful, this method returns a `200 OK` response code and an updated [adminAppsAndServices](../resources/adminappsandservices.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "update_adminappsandservices"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/admin/appsAndServices
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.adminAppsAndServices",
+ "settings": {
+ "@odata.type": "microsoft.graph.appsAndServicesSettings",
+ "isOfficeStoreEnabled": false,
+ "isAppAndServicesTrialEnabled": false
+ }
+}
+```
+
+# [C#](#tab/csharp)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
++++
+### Response
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+Content-Type: text/plain
+
+```
+
v1.0 Adminconsentrequestpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminconsentrequestpolicy-get.md
Title: "Get adminConsentRequestPolicy" description: "Read the properties and relationships of an adminConsentRequestPolicy object."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
GET https://graph.microsoft.com/beta/policies/adminConsentRequestPolicy
[!INCLUDE [sample-code](../includes/snippets/php/get-adminconsentrequestpolicy-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Adminconsentrequestpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminconsentrequestpolicy-update.md
Title: "Update adminConsentRequestPolicy" description: "Update the properties of an adminConsentRequestPolicy object."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
Content-Type: application/json
} ```
-# [C#](#tab/csharp)
-
-# [Go](#tab/go)
- # [Java](#tab/java) [!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/javascript/update-adminconsentrequestpolicy-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PHP](#tab/php)
- ### Response
v1.0 Admindynamics Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/admindynamics-get.md
+
+ Title: "Get adminDynamics"
+description: "Read the properties and relationships of a Microsoft Graph adminDynamics object."
+
+ms.localizationpriority: medium
++
+# Get adminDynamics
+Namespace: microsoft.graph
++
+Read the properties and relationships of a [adminDynamics](../resources/admindynamics.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)|OrgSettings-DynamicsVoice.Read.All, OrgSettings-DynamicsVoice.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|OrgSettings-DynamicsVoice.Read.All, OrgSettings-DynamicsVoice.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/dynamics
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [adminDynamics](../resources/admindynamics.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_admindynamics"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/admin/dynamics
+```
+
+# [C#](#tab/csharp)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
++++
+### 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.adminDynamics"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": {
+ "@odata.type": "#microsoft.graph.adminDynamics",
+ "id": "6099c226-4296-c20b-eb7f-a5f7c648cbed",
+ "customerVoice": {
+ "@odata.type": "microsoft.graph.customerVoiceSettings",
+ "isRestrictedSurveyAccessEnabled": "false",
+ "isRecordIdentityByDefaultEnabled": "true",
+ "isInOrgFormsPhishingScanEnabled": "true"
+ }
+ }
+}
+```
+
v1.0 Admindynamics Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/admindynamics-update.md
+
+ Title: "Update adminDynamics"
+description: "Update the properties of a Microsoft Graph adminDynamics object."
+
+ms.localizationpriority: medium
++
+# Update adminDynamics
+Namespace: microsoft.graph
++
+Update the properties of a [adminDynamics](../resources/admindynamics.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)|OrgSettings-DynamicsVoice.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|OrgSettings-DynamicsVoice.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /admin/dynamics
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
++
+|Property|Type|Description|
+|:|:|:|
+|customerVoice|[customerVoiceSettings](../resources/customervoicesettings.md)|Company-wide settings for Dynamics customer voice. Required.|
+++
+## Response
+
+If successful, this method returns a `200 OK` response code and an updated [adminDynamics](../resources/admindynamics.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "update_admindynamics"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/admin/dynamics
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.adminDynamics",
+ "customerVoice": {
+ "@odata.type": "microsoft.graph.customerVoiceSettings",
+ "isRestrictedSurveyAccessEnabled": "false",
+ "isRecordIdentityByDefaultEnabled": "false",
+ "isInOrgFormsPhishingScanEnabled": "false"
+ }
+}
+```
+
+# [C#](#tab/csharp)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
++++
+### Response
+The following is an example of the response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+Content-Type: text/plain
+
+```
+
v1.0 Adminforms Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminforms-get.md
+
+ Title: "Get adminForms"
+description: "Read the properties and relationships of a Microsoft Graph adminForms object."
+
+ms.localizationpriority: medium
++
+# Get adminForms
+Namespace: microsoft.graph
++
+Read the properties and relationships of a [adminForms](../resources/adminforms.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)|OrgSettings-Forms.Read.All, OrgSettings-Forms.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|OrgSettings-Forms.Read.All, OrgSettings-Forms.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/forms
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [adminForms](../resources/adminforms.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_adminforms"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/admin/forms
+```
+
+# [C#](#tab/csharp)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
++++
+### 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.adminForms"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": {
+ "@odata.type": "#microsoft.graph.adminForms",
+ "id": "7ef97113-d231-e67c-535d-7c051d9e22be",
+ "settings": {
+ "@odata.type": "microsoft.graph.formsSettings",
+ "isExternalSendFormEnabled": true,
+ "isExternalShareCollaborationEnabled": false,
+ "isExternalShareResultEnabled": false,
+ "isExternalShareTemplateEnabled": true,
+ "isRecordIdentityByDefaultEnabled": true,
+ "isBingImageSearchEnabled": true,
+ "isInOrgFormsPhishingScanEnabled": false
+ }
+ }
+}
+```
+
v1.0 Adminforms Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminforms-update.md
+
+ Title: "Update adminForms"
+description: "Update the properties of a Microsoft Graph adminForms object."
+
+ms.localizationpriority: medium
++
+# Update adminForms
+Namespace: microsoft.graph
++
+Update the properties of a [adminForms](../resources/adminforms.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)|OrgSettings-Forms.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|OrgSettings-Forms.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /admin/forms
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
++
+|Property|Type|Description|
+|:|:|:|
+|settings|[formsSettings](../resources/formssettings.md)|Company-wide settings for Microsoft Forms. Required.|
+++
+## Response
+
+If successful, this method returns a `200 OK` response code and an updated [adminForms](../resources/adminforms.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "update_adminforms"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/admin/forms
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.adminForms",
+ "settings": {
+ "@odata.type": "microsoft.graph.formsSettings",
+ "isExternalSendFormEnabled": true,
+ "isExternalShareCollaborationEnabled": false,
+ "isExternalShareResultEnabled": false,
+ "isExternalShareTemplateEnabled": false,
+ "isRecordIdentityByDefaultEnabled": true,
+ "isBingImageSearchEnabled": true,
+ "isInOrgFormsPhishingScanEnabled": false
+ }
+}
+```
+
+# [C#](#tab/csharp)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
++++
+### Response
+The following is an example of the response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+Content-Type: text/plain
+```
+
v1.0 Administrativeunit Delete Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/administrativeunit-delete-members.md
One of the following permissions is required to call this API. To learn more, in
```http DELETE /administrativeUnits/{id}/members/{id}/$ref ```+
+> [!CAUTION]
+> If you don't append `/$ref` to the request and the calling app has permissions to manage the member object, the object will also be deleted from Azure Active Directory (Azure AD); otherwise, a `403 Forbidden` error is returned. You can restore specific objects through the [Restore deleted items API](directory-deleteditems-restore.md).
+ ## Request headers | Name |Description| |:-|:-|
v1.0 Administrativeunit Delete Scopedrolemembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/administrativeunit-delete-scopedrolemembers.md
DELETE https://graph.microsoft.com/beta/administrativeUnits/{id}/scopedRoleMembe
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-scopedrolemember-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Administrativeunit Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/administrativeunit-delete.md
DELETE https://graph.microsoft.com/beta/administrativeUnits/{id}
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-administrativeunit-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Administrativeunit Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/administrativeunit-delta.md
GET https://graph.microsoft.com/beta/administrativeUnits/delta
[!INCLUDE [sample-code](../includes/snippets/php/administrativeunit-delta-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ ### Response
v1.0 Administrativeunit Get Scopedrolemembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/administrativeunit-get-scopedrolemembers.md
GET https://graph.microsoft.com/beta/administrativeUnits/{id}/scopedRoleMembers/
[!INCLUDE [sample-code](../includes/snippets/powershell/get-scopedrolemember-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Administrativeunit Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/administrativeunit-get.md
Do not supply a request body for this method.
## Response If successful, this method returns a `200 OK` response code and [administrativeUnit](../resources/administrativeunit.md) object in the response body.
-## Example
-### Request
-Here is an example of the request.
+
+## Examples
+
+### Example 1: Get an administrative unit
+
+#### Request
# [HTTP](#tab/http) <!-- {
GET https://graph.microsoft.com/beta/administrativeUnits/4d7ea995-bc0f-45c0-8c3e
[!INCLUDE [sample-code](../includes/snippets/powershell/get-administrativeunit-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+
-### Response
-Here is an example of the response.
+#### Response
>**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response",
Content-type: application/json
} ```
+### Example 2: Get a restricted management administrative unit
+
+#### Request
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_administrativeunit_restricted"
+}-->
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/administrativeUnits/2sd35b05-ae71-48ab-9e7d-4r41a28te37d
+```
+
+# [C#](#tab/csharp)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+++
+#### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.administrativeUnit"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#administrativeUnits/$entity",
+ "id": "2sd35b05-ae71-48ab-9e7d-4r41a28te37d",
+ "deletedDateTime": null,
+ "displayName": "Executive Division",
+ "description": "Executive division administration",
+ "isMemberManagementRestricted": true
+}
+```
+ ## See also - [Add custom data to resources using extensions](/graph/extensibility-overview)
v1.0 Administrativeunit List Scopedrolemembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/administrativeunit-list-scopedrolemembers.md
GET https://graph.microsoft.com/beta/administrativeUnits/{id}/scopedRoleMembers
[!INCLUDE [sample-code](../includes/snippets/powershell/get-scopedrolemember-2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Administrativeunit Post Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/administrativeunit-post-members.md
POST /administrativeUnits/{id}/members
| Content-type | application/json. Required. | ### Adding an existing user or group
-In the request body, provide the `id` of a [user](../resources/user.md), [group](../resources/group.md), [device](../resources/device.md), or [directoryObject](../resources/directoryobject.md) to be added.
+In the request body, provide the `id` of a [user](../resources/user.md), [group](../resources/group.md), [device](../resources/device.md), or [directoryObject](../resources/directoryobject.md) to be added. If the administrative unit is a restricted management administrative unit (`isMemberManagementRestricted`=true), the group type must be an Azure AD security group. Only non-unified groups that are security enabled, not mail enabled, and not on-premises sync enabled are supported.
### Creating a new group The following table shows the properties of the [group](../resources/group.md) resource to specify when you create a group in the administrative unit.
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/post-administrativeunits-members-ref-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ In the request body, provide the `id` of the [user](../resources/user.md), [group](../resources/group.md), or [device](../resources/device.md) object you want to add.
Content-type: application/json
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell)+
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Administrativeunit Post Scopedrolemembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/administrativeunit-post-scopedrolemembers.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-scopedrolemembership-from-administrativeunit-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ In the request body, supply a JSON representation of [scopedRoleMembership](../resources/scopedrolemembership.md) object.
v1.0 Administrativeunit Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/administrativeunit-update.md
Since the **administrativeUnit** resource supports [extensions](/graph/extensibi
If successful, this method returns a `204 No Content` response code.
-## Example
-The following example sets a dynamic membership rule on an existing administrative unit to include all users whose country is United States.
+## Examples
-### Request
+The following example sets a dynamic membership rule on an existing administrative unit to include all users whose country is United States. It also updates the administrative unit display name.
+### Request
# [HTTP](#tab/http) <!-- {
PATCH https://graph.microsoft.com/beta/administrativeUnits/4d7ea995-bc0f-45c0-8c
Content-type: application/json {
+ "displayName": "Executive Division",
"membershipType": "Dynamic", "membershipRule": "(user.country -eq \"United States\")", "membershipRuleProcessingState": "On"
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-administrativeunit-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Adminreportsettings Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminreportsettings-get.md
GET https://graph.microsoft.com/beta/admin/reportSettings
[!INCLUDE [sample-code](../includes/snippets/php/get-adminreportsettings-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ ### Response
v1.0 Adminreportsettings Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminreportsettings-update.md
Content-length: 37
[!INCLUDE [sample-code](../includes/snippets/php/update-adminreportsettings-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ ### Response
v1.0 Admintodo Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/admintodo-get.md
+
+ Title: "Get adminTodo"
+description: "Read the properties and relationships of a Microsoft Graph adminTodo object."
+
+ms.localizationpriority: medium
++
+# Get adminTodo
+Namespace: microsoft.graph
++
+Read the properties and relationships of a [adminTodo](../resources/admintodo.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)|OrgSettings-Todo.Read.All, OrgSettings-Todo.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|OrgSettings-Todo.Read.All, OrgSettings-Todo.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/todo
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [adminTodo](../resources/admintodo.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_admintodo"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/admin/todo
+```
+
+# [C#](#tab/csharp)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
++++
+### 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.adminTodo"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": {
+ "@odata.type": "#microsoft.graph.adminTodo",
+ "id": "9b13e840-31a8-2ed4-57d8-22f42c130334",
+ "settings": {
+ "@odata.type": "microsoft.graph.todoSettings",
+ "isPushNotificationEnabled": true,
+ "isExternalJoinEnabled": true,
+ "isExternalShareEnabled": true
+ }
+ }
+}
+```
+
v1.0 Admintodo Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/admintodo-update.md
+
+ Title: "Update adminTodo"
+description: "Update the properties of a Microsoft Graph adminTodo object."
+
+ms.localizationpriority: medium
++
+# Update adminTodo
+Namespace: microsoft.graph
++
+Update the properties of a [adminTodo](../resources/admintodo.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)|OrgSettings-Todo.ReadWrite.All|
+|Delegated (personal Microsoft account)|**Not supported.**|
+|Application|**OrgSettings-Todo.ReadWrite.All**|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /admin/todo
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
++
+|Property|Type|Description|
+|:|:|:|
+|settings|[todoSettings](../resources/todosettings.md)|Company-wide settings for Microsoft Todo. Required.|
+++
+## Response
+
+If successful, this method returns a `200 OK` response code and an updated [adminTodo](../resources/admintodo.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "update_admintodo"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/admin/todo
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.adminTodo",
+ "settings": {
+ "@odata.type": "microsoft.graph.todoSettings",
+ "isPushNotificationEnabled": true,
+ "isExternalJoinEnabled": false,
+ "isExternalShareEnabled": true
+ }
+}
+```
+
+# [C#](#tab/csharp)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
++++
+### Response
+The following is an example of the response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+Content-Type: text/plain
+
+```
+
v1.0 Adminwindowsupdates List Deploymentaudiences https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminwindowsupdates-list-deploymentaudiences.md
GET https://graph.microsoft.com/beta/admin/windows/updates/deploymentAudiences
[!INCLUDE [sample-code](../includes/snippets/php/list-deployment-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Adminwindowsupdates List Deployments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminwindowsupdates-list-deployments.md
GET https://graph.microsoft.com/beta/admin/windows/updates/deployments
[!INCLUDE [sample-code](../includes/snippets/powershell/list-deployment-e1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Adminwindowsupdates List Resourceconnections Operationalinsightsconnection https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminwindowsupdates-list-resourceconnections-operationalinsightsconnection.md
GET https://graph.microsoft.com/beta/admin/windows/updates/resourceConnections/m
[!INCLUDE [sample-code](../includes/snippets/powershell/list-operationalinsightsconnection-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Adminwindowsupdates List Resourceconnections https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminwindowsupdates-list-resourceconnections.md
GET https://graph.microsoft.com/beta/admin/windows/updates/resourceConnections
[!INCLUDE [sample-code](../includes/snippets/powershell/list-resourceconnection-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Adminwindowsupdates List Updatableassets Azureaddevice https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminwindowsupdates-list-updatableassets-azureaddevice.md
GET https://graph.microsoft.com/beta/admin/windows/updates/updatableAssets/micro
[!INCLUDE [sample-code](../includes/snippets/powershell/list-azureaddevice-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Adminwindowsupdates List Updatableassets Updatableassetgroup https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminwindowsupdates-list-updatableassets-updatableassetgroup.md
GET https://graph.microsoft.com/beta/admin/windows/updates/updatableAssets/micro
[!INCLUDE [sample-code](../includes/snippets/powershell/list-updatableassetgroup-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Adminwindowsupdates List Updatableassets https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminwindowsupdates-list-updatableassets.md
GET https://graph.microsoft.com/beta/admin/windows/updates/updatableAssets
[!INCLUDE [sample-code](../includes/snippets/powershell/list-updatableasset-fromupdates-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Adminwindowsupdates List Updatepolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminwindowsupdates-list-updatepolicies.md
GET https://graph.microsoft.com/beta/admin/windows/updates/updatePolicies
[!INCLUDE [sample-code](../includes/snippets/powershell/list-updatepolicy-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Adminwindowsupdates Post Deploymentaudiences https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminwindowsupdates-post-deploymentaudiences.md
Content-length: 4
[!INCLUDE [sample-code](../includes/snippets/php/create-deploymentaudience-from--php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Adminwindowsupdates Post Deployments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminwindowsupdates-post-deployments.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-deployment-from--powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Adminwindowsupdates Post Resourceconnections Operationalinsightsconnection https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminwindowsupdates-post-resourceconnections-operationalinsightsconnection.md
Content-length: 97
[!INCLUDE [sample-code](../includes/snippets/powershell/create-operationalinsightsconnection-from--powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Adminwindowsupdates Post Updatableassets Updatableassetgroup https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminwindowsupdates-post-updatableassets-updatableassetgroup.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-updatableassetgroup-from--powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Adminwindowsupdates Post Updatepolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminwindowsupdates-post-updatepolicies.md
Content-length: 835
[!INCLUDE [sample-code](../includes/snippets/powershell/create-updatepolicy-from--powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Agreement Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/agreement-delete.md
description: "Delete an agreement object."
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # Delete agreement
DELETE https://graph.microsoft.com/beta/identityGovernance/termsOfUse/agreements
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-agreement-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Agreement Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/agreement-get.md
description: "Retrieve the properties and relationships of an agreement object."
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # Get agreement
GET https://graph.microsoft.com/beta/identityGovernance/termsOfUse/agreements/0e
[!INCLUDE [sample-code](../includes/snippets/powershell/get-agreement-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/identityGovernance/termsOfUse/agreements/09
[!INCLUDE [sample-code](../includes/snippets/powershell/get-agreement-files-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Agreement List Acceptances https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/agreement-list-acceptances.md
Title: "List acceptances" description: "Get the details about the acceptance records for a specific agreement."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
GET https://graph.microsoft.com/beta/identityGovernance/termsOfUse/agreements/94
[!INCLUDE [sample-code](../includes/snippets/php/list-agreementacceptance-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Agreement List Files https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/agreement-list-files.md
Title: "List files (localized agreement files)"
+ Title: "List files (terms of use agreement files)"
description: "Retrieve all localized files related to an agreement." ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+
-# List files (localized agreement files)
+# List files (terms of use agreement files)
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve all localized files related to an agreement.
+Retrieve all files related to an agreement. This includes the default file and all localized files.
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
GET https://graph.microsoft.com/beta/identityGovernance/termsOfUse/agreements/94
[!INCLUDE [sample-code](../includes/snippets/powershell/list-agreementfilelocalization-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Agreement Post Files https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/agreement-post-files.md
Title: "Create agreementFileLocalization" description: "Create a new localized agreement file."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-agreementfilelocalization-from--php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ ### Response
v1.0 Agreement Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/agreement-update.md
description: "Update the properties of an agreement object."
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # Update agreement
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-agreement-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Agreementfile Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/agreementfile-get.md
Title: "Get agreementFile" description: "Retrieve the details of the default file for an agreement, including the language and version information. "-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve the details of the default file for an agreement, including the language and version information. The file information is specified through the [agreementFile](../resources/agreementfile.md) object.
+Retrieve the details of an agreement file, including the language and version information. The default file can have multiple versions, each with its own language, that can be retrieved by specifying the **Accept-Language** header.
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
GET /agreements/{agreementsId}/file
``` ## Optional query parameters
-This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+This method does not support any OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
## Request headers |Name|Description|
If successful, this method returns a `200 OK` response code and a collection of
## Examples
-### Request
+### Example 1: Get the default agreement file
+
+#### Request
# [HTTP](#tab/http) <!-- {
GET https://graph.microsoft.com/beta/identityGovernance/termsOfUse/agreements/94
[!INCLUDE [sample-code](../includes/snippets/powershell/get-agreementfile-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+
-### Response
+#### Response
>**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response",
Content-Type: application/json
} ``` +
+### Example 2: Get the agreement file for a specific language
+
+#### Request
+
+The following example shows how to get the agreement file for the `fr-FR` language. If no such agreement file exists, the default agreement file is returned.
+
+<!-- {
+ "blockType": "request",
+ "name": "list_agreementfile_fr"
+}
+-->
+```http
+GET https://graph.microsoft.com/beta/agreements/94410bbf-3d3e-4683-8149-f034e55c39dd/file
+Accept-Language: fr-FR
+```
+
+#### Response
+
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.agreementFile"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#agreements('94410bbf-3d3e-4683-8149-f034e55c39dd')/file/$entity",
+ "@odata.type": "#microsoft.graph.agreementFileLocalization",
+ "id": "90d1723c-52c1-40e3-a51a-da99a82c0327",
+ "fileName": "Contoso ToU for guest users (French)",
+ "displayName": "Contoso ToU for guest users (French)",
+ "language": "fr-FR",
+ "isDefault": false,
+ "isMajorVersion": false,
+ "createdDateTime": "2022-03-04T14:38:22.8292386Z",
+ "fileData": null
+}
+```
+
v1.0 Agreementfile List Localizations https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/agreementfile-list-localizations.md
+
+ Title: "List agreementFileLocalizations"
+description: "Get a list of the default and localized agreement files."
+
+ms.localizationpriority: medium
++
+# List agreementFileLocalizations
+Namespace: microsoft.graph
++
+Get a list of the default and localized agreement files.
+
+## Permissions
+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)|Agreement.Read.All, Agreement.ReadWrite.All |
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /agreements/{agreementsId}/file/localizations
+```
+
+## Optional query parameters
+This method does not support OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## 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 [agreementFileLocalization](../resources/agreementfilelocalization.md) objects in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "list_agreementfile_localization"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/agreements/94410bbf-3d3e-4683-8149-f034e55c39dd/file/localizations
+```
++
+### 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": "Collection(microsoft.graph.agreementFileLocalization)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#agreements('94410bbf-3d3e-4683-8149-f034e55c39dd')/file/localizations",
+ "value": [
+ {
+ "id": "90d1723c-52c1-40e3-a51a-da99a82c0327",
+ "fileName": "Contoso ToU for guest users (French)",
+ "displayName": "Contoso ToU for guest users (French)",
+ "language": "fr-FR",
+ "isDefault": false,
+ "isMajorVersion": false,
+ "createdDateTime": "2022-03-04T14:38:22.8292386Z",
+ "fileData": null
+ },
+ {
+ "id": "08033369-8972-42a3-8533-90bbd2757a01",
+ "fileName": "TOU.pdf",
+ "displayName": "Contoso ToU for guest users",
+ "language": "en",
+ "isDefault": true,
+ "isMajorVersion": false,
+ "createdDateTime": "2022-03-04T13:14:13.9361722Z",
+ "fileData": null
+ }
+ ]
+}
+```
+
v1.0 Alert Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/alert-get.md
GET https://graph.microsoft.com/beta/security/alerts/{id}
[!INCLUDE [sample-code](../includes/snippets/powershell/get-alert-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Alert List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/alert-list.md
GET https://graph.microsoft.com/beta/security/alerts
[!INCLUDE [sample-code](../includes/snippets/powershell/get-alerts-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Alert Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/alert-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-alert-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ <!-- markdownlint-disable MD024 -->
Prefer: return=representation
[!INCLUDE [sample-code](../includes/snippets/powershell/update-alert-2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Alert Updatealerts https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/alert-updatealerts.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/alert-updatealerts-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Allowedvalue Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/allowedvalue-get.md
doc_type: apiPageType
# Get allowedValue+ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
Namespace: microsoft.graph
Read the properties and relationships of an [allowedValue](../resources/allowedvalue.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)|
GET /directory/customSecurityAttributeDefinitions/{customSecurityAttributeDefini
``` ## Optional query parameters
-This method supports the `$select` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+This method supports the `$select` OData query parameter to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
## Request headers+ |Name|Description| |:|:| |Authorization|Bearer {token}. Required.| ## Request body+ Do not supply a request body for this method. ## Response
If successful, this method returns a `200 OK` response code and an [allowedValue
## Examples
-### Example: Get the properties of a predefined value
+### Request
The following example gets the properties of a predefined value for a custom security attribute definition.
The following example gets the properties of a predefined value for a custom sec
+ Attribute: `Project` + Predefined value: `Alpine`
-#### Request
- # [HTTP](#tab/http) <!-- { "blockType": "request",
GET https://graph.microsoft.com/beta/directory/customSecurityAttributeDefinition
[!INCLUDE [sample-code](../includes/snippets/powershell/get-allowedvalue-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+
-#### Response
+### Response
+
+The following is an example of the response.
+ <!-- { "blockType": "response", "truncated": true,
v1.0 Allowedvalue Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/allowedvalue-update.md
doc_type: apiPageType
# Update allowedValue+ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
Namespace: microsoft.graph
Update the properties of an [allowedValue](../resources/allowedvalue.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)|
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application|CustomSecAttributeDefinition.ReadWrite.All|
-The signed-in user must also be assigned the Attribute Definition Administrator [directory role](/azure/active-directory/roles/permissions-reference). By default, Global Administrator and other administrator roles do not have permissions to read, define, or assign custom security attributes.
## HTTP request
The signed-in user must also be assigned the Attribute Definition Administrator
PATCH /directory/customSecurityAttributeDefinitions/{customSecurityAttributeDefinitionId}/allowedValues/{allowedValueId} ``` - ## Request headers+ |Name|Description| |:|:| |Authorization|Bearer {token}. Required.| |Content-Type|application/json. Required.| ## Request body
-In the request body, supply *only* the values for properties 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.
-The following table specifies the properties that can be updated.
|Property|Type|Description| |:|:|:|
-|isActive|Boolean|Indicates whether the predefined value is active or deactivated. If set to `false`, this predefined value cannot be assigned to any additional supported directory objects. Optional.|
--
+|isActive|Boolean|Indicates whether the predefined value is active or deactivated. If `false`, this predefined value cannot be assigned to any additional supported directory objects. Optional.|
## Response
If successful, this method returns a `204 No Content` response code.
## Examples
-### Example: Deactivate a predefined value
+### Request
The following example deactivates a predefined value for a custom security attribute definition.
The following example deactivates a predefined value for a custom security attri
+ Attribute: `Project` + Predefined value: `Alpine`
-#### Request
- # [HTTP](#tab/http) <!-- { "blockType": "request",
Content-length: 80
[!INCLUDE [sample-code](../includes/snippets/powershell/update-allowedvalue-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+
-#### Response
+### Response
+
+The following is an example of the response.
+ <!-- { "blockType": "response", "truncated": true
v1.0 Appmanagementpolicy Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/appManagementPolicy-delete.md
- Title: "Delete appManagementPolicy"
-description: "Delete an application management policy."
-
-doc_type: "apiPageType"
--
-# Delete appManagementPolicy
-
-Namespace: microsoft.graph
--
-Delete an [appManagementPolicy](../resources/appManagementPolicy.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) | Policy.ReadWrite.ApplicationConfiguration |
-| Delegated (personal Microsoft account) | Not supported. |
-| Application | Policy.ReadWrite.ApplicationConfiguration |
-
-## HTTP request
-
-<!-- { "blockType": "ignored" } -->
-
-```http
-DELETE /policies/appManagementPolicies/{id}
-```
-
-## Request headers
-
-| Name | Description |
-| : | :-- |
-| Authorization | Bearer {token}. Required. |
-| Content-Type | application/json. Required. |
-
-## Request body
-
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns `204 No Content` response code. It does not return anything in the response body.
-
-## Examples
-
-### Request
-
-The following is an example of the request.
--
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "delete_appManagementPolicy"
-}-->
-
-```http
-DELETE https://graph.microsoft.com/beta/policies/appManagementPolicies/{id}
-```
-
-# [C#](#tab/csharp)
-
-# [Go](#tab/go)
-
-# [Java](#tab/java)
-
-# [JavaScript](#tab/javascript)
-
-# [PHP](#tab/php)
-
-# [PowerShell](#tab/powershell)
---
-### Response
-
-The following is an example of the response.
-
-<!-- {
- "blockType": "response",
- "truncated": false
-} -->
-
-```http
-HTTP/1.1 204 No Content
-
-```
-
-<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
-2019-02-04 14:57:30 UTC -->
-<!-- {
- "type": "#page.annotation",
- "description": "delete appManagementPolicy",
- "keywords": "",
- "section": "documentation",
- "tocPath": ""
-}-->
v1.0 Appmanagementpolicy List Appliesto https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/appManagementPolicy-list-appliesTo.md
- Title: "List appliesTo"
-description: "List resources assigned to an application management policy."
-
-doc_type: "apiPageType"
--
-# List appliesTo
-
-Namespace: microsoft.graph
--
-List application and service principal objects assigned an [appManagementPolicy](../resources/appManagementPolicy.md) policy 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) | Application.Read.All and Policy.Read.All, Application.Read.All and Policy.ReadWrite.ApplicationConfiguration |
-| Delegated (personal Microsoft account) | Not supported. |
-| Application | Application.Read.All and Policy.Read.All, Application.Read.All and Policy.ReadWrite.ApplicationConfiguration |
-
-## HTTP request
-
-<!-- { "blockType": "ignored" } -->
-
-```http
-GET /policies/appManagementPolicies/{id}/appliesTo
-```
-
-## Optional query parameters
-
-This method supports the `$select`, `$filter`, and `$top` OData query parameters to help customize the response. You can apply `$filter` on properties of [application](../resources/application.md) or [servicePrincipal](../resources/serviceprincipal.md) objects that support `$filter`. For example, the following query retrieves the **appId** and **displayName** of applications or service principals that are assigned the policy.
-
-``` http
-
-https://graph.microsoft.com/beta/policies/appManagementPolicies/{id}/appliesTo?$select=appId,displayName
-```
-
-For general information, see [OData query parameters](/graph/query-parameters).
-
-## Request headers
-
-| Name | Description |
-| : | : |
-| Authorization | Bearer {token}. Required. |
-
-## 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 [appManagementPolicy](../resources/appManagementPolicy.md) objects in the response body.
-
-## Examples
-
-### Example 1: Get applications and service principal objects applied to an app management policy
-
-#### Request
-
-The following is an example of the request.
--
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "list_appManagementPolicyAppliesTo"
-}-->
-
-```msgraph-interactive
-GET https://graph.microsoft.com/beta/policies/appManagementPolicies/{id}/appliesTo
-```
-
-# [C#](#tab/csharp)
-
-# [Go](#tab/go)
-
-# [Java](#tab/java)
-
-# [JavaScript](#tab/javascript)
-
-# [PHP](#tab/php)
-
-# [PowerShell](#tab/powershell)
---
-#### 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.appManagementPolicy"
-} -->
-
-```http
-HTTP/1.1 200 OK
-Content-type: application/json
-
-{
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#directoryObjects",
- "value": [
- {
- "@odata.type": "#microsoft.graph.application",
- "id": "0d77e011-2fc6-438f-8b93-decb4f926929",
- "appId": "8f527de6-05c9-4032-bca9-b2b56ab2358a",
- "displayName": "TestApp1",
- "createdDateTime": "2018-01-24T05:55:37Z"
- }
- ]
-}
-```
-
-### Example 2: Get specific properties of applications and service principal objects applied to an app management policy using $select query option
-
-#### Request
-
-The following is an example of the request using $select query option.
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "list_appManagementPolicyAppliesTo_select"
-}-->
-
-```msgraph-interactive
-GET https://graph.microsoft.com/beta/policies/appManagementPolicies/{id}/appliesTo?$select=id,appId,displayName,createdDateTime
-```
-
-# [C#](#tab/csharp)
-
-# [Go](#tab/go)
-
-# [Java](#tab/java)
-
-# [JavaScript](#tab/javascript)
-
-# [PHP](#tab/php)
-
-# [PowerShell](#tab/powershell)
---
-#### Response
-
-The following is an example of the response that returns `id`, `appId`, `displayName` and `createdDateTime` of applications and service principals where the policy is applied.
-
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.appManagementPolicy"
-} -->
-
-```http
-HTTP/1.1 200 OK
-Content-type: application/json
-
-{
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#directoryObjects(id,appId,displayName,createdDateTime)",
- "value": [
- {
- "@odata.type": "#microsoft.graph.application",
- "id": "0d77e011-2fc6-438f-8b93-decb4f926929",
- "appId": "8f527de6-05c9-4032-bca9-b2b56ab2358a",
- "displayName": "TestApp1",
- "createdDateTime": "2018-01-24T05:55:37Z"
- },
- {
- "@odata.type": "#microsoft.graph.servicePrincipal",
- "id": "0e1fa067-dcc1-4d85-9b4c-e69145dd3efb",
- "appId": "255912cb-e31d-4dee-bee4-3fa5d774d6b9",
- "displayName": "TestApp2",
- "createdDateTime": "2018-01-24T05:55:37Z"
- }
- ]
-}
-```
--
-<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
-2019-02-04 14:57:30 UTC -->
-<!-- {
- "type": "#page.annotation",
- "description": "list resources for appManagementPolicies",
- "keywords": "",
- "section": "documentation",
- "tocPath": ""
-}-->
v1.0 Appmanagementpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/appManagementPolicy-update.md
- Title: "Update appManagementPolicy"
-description: "Update an application management policy."
-
-doc_type: "apiPageType"
--
-# Update appManagementPolicy
-
-Namespace: microsoft.graph
--
-Update an [appManagementPolicy](../resources/appManagementPolicy.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) | Policy.ReadWrite.ApplicationConfiguration |
-| Delegated (personal Microsoft account) | Not supported. |
-| Application | Policy.ReadWrite.ApplicationConfiguration |
-
-## HTTP request
-
-<!-- { "blockType": "ignored" } -->
-
-```http
-PATCH /policies/appManagementPolicies/{id}
-```
-
-## Request headers
-
-| Name | Description |
-| : | :-- |
-| Authorization | Bearer {token}. Required. |
-| Content-Type | application/json. Required. |
-
-## Request body
-
-In the request body, supply the values for relevant fields from the [appManagementPolicy](../resources/appManagementPolicy.md) 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 | The display name of the policy. Inherited from [policyBase](../resources/policybase.md). |
-| description | String | The description of the policy. Inherited from [policyBase](../resources/policybase.md). |
-| isEnabled | Boolean | Denotes whether the policy is enabled. |
-| restrictions | [appManagementConfiguration](../resources/appManagementConfiguration.md) | Restrictions that apply to an application or service principal object. |
-
-## Response
-
-If successful, this method returns a `204 No Content` response code.
-
-## Examples
-
-### Request
-
-The following is an example of the request.
--
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "update_appManagementPolicy"
-}-->
-
-```http
-PATCH https://graph.microsoft.com/beta/policies/appManagementPolicies/{id}
-
-{
- "isEnabled": false
-}
-
-```
-
-# [C#](#tab/csharp)
-
-# [Go](#tab/go)
-
-# [Java](#tab/java)
-
-# [JavaScript](#tab/javascript)
-
-# [PHP](#tab/php)
---
-### Response
-
-The following is an example of the response.
-
-<!-- {
- "blockType": "response",
- "truncated": true
-} -->
-
-```http
-HTTP/1.1 204 No Content
-
-```
-
-<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
-2019-02-04 14:57:30 UTC -->
-<!-- {
- "type": "#page.annotation",
- "description": "update appManagementPolicies",
- "keywords": "",
- "section": "documentation",
- "tocPath": ""
-}-->
v1.0 Appcatalogs List Teamsapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/appcatalogs-list-teamsapps.md
Namespace: microsoft.graph
List [apps](../resources/teamsapp.md) from the Microsoft Teams app catalog. This includes apps from the Microsoft Teams store, as well as apps from your organization's app catalog (the tenant app catalog). To get apps from your organization's app catalog only, specify `organization` as the **distributionMethod** in the request.
-> [!NOTE]
+> [!NOTE]
> In general, the **id** of a **teamsApp** resource is generated by the server. It is not the same as the **id** specified in a Teams app manifest, unless its **distributionMethod** is `store`. For other cases, the **id** provided by the developer as part of the Teams app manifest is stamped as the **externalId** in the **teamsApp** resource. ## Permissions
One of the following permissions is required to call this API. To learn more, in
| Delegated (personal Microsoft account) | Not supported. | | Application | AppCatalog.Read.All, AppCatalog.ReadWrite.All |
-> **Note**:
+> **Note**:
<br><sup>1</sup> These permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission and avoid using these permissions going forward. ## HTTP request
GET /appCatalogs/teamsApps
This method supports the `$filter`, `$select`, and `$expand` [OData query parameters](/graph/query-parameters) to help customize the response.
-Using `$expand=AppDefinitions` will return more information about the state of the app, such as the **publishingState**, which reflects the app submission review status and returns whether an app has been approved, rejected, or remains under review.
+Using `$expand=AppDefinitions` will return more information about the state of the app, such as the **publishingState**, which reflects the app submission review status and returns whether an app has been approved, rejected, or remains under review.
> **Note:** You can filter on any of the fields of the [teamsApp](../resources/teamsapp.md) object to shorten the list of results. You can use any of the following filter operations: Equal, not-equal, and, or, and not.
GET https://graph.microsoft.com/beta/appCatalogs/teamsApps?$filter=distributionM
[!INCLUDE [sample-code](../includes/snippets/powershell/list-teamsapps-filter-distributionmethod-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ <!-- markdownlint-disable MD024 -->
GET https://graph.microsoft.com/beta/appCatalogs/teamsApps?$filter=id eq 'b1c535
[!INCLUDE [sample-code](../includes/snippets/powershell/list-teamsapp-filter-id-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
] } ```+ ### Example 3: Find application based on the Teams app manifest ID The following example lists applications that match the **id** specified in the Teams app manifest. In the example, the manifest ID of the Teams app is `cf1ba4c7-f94e-4d80-ba90-5594b641a8ee`.
GET https://graph.microsoft.com/beta/appCatalogs/teamsApps?$filter=externalId e
[!INCLUDE [sample-code](../includes/snippets/powershell/list-teamsapp-filter-externalid-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/appCatalogs/teamsApps?$filter=id eq '876df
[!INCLUDE [sample-code](../includes/snippets/powershell/list-teamsapp-with-filter-expand-appdefinitions-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/appCatalogs/teamsApps?$expand=appDefinitio
[!INCLUDE [sample-code](../includes/snippets/powershell/list-teamsapp-with-bots-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/appCatalogs/teamsApps?$expand=appDefinitio
[!INCLUDE [sample-code](../includes/snippets/powershell/list-teamsapp-in-personal-scope-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
] } ```+ ### Example 7: List applications with a given ID and return only the resource specific permissions required by the app The following example lists the apps with a given ID and returns the resource-specific permissions that are associated with it.
GET https://graph.microsoft.com/beta/appCatalogs/teamsApps?$filter=id+eq+'a5228
[!INCLUDE [sample-code](../includes/snippets/powershell/list-teamsapp-with-rsc-permissions-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
- [List apps installed in a chat](chat-list-installedapps.md) - [List apps installed in the personal scope of a user](userteamwork-list-installedapps.md) - [Request resource-specific consent for apps](/microsoftteams/platform/graph-api/rsc/resource-specific-consent)----
v1.0 Appconsentapprovalroute List Appconsentrequests https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/appconsentapprovalroute-list-appconsentrequests.md
Title: "List appConsentRequests" description: "Retrieve appConsentRequest objects and their properties."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
GET https://graph.microsoft.com/beta/identityGovernance/appConsent/appConsentReq
[!INCLUDE [sample-code](../includes/snippets/powershell/list-appconsentrequest-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/identityGovernance/appConsent/appConsentReq
[!INCLUDE [sample-code](../includes/snippets/powershell/list-appconsentrequest-userconsentrequest-inprogress-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Appconsentrequest Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/appconsentrequest-filterByCurrentUser.md
Title: "appConsentRequest: filterByCurrentUser" description: "Retrieve appConsentRequest objects for which the current user is the reviewer."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
GET https://graph.microsoft.com/beta/identityGovernance/appConsent/appConsentReq
[!INCLUDE [sample-code](../includes/snippets/php/appconsentrequest-filterbycurrentuser-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Appconsentrequest Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/appconsentrequest-get.md
Title: "Get appConsentRequest" description: "Read the properties and relationships of an appConsentRequest object."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
GET https://graph.microsoft.com/beta/identityGovernance/appConsent/appConsentReq
[!INCLUDE [sample-code](../includes/snippets/powershell/get-appconsentrequest-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Appconsentrequest List Userconsentrequests https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/appconsentrequest-list-userconsentrequests.md
Title: "List userConsentRequests" description: "Retrieve userConsentRequest objects and their properties."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
GET https://graph.microsoft.com/beta/identityGovernance/appConsent/appConsentReq
[!INCLUDE [sample-code](../includes/snippets/powershell/list-userconsentrequest-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Appcredentialsigninactivity Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/appcredentialsigninactivity-get.md
+
+ Title: "Get appCredentialSignInActivity"
+description: "Get an appCredentialSignInActivity object that contains recent activity of an application credential."
+ms.localizationpriority: medium
+++
+# Get appCredentialSignInActivity
+
+Namespace: microsoft.graph
++
+Get an [appCredentialSignInActivity](../resources/appcredentialsigninactivity.md) object that contains recent activity of an application credential.
+
+## Permissions
+
+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) | AuditLog.Read.All, Directory.Read.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | AuditLog.Read.All, Directory.Read.All |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+```http
+GET /reports/appCredentialSignInActivities/{appCredentialSignInActivityId}
+```
+
+## Optional query parameters
+
+This method does not support OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+
+| Name | Description |
+| : | : |
+| Authorization | Bearer {token}. Required. |
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and an [appCredentialSignInActivity](../resources/appcredentialsigninactivity.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of a request that shows how to get an **appCredentialSignInActivity** object based on its ID.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_appcredentialsigninactivity_1",
+ "sampleKeys": ["ODNmNDUyOTYtZmI4Zi00YWFhLWEzOTktYWM1MTA4NGUwMmI3fGFwcGxpY2F0aW9u"]
+}-->
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/reports/appCredentialSignInActivities/ODNmNDUyOTYtZmI4Zi00YWFhLWEzOTktYWM1MTA4NGUwMmI3fGFwcGxpY2F0aW9u
+```
+
+# [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.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.appCredentialSignInActivity"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+Content-length: 211
+
+{
+ "@odata.type": "#microsoft.graph.appCredentialSignInActivity",
+ "appId": "f4d9654f-0305-4072-878c-8bf266dfe146",
+ "appObjectId": "6920caa5-1cae-4bc8-bf59-9c0b8495d240",
+ "credentialOrigin": "application",
+ "expirationDate": "2021-04-01T21:36:48-8:00",
+ "id": "ODNmNDUyOTYtZmI4Zi00YWFhLWEzOTktYWM1MTA4NGUwMmI3fGFwcGxpY2F0aW9u",
+ "keyId": "83f45296-fb8f-4aaa-a399-ac51084e02b7",
+ "keyType":"certificate",
+ "keyUsage": "sign",
+ "resourceId": "a89dc091-a671-4da4-9fcf-3ef06bdf3ac3",
+ "servicePrincipalObjectId": "cf533854-9fb7-4c01-9c0e-f68922ada8b6",
+ "signInActivity": {
+ "lastSignInDateTime": "2021-04-01T00:00:00-8:00",
+ "lastSignInRequestId": "b0a282a3-68ec-4ec8-aef0-290ed4350271"
+ }
+}
+```
v1.0 Application Addkey https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-addkey.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/application-addkey-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/application-addkey-2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Application Addpassword https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-addpassword.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/application-addpassword-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Application Delete Owners https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-delete-owners.md
DELETE https://graph.microsoft.com/beta/applications/{id}/owners/{id}/$ref
[!INCLUDE [sample-code](../includes/snippets/powershell/application-delete-owners-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Application Delete Tokenissuancepolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-delete-tokenissuancepolicies.md
Remove a [tokenIssuancePolicy](../resources/tokenissuancepolicy.md) from an [app
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
| Permission type | Permissions (from least to most privileged) | |:|:--| | Delegated (work or school account) | Policy.Read.All and Application.ReadWrite.All, Policy.ReadWrite.ApplicationConfiguration and Application.ReadWrite.All |
DELETE https://graph.microsoft.com/beta/applications/{id}/tokenIssuancePolicies/
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-tokenissuancepolicy-from-application-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Application Delete Tokenlifetimepolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-delete-tokenlifetimepolicies.md
Remove a [tokenLifetimePolicy](../resources/tokenlifetimepolicy.md) from an [app
One of the following sets of permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
| Permission type | Permissions (from least to most privileged) | |:|:--| | Delegated (work or school account) | Policy.Read.All and Application.ReadWrite.All, Policy.ReadWrite.ApplicationConfiguration and Application.ReadWrite.All |
You can address the application using either its **id** or **appId**. **id** and
<!-- { "blockType": "ignored" } --> ```http
-DELETE /applications/{id}/tokenLifetimePolicies/$ref
+DELETE /applications/{applicationObjectId}/tokenLifetimePolicies/{tokenLifetimePolicyId}/$ref
-DELETE /applications(appId='{appId}')/tokenLifetimePolicies/$ref
+DELETE /applications(appId='{appId}')/tokenLifetimePolicies/{tokenLifetimePolicyId}/$ref
-DELETE /servicePrincipals/{id}/tokenLifetimePolicies/$ref
+DELETE /servicePrincipals/{servicePrincipalObjectId}/tokenLifetimePolicies/{tokenLifetimePolicyId}/$ref
-DELETE /servicePrincipals(appId='{appId}')/tokenLifetimePolicies/$ref
+DELETE /servicePrincipals(appId='{appId}')/tokenLifetimePolicies/{tokenLifetimePolicyId}/$ref
``` ## Request headers
DELETE https://graph.microsoft.com/beta/applications/3ccc9971-9ae7-45d6-8de8-263
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-tokenlifetimepolicy-from-application-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Application Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-delete.md
DELETE https://graph.microsoft.com/beta/applications/{id}
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-application-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Application Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-delta.md
GET https://graph.microsoft.com/beta/applications/delta
[!INCLUDE [sample-code](../includes/snippets/php/application-delta-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ ##### Response
v1.0 Application Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-get.md
GET https://graph.microsoft.com/beta/applications/03ef14b0-ca33-4840-8f4f-d6e919
[!INCLUDE [sample-code](../includes/snippets/powershell/get-application-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Application List Extensionproperty https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-list-extensionproperty.md
One of the following permissions is required to call this API. To learn more, in
```http GET /applications/{application ObjectId}/extensionProperties
+GET /applications(appId='{appId}')/extensionProperties
``` ## Optional query parameters
GET https://graph.microsoft.com/beta/applications/fd918e4b-c821-4efb-b50a-5eddd2
[!INCLUDE [sample-code](../includes/snippets/powershell/get-extensionproperties-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
Content-type: application/json
"name": "extension_25883231668a43a780b25685c3f874bc_jobGroup", "dataType": "String", "isSyncedFromOnPremises": false,
+ "isMultiValued": true,
"targetObjects": [ "User" ]
Content-type: application/json
"name": "extension_25883231668a43a780b25685c3f874bc_cpiminternal_useAccountEnabledForPhone", "dataType": "String", "isSyncedFromOnPremises": false,
+ "isMultiValued": true,
"targetObjects": [ "User" ]
v1.0 Application List Federatedidentitycredentials https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-list-federatedidentitycredentials.md
GET https://graph.microsoft.com/beta/applications/bcd7c908-1c4d-4d48-93ee-ff3834
[!INCLUDE [sample-code](../includes/snippets/powershell/list-federatedidentitycredential-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Application List Owners https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-list-owners.md
GET https://graph.microsoft.com/beta/applications/{id}/owners
[!INCLUDE [sample-code](../includes/snippets/powershell/application-get-owners-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Application List Tokenissuancepolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-list-tokenissuancepolicies.md
List the [tokenIssuancePolicy](../resources/tokenissuancepolicy.md) objects that
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
| Permission type | Permissions (from least to most privileged) | |:|:--| | Delegated (work or school account) | Policy.Read.All and Application.ReadWrite.All, Policy.ReadWrite.ApplicationConfiguration and Application.ReadWrite.All |
GET https://graph.microsoft.com/beta/applications/{id}/tokenIssuancePolicies
[!INCLUDE [sample-code](../includes/snippets/powershell/list-tokenissuancepolicies-on-application-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Application List Tokenlifetimepolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-list-tokenlifetimepolicies.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-List the [tokenLifetimePolicy](../resources/tokenlifetimepolicy.md) objects that are assigned to an [application](../resources/application.md) or [servicePrincipal](../resources/servicePrincipal.md)..
+List the [tokenLifetimePolicy](../resources/tokenlifetimepolicy.md) objects that are assigned to an [application](../resources/application.md) or [servicePrincipal](../resources/servicePrincipal.md). Only one object is returned in the collection because only one tokenLifetimePolicy can be assigned to an application.
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
| Permission type | Permissions (from least to most privileged) | |:|:--| | Delegated (work or school account) | Policy.Read.All and Application.ReadWrite.All, Policy.ReadWrite.ApplicationConfiguration and Application.ReadWrite.All |
GET https://graph.microsoft.com/beta/applications/3ccc9971-9ae7-45d6-8de8-263fd2
[!INCLUDE [sample-code](../includes/snippets/powershell/list-tokenlifetimepolicies-on-application-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Application List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-list.md
Get the list of [applications](../resources/application.md) in this organization
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
| Permission type | Permissions (from least to most privileged) | |: |:- | | Delegated (work or school account) | Application.Read.All, Application.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
GET https://graph.microsoft.com/beta/applications
[!INCLUDE [sample-code](../includes/snippets/powershell/list-application-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
ConsistencyLevel: eventual
[!INCLUDE [sample-code](../includes/snippets/powershell/list-applications-startswith-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
ConsistencyLevel: eventual
[!INCLUDE [sample-code](../includes/snippets/powershell/list-applications-search-count-select-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
ConsistencyLevel: eventual
[!INCLUDE [sample-code](../includes/snippets/powershell/list-application-lessthan2owners-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Application Post Applications https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-post-applications.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-application-from-applications-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Application Post Calls https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-post-calls.md
One of the following permissions is required to call this API. To learn more, in
| Delegated (personal Microsoft account) | Not supported. | | Application | Calls.JoinGroupCalls.Chat*, Calls.JoinGroupCallAsGuest.All, Calls.JoinGroupCall.All, Calls.Initiate.All, Calls.InitiateGroupCall.All |
-> **Notes:** For a call with app-hosted media, you need the Calls.AccessMedia.All or the Calls.AccessMedia.Chat* permission in addition to one of the permissions listed.
->
-> Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent).
+> **Notes:**
+> - For a call with app-hosted media, you need the Calls.AccessMedia.All permission in addition to one of the permissions listed in the previous table.
+> - Cloud Video Interop solutions that are [Certified for Microsoft Teams](/MicrosoftTeams/cloud-video-interop) have permission to call this API to join meetings for which they have meeting join links, similar to external users joining through a browser.
+> - Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent).
## HTTP request <!-- { "blockType": "ignored" } -->
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-call-service-hosted-media-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-call-app-hosted-media-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ `<Media Session Configuration>` is the serialized media session configuration which contains the session information of the media stack. Specific information about audio, video, VBSS session information should be passed here.
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-group-call-service-hosted-media-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-group-call-app-hosted-media-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/join-meeting-service-hosted-media-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
POST https://bot.contoso.com/callback
Content-Type: application/json ```
+##### Delta roster disabled (default)
+ <!-- { "blockType": "example", "@odata.type": "microsoft.graph.commsNotifications",
Content-Type: application/json
} ```
+##### Delta roster enabled
+
+<!-- {
+ "blockType": "example",
+ "@odata.type": "microsoft.graph.commsNotifications",
+ "truncated": true
+}-->
+```json
+{
+ "@odata.type": "#microsoft.graph.commsNotifications",
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.commsNotification",
+ "changeType": "updated",
+ "resource": "/app/calls/421f7700-f4ad-4ea9-a3fc-c1d2195675ad/participants",
+ "resourceUrl": "/communications/calls/421f7700-f4ad-4ea9-a3fc-c1d2195675ad/participants",
+ "resourceData": [
+ {
+ "@odata.type": "#microsoft.graph.deltaParticipants",
+ "participants": [
+ {
+ "@odata.type": "#microsoft.graph.participant",
+ "info": {
+ "@odata.type": "#microsoft.graph.participantInfo",
+ "identity": {
+ "@odata.type": "#microsoft.graph.identitySet",
+ "user": {
+ "@odata.type": "#microsoft.graph.identity",
+ "displayName": "John",
+ "id": "112f7296-5fa4-42ca-bae8-6a692b15d4b8"
+ }
+ },
+ "languageId": "en-US"
+ },
+ "mediaStreams": [
+ {
+ "@odata.type": "#microsoft.graph.mediaStream",
+ "mediaType": "audio",
+ "sourceId": "1",
+ "direction": "sendReceive",
+ "serverMuted": false
+ },
+ {
+ "@odata.type": "#microsoft.graph.mediaStream",
+ "mediaType": "video",
+ "sourceId": "2",
+ "direction": "receiveOnly",
+ "serverMuted": false
+ },
+ {
+ "@odata.type": "#microsoft.graph.mediaStream",
+ "mediaType": "videoBasedScreenSharing",
+ "sourceId": "8",
+ "direction": "receiveOnly",
+ "serverMuted": false
+ }
+ ],
+ "isMuted": true,
+ "isInLobby": false,
+ "id": "0d7664b6-6432-43ed-8d27-d9e7adec188c",
+ "rosterSequenceNumber": 1
+ },
+ {
+ "@odata.type": "#microsoft.graph.participant",
+ "info": {
+ "@odata.type": "#microsoft.graph.participantInfo",
+ "identity": {
+ "@odata.type": "#microsoft.graph.identitySet",
+ "application": {
+ "@odata.type": "#microsoft.graph.identity",
+ "displayName": "Calling Bot",
+ "id": "2891555a-92ff-42e6-80fa-6e1300c6b5c6"
+ }
+ }
+ },
+ "mediaStreams": [
+ {
+ "@odata.type": "#microsoft.graph.mediaStream",
+ "mediaType": "audio",
+ "sourceId": "10",
+ "direction": "sendReceive",
+ "serverMuted": false
+ }
+ ],
+ "isMuted": false,
+ "isInLobby": false,
+ "id": "05491616-385f-44a8-9974-18cc5f9933c1",
+ "rosterSequenceNumber": 1,
+ "removedState": {
+ "reason": "Removed from roster"
+ }
+ }
+ ],
+ "sequenceNumber": 1
+ }
+ ]
+ }
+ ]
+}
+```
+ >**Note:** For join meeting scenarios apart from call state notifications, we receive roster notifications. ### Example 6: Join a scheduled meeting with joinMeetingId and passcode
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/join-meeting-with-join-meeting-id-and-passcode-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/join-meeting-with-join-meeting-id-and-without-passcode-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/join-meeting-app-hosted-media-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/join-channel-meeting-service-hosted-media-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/join-channel-meeting-as-guest-service-hosted-media-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ > **Note:** The guest join depends on the tenant settings for meeting. The application might be put in lobby waiting to be admitted by a user. This is defined by the `isInLobby` property
POST https://bot.contoso.com/callback
Content-Type: application/json ```
+##### Delta roster disabled (default)
<!-- { "blockType": "example", "@odata.type": "microsoft.graph.commsNotifications",
Content-Type: application/json
} ```
-> **Note:** The application will not receive the roster for participants in the meeting until its admitted from lobby
+##### Delta roster enabled
+
+<!-- {
+ "blockType": "example",
+ "@odata.type": "microsoft.graph.commsNotifications",
+ "truncated": true
+}-->
+```json
+{
+ "@odata.type": "#microsoft.graph.commsNotifications",
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.commsNotification",
+ "changeType": "updated",
+ "resource": "/app/calls/421f7700-f4ad-4ea9-a3fc-c1d2195675ad/participants",
+ "resourceUrl": "/communications/calls/421f7700-f4ad-4ea9-a3fc-c1d2195675ad/participants",
+ "resourceData": [
+ {
+ "@odata.type": "#microsoft.graph.deltaParticipants",
+ "participants": [
+ {
+ "@odata.type": "#microsoft.graph.participant",
+ "info": {
+ "@odata.type": "#microsoft.graph.participantInfo",
+ "identity": {
+ "@odata.type": "#microsoft.graph.identitySet",
+ "guest": {
+ "@odata.type": "#microsoft.graph.identity",
+ "displayName": "Guest User",
+ "id": "d7a3b999-17ac-4bca-9e77-e6a730d2ec2e"
+ }
+ }
+ },
+ "mediaStreams": [
+ {
+ "@odata.type": "#microsoft.graph.mediaStream",
+ "mediaType": "audio",
+ "sourceId": "10",
+ "direction": "sendReceive",
+ "serverMuted": false
+ }
+ ],
+ "isMuted": false,
+ "isInLobby": true,
+ "id": "05491616-385f-44a8-9974-18cc5f9933c1"
+ }
+ ],
+ "sequenceNumber": 2
+ }
+ ]
+ }
+ ]
+}
+```
+
+> **Note:** The application will not receive the roster for participants in the meeting until its admitted from lobby.
### Example 11: Create peer-to-peer PSTN call with service hosted media
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-call-service-hosted-media-2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-call-service-hosted-media-3-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Application Post Extensionproperty https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-post-extensionproperty.md
One of the following permissions is required to call this API. To learn more, in
```http POST /applications/{application ObjectId}/extensionProperties
+POST /applications(appId='{appId}')/extensionProperties
``` ## Request headers
In the request body, provide an [extensionProperty](../resources/extensionproper
|:-|:|:| |dataType|String| Specifies the data type of the value the extension property can hold. Following values are supported. Not nullable. <ul><li>`Binary` - 256 bytes maximum</li><li>`Boolean`</li><li>`DateTime` - Must be specified in ISO 8601 format. Will be stored in UTC.</li><li>`Integer` - 32-bit value.</li><li>`LargeInteger` - 64-bit value.</li><li>`String` - 256 characters maximum</li></ul>| |name|String| Name of the extension property. Not nullable. |
+|isMultiValued|Boolean| Defines the directory extension as a multi-valued property. When `true`, the directory extension property can store a collection of objects of the **dataType**; for example, a collection of integers. The default value is `false`.|
|targetObjects|String collection| The Microsoft Graph resources that can use the extension property. All values must be in PascalCase. The following values are supported. Not nullable. <ul><li>`User`</li><li>`Group`</li><li>`AdministrativeUnit`</li><li>`Application`</li><li>`Device`</li><li>`Organization`</li></ul>|
Content-type: application/json
{ "name": "jobGroup", "dataType": "String",
+ "isMultiValued": true,
"targetObjects": [ "User" ]
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-extensionproperty-from-application-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
Content-type: application/json
"deletedDateTime": null, "appDisplayName": "b2c-extensions-app. Do not modify. Used by AADB2C for storing user data.", "dataType": "String",
+ "isMultiValued": true,
"isSyncedFromOnPremises": false, "name": "extension_25883231668a43a780b25685c3f874bc_jobGroup", "targetObjects": [
v1.0 Application Post Federatedidentitycredentials https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-post-federatedidentitycredentials.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-federatedidentitycredential-from--powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Application Post Onlinemeetings https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-post-onlinemeetings.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-onlinemeeting-user-token-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-online-meeting-with-passcode-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-online-meeting-without-passcode-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ or
v1.0 Application Post Owners https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-post-owners.md
Use this API to add an owner to an application by posting to the owners collecti
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
|Permission type | Permissions (from least to most privileged) | |:--|:| |Delegated (work or school account) | Application.ReadWrite.All and Directory.Read.All, Directory.ReadWrite.All |
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-directoryobject-from-application-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Application Post Tokenissuancepolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-post-tokenissuancepolicies.md
Assign a [tokenIssuancePolicy](../resources/tokenissuancepolicy.md) to an [appli
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
| Permission type | Permissions (from least to most privileged) | |:|:--| | Delegated (work or school account) | Policy.Read.All and Application.ReadWrite.All, Policy.ReadWrite.ApplicationConfiguration and Application.ReadWrite.All |
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-tokenissuancepolicy-from-application-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Application Post Tokenlifetimepolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-post-tokenlifetimepolicies.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Assign a [tokenLifetimePolicy](../resources/tokenlifetimepolicy.md) to an [application](../resources/application.md) or [servicePrincipal](../resources/servicePrincipal.md).
+Assign a [tokenLifetimePolicy](../resources/tokenlifetimepolicy.md) to an [application](../resources/application.md) or [servicePrincipal](../resources/servicePrincipal.md). You can have multiple tokenLifetimePolicy policies in a tenant but can assign only one tokenLifetimePolicy per application.
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
| Permission type | Permissions (from least to most privileged) | |:|:--| | Delegated (work or school account) | Policy.Read.All and Application.ReadWrite.All, Policy.ReadWrite.ApplicationConfiguration and Application.ReadWrite.All |
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-tokenlifetimepolicy-from-application-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Application Setverifiedpublisher https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-setverifiedpublisher.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/application-setverifiedpublisher-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Application Unsetverifiedpublisher https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-unsetverifiedpublisher.md
POST https://graph.microsoft.com/beta/applications/{id}/unsetVerifiedPublisher
[!INCLUDE [sample-code](../includes/snippets/powershell/application-unsetverifiedpublisher-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Application Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-application-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Applicationsignindetailedsummary Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/applicationsignindetailedsummary-get.md
Title: "Get applicationSignInDetailedSummary"
-description: "Retrieve the properties and relationships of an applicationSignInDetailSummary object."
+description: "Retrieve the properties and relationships of an applicationSignInDetailedSummary object."
ms.localizationpriority: medium ms.prod: "identity-and-access-reports"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve the properties and relationships of an [applicationSignInDetailSummary](../resources/applicationsignindetailedsummary.md) object.
+Retrieve the properties and relationships of an [applicationSignInDetailedSummary](../resources/applicationsignindetailedsummary.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).
GET https://graph.microsoft.com/beta/reports/applicationSignInDetailedSummary/{i
[!INCLUDE [sample-code](../includes/snippets/powershell/get-applicationsignindetailedsummary-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Applicationtemplate Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/applicationtemplate-get.md
GET https://graph.microsoft.com/beta/applicationTemplates/{id}
[!INCLUDE [sample-code](../includes/snippets/powershell/get-applicationtemplate-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Applicationtemplate Instantiate https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/applicationtemplate-instantiate.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/applicationtemplate-instantiate-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Applicationtemplate List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/applicationtemplate-list.md
GET https://graph.microsoft.com/beta/applicationTemplates
[!INCLUDE [sample-code](../includes/snippets/powershell/get-applicationtemplates-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Appmanagementpolicy Delete Appliesto https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/appmanagementpolicy-delete-appliesto.md
Remove an [appManagementPolicy](../resources/appManagementPolicy.md) policy obje
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
| Permission type | Permissions (from least to most privileged) | | :- | :-- | | Delegated (work or school account) | Application.Read.All and Policy.ReadWrite.ApplicationConfiguration |
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-DELETE /applications/{id}/appManagementPolicies/$ref
+DELETE /applications/{applicationObjectId}/appManagementPolicies/{appManagementPolicyId}/$ref
+DELETE /servicePrincipals/{servicePrincipalObjectId}/appManagementPolicies/{appManagementPolicyId}/$ref
``` ## Request headers
DELETE /applications/{id}/appManagementPolicies/$ref
## Request body
-In the request body, provide a reference to a single policy object from the [appManagementPolicies](../resources/appmanagementpolicy.md) collection.
+Do not supply a request body for this method.
## Response
The following is an example of the request to remove an appManagementPolicy from
}--> ```http
-DELETE https://graph.microsoft.com/beta/applications/{id}/appManagementPolicies/$ref
-Content-type: application/json
-
-{
- "@odata.id":"https://graph.microsoft.com/beta/policies/appManagementPolicies/{id}"
-}
+DELETE https://graph.microsoft.com/beta/applications/3ccc9971-9ae7-45d6-8de8-263fd25fe116/appManagementPolicies/15942288-d19b-458c-9be4-20377d0a2435/$ref
``` # [C#](#tab/csharp)
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/remove-appliesto-e1-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ #### Response
The following is an example of the request to remove an appManagementPolicy from
}--> ``` http
-DELETE https://graph.microsoft.com/beta/servicePrincipals/{id}/appManagementPolicies/$ref
-
-{
- "@odata.id":"https://graph.microsoft.com/beta/policies/appManagementPolicies/{id}"
-}
+DELETE https://graph.microsoft.com/beta/servicePrincipals/f284860e-368c-4a1f-8894-77f0a9676fb3/appManagementPolicies/15942288-d19b-458c-9be4-20377d0a2435/$ref
``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java)
DELETE https://graph.microsoft.com/beta/servicePrincipals/{id}/appManagementPoli
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php)+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Appmanagementpolicy Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/appmanagementpolicy-delete.md
+
+ Title: "Delete appManagementPolicy"
+description: "Delete an application management policy."
+ms.localizationpriority: medium
+++
+# Delete appManagementPolicy
+
+Namespace: microsoft.graph
++
+Delete an [appManagementPolicy](../resources/appmanagementpolicy.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) | Policy.ReadWrite.ApplicationConfiguration |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Policy.ReadWrite.ApplicationConfiguration |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+DELETE /policies/appManagementPolicies/{id}
+```
+
+## Request headers
+
+| Name | Description |
+| : | :-- |
+| Authorization | Bearer {token}. Required. |
+| Content-Type | application/json. Required. |
+
+## Request body
+
+Do not 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.
+
+## Examples
+
+### Request
+
+The following is an example of the request.
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "delete_appManagementPolicy"
+}-->
+
+```http
+DELETE https://graph.microsoft.com/beta/policies/appManagementPolicies/{id}
+```
+
+# [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.
+
+<!-- {
+ "blockType": "response",
+ "truncated": false
+} -->
+
+```http
+HTTP/1.1 204 No Content
+```
+
+<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
+2019-02-04 14:57:30 UTC -->
+<!-- {
+ "type": "#page.annotation",
+ "description": "delete appManagementPolicy",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": ""
+}-->
v1.0 Appmanagementpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/appmanagementpolicy-get.md
GET https://graph.microsoft.com/beta/policies/appManagementPolicies/{id}
[!INCLUDE [sample-code](../includes/snippets/powershell/get-appmanagementpolicy-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Appmanagementpolicy List Appliesto https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/appmanagementpolicy-list-appliesto.md
+
+ Title: "List appliesTo"
+description: "List resources assigned to an application management policy."
+ms.localizationpriority: medium
+++
+# List appliesTo
+
+Namespace: microsoft.graph
++
+List application and service principal objects assigned an [appManagementPolicy](../resources/appManagementPolicy.md) policy 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).
+
+<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
+| Permission type | Permissions (from least to most privileged) |
+| :- | :-- |
+| Delegated (work or school account) | Application.Read.All and Policy.Read.All, Application.Read.All and Policy.ReadWrite.ApplicationConfiguration |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Application.Read.All and Policy.Read.All, Application.Read.All and Policy.ReadWrite.ApplicationConfiguration |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+GET /policies/appManagementPolicies/{id}/appliesTo
+```
+
+## Optional query parameters
+
+This method supports the `$select`, `$filter`, and `$top` OData query parameters to help customize the response. You can apply `$filter` on properties of [application](../resources/application.md) or [servicePrincipal](../resources/serviceprincipal.md) objects that support `$filter`. For example, the following query retrieves the **appId** and **displayName** of applications or service principals that are assigned the policy.
+
+``` http
+
+https://graph.microsoft.com/beta/policies/appManagementPolicies/{id}/appliesTo?$select=appId,displayName
+```
+
+For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+
+| Name | Description |
+| : | : |
+| Authorization | Bearer {token}. Required. |
+
+## 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 [application](../resources/application.md) or [servicePrincipal](../resources/serviceprincipal.md) objects in the response body.
+
+## Examples
+
+### Example 1: Get applications and service principal objects applied to an app management policy
+
+#### Request
+
+The following is an example of the request.
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "list_appManagementPolicyAppliesTo"
+}-->
+
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/policies/appManagementPolicies/{id}/appliesTo
+```
+
+# [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.
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.appManagementPolicy"
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#directoryObjects",
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.application",
+ "id": "0d77e011-2fc6-438f-8b93-decb4f926929",
+ "appId": "8f527de6-05c9-4032-bca9-b2b56ab2358a",
+ "displayName": "TestApp1",
+ "createdDateTime": "2018-01-24T05:55:37Z"
+ }
+ ]
+}
+```
+
+### Example 2: Get specific properties of applications and service principal objects applied to an app management policy using $select query option
+
+#### Request
+
+The following is an example of the request using $select query option.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "list_appManagementPolicyAppliesTo_select"
+}-->
+
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/policies/appManagementPolicies/{id}/appliesTo?$select=id,appId,displayName,createdDateTime
+```
+
+# [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 that returns `id`, `appId`, `displayName` and `createdDateTime` of applications and service principals where the policy is applied.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.appManagementPolicy"
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#directoryObjects(id,appId,displayName,createdDateTime)",
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.application",
+ "id": "0d77e011-2fc6-438f-8b93-decb4f926929",
+ "appId": "8f527de6-05c9-4032-bca9-b2b56ab2358a",
+ "displayName": "TestApp1",
+ "createdDateTime": "2018-01-24T05:55:37Z"
+ },
+ {
+ "@odata.type": "#microsoft.graph.servicePrincipal",
+ "id": "0e1fa067-dcc1-4d85-9b4c-e69145dd3efb",
+ "appId": "255912cb-e31d-4dee-bee4-3fa5d774d6b9",
+ "displayName": "TestApp2",
+ "createdDateTime": "2018-01-24T05:55:37Z"
+ }
+ ]
+}
+```
++
+<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
+2019-02-04 14:57:30 UTC -->
+<!-- {
+ "type": "#page.annotation",
+ "description": "list resources for appManagementPolicies",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": ""
+}-->
v1.0 Appmanagementpolicy List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/appmanagementpolicy-list.md
GET https://graph.microsoft.com/beta/policies/appManagementPolicies
[!INCLUDE [sample-code](../includes/snippets/powershell/list-appmanagementpolicies-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Appmanagementpolicy Post Appliesto https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/appmanagementpolicy-post-appliesto.md
Assign an [appManagementPolicy](../resources/appManagementPolicy.md) policy obje
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
| Permission type | Permissions (from least to most privileged) | | :- | :-- | | Delegated (work or school account) | Application.Read.All and Policy.ReadWrite.ApplicationConfiguration |
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/applicationsappmanagementpolicies-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
POST https://graph.microsoft.com/beta/servicePrincipals/{id}/appManagementPolici
``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java)
POST https://graph.microsoft.com/beta/servicePrincipals/{id}/appManagementPolici
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [snippet-not-available](../includes/snippets/snippet-not-available.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Appmanagementpolicy Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/appmanagementpolicy-post.md
POST https://graph.microsoft.com/beta/policies/appManagementPolicies
[!INCLUDE [sample-code](../includes/snippets/php/create-appmanagementpolicy-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Appmanagementpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/appmanagementpolicy-update.md
+
+ Title: "Update appManagementPolicy"
+description: "Update an application management policy."
+ms.localizationpriority: medium
+++
+# Update appManagementPolicy
+
+Namespace: microsoft.graph
++
+Update an [appManagementPolicy](../resources/appmanagementpolicy.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) | Policy.ReadWrite.ApplicationConfiguration |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Policy.ReadWrite.ApplicationConfiguration |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+PATCH /policies/appManagementPolicies/{id}
+```
+
+## Request headers
+
+| Name | Description |
+| : | :-- |
+| Authorization | Bearer {token}. Required. |
+| Content-Type | application/json. Required. |
+
+## Request body
++
+| Property | Type | Description |
+| :-- | :-- | : |
+| description | String | The description of the policy. Inherited from [policyBase](../resources/policybase.md). |
+| displayName | String | The display name of the policy. Inherited from [policyBase](../resources/policybase.md). |
+| isEnabled | Boolean | Denotes whether the policy is enabled. |
+| restrictions | [appManagementConfiguration](../resources/appmanagementconfiguration.md) | Restrictions that apply to an application or service principal object. |
+
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+
+The following is an example of the request.
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "update_appManagementPolicy"
+}-->
+
+```http
+PATCH https://graph.microsoft.com/beta/policies/appManagementPolicies/{id}
+
+{
+ "isEnabled": false
+}
+```
+
+# [C#](#tab/csharp)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
+++
+### Response
+
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+} -->
+
+```http
+HTTP/1.1 204 No Content
+```
+
+<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
+2019-02-04 14:57:30 UTC -->
+<!-- {
+ "type": "#page.annotation",
+ "description": "update appManagementPolicies",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": ""
+}-->
v1.0 Approleassignment Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/approleassignment-get.md
+
+ Title: "Get appRoleAssignment"
+description: "Read the properties and relationships of an appRoleAssignment object."
+
+ms.localizationpriority: medium
++
+# Get appRoleAssignment
+Namespace: microsoft.graph
++
+Read the properties and relationships of an [appRoleAssignment](../resources/approleassignment.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).
+
+### For client service principals
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | Application.Read.All, Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Application.Read.All, Directory.Read.All, Application.ReadWrite.OwnedBy, Application.ReadWrite.All, Directory.ReadWrite.All |
+
+### For resource service principals
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | Application.Read.All, Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Application.Read.All, Directory.Read.All, Application.ReadWrite.OwnedBy, Application.ReadWrite.All, Directory.ReadWrite.All |
+
+### For groups
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | Group.Read.All, Directory.Read.All, AppRoleAssignment.ReadWrite.All, Directory.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Group.Read.All, Directory.Read.All, AppRoleAssignment.ReadWrite.All, Directory.ReadWrite.All |
+
+### For users
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | User.Read, User.ReadBasic.All, Directory.Read.All, AppRoleAssignment.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Directory.Read.All, AppRoleAssignment.ReadWrite.All |
+
+## HTTP request
+
+To get details of an appRole granted to a service principal:
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /servicePrincipals/{client-serviceprincipal-id}/appRoleAssignments/{appRoleAssignment-id}
+GET /servicePrincipals(appId='{client-servicePrincipal-appId}')/appRoleAssignments/{appRoleAssignment-id}
+```
+
+To get details of an appRole granted to a user, group, or client service principal for the given resource service principal:
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /servicePrincipals(appId='{resource-servicePrincipal-appId}')/appRoleAssignedTo/{appRoleAssignment-id}
+GET /servicePrincipals/{resource-serviceprincipal-id}/appRoleAssignedTo/{appRoleAssignment-id}
+```
+
+To get details of an appRole granted to a group:
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /groups/{group-id}/appRoleAssignments/{appRoleAssignment-id}
+```
+
+To get details of an appRole granted to a user:
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /users/{user-id}/appRoleAssignments/{appRoleAssignment-id}
+GET /me/appRoleAssignments/{appRoleAssignment-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
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and an [appRoleAssignment](../resources/approleassignment.md) object in the response body.
+
+## Examples
+
+### Example 1: Get details of an app role granted to a user, group, or client service principal for the given resource service principal
+
+#### Request
+The following request queries the resource service principal to get details of an app role it has granted to a client that can be a user, group, or client service principal in the tenant.
+<!-- {
+ "blockType": "request",
+ "name": "get_approleassignment_beta_e1",
+ "sampleKeys": ["00000003-0000-0000-c000-000000000000", "ep6PKgGvOkGVksMuwOXBpxV3dkHvwM1ElSjMUzZtaIA"]
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/servicePrincipals(appId='00000003-0000-0000-c000-000000000000')/appRoleAssignedTo/ep6PKgGvOkGVksMuwOXBpxV3dkHvwM1ElSjMUzZtaIA
+```
++
+#### Response
+The following is an example of the response. It shows a client service principal named **Postman** has been granted an app role with the ID **df021288-bdef-4463-88db-98f22de89214** which is the *User.Read.All* application permission, for the resource service principal named **Microsoft Graph**.
+
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.appRoleAssignment"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#servicePrincipals('00000003-0000-0000-c000-000000000000')/appRoleAssignedTo/$entity",
+ "id": "ep6PKgGvOkGVksMuwOXBpxV3dkHvwM1ElSjMUzZtaIA",
+ "deletedDateTime": null,
+ "appRoleId": "df021288-bdef-4463-88db-98f22de89214",
+ "createdDateTime": "2023-02-24T17:01:47.0988029Z",
+ "principalDisplayName": "Postman",
+ "principalId": "2a8f9e7a-af01-413a-9592-c32ec0e5c1a7",
+ "principalType": "ServicePrincipal",
+ "resourceDisplayName": "Microsoft Graph",
+ "resourceId": "7408235b-7540-4850-82fe-a5f15ed019e2"
+}
+```
+
+### Example 2: Get details of an app role granted to a service principal
+
+#### Request
+The following request queries the client service principal to get details of an app role granted to it. In this instance, the app role represents the application permission.
+<!-- {
+ "blockType": "request",
+ "name": "get_approleassignment_serviceprincipal_beta_e2",
+ "sampleKeys": ["ceb96a54-de95-49a0-b38c-c55263fcf421", "ep6PKgGvOkGVksMuwOXBpxV3dkHvwM1ElSjMUzZtaIA"]
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/servicePrincipals(appId='ceb96a54-de95-49a0-b38c-c55263fcf421')/appRoleAssignments/ep6PKgGvOkGVksMuwOXBpxV3dkHvwM1ElSjMUzZtaIA
+```
++
+#### Response
+The following is an example of the response. It shows a client service principal named **Postman** has been granted an app role with the ID **df021288-bdef-4463-88db-98f22de89214** which is the *User.Read.All* application permission, for the resource service principal named **Microsoft Graph**.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.appRoleAssignment"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#servicePrincipals('ceb96a54-de95-49a0-b38c-c55263fcf421')/appRoleAssignments/$entity",
+ "id": "ep6PKgGvOkGVksMuwOXBpxV3dkHvwM1ElSjMUzZtaIA",
+ "deletedDateTime": null,
+ "appRoleId": "df021288-bdef-4463-88db-98f22de89214",
+ "createdDateTime": "2023-02-24T17:01:47.0988029Z",
+ "principalDisplayName": "Postman",
+ "principalId": "2a8f9e7a-af01-413a-9592-c32ec0e5c1a7",
+ "principalType": "ServicePrincipal",
+ "resourceDisplayName": "Microsoft Graph",
+ "resourceId": "7408235b-7540-4850-82fe-a5f15ed019e2"
+}
+```
+
+### Example 3: Get details of an app role granted to the signed-in user
+
+#### Request
+The following request queries the signed-in user's appRoleAssignments.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_approleassignment"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/me/appRoleAssignments/Lo6gEKI-4EyAy9X91LBepo6Aq0Rt6QxBjWRl76txk8I
+```
+
+# [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. It shows the signed-in user has the default app role for a resource service principal named *Postman*.
+
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.appRoleAssignment"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('10a08e2e-3ea2-4ce0-80cb-d5fdd4b05ea6')/appRoleAssignments/$entity",
+ "id": "Lo6gEKI-4EyAy9X91LBepo6Aq0Rt6QxBjWRl76txk8I",
+ "deletedDateTime": null,
+ "appRoleId": "00000000-0000-0000-0000-000000000000",
+ "createdDateTime": "2022-09-08T17:43:57.8423817Z",
+ "principalDisplayName": "MOD Administrator",
+ "principalId": "10a08e2e-3ea2-4ce0-80cb-d5fdd4b05ea6",
+ "principalType": "User",
+ "resourceDisplayName": "Postman",
+ "resourceId": "2a8f9e7a-af01-413a-9592-c32ec0e5c1a7"
+}
+```
v1.0 Approval Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/approval-get.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-In [Azure AD entitlement management](../resources/entitlementmanagement-overview.md), retrieves the properties of an [approval](../resources/approval.md) object. This call can be made by an approver, providing the identifier of the [access package assignment request](../resources/accesspackageassignmentrequest.md).
+Retrieve the properties of an [approval](../resources/approval.md) object. This API request is made by an approver in the following scenarios:
+
+- In [entitlement management](../resources/entitlementmanagement-overview.md), providing the identifier of the [access package assignment request](../resources/accesspackageassignmentrequest.md).
+- In [PIM for groups](../resources/privilegedidentitymanagement-for-groups-api-overview.md), providing the identifier of the [assignment schedule request](../resources/privilegedaccessgroupassignmentschedulerequest.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).
+### For entitlement management
+ | Permission type | Permissions (from least to most privileged) | |:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. | | Application | Not supported. |
+### For PIM for groups
+
+| Permission type | Permissions (from least to most privileged) |
+|:|:--|
+| Delegated (work or school account) | PrivilegedAssignmentSchedule.Read.AzureADGroup, PrivilegedAssignmentSchedule.ReadWrite.AzureADGroup |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Not supported. |
+ ## HTTP request
-<!-- { "blockType": "ignored" } -->
+To get approval objects in entitlement management:
+<!-- { "blockType": "ignored" } -->
```http GET /identityGovernance/entitlementManagement/accessPackageAssignmentApprovals/{id} ```
+To get approval objects in PIM for groups:
+
+<!-- { "blockType": "ignored" } -->
+```http
+GET /identityGovernance/privilegedAccess/group/assignmentApprovals/{id}
+```
+ ## Request headers | Name |Description|
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
[!INCLUDE [sample-code](../includes/snippets/php/get-approval-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
Content-type: application/json
"section": "documentation", "tocPath": "" }-->--
v1.0 Approval List Steps https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/approval-list-steps.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-In [Azure AD entitlement management](../resources/entitlementmanagement-overview.md), lists the [approvalStep](../resources/approvalstep.md) objects associated with an [approval](../resources/approval.md) object. This call can be made by an approver, providing the identifier of the [access package assignment request](../resources/accesspackageassignmentrequest.md).
+List the [approvalStep](../resources/approvalstep.md) objects associated with an [approval](../resources/approval.md). This API request is made by an approver in the following scenarios:
+
+- In [entitlement management](../resources/entitlementmanagement-overview.md), providing the identifier of the [access package assignment request](../resources/accesspackageassignmentrequest.md).
+- In [PIM for groups](../resources/privilegedidentitymanagement-for-groups-api-overview.md), providing the identifier of the [assignment schedule request](../resources/privilegedaccessgroupassignmentschedulerequest.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).
+### For entitlement management
+ | Permission type | Permissions (from least to most privileged) | |:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. | | Application | Not supported. |
+### For PIM for groups
+
+| Permission type | Permissions (from least to most privileged) |
+|:|:--|
+| Delegated (work or school account) | PrivilegedAssignmentSchedule.Read.AzureADGroup, PrivilegedAssignmentSchedule.ReadWrite.AzureADGroup |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Not supported. |
+ ## HTTP request
-<!-- { "blockType": "ignored" } -->
+To list the approval steps in entitlement management:
+<!-- { "blockType": "ignored" } -->
```http GET /identityGovernance/entitlementManagement/accessPackageAssignmentApprovals/{id}/steps ```
+To list the approval steps in PIM for groups:
+
+<!-- { "blockType": "ignored" } -->
+```http
+GET /identityGovernance/privilegedAccess/group/assignmentApprovals/{id}/steps
+```
+ ## Request headers | Name |Description|
If successful, this method returns a `200 OK` response code and a collection of
The following is an example of the request. - # [HTTP](#tab/http) <!-- { "blockType": "request",
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
[!INCLUDE [sample-code](../includes/snippets/php/get-approvalstep-1-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
Content-type: application/json
"section": "documentation", "tocPath": "" }-->--
v1.0 Approvalstep Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/approvalstep-get.md
Retrieve the properties of an [approvalStep](../resources/approvalstep.md) objec
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+### Permissions required for calling this API for entitlement management
+ | Permission type | Permissions (from least to most privileged) | |:|:--| | Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. | | Application | Not supported. |
+### Permissions required for calling this API for PIM for groups
+
+| Permission type | Permissions (from least to most privileged) |
+|:|:--|
+| Delegated (work or school account) | PrivilegedAssignmentSchedule.Read.AzureADGroup, PrivilegedAssignmentSchedule.ReadWrite.AzureADGroup |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Not supported. |
+ ## HTTP request
-<!-- { "blockType": "ignored" } -->
+To get an approval step in entitlement management:
+<!-- { "blockType": "ignored" } -->
```http GET /identityGovernance/entitlementManagement/accessPackageAssignmentApprovals/{id}/steps/{id} ```
+To get an approval step in PIM for groups:
+
+<!-- { "blockType": "ignored" } -->
+```http
+GET /identityGovernance/privilegedAccess/group/assignmentApprovals/{id}/steps/{id}
+```
+ ## Request headers | Name |Description|
If successful, this method returns a `200 OK` response code and the [approvalSte
The following is an example of the request. -- # [HTTP](#tab/http) <!-- { "blockType": "request",
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/ac
[!INCLUDE [sample-code](../includes/snippets/php/get-approvalstep-2-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
Content-type: application/json
"section": "documentation", "tocPath": "" }-->--
v1.0 Approvalstep Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/approvalstep-update.md
Apply approve or deny decision on an [approvalStep](../resources/approvalStep.md
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+### Permissions required for calling this API for entitlement management
+ | Permission type | Permissions (from least to most privileged) | |:|:--| | Delegated (work or school account) | EntitlementManagement.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. | | Application | Not supported. |
+### Permissions required for calling this API for PIM for groups
+
+| Permission type | Permissions (from least to most privileged) |
+|:|:--|
+| Delegated (work or school account) | PrivilegedAssignmentSchedule.ReadWrite.AzureADGroup |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Not supported. |
+ ## HTTP request
-<!-- { "blockType": "ignored" } -->
+To update an approval decision in entitlement management:
+<!-- { "blockType": "ignored" } -->
```http PATCH /identityGovernance/entitlementManagement/accessPackageAssignmentApprovals/{id}/steps/{id} ```
+To update an approval decision in PIM for groups:
+
+<!-- { "blockType": "ignored" } -->
+```http
+PATCH /identityGovernance/privilegedAccess/group/assignmentApprovals/{id}/steps/{id}
+```
+ ## Request headers | Name |Description|
If successful, this method returns a `204 No Content` response code in the respo
The following is an example of the request. - # [HTTP](#tab/http) <!-- { "blockType": "request",
PATCH https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/
[!INCLUDE [sample-code](../includes/snippets/powershell/patch-approvalstep-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Associatedteaminfo List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/associatedteaminfo-list.md
GET https://graph.microsoft.com/beta/me/teamwork/associatedTeams
[!INCLUDE [sample-code](../includes/snippets/powershell/list-associatedteaminfo-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Attachment Createuploadsession https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/attachment-createuploadsession.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/attachment-createuploadsession-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/attachment-createuploadsession-inline-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Attachment Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/attachment-delete.md
DELETE https://graph.microsoft.com/beta/me/events/{id}/attachments/{id}
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-attachment-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Attachment Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/attachment-get.md
For an item attachment that is a [contact](../resources/contact.md), [event](../
Attempting to get the `$value` of a reference attachment returns HTTP 405.
+> [!NOTE]
+> When certain files are requested, MIME can encode the byte stream output in the response and provide a link to download the file as an email attachment.
+>
## Permissions Depending on the resource (**event**, **message**, **outlookTask**, or **post**) that the attachment is attached to and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. To learn more, including [taking caution](/graph/auth/auth-concepts#best-practices-for-requesting-permissions) before choosing more privileged permissions, search for the following permissions in [Permissions](/graph/permissions-reference).
GET https://graph.microsoft.com/beta/me/messages/AAMkAGUzY5QKjAAA=/attachments/A
[!INCLUDE [sample-code](../includes/snippets/powershell/get-file-attachment-beta-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/me/messages/AAMkADA1M-zAAA=/attachments/AAM
[!INCLUDE [sample-code](../includes/snippets/powershell/get-item-attachment-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/me/messages/AAMkADA1M-zAAA=/attachments/AAM
[!INCLUDE [sample-code](../includes/snippets/powershell/get-and-expand-item-attachment-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] -
+# [Python](#tab/python)
+ #### Response Here is an example of the response. Note: The response object shown here might be shortened for readability.
GET https://graph.microsoft.com/beta/me/messages/AAMkADA1M-zAAA=/attachments/AAM
[!INCLUDE [sample-code](../includes/snippets/powershell/get-and-expand-nested-item-attachment-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/me/events/AAMkAGE1M88AADUv0uAAAG=/attachmen
[!INCLUDE [sample-code](../includes/snippets/powershell/get-reference-attachment-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Attacksimulationoperation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/attacksimulationoperation-get.md
GET https://graph.microsoft.com/beta/security/attackSimulation/operations/f1b138
[!INCLUDE [sample-code](../includes/snippets/powershell/get-attacksimulationoperation-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Attacksimulationroot List Payloads https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/attacksimulationroot-list-payloads.md
GET https://graph.microsoft.com/beta/security/attackSimulation/payloads?$filter=
[!INCLUDE [sample-code](../includes/snippets/powershell/list-payload-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Attacksimulationroot List Simulationautomations https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/attacksimulationroot-list-simulationautomations.md
GET https://graph.microsoft.com/beta/security/attackSimulation/simulationAutomat
[!INCLUDE [sample-code](../includes/snippets/powershell/list-simulationautomation-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Attacksimulationroot List Simulations https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/attacksimulationroot-list-simulations.md
GET https://graph.microsoft.com/beta/security/attackSimulation/simulations
[!INCLUDE [sample-code](../includes/snippets/powershell/list-simulation-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Attacksimulationroot Post Simulation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/attacksimulationroot-post-simulation.md
Content-type: application/json
"durationInDays": 7, "attackTechnique": "credentialHarvesting", "status": "scheduled",
- "durationInDays": "3",
"includedAccountTarget": { "@odata.type": "#microsoft.graph.addressBookAccountTargetContent", "type" : "addressBook",
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-simulation-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Attendancerecord List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/attendancerecord-list.md
GET /me/onlineMeetings/{meetingId}/attendanceReports/{reportId}/attendanceRecord
GET /users/{userId}/onlineMeetings/{meetingId}/attendanceReports/{reportId}/attendanceRecords ```
+To get attendance records of a virtual event session's attendance report:
+<!-- {"blockType": "ignored"}-->
+``` http
+GET /solutions/virtualEvents/webinars/{webinarId}/sessions/{sessionId}/attendanceReports/{reportId}/attendanceRecords
+```
+ >- `userId` is the object ID of a user in [Azure user management portal](https://portal.azure.com/#blade/Microsoft_AAD_IAM/UsersManagementMenuBlade). For more details, see [Allow applications to access online meetings on behalf of a user](/graph/cloud-communication-online-meeting-application-access-policy). >- `meetingId` is the **id** of an [onlineMeeting](../resources/onlinemeeting.md) object. >- `reportId` is the **id** of an [meetingAttendanceReport](../resources/meetingAttendanceReport.md) object.
+>- `webinarId` is the **id** of an [virtualEventWebinar](../resources/virtualEventWebinar.md) object.
+>- `sessionId` is the **id** of an [virtualEventSession](../resources/virtualEventSession.md) object.
## Optional query parameters
GET https://graph.microsoft.com/beta/me/onlineMeetings/{meetingId}/attendanceRep
[!INCLUDE [sample-code](../includes/snippets/powershell/list-attendancerecord-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/me/onlineMeetings/{meetingId}/attendanceRep
[!INCLUDE [sample-code](../includes/snippets/powershell/list-attendancerecord-acsuser-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
] } ```+
+### Example 3: List attendance records of a virtual event session's attendance report
+
+#### Request
+
+The following is an example of a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_virtualeventsession_record"
+}
+-->
+``` http
+GET /solutions/virtualEvents/webinars/{webinarId}/sessions/{sessionId}/attendanceReports/{reportId}/attendancerecords
+```
+
+# [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
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.attendanceRecord)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#solutions/virtualEvents/webinars('336f94f4-3a81-5130-43e9-88f3-fcb3582cde37')/sessions('a0f934c324b7785c')/attendanceReports('2c2454-7613-4d6e-9c7c-4c8')/attendancerecords",
+ "value": [
+ {
+ "emailAddress": "frederick.cormier@contoso.com",
+ "totalAttendanceInSeconds": 322,
+ "role": "Organizer",
+ "registrantId": null,
+ "identity": {
+ "id": "dc17674c-81d9-4adb-bfb2-8f6a442e4623",
+ "displayName": "Frederick Cormier",
+ "tenantId": null
+ },
+ "attendanceIntervals": [
+ {
+ "joinDateTime": "2021-10-05T04:38:27.6027225Z",
+ "leaveDateTime": "2021-10-05T04:43:49.7702391Z",
+ "durationInSeconds": 322
+ }
+ ]
+ },
+ {
+ "emailAddress": "lisa.adkins@contoso.com",
+ "totalAttendanceInSeconds": 314,
+ "role": "Presenter",
+ "registrantId": null,
+ "identity": {
+ "id": "57caaef9-5ed0-48d5-8862-e5abfa71b3e9",
+ "displayName": "Lisa Adkins",
+ "tenantId": null
+ },
+ "attendanceIntervals": [
+ {
+ "joinDateTime": "2021-10-04T23:13:43.3776519Z",
+ "leaveDateTime": "2021-10-04T23:18:57.5639338Z",
+ "durationInSeconds": 314
+ }
+ ]
+ }
+ ]
+}
+```
v1.0 Attributeset Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/attributeset-get.md
doc_type: apiPageType
# Get attributeSet+ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
Namespace: microsoft.graph
Read the properties and relationships of an [attributeSet](../resources/attributeset.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)|
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application|CustomSecAttributeDefinition.Read.All, CustomSecAttributeDefinition.ReadWrite.All|
-The signed-in user must also be assigned one of the following [directory roles](/azure/active-directory/roles/permissions-reference):
-
-+ Attribute Assignment Reader
-+ Attribute Definition Reader
-+ Attribute Assignment Administrator
-+ Attribute Definition Administrator
-
-By default, Global Administrator and other administrator roles do not have permissions to define, read, or assign custom security attributes.
## HTTP request
GET /directory/attributeSets/{attributeSetId}
``` ## Optional query parameters
-This method supports the `$select` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+This method supports the `$select` OData query parameter to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
## Request headers+ |Name|Description| |:|:| |Authorization|Bearer {token}. Required.| ## Request body+ Do not supply a request body for this method. ## Response
If successful, this method returns a `200 OK` response code and an [attributeSet
## Examples
-### Example: Get an attribute set
+### Request
The following example gets a single attribute set named `Engineering`.
-#### Request
- # [HTTP](#tab/http) <!-- { "blockType": "request",
- "name": "get_attributeset_single"
+ "name": "get_attributeset_single",
+ "sampleKeys": ["Engineering"]
} --> ``` http
GET https://graph.microsoft.com/beta/directory/attributeSets/Engineering
[!INCLUDE [sample-code](../includes/snippets/powershell/get-attributeset-single-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+
-#### Response
+### Response
+
+The following is an example of the response.
<!-- { "blockType": "response",
v1.0 Attributeset Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/attributeset-update.md
doc_type: apiPageType
# Update attributeSet+ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
Namespace: microsoft.graph
Update the properties of an [attributeSet](../resources/attributeset.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)|
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application|CustomSecAttributeDefinition.ReadWrite.All|
-The signed-in user must also be assigned the Attribute Definition Administrator [directory role](/azure/active-directory/roles/permissions-reference). By default, Global Administrator and other administrator roles do not have permissions to read, define, or assign custom security attributes.
## HTTP request
PATCH /directory/attributeSets/{attributeSetId}
``` ## Request headers+ |Name|Description| |:|:| |Authorization|Bearer {token}. Required.| |Content-Type|application/json. Required.| ## Request body
-In the request body, supply *only* the values for properties 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.
-The following table specifies the properties that can be updated.
|Property|Type|Description| |:|:|:| |description|String|Description of the attribute set. Can be up to 128 characters long and include Unicode characters. Optional.| |maxAttributesPerSet|Int32|Maximum number of custom security attributes that can be defined in this attribute set. Default value is `null`. If not specified, the administrator can add up to the maximum of 500 active attributes per tenant. Optional.| -- ## Response If successful, this method returns a `204 No Content` response code. ## Examples
-### Example: Update an attribute set
+### Request
The following example updates the description and the maximum number of attributes for an attribute set named `Engineering`.
-#### Request
- # [HTTP](#tab/http) <!-- { "blockType": "request",
- "name": "update_attributeset"
+ "name": "update_attributeset",
+ "sampleKeys": ["Engineering"]
} --> ``` http
Content-length: 119
[!INCLUDE [sample-code](../includes/snippets/powershell/update-attributeset-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+
-#### Response
+### Response
+
+The following is an example of the response.
<!-- { "blockType": "response",
v1.0 Audioroutinggroup Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/audioroutinggroup-delete.md
DELETE https://graph.microsoft.com/beta/communications/calls/{id}/audioRoutingGr
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-audioroutinggroup-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Audioroutinggroup Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/audioroutinggroup-get.md
GET https://graph.microsoft.com/beta/communications/calls/{id}/audioRoutingGroup
[!INCLUDE [sample-code](../includes/snippets/powershell/get-audioroutinggroup-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Audioroutinggroup Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/audioroutinggroup-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-audioroutinggroup-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Authentication Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authentication-get.md
+
+ Title: "Get authentication signInPreferences"
+description: "Read the properties of a user's authentication sign in preferences."
+
+ms.localizationpriority: medium
++
+# Get authentication signInPreferences
+Namespace: microsoft.graph
++
+Read the properties and relationships of a [signInPreferences](../resources/signInPreferences.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)|UserAuthenticationMethod.Read, UserAuthenticationMethod.ReadWrite|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|UserAuthenticationMethod.Read, UserAuthenticationMethod.ReadWrite|
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /users/{id | userPrincipalName}/authentication/signInPreferences
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [signInPreferences](../resources/signInPreferences.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_authentication"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/users/071cc716-8147-4397-a5ba-b2105951cc0b/authentication/signInPreferences
+```
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+++
+### 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.signInPreferences"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "isSystemPreferredAuthenticationMethodEnabled": false,
+ "userPreferredMethodForSecondaryAuthentication": "push"
+}
+```
+
v1.0 Authentication List Emailmethods https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authentication-list-emailmethods.md
GET https://graph.microsoft.com/beta/me/authentication/emailMethods
[!INCLUDE [sample-code](../includes/snippets/powershell/get-emailauthenticationmethod-2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Authentication List Methods https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authentication-list-methods.md
GET https://graph.microsoft.com/beta/me/authentication/methods
[!INCLUDE [sample-code](../includes/snippets/powershell/get-methods-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Authentication List Passwordmethods https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authentication-list-passwordmethods.md
GET https://graph.microsoft.com/beta/me/authentication/passwordMethods
[!INCLUDE [sample-code](../includes/snippets/powershell/get-passwordmethods-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Authentication List Phonemethods https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authentication-list-phonemethods.md
GET https://graph.microsoft.com/beta/me/authentication/phoneMethods
[!INCLUDE [sample-code](../includes/snippets/powershell/get-phonemethods-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Authentication List Softwareoathmethods https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authentication-list-softwareoathmethods.md
GET https://graph.microsoft.com/beta/me/authentication/softwareOathMethods
[!INCLUDE [sample-code](../includes/snippets/powershell/list-softwareoathauthenticationmethod-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Authentication List Temporaryaccesspassmethods https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authentication-list-temporaryaccesspassmethods.md
GET https://graph.microsoft.com/beta/users/071cc716-8147-4397-a5ba-b2105951cc0b/
[!INCLUDE [sample-code](../includes/snippets/powershell/list-temporaryaccesspassauthenticationmethod-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Authentication Post Emailmethods https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-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"
Set a user's [emailAuthenticationMethod](../resources/emailauthenticationmethod.
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-### Permissions acting on self
-
-|Permission type | Permissions (from least to most privileged) |
-|:|:-|
-| Delegated (work or school account) | UserAuthenticationMethod.ReadWrite |
-| Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
-
-### Permissions acting on other users
- |Permission type | Permissions (from least to most privileged) | |:|:-| | Delegated (work or school account) | UserAuthenticationMethod.ReadWrite.All |
One of the following permissions is required to call this API. To learn more, in
[!INCLUDE [rbac-authentication-methods-apis-write-others](../includes/rbac-for-apis/rbac-authentication-methods-apis-write-others.md)]
-## HTTP request
+Users cannot add an email authentication method to their own account.
-Add an email method to your own account. For a signed-in user to update their own authentication method, they must have satisfied a multi-factor authentication requirement during sign in.
-<!-- { "blockType": "ignored" } -->
-``` http
-POST /me/authentication/emailMethods
-```
+## HTTP request
Add an email authentication method to another user's account. <!-- { "blockType": "ignored" } -->
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-emailauthenticationmethod-from--powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Authentication Post Phonemethods https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-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"
Additionally, if a user is enabled by policy to use SMS sign-in and a `mobile` n
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-### Permissions acting on self
-
-|Permission type | Permissions (from least to most privileged) |
-|:|:-|
-| Delegated (work or school account) | UserAuthenticationMethod.ReadWrite |
-| Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
-
-### Permissions acting on other users
- |Permission type | Permissions (from least to most privileged) | |:|:-| | Delegated (work or school account) | UserAuthenticationMethod.ReadWrite.All |
One of the following permissions is required to call this API. To learn more, in
[!INCLUDE [rbac-authentication-methods-apis-write](../includes/rbac-for-apis/rbac-authentication-methods-apis-write.md)]
-## HTTP request
+Users cannot add a phone authentication method to their own account.
-Add a phone authentication method to your own account. For a signed-in user to update their own authentication method, they must have satisfied a multi-factor authentication requirement during sign in.
-<!-- { "blockType": "ignored" } -->
-```http
-POST /me/authentication/phoneMethods
-```
+## HTTP request
Add a phone authentication method to another user's account. <!-- { "blockType": "ignored" } -->
The following is an example of the request.
# [HTTP](#tab/http) <!-- { "blockType": "request",
+ "sampleKeys": ["kim@contoso.com"],
"name": "create_phoneauthenticationmethod_from_authentication" }--> ```http
-POST https://graph.microsoft.com/beta/me/authentication/phoneMethods
+POST https://graph.microsoft.com/beta/users/kim@contoso.com/authentication/phoneMethods
Content-type: application/json {
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-phoneauthenticationmethod-from-authentication-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Authentication Post Temporaryaccesspassmethods https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authentication-post-temporaryaccesspassmethods.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-temporaryaccesspassauthenticationmethod-from--powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Authentication Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authentication-update.md
+
+ Title: "Update authentication signInPreferences"
+description: "Update the properties of a user's authentication sign in preferences."
+
+ms.localizationpriority: medium
++
+# Update authentication signInPreferences
+Namespace: microsoft.graph
++
+Update the properties of a [signInPreferences](../resources/signInPreferences.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)|UserAuthenticationMethod.ReadWrite|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|UserAuthenticationMethod.ReadWrite|
+++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /users/{id | userPrincipalName}/authentication/signInPreferences
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
++
+|Property|Type|Description|
+|:|:|:|
+|isSystemPreferredAuthenticationMethodEnabled|Boolean|Indicates whether the credential preferences of the system are enabled.|
+|userPreferredMethodForSecondaryAuthentication|userDefaultAuthenticationMethodType|The default second-factor method used by the user when signing in. If a user is enabled for system-preferred authentication, then this value is ignored except for a few scenarios where a user is authenticating via NPS extension or ADFS adapter. Possible values are `push`, `oath`, `voiceMobile`, `voiceAlternateMobile`, `voiceOffice`, `sms`, and `unknownFutureValue`|
+++
+## Response
+
+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "update_authentication"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/users/071cc716-8147-4397-a5ba-b2105951cc0b/authentication/signInPreferences
+Content-Type: application/json
+
+{
+ "userPreferredMethodForSecondaryAuthentication": "oath"
+}
+```
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+++
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+```http
+HTTP/1.1 204 No Content
+```
++
v1.0 Authenticationcombinationconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationcombinationconfiguration-get.md
GET https://graph.microsoft.com/beta/identity/conditionalAccess/authenticationSt
[!INCLUDE [sample-code](../includes/snippets/php/get-authenticationcombinationconfiguration-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Authenticationcombinationconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationcombinationconfiguration-update.md
Content-length: 130
[!INCLUDE [sample-code](../includes/snippets/php/update-authenticationcombinationconfiguration-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Authenticationconditionapplication Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationconditionapplication-delete.md
+
+ Title: "Delete authenticationConditionApplication (from a user flow)"
+description: "Remove an application from an externalUsersSelfServiceSignupEventsFlow."
+
+ms.localizationpriority: medium
++
+# Delete authenticationConditionApplication (from a user flow)
+Namespace: microsoft.graph
++
+Remove or unlink [an application](../resources/authenticationconditionapplication.md) from an external identities self-service sign up user flow that's represented by an [externalUsersSelfServiceSignupEventsFlow](../resources/externalusersselfservicesignupeventsflow.md) object. This disables the authentication experience that's defined by the user flow for the application.
+
+## Permissions
+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)|EventListener.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|EventListener.ReadWrite.All|
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /identity/authenticationEventsFlows/{authenticationEventsFlow-id}/conditions/applications/includeApplications/{appId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+Do not supply a request body for this method.
++
+## Response
+
+If successful, this method returns a `204 No Content` response code. If unsuccessful, a `4xx` error will be returned with specific details.
+
+## Examples
+
+#### Request
+The following is an example of a request. `63856651-13d9-4784-9abf-20758d509e19` representes the **appId** of the application, also known as the client ID, not the object ID.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "delete_includeApplications"
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/beta/identity/authenticationEventsFlows/0313cc37-d421-421d-857b-87804d61e33e/conditions/applications/includeApplications/63856651-13d9-4784-9abf-20758d509e19
+```
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+++
+#### Response
+The following is an example of the response
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
v1.0 Authenticationconditionsapplications List Includeapplications https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationconditionsapplications-list-includeapplications.md
+
+ Title: "List includeApplications (for a user flow)"
+description: "List applications for an externalusersselfservicesignupeventsflow."
+
+ms.localizationpriority: medium
++
+# List includeApplications (for a user flow)
+Namespace: microsoft.graph
++
+List the applications linked to an external identities self-service sign up user flow that's represented by an [externalUsersSelfServiceSignupEventsFlow](../resources/externalusersselfservicesignupeventsflow.md) object. These are the applications for which the authentication experience that's defined by the user flow is enabled.
+
+## Permissions
+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)|EventListener.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|EventListener.ReadWrite.All|
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /identity/authenticationEventsFlows/{authenticationEventsFlow-id}/conditions/applications/includeApplications/
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` and a collection of [identityUserFlowAttribute](../resources/identityuserflowattribute.md) objects in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request to retrieve the list of applications associated with a user flow.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_includeApplications"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/identity/authenticationEventsFlows/0313cc37-d421-421d-857b-87804d61e33e/conditions/applications/includeApplications/
+```
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+++
+### Response
+The following is an example of the response
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.authenticationConditionApplication"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#identity/authenticationEventsFlows('0313cc37-d421-421d-857b-87804d61e33e')/conditions/applications/includeApplications",
+ "value": [
+ {
+ "appId": "63856651-13d9-4784-9abf-20758d509e19"
+ }
+ ]
+}
+```
v1.0 Authenticationconditionsapplications Post Includeapplications https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationconditionsapplications-post-includeapplications.md
+
+ Title: "Add includeApplication (to a user flow)"
+description: "Add application to an externalusersselfservicesignupeventsflow."
+
+ms.localizationpriority: medium
++
+# Add includeApplication (to a user flow)
+Namespace: microsoft.graph
++
+Add or link an application to an external identities self-service sign up user flow that's represented by an [externalUsersSelfServiceSignupEventsFlow](../resources/externalusersselfservicesignupeventsflow.md) object. This enables the authentication experience that's defined by the user flow to be enabled for the application. An application can only be linked to one user flow.
++
+## Permissions
+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)|EventListener.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|EventListener.ReadWrite.All|
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /identity/authenticationEventsFlows/{authenticationEventsFlow-id}/conditions/applications/includeApplications
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, provide a JSON representation of the **appId** of the application to associate with the user flow.
+
+## Response
+
+If successful, this method returns a `201 Created` response code and a new [authenticationConditionApplication](../resources/authenticationconditionapplication.md) object in the response body. If unsuccessful, a `4xx` error will be returned with specific details.
+
+## Examples
+
+### Request
+The following is an example of a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "post_includeapplications"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/identity/authenticationEventsFlows/0313cc37-d421-421d-857b-87804d61e33e/conditions/applications/includeApplications
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.authenticationConditionApplication",
+ "appId": "63856651-13d9-4784-9abf-20758d509e19"
+}
+
+```
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+++
+### Response
+The following is an example of the response
+<!-- {
+ "blockType": "response",
+ "@odata.type": "microsoft.graph.authenticationConditionApplication",
+ "truncated": true,
+}
+-->
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#identity/authenticationEventsFlows('0313cc37-d421-421d-857b-87804d61e33e')/conditions/applications/includeApplications/$entity",
+ "appId": "63856651-13d9-4784-9abf-20758d509e19"
+}
+```
v1.0 Authenticationcontextclassreference Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationcontextclassreference-delete.md
The following is an example of a request.
# [HTTP](#tab/http) <!-- { "blockType": "request",
- "name": "delete_authenticationcontextclassreference"
+ "name": "delete_authenticationcontextclassreference",
+ "sampleKeys": ["c1"]
} --> ``` http
DELETE https://graph.microsoft.com/beta/identity/conditionalAccess/authenticatio
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-authenticationcontextclassreference-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Authenticationcontextclassreference Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationcontextclassreference-get.md
GET https://graph.microsoft.com/beta/identity/conditionalAccess/authenticationCo
[!INCLUDE [sample-code](../includes/snippets/powershell/get-identity-conditionalaccess-authenticationcontextclassreferences-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Authenticationcontextclassreference Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationcontextclassreference-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-authenticationcontextclassreference-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Authenticationeventlistener Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationeventlistener-delete.md
+
+ Title: "Delete authenticationEventListener"
+description: "Deletes an authenticationEventListener object."
+
+ms.localizationpriority: medium
++
+# Delete authenticationEventListener
+Namespace: microsoft.graph
++
+Deletes an [authenticationEventListener](../resources/authenticationeventlistener.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)|EventListener.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|EventListener.ReadWrite.All|
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /identity/authenticationEventListeners/{authenticationEventListenerId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+The following is an example of a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "delete_authenticationeventlistener"
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/beta/identity/authenticationEventListeners/c7a1f2c5-3d36-4b3f-b75c-143af30a5246
+```
+
+# [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
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Authenticationeventlistener Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationeventlistener-get.md
+
+ Title: "Get authenticationEventListener"
+description: "Read the properties and relationships of an authenticationEventListener object."
+
+ms.localizationpriority: medium
++
+# Get authenticationEventListener
+Namespace: microsoft.graph
++
+Read the properties and relationships of an [authenticationEventListener](../resources/authenticationeventlistener.md) object. The **@odata.type** property in the response object indicates the type of the authenticationEventListener 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)|EventListener.Read.All, EventListener.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported|
+|Application|EventListener.Read.All, EventListener.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /identity/authenticationEventListeners/{authenticationEventListenerId}
+```
+
+## Optional query parameters
+This method supports the `$select` OData query parameter to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and an [authenticationEventListener](../resources/authenticationeventlistener.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_authenticationeventlistener"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/identity/customAuthenticationExtensions/6fc5012e-7665-43d6-9708-4370863f4e6e
+```
+
+# [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
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.authenticationEventListener"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#identity/customAuthenticationExtensions/$entity",
+ "@odata.type": "#microsoft.graph.onTokenIssuanceStartCustomExtension",
+ "id": "6fc5012e-7665-43d6-9708-4370863f4e6e",
+ "displayName": "onTokenIssuanceStartCustomExtension",
+ "description": "Fetch additional claims from custom user store",
+ "clientConfiguration": null,
+ "behaviorOnError": null,
+ "authenticationConfiguration": {
+ "@odata.type": "#microsoft.graph.azureAdTokenAuthentication",
+ "resourceId": "api://authenticationeventsAPI.contoso.com/a13d0fc1-04ab-4ede-b215-63de0174cbb4"
+ },
+ "endpointConfiguration": {
+ "@odata.type": "#microsoft.graph.httpRequestEndpoint",
+ "targetUrl": "https://authenticationeventsAPI.contoso.com"
+ },
+ "claimsForTokenConfiguration": [
+ {
+ "claimIdInApiResponse": "DateOfBirth"
+ },
+ {
+ "claimIdInApiResponse": "CustomRoles"
+ }
+ ]
+}
+```
+
v1.0 Authenticationeventlistener Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationeventlistener-update.md
+
+ Title: "Update authenticationEventListener"
+description: "Update the properties of an authenticationEventListener object."
+
+ms.localizationpriority: medium
++
+# Update authenticationEventListener
+Namespace: microsoft.graph
++
+Update the properties of an [authenticationEventListener](../resources/authenticationeventlistener.md) object. You must specify the **@odata.type** property and the value of the [authenticationEventListener](../resources/authenticationeventlistener.md) object type to update.
+
+## Permissions
+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)|EventListener.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|EventListener.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /identity/authenticationEventListeners/{authenticationEventListenerId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+
+You must specify the **@odata.type** property and the value of the [authenticationEventListener](../resources/authenticationeventlistener.md) object type to update. For example, `"@odata.type": "#microsoft.graph.onTokenIssuanceStartListener"`.
+
+|Property|Type|Description|
+|:|:|:|
+|authenticationEventsFlowId|String|The identifier of the authentication events flow. Optional.|
+|conditions|[authenticationConditions](../resources/authenticationconditions.md)|The conditions on which this authenticationEventListener should trigger. Optional.|
+|handler|[onAttributeCollectionHandler](../resources/ontokenissuancestarthandler.md)|The handler to invoke when conditions are met. Can be updated for the **onAttributeCollectionListener** listener type.|
+|handler|[onAuthenticationMethodLoadStartHandler](../resources/ontokenissuancestarthandler.md)|The handler to invoke when conditions are met. Can be updated for the **onAuthenticationMethodLoadStartListener** listener type.|
+|handler|[onInteractiveAuthFlowStartHandler](../resources/ontokenissuancestarthandler.md)|The handler to invoke when conditions are met. Can be updated for the **onInteractiveAuthFlowStartListener** listener type.|
+|handler|[onTokenIssuanceStartHandler](../resources/ontokenissuancestarthandler.md)|The handler to invoke when conditions are met. Can be updated for the **onTokenIssuanceStartListener** listener type.|
+|handler|[onUserCreateStartHandler](../resources/ontokenissuancestarthandler.md)|The handler to invoke when conditions are met. Can be updated for the **onUserCreateStartListener** listener type.|
+|priority|Int32|The priority of this handler. Between 0 (lower priority) and 1000 (higher priority). Required.|
+
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+The following is an example of a request to update an authentication event listener's trigger conditions or priority:
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "update_authenticationeventlistener"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/identity/authenticationEventListeners/990d94e5-cc8f-4c4b-97b4-27e2678aac28
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.onTokenIssuanceStartListener",
+ "conditions": {
+ "applications": {
+ "includeAllApplications": false
+ }
+ },
+ "priority": 500
+}
+```
+
+# [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
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Authenticationeventsflow Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationeventsflow-delete.md
+
+ Title: "Delete authenticationEventsFlow"
+description: "Delete an authenticationEventsFlow object."
+
+ms.localizationpriority: medium
++
+# Delete authenticationEventsFlow
+Namespace: microsoft.graph
++
+Delete a specific [authenticationEventsFlow](../resources/authenticationeventsflow.md) resource by ID. Only [externalUsersSelfServiceSignupEventsFlow](../resources/externalusersselfservicesignupeventsflow.md) object types are available.
+
+## Permissions
+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)|EventListener.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|EventListener.ReadWrite.All|
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /identity/authenticationEventsFlows/{authenticationEventsFlow-id}/
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+The following is an example of a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "delete_authenticationeventsflow"
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/beta/identity/authenticationEventsFlows/0313cc37-d421-421d-857b-87804d61e33e
+```
+
+# [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
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
v1.0 Authenticationeventsflow Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationeventsflow-get.md
+
+ Title: "Get authenticationEventsFlow"
+description: "Read the properties and relationships of an authenticationEventsFlow object."
+
+ms.localizationpriority: medium
++
+# Get authenticationEventsFlow
+Namespace: microsoft.graph
++
+Retrieve the properties and relationships of a specific [authenticationEventsFlow](../resources/authenticationeventsflow.md) object by ID. Only [externalUsersSelfServiceSignupEventsFlow](../resources/externalusersselfservicesignupeventsflow.md) object types are available.
+
+## Permissions
+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)|EventListener.Read.All, EventListener.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|EventListener.Read.All, EventListener.ReadWrite.All|
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /identity/authenticationEventsFlows/{authenticationEventsFlow-id}
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and an [authenticationEventsFlow](../resources/authenticationeventsflow.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request to retrieve a specific External Identities user flow.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_authenticationeventsflow"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/identity/authenticationEventsFlows/0313cc37-d421-421d-857b-87804d61e33e
+```
+
+# [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. In this example, the user flow retrieved is named "Woodgrove Drive Users Flow" and is set up to:
+
+- Allow users to create a local email with password account, or sign up with their Google or Facebook identity
+- Collect **Display Name** and **Favorite Color**
+- Create a "Member" user type.
+
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.authenticationEventsFlow"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": {
+ "@odata.type": "#microsoft.graph.externalUsersSelfServiceSignUpEventsFlow",
+ "id": "0313cc37-d421-421d-857b-87804d61e33e",
+ "displayName": "Woodgrove Drive User Flow",
+ "description": "For onboarding consumers to the Woodgrove Drive application",
+ "priority": 50,
+ "onAttributeCollectionStart": null,
+ "onAttributeCollectionSubmit": null,
+ "conditions": {
+ "applications": {
+ "includeAllApplications": false,
+ "includeApplications@odata.context": "https://graph.microsoft.com/beta/$metadata#identity/authenticationEventsFlows('0313cc37-d421-421d-857b-87804d61e33e')/microsoft.graph.externalUsersSelfServiceSignUpEventsFlow/conditions/applications/includeApplications",
+ "includeApplications": []
+ }
+ },
+ "onInteractiveAuthFlowStart": {
+ "@odata.type": "#microsoft.graph.onInteractiveAuthFlowStartExternalUsersSelfServiceSignUp",
+ "isSignUpAllowed": true
+ },
+ "onAuthenticationMethodLoadStart": {
+ "@odata.type": "#microsoft.graph.onAuthenticationMethodLoadStartExternalUsersSelfServiceSignUp",
+ "identityProviders": [
+ {
+ "@odata.type": "#microsoft.graph.builtInIdentityProvider",
+ "id": "EmailPassword-OAUTH",
+ "displayName": "Email with password",
+ "identityProviderType": "EmailPassword",
+ "state": null
+ },
+ {
+ "@odata.type": "#microsoft.graph.socialIdentityProvider",
+ "id": "Google-OAUTH",
+ "displayName": "Google",
+ "identityProviderType": "Google",
+ "clientId": "137004260525-q8j2cp9hqceqa6hpvaa346e04g92tn8m.apps.googleusercontent.com",
+ "clientSecret": "******"
+ },
+ {
+ "@odata.type": "#microsoft.graph.socialIdentityProvider",
+ "id": "Facebook-OAUTH",
+ "displayName": "Facebook",
+ "identityProviderType": "Facebook",
+ "clientId": "236028191057849",
+ "clientSecret": "******"
+ }
+ ]
+ },
+ "onAttributeCollection": {
+ "@odata.type": "#microsoft.graph.onAttributeCollectionExternalUsersSelfServiceSignUp",
+ "accessPackages": [],
+ "attributeCollectionPage": {
+ "customStringsFileId": null,
+ "views": [
+ {
+ "title": null,
+ "description": null,
+ "inputs": [
+ {
+ "attribute": "email",
+ "label": "Email Address",
+ "inputType": "text",
+ "defaultValue": null,
+ "hidden": true,
+ "editable": false,
+ "writeToDirectory": true,
+ "required": true,
+ "validationRegEx": "^[a-zA-Z0-9.!#$%&amp;&#8217;'*+/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:.[a-zA-Z0-9-]+)*$",
+ "options": []
+ },
+ {
+ "attribute": "displayName",
+ "label": "Display Name",
+ "inputType": "text",
+ "defaultValue": null,
+ "hidden": false,
+ "editable": true,
+ "writeToDirectory": true,
+ "required": false,
+ "validationRegEx": "^[a-zA-Z_][0-9a-zA-Z_ ]*[0-9a-zA-Z_]+$",
+ "options": []
+ },
+ {
+ "attribute": "extension_6ea3bc85aec24b1c92ff4a117afb6621_Favoritecolor",
+ "label": "Favorite color",
+ "inputType": "text",
+ "defaultValue": null,
+ "hidden": false,
+ "editable": true,
+ "writeToDirectory": true,
+ "required": false,
+ "validationRegEx": "^.*",
+ "options": []
+ }
+ ]
+ }
+ ]
+ },
+ "attributes": [
+ {
+ "id": "email",
+ "displayName": "Email Address",
+ "description": "Email address of the user",
+ "userFlowAttributeType": "builtIn",
+ "dataType": "string"
+ },
+ {
+ "id": "displayName",
+ "displayName": "Display Name",
+ "description": "Display Name of the User.",
+ "userFlowAttributeType": "builtIn",
+ "dataType": "string"
+ },
+ {
+ "id": "extension_6ea3bc85aec24b1c92ff4a117afb6621_Favoritecolor",
+ "displayName": "Favorite color",
+ "description": "what is your favorite color",
+ "userFlowAttributeType": "custom",
+ "dataType": "string"
+ }
+ ]
+ },
+ "onUserCreateStart": {
+ "@odata.type": "#microsoft.graph.onUserCreateStartExternalUsersSelfServiceSignUp",
+ "userTypeToCreate": "member",
+ "accessPackages": []
+ }
+ }
+}
+```
+
v1.0 Authenticationeventsflow Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationeventsflow-update.md
+
+ Title: "Update authenticationEventsFlow"
+description: "Update the properties of an authenticationEventsFlow object."
+
+ms.localizationpriority: medium
++
+# Update authenticationEventsFlow
+Namespace: microsoft.graph
++
+Update the properties of an [authenticationEventsFlow](../resources/authenticationeventsflow.md) object. Only the [externalUsersSelfServiceSignupEventsFlow](../resources/externalusersselfservicesignupeventsflow.md) object type is supported.
+
+## Permissions
+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)|EventListener.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|EventListener.ReadWrite.All|
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /identity/authenticationEventsFlows/{authenticationEventsFlow-id}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
++
+You must include the **@odata.type** property with a value of the specific user flow type in the body. For example, `"@odata.type": "#microsoft.graph.externalUsersSelfServiceSignupEventsFlow"`.
+
+|Property|Type|Description|
+|:|:|:|
+|id|String|The unique identifier for the entity. Read-only. |
+|displayName|String|The display name for the events policy. |
+|description|String|The description of the events policy.|
+|conditions|[authenticationConditions](../resources/authenticationconditions.md)|The conditions representing the context of the authentication request which is used to decide whether the events policy is invoked. |
+|priority|Int32|The priority to use for each individual event of the events policy. If multiple competing listeners for an event have the same priority, one is chosen and an error is silently logged. |
+|onInteractiveAuthFlowStart|[onInteractiveAuthFlowStartHandler](../resources/oninteractiveauthflowstarthandler.md)|The configuration for what to invoke for the onInteractiveAuthFlowStart event. |
+|onAuthenticationMethodLoadStart|[onAuthenticationMethodLoadStartHandler](../resources/onauthenticationmethodloadstarthandler.md)|The configuration for what to invoke for the onAuthenticationMethodLoadStart event. Must have at least one identity provider linked.|
+|onAttributeCollection|[onAttributeCollectionHandler](../resources/onattributecollectionhandler.md)|The configuration for what to invoke for the onAttributeCollection event.|
+|onUserCreateStart|[onUserCreateStartHandler](../resources/onusercreatestarthandler.md)|The configuration for what to invoke for the onUserCreateStart event.|
+
+## Response
+
+If successful, this method returns a `204 No Content` response code. If unsuccessful, a `4xx` error will be returned with specific details.
+
+## Examples
+
+### Example 1: Update the display name and priority of an authenticationEventsFlow
+
+#### Request
+The following is an example of a request that updates the display name of a specific external identities user flow ( an authentication event type), as well as the priority for all the listeners associated with the policy.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "authenticationeventsflow_update_beta_e1"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/identity/authenticationEventsFlows/0313cc37-d421-421d-857b-87804d61e33e
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.externalUsersSelfServiceSignUpEventsFlow",
+ "displayName": "New user flow description",
+ "priority": 200
+}
+```
+
+# [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
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
+### Example 2: Update the onAttributeCollection event of a self-service sign up user flow
+
+Add city (built-in attribute) as an attribute to be collected during the attribute collection step of a self-service sign up user flow. You must specify in the **inputs** object all attributes that you want to retain, otherwise they are removed from the user flow.
+
+#### Request
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "update_authenticationeventsflow_onattributecollection_beta_e2"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/identity/authenticationEventsFlows/0313cc37-d421-421d-857b-87804d61e33e
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.externalUsersSelfServiceSignUpEventsFlow",
+ "onAttributeCollection": {
+ "@odata.type": "#microsoft.graph.onAttributeCollectionExternalUsersSelfServiceSignUp",
+ "attributeCollectionPage": {
+ "customStringsFileId": null,
+ "views": [
+ {
+ "title": null,
+ "description": null,
+ "inputs": [
+ {
+ "attribute": "email",
+ "label": "Email Address",
+ "inputType": "text",
+ "defaultValue": null,
+ "hidden": true,
+ "editable": false,
+ "writeToDirectory": true,
+ "required": true,
+ "validationRegEx": "^[a-zA-Z0-9.!#$%&amp;&#8217;'*+/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:.[a-zA-Z0-9-]+)*$",
+ "options": []
+ },
+ {
+ "attribute": "displayName",
+ "label": "Display Name",
+ "inputType": "text",
+ "defaultValue": null,
+ "hidden": false,
+ "editable": true,
+ "writeToDirectory": true,
+ "required": false,
+ "validationRegEx": "^[a-zA-Z_][0-9a-zA-Z_ ]*[0-9a-zA-Z_]+$",
+ "options": []
+ },
+ {
+ "attribute": "city",
+ "label": "City",
+ "inputType": "text",
+ "defaultValue": null,
+ "hidden": false,
+ "editable": true,
+ "writeToDirectory": true,
+ "required": false,
+ "validationRegEx": "^[a-zA-Z_][0-9a-zA-Z_ ]*[0-9a-zA-Z_]+$",
+ "options": []
+ },
+ {
+ "attribute": "extension_6ea3bc85aec24b1c92ff4a117afb6621_Favoritecolor",
+ "label": "Favorite color",
+ "inputType": "text",
+ "defaultValue": null,
+ "hidden": false,
+ "editable": true,
+ "writeToDirectory": true,
+ "required": false,
+ "validationRegEx": "^.*",
+ "options": []
+ }
+ ]
+ }
+ ]
+ }
+ }
+}
+```
+
+# [C#](#tab/csharp)
+
+# [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
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
+### Example 3: Remove an attribute collected during a self-service sign up user flow
+
+Remove city as an attribute to be collected during the attribute collection step of a self-service sign up user flow. By excluding the city attribute from the request body, the attribute will be removed from the user flow.
+
+#### Request
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "update_authenticationeventsflow_onattributecollection_beta_e3"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/identity/authenticationEventsFlows/0313cc37-d421-421d-857b-87804d61e33e
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.externalUsersSelfServiceSignUpEventsFlow",
+ "onAttributeCollection": {
+ "@odata.type": "#microsoft.graph.onAttributeCollectionExternalUsersSelfServiceSignUp",
+ "attributeCollectionPage": {
+ "customStringsFileId": null,
+ "views": [
+ {
+ "title": null,
+ "description": null,
+ "inputs": [
+ {
+ "attribute": "email",
+ "label": "Email Address",
+ "inputType": "text",
+ "defaultValue": null,
+ "hidden": true,
+ "editable": false,
+ "writeToDirectory": true,
+ "required": true,
+ "validationRegEx": "^[a-zA-Z0-9.!#$%&amp;&#8217;'*+/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:.[a-zA-Z0-9-]+)*$",
+ "options": []
+ },
+ {
+ "attribute": "displayName",
+ "label": "Display Name",
+ "inputType": "text",
+ "defaultValue": null,
+ "hidden": false,
+ "editable": true,
+ "writeToDirectory": true,
+ "required": false,
+ "validationRegEx": "^[a-zA-Z_][0-9a-zA-Z_ ]*[0-9a-zA-Z_]+$",
+ "options": []
+ },
+ {
+ "attribute": "extension_6ea3bc85aec24b1c92ff4a117afb6621_Favoritecolor",
+ "label": "Favorite color",
+ "inputType": "text",
+ "defaultValue": null,
+ "hidden": false,
+ "editable": true,
+ "writeToDirectory": true,
+ "required": false,
+ "validationRegEx": "^.*",
+ "options": []
+ }
+ ]
+ }
+ ]
+ }
+ }
+}
+```
+
+# [C#](#tab/csharp)
+
+# [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
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Authenticationflowspolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationflowspolicy-get.md
GET https://graph.microsoft.com/beta/policies/authenticationFlowsPolicy
[!INCLUDE [sample-code](../includes/snippets/powershell/get-authenticationflowspolicy-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Authenticationflowspolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationflowspolicy-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-authenticationflowspolicy-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Authenticationmethod Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationmethod-get.md
GET https://graph.microsoft.com/beta/me/authentication/methods/{id}
[!INCLUDE [sample-code](../includes/snippets/powershell/get-authenticationmethod-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Authenticationmethodmodedetail Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationmethodmodedetail-get.md
GET https://graph.microsoft.com/beta/identity/conditionalAccess/authenticationSt
[!INCLUDE [sample-code](../includes/snippets/php/get-authenticationmethodmodedetail-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Authenticationmethodspolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationmethodspolicy-get.md
GET https://graph.microsoft.com/beta/policies/authenticationMethodsPolicy
[!INCLUDE [sample-code](../includes/snippets/powershell/get-authenticationmethodspolicy-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
Content-Type: application/json
] } },
+ "reportSuspiciousActivitySettings": {
+ "@odata.type": "#microsoft.graph.reportSuspiciousActivitySettings",
+ "state": "enabled",
+ "includeTarget": {
+ "targetType": "group",
+ "id": "all_users",
+ },
+ "voiceReportingCode": 0,
+ },
"authenticationMethodConfigurations": [ { "@odata.type": "#microsoft.graph.fido2AuthenticationMethodConfiguration",
Content-Type: application/json
"excludeTargets": [] } ]
+
} ```
v1.0 Authenticationmethodspolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationmethodspolicy-update.md
In the request body, supply a JSON representation of the [registrationEnforcemen
|Property|Type|Description| |:|:|:| |registrationEnforcement|[registrationEnforcement](../resources/registrationenforcement.md)|Enforce registration at sign-in time. This property can be used to prompt users to set up targeted authentication methods.|
+|reportSuspiciousActivitySettings|[reportSuspiciousActivitySettings](../resources/reportsuspiciousactivitysettings.md)|Enable users to report voice or phone app multi-factor authentication notifications as suspicious.|
|systemCredentialPreferences|[systemCredentialPreferences](../resources/systemcredentialpreferences.md)|Prompt users with their most-preferred credential for multifactor authentication.| ## Response
Content-Type: application/json
} ] }
+ },
+ "reportSuspiciousActivitySettings": {
+ "state": "enabled",
+ "includeTarget": {
+ "targetType": "group",
+ "id": "all_users"
+ },
+ "voiceReportingCode": 0
} } ```
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-authenticationmethodspolicy-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
Content-Type: application/json
} ] }
+ },
+ "reportSuspiciousActivitySettings": {
+ "state": "enabled",
+ "includeTarget": {
+ "targetType": "group",
+ "id": "all_users"
+ },
+ "voiceReportingCode": 0
}, "systemCredentialPreferences": { "@odata.type": "#microsoft.graph.systemCredentialPreferences",
v1.0 Authenticationmethodsroot List Userregistrationdetails https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationmethodsroot-list-userregistrationdetails.md
Title: "List userRegistrationDetails"
-description: "Get a list of the authentication methods registered for the user as defined in the userRegistrationDetails object."
+description: "Get a list of the authentication methods registered for a user as defined in the userRegistrationDetails object."
ms.localizationpriority: medium ms.prod: "identity-and-access-reports"
doc_type: apiPageType
# List userRegistrationDetails+ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get a list of the authentication methods registered for the user as defined in the [userRegistrationDetails](../resources/userregistrationdetails.md) object.
+Get a list of the authentication methods registered for a user as defined in the [userRegistrationDetails](../resources/userregistrationdetails.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).
+<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|UserAuthenticationMethod.Read.All and AuditLog.Read.All|
+|Delegated (work or school account)|AuditLog.Read.All|
|Delegated (personal Microsoft account)|Not supported.|
-|Application|UserAuthenticationMethod.Read.All and AuditLog.Read.All|
+|Application|AuditLog.Read.All|
## HTTP request
GET /reports/authenticationMethods/userRegistrationDetails
``` ## Optional query parameters+ This method supports only the `$filter` and `$orderBy` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ## Request headers+ |Name|Description| |:|:| |Authorization|Bearer {token}. Required.| ## 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
### Request
+The following is an example of the request.
+ # [HTTP](#tab/http) <!-- { "blockType": "request",
GET https://graph.microsoft.com/beta/reports/authenticationMethods/userRegistrat
[!INCLUDE [sample-code](../includes/snippets/powershell/list-userregistrationdetails-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response+
+The following is an example of the response.
+ >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response",
HTTP/1.1 200 OK
Content-Type: application/json {
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#reports/authenticationMethods/userRegistrationDetails",
- "value": [
- {
- "id": "86462606-fde0-4fc4-9e0c-a20eb73e54c6",
- "userPrincipalName": "AlexW@Contoso.com",
- "userDisplayName": "Alex Wilber",
- "isAdmin": false,
- "isSsprRegistered": false,
- "isSsprEnabled": false,
- "isSsprCapable": false,
- "isMfaRegistered": true,
- "isMfaCapable": true,
- "isPasswordlessCapable": false,
- "methodsRegistered": [
- "microsoftAuthenticatorPush",
- "softwareOneTimePasscode"
- ],
- "defaultMethod": "microsoftAuthenticatorPush",
- "userType": "member"
- },
- {
- "id": "c6ad1942-4afa-47f8-8d48-afb5d8d69d2f",
- "userPrincipalName": "AllanD@Contoso.com",
- "userDisplayName": "Allan Deyoung",
- "isAdmin": false,
- "isSsprRegistered": false,
- "isSsprEnabled": false,
- "isSsprCapable": false,
- "isMfaRegistered": false,
- "isMfaCapable": false,
- "isPasswordlessCapable": false,
- "methodsRegistered": [],
- "defaultMethod": "",
- "userType": "guest"
- },
- {
- "id": "c8096958-797c-44fa-8fde-a6fb62567cf0",
- "userPrincipalName": "BiancaP@Contoso.com",
- "userDisplayName": "Bianca Pisani",
- "isAdmin": false,
- "isSsprRegistered": true,
- "isSsprEnabled": false,
- "isSsprCapable": false,
- "isMfaRegistered": true,
- "isMfaCapable": true,
- "isPasswordlessCapable": false,
- "methodsRegistered": [
- "mobilePhone",
- "microsoftAuthenticatorPush",
- "softwareOneTimePasscode"
- ],
- "defaultMethod": "mobilePhone",
- "userType": "member"
- }
- ]
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#reports/authenticationMethods/userRegistrationDetails",
+ "value": [
+ {
+ "id": "86462606-fde0-4fc4-9e0c-a20eb73e54c6",
+ "userPrincipalName": "AlexW@Contoso.com",
+ "userDisplayName": "Alex Wilber",
+ "isAdmin": false,
+ "isSsprRegistered": false,
+ "isSsprEnabled": false,
+ "isSsprCapable": false,
+ "isMfaRegistered": true,
+ "isMfaCapable": true,
+ "isPasswordlessCapable": false,
+ "lastUpdatedDateTime": "2023-03-13T19:15:41.6195833Z",
+ "methodsRegistered": [
+ "microsoftAuthenticatorPush",
+ "softwareOneTimePasscode"
+ ],
+ "defaultMfaMethod": "microsoftAuthenticatorPush",
+ "isSystemPreferredAuthenticationMethodEnabled": true,
+ "systemPreferredAuthenticationMethods": [
+ "push"
+ ],
+ "userPreferredMethodForSecondaryAuthentication": "push",
+ "userType": "member"
+ },
+ {
+ "id": "c6ad1942-4afa-47f8-8d48-afb5d8d69d2f",
+ "userPrincipalName": "AllanD@Contoso.com",
+ "userDisplayName": "Allan Deyoung",
+ "isAdmin": false,
+ "isSsprRegistered": false,
+ "isSsprEnabled": false,
+ "isSsprCapable": false,
+ "isMfaRegistered": false,
+ "isMfaCapable": false,
+ "isPasswordlessCapable": false,
+ "lastUpdatedDateTime": "2023-03-13T19:15:41.6195833Z",
+ "methodsRegistered": [],
+ "defaultMfaMethod": "",
+ "isSystemPreferredAuthenticationMethodEnabled": true,
+ "systemPreferredAuthenticationMethods": [],
+ "userPreferredMethodForSecondaryAuthentication": "",
+ "userType": "guest"
+ },
+ {
+ "id": "c8096958-797c-44fa-8fde-a6fb62567cf0",
+ "userPrincipalName": "BiancaP@Contoso.com",
+ "userDisplayName": "Bianca Pisani",
+ "isAdmin": false,
+ "isSsprRegistered": true,
+ "isSsprEnabled": false,
+ "isSsprCapable": false,
+ "isMfaRegistered": true,
+ "isMfaCapable": true,
+ "isPasswordlessCapable": false,
+ "lastUpdatedDateTime": "2023-03-13T19:15:41.6195833Z",
+ "methodsRegistered": [
+ "mobilePhone",
+ "microsoftAuthenticatorPush",
+ "softwareOneTimePasscode"
+ ],
+ "defaultMfaMethod": "mobilePhone",
+ "isSystemPreferredAuthenticationMethodEnabled": true,
+ "systemPreferredAuthenticationMethods": [
+ "push"
+ ],
+ "userPreferredMethodForSecondaryAuthentication": "voiceMobile",
+ "userType": "member"
+ }
+ ]
} ```-
v1.0 Authenticationmethodsroot Usersregisteredbyfeature https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationmethodsroot-usersregisteredbyfeature.md
doc_type: apiPageType
# authenticationMethodsRoot: usersRegisteredByFeature+ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
Namespace: microsoft.graph
Get the number of users capable of multi-factor authentication, self-service password reset, and passwordless authentication. ## 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)|
The following permissions are required to call this API. To learn more, includin
|Delegated (personal Microsoft account)|Not supported.| |Application|Not supported.|
-In order to access the API, [one of the following roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles) is required:
+To access the API, [one of the following roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles) is required:
-* Reports reader
-* Security reader
-* Security admin
-* Global reader
-* Global admin
+* Reports Reader
+* Security Reader
+* Security Administrator
+* Global Reader
+* Global Administrator
## HTTP request
GET /reports/authenticationMethods/usersRegisteredByFeature
``` ## Function parameters+ The following table shows the parameters that can be used with this function. |Parameter|Type|Description| |:|:|:|
+|includedUserRoles|includedUserRoles|The role type for the user. Possible values are: `all`, `privilegedAdmin`, `admin`, `user`.|
|includedUserTypes|includedUserTypes|User type. Possible values are: `all`, `member`, `guest`.|
-|includedUserRoles|includedUserRoles|User role type. Possible values are: `all`, `privilegedAdmin`, `admin`, `user`.|
The value `privilegedAdmin` consists of the following privileged admin roles:
-* Global admin
-* Security admin
-* Conditional Access admin
-* Exchange admin
-* SharePoint admin
-* Helpdesk admin
-* Billing admin
-* User admin
-* Authentication admin
+* Global Administrator
+* Security Administrator
+* Conditional Access Administrator
+* Exchange Administrator
+* SharePoint Administrator
+* Helpdesk Administrator
+* Billing Administrator
+* User Administrator
+* Authentication Administrator
-The value `admin` includes all Azure AD admin roles.
+The value `admin` includes all Azure Active Director admin roles.
## Request headers+ |Name|Description| |:|:| |Authorization|Bearer {token}. Required.| ## Request body+ Do not supply a request body for this method. ## Response
If successful, this function returns a `200 OK` response code and a [userRegistr
### Request
+The following is an example of the request.
+ # [HTTP](#tab/http) <!-- { "blockType": "request",
If successful, this function returns a `200 OK` response code and a [userRegistr
GET https://graph.microsoft.com/beta/reports/authenticationMethods/usersRegisteredByFeature(includedUserTypes='all',includedUserRoles='all') ```
-# [C#](#tab/csharp)
-
-# [Go](#tab/go)
- # [Java](#tab/java) [!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
GET https://graph.microsoft.com/beta/reports/authenticationMethods/usersRegister
[!INCLUDE [sample-code](../includes/snippets/javascript/authenticationmethodsroot-usersregisteredbyfeature-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PHP](#tab/php)
- ### 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,
HTTP/1.1 200 OK
Content-Type: application/json {
- "@odata.type": "#microsoft.graph.userRegistrationFeatureSummary",
- "totalUserCount": 23123,
- "userTypes": "all",
- "userRoles": "all",
- "userRegistrationFeatureCounts": [{
- "feature": "ssprRegistered",
- "userCount": 23423
- },
- {
- "feature": "ssprEnabled",
- "userCount": 4234
- },
- {
- "feature": "ssprCapable",
- "userCount": 4234
- }, {
- "feature": "passwordlessCapable",
- "userCount": 323
- },
- {
- "feature": "mfaCapable",
- "userCount": 3345
- }
- ]
+ "@odata.type": "#microsoft.graph.userRegistrationFeatureSummary",
+ "totalUserCount": 23123,
+ "userTypes": "all",
+ "userRoles": "all",
+ "userRegistrationFeatureCounts": [
+ {
+ "feature": "ssprRegistered",
+ "userCount": 23423
+ },
+ {
+ "feature": "ssprEnabled",
+ "userCount": 4234
+ },
+ {
+ "feature": "ssprCapable",
+ "userCount": 4234
+ },
+ {
+ "feature": "passwordlessCapable",
+ "userCount": 323
+ },
+ {
+ "feature": "mfaCapable",
+ "userCount": 3345
+ }
+ ]
} ```
v1.0 Authenticationmethodsroot Usersregisteredbymethod https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationmethodsroot-usersregisteredbymethod.md
doc_type: apiPageType
# authenticationMethodsRoot: usersRegisteredByMethod+ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
Namespace: microsoft.graph
Get the number of users registered for each authentication method. ## Permissions+ 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)|
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account)|Not supported.| |Application|Not supported.|
-In order to access the API, [one of the following roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles) is required:
+To access the API, [one of the following roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles) is required:
-* Reports reader
-* Security reader
-* Security admin
-* Global reader
-* Global admin
+* Reports Reader
+* Security Reader
+* Security Administrator
+* Global Reader
+* Global Administrator
## HTTP request
GET /reports/authenticationMethods/usersRegisteredByMethod
``` ## Function parameters+ The following table shows the parameters that can be used with this function. |Parameter|Type|Description| |:|:|:|
+|includedUserRoles|includedUserRoles|The role type for the user. Possible values are: `all`, `privilegedAdmin`, `admin`, `user`.|
|includedUserTypes|includedUserTypes|User type. Possible values are: `all`, `member`, `guest`.|
-|includedUserRoles|includedUserRoles|User role type. Possible values are: `all`, `privilegedAdmin`, `admin`, `user`.|
The value `privilegedAdmin` consists of the following privileged admin roles:
-* Global admin
-* Security admin
-* Conditional Access admin
-* Exchange admin
-* SharePoint admin
-* Helpdesk admin
-* Billing admin
-* User admin
-* Authentication admin
+* Global Administrator
+* Security Administrator
+* Conditional Access Administrator
+* Exchange Administrator
+* SharePoint Administrator
+* Helpdesk Administrator
+* Billing Administrator
+* User Administrator
+* Authentication Administrator
-The value `admin` includes all Azure AD admin roles.
+The value `admin` includes all Azure Active Directory admin roles.
## Request headers+ |Name|Description| |:|:| |Authorization|Bearer {token}. Required.| ## Request body+ Do not supply a request body for this method. ## Response
If successful, this function returns a `200 OK` response code and a [userRegistr
### Request
+The following is an example of the request.
+ # [HTTP](#tab/http) <!-- { "blockType": "request",
If successful, this function returns a `200 OK` response code and a [userRegistr
GET https://graph.microsoft.com/beta/reports/authenticationMethods/usersRegisteredByMethod(includedUserTypes='all',includedUserRoles='all') ```
-# [C#](#tab/csharp)
-
-# [Go](#tab/go)
- # [Java](#tab/java) [!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
GET https://graph.microsoft.com/beta/reports/authenticationMethods/usersRegister
[!INCLUDE [sample-code](../includes/snippets/javascript/authenticationmethodsroot-usersregisteredbymethod-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PHP](#tab/php)
- ### 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,
HTTP/1.1 200 OK
Content-Type: application/json {
- "@odata.type": "#microsoft.graph.userRegistrationMethodSummary",
- "userTypes": "all",
- "userRoles": "all",
- "userRegistrationMethodCounts": [{
- "authenticationMethod": "password",
- "userCount": 12209
- },
- {
- "authenticationMethod": "windowsHelloForBusiness",
- "userCount": 223
- },
- {
- "authenticationMethod": "mobilePhone",
- "userCount": 4234
- }
- ]
+ "@odata.type": "#microsoft.graph.userRegistrationMethodSummary",
+ "userTypes": "all",
+ "userRoles": "all",
+ "userRegistrationMethodCounts": [
+ {
+ "authenticationMethod": "password",
+ "userCount": 12209
+ },
+ {
+ "authenticationMethod": "windowsHelloForBusiness",
+ "userCount": 223
+ },
+ {
+ "authenticationMethod": "mobilePhone",
+ "userCount": 4234
+ }
+ ]
} ```
v1.0 Authenticationoperation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationoperation-get.md
GET /users/{id | userPrincipalName}/authentication/operations/{id}
[!INCLUDE [sample-code](../includes/snippets/powershell/get-operation-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Authenticationstrengthpolicy Delete Combinationconfigurations https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-delete-combinationconfigurations.md
The following is an example of a request.
DELETE https://graph.microsoft.com/beta/identity/conditionalAccess/authenticationStrength/policies/0e371351-6419-4c8a-8047-61eef0212ffb/combinationConfigurations/6cbbcfd0-5054-4a59-a10e-2d21fe09305d/$ref ```
-# [C#](#tab/csharp)
-
-# [Go](#tab/go)
- # [Java](#tab/java) [!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
DELETE https://graph.microsoft.com/beta/identity/conditionalAccess/authenticatio
[!INCLUDE [sample-code](../includes/snippets/javascript/delete-authenticationcombinationconfiguration-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PHP](#tab/php)
-
-# [PowerShell](#tab/powershell)
- ### Response
v1.0 Authenticationstrengthpolicy Findbymethodmode https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-findbymethodmode.md
GET https://graph.microsoft.com/beta/policies/authenticationStrengthPolicies/fin
[!INCLUDE [sample-code](../includes/snippets/powershell/authenticationstrengthpolicythisfindbymethodmode-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Authenticationstrengthpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-get.md
GET https://graph.microsoft.com/beta/policies/authenticationStrengthPolicies/000
[!INCLUDE [sample-code](../includes/snippets/powershell/get-authenticationstrengthpolicy-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Authenticationstrengthpolicy List Combinationconfigurations https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-list-combinationconfigurations.md
GET https://graph.microsoft.com/beta/identity/conditionalAccess/authenticationSt
[!INCLUDE [sample-code](../includes/snippets/php/list-authenticationcombinationconfiguration-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Authenticationstrengthpolicy Post Combinationconfigurations https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-post-combinationconfigurations.md
Content-length: 130
[!INCLUDE [sample-code](../includes/snippets/php/create-authenticationcombinationconfiguration-from--php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Authenticationstrengthpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-update.md
Content-length: 239
[!INCLUDE [sample-code](../includes/snippets/powershell/update-authenticationstrengthpolicy-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Authenticationstrengthpolicy Updateallowedcombinations https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-updateallowedcombinations.md
Content-length: 51
[!INCLUDE [sample-code](../includes/snippets/powershell/authenticationstrengthpolicythisupdateallowedcombinations-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Authenticationstrengthpolicy Usage https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-usage.md
GET https://graph.microsoft.com/beta/policies/authenticationStrengthPolicies/{au
[!INCLUDE [sample-code](../includes/snippets/php/authenticationstrengthpolicythisusage-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ ### Response
v1.0 Authenticationstrengthroot List Authenticationmethodmodes https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthroot-list-authenticationmethodmodes.md
GET https://graph.microsoft.com/beta/identity/conditionalAccess/authenticationSt
[!INCLUDE [sample-code](../includes/snippets/php/list-authenticationmethodmodedetail-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
GET https://graph.microsoft.com/beta/identity/conditionalAccess/authenticationSt
[!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 Authenticationstrengthroot List Policies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthroot-list-policies.md
GET https://graph.microsoft.com/beta/policies/authenticationStrengthPolicies
[!INCLUDE [sample-code](../includes/snippets/powershell/list-authenticationstrengthpolicy-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
The following is an example of a request.
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_authenticationstrengthpolicy_filter_allowedCombinations"
The following is an example of a request.
GET https://graph.microsoft.com/beta/policies/authenticationStrengthPolicies?$filter=allowedCombinations/any(x:x has 'sms, password') ```
+# [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
Content-Type: application/json
} ] }
-```
+```
v1.0 Authenticationstrengthroot Post Policies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthroot-post-policies.md
Content-length: 239
[!INCLUDE [sample-code](../includes/snippets/powershell/create-authenticationstrengthpolicy-from--powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Authorizationpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authorizationpolicy-update.md
One of the following permissions is required to call this API. To learn more, in
| Delegated (personal Microsoft account) | Not supported. | | Application | Policy.ReadWrite.Authorization|
+When calling on behalf of a user, the user needs to have the *Privileged Role Administrator* [Azure AD role](/azure/active-directory/roles/permissions-reference).
+ ## HTTP request <!-- { "blockType": "ignored" } -->
In the request body, supply the values for relevant fields that should be update
| Property | Type | Description | |:-|:|:|
-|allowedToSignUpEmailBasedSubscriptions|Boolean| Indicates whether users can sign up for email based subscriptions. |
-|allowedToUseSSPR|Boolean| Indicates whether the Self-Serve Password Reset feature can be used by users on the tenant. |
|allowEmailVerifiedUsersToJoinOrganization|Boolean| Indicates whether a user can join the tenant by email validation. |
-|allowUserConsentForRiskyApps|Boolean| Indicates whether [user consent for risky apps](/azure/active-directory/manage-apps/configure-risk-based-step-up-consent) is allowed. It is recommended to keep this as `false`. |
-|blockMsolPowerShell|Boolean| To disable the use of MSOL PowerShell, set this property to `true`. This will also disable user-based access to the legacy service endpoint used by MSOL PowerShell. This does not affect Azure AD Connect or Microsoft Graph. |
+|allowUserConsentForRiskyApps|Boolean| Indicates whether [user consent for risky apps](/azure/active-directory/manage-apps/configure-risk-based-step-up-consent) is allowed. Default value is `false`. We recommend that you keep the value set to `false`.|
+|allowedToSignUpEmailBasedSubscriptions|Boolean| Indicates whether users can sign up for email-based subscriptions. |
+|allowedToUseSSPR|Boolean| Indicates whether users can use the Self-Serve Password Reset feature on the tenant. |
+|blockMsolPowerShell|Boolean| To disable the use of MSOL PowerShell, set this property to `true`. This also disables user-based access to the legacy service endpoint used by MSOL PowerShell. This does not affect Azure Active Directory Connect or Microsoft Graph. |
|defaultUserRolePermissions|[defaultUserRolePermissions](../resources/defaultUserRolePermissions.md)| Specifies certain customizable permissions for default user role. | |description|String| Description of this policy. | |displayName|String| Display name for this policy. |
-|enabledPreviewFeatures|Collection(string)| List of features enabled for private preview on the tenant. |
+|enabledPreviewFeatures|String collection| List of features enabled for private preview on the tenant. |
|guestUserRoleId|Guid| Represents role templateId for the role that should be granted to guest user. Refer to [List unifiedRoleDefinitions](./rbacapplication-list-roledefinitions.md) to find the list of available role templates. Only supported roles today are User (`a0b1b346-4d3e-4e8b-98f8-753987be4970`), Guest User (`10dae51f-b6af-4016-8d66-8c2a99b929b3`), and Restricted Guest User (`2af84b1e-32c8-42b7-82bc-daa82404023b`). | |permissionGrantPolicyIdsAssignedToDefaultUserRole | String collection | Indicates whether user consent to apps is allowed, and if it is, which [app consent policy](/azure/active-directory/manage-apps/manage-app-consent-policies) governs the permission for users to grant consent. Values should be in the format `managePermissionGrantsForSelf.{id}`, where `{id}` is the **id** of a built-in or custom [app consent policy](/azure/active-directory/manage-apps/manage-app-consent-policies). An empty list indicates user consent to apps is disabled. |
PATCH https://graph.microsoft.com/beta/policies/authorizationPolicy/authorizatio
[!INCLUDE [sample-code](../includes/snippets/php/update-authzpolicy-guestuserlevel-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
PATCH https://graph.microsoft.com/beta/policies/authorizationPolicy/authorizatio
[!INCLUDE [sample-code](../includes/snippets/php/update-authzpolicy-preview-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
PATCH https://graph.microsoft.com/beta/policies/authorizationPolicy/authorizatio
[!INCLUDE [sample-code](../includes/snippets/php/update-authzpolicy-blockmsolpowershell-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
PATCH https://graph.microsoft.com/beta/policies/authorizationPolicy/authorizatio
[!INCLUDE [sample-code](../includes/snippets/php/update-authzpolicy-applications-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
PATCH https://graph.microsoft.com/beta/policies/authorizationPolicy/authorizatio
[!INCLUDE [sample-code](../includes/snippets/php/update-authzpolicy-sspr-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
PATCH https://graph.microsoft.com/beta/policies/authorizationPolicy/authorizatio
[!INCLUDE [sample-code](../includes/snippets/php/update-authzpolicy-disableuserconsent-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
PATCH https://graph.microsoft.com/beta/policies/authorizationPolicy/authorizatio
[!INCLUDE [sample-code](../includes/snippets/php/update-authzpolicy-enableuserconsentlow-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Azureadauthentication Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/azureadauthentication-get.md
+
+ Title: "Get azureADAuthentication"
+description: "Read the properties and relationships of an azureADAuthentication object to find Azure AD SLA attainment for your tenant."
+
+ms.localizationpriority: medium
++
+# Get azureADAuthentication
+Namespace: microsoft.graph
++
+Read the properties and relationships of an [azureADAuthentication](../resources/azureadauthentication.md) object to find the level of Azure AD authentication availability for your tenant. The Azure AD Service Level Agreement (SLA) commits to at least 99.99% authentication availability, as described in [Azure Active Directory SLA performance](/azure/active-directory/reports-monitoring/reference-azure-ad-sla-performance). This object provides you with your tenantΓÇÖs actual performance against this commitment.
+
+## Permissions
+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) | Reports.Read.All |
+| Application | Reports.Read.All |
+
+In addition to the delegated permissions, the signed-in user needs to belong to one of the following directory roles that allow them to read sign-in reports. To learn more about directory roles, see [Azure AD built-in roles](/azure/active-directory/roles/permissions-reference):
++ Global Administrator++ Global Reader++ Reports Reader++ Security Administrator++ Security Operator++ Security Reader+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /reports/sla/azureADAuthentication
+```
+
+## Optional query parameters
+This method doesn't take any parameters.
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and an [azureADAuthentication](../resources/azureadauthentication.md) object in the response body. Each returned value includes a score indicating the availability percentage of the tenantΓÇÖs authentications for the month, along with a startDate and endDate indicating the month that the availability percentage is assigned to.
+
+## Examples
+
+### Request
+The following is an example of a request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_azureadauthentication"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/reports/sla/azureADAuthentication
+```
+
+# [C#](#tab/csharp)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
+++
+### Response
+The following is an example of the response
+>**Note:** The response object shown here is shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.azureADAuthentication"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#reports/sla/azureADAuthentication/$entity",
+ "attainments": [
+ {
+ "startDate": "2023-05-01",
+ "endDate": "2023-05-31",
+ "score": 99.999
+ },
+ {
+ "startDate": "2023-04-01",
+ "endDate": "2023-04-30",
+ "score": 99.999
+ },
+ {
+ "startDate": "2023-03-01",
+ "endDate": "2023-03-31",
+ "score": 99.999
+ },
+ {
+ "startDate": "2023-02-01",
+ "endDate": "2023-02-28",
+ "score": 99.999
+ },
+ {
+ "startDate": "2023-01-01",
+ "endDate": "2023-01-31",
+ "score": 99.998
+ },
+ {
+ "startDate": "2022-12-01",
+ "endDate": "2022-12-31",
+ "score": 99.999
+ },
+ ]
+}
+```
v1.0 B2cauthenticationmethodspolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/b2cauthenticationmethodspolicy-get.md
GET https://graph.microsoft.com/beta/policies/b2cAuthenticationMethodsPolicy
[!INCLUDE [sample-code](../includes/snippets/powershell/get-b2cauthenticationmethodspolicy-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 B2cauthenticationmethodspolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/b2cauthenticationmethodspolicy-update.md
PATCH https://graph.microsoft.com/beta/policies/b2cAuthenticationMethodsPolicy
[!INCLUDE [sample-code](../includes/snippets/php/patch-b2cauthenticationmethodspolicy-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 B2cidentityuserflow Delete Identityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/b2cidentityuserflow-delete-identityproviders.md
DELETE https://graph.microsoft.com/beta/identity/b2cUserFlows/B2C_1_CustomerSign
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-b2xuserflows-identityproviders-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 B2cidentityuserflow Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/b2cidentityuserflow-delete.md
DELETE https://graph.microsoft.com/beta/identity/b2cUserFlows/{id}
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-b2cuserflows-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 B2cidentityuserflow Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/b2cidentityuserflow-get.md
Do not supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and a JSON representation of the [b2cIdentityUserFlow](../resources/b2cidentityuserflow.md) in the response body.
+If successful, this method returns a `200 OK` response code and a [b2cIdentityUserFlow](../resources/b2cidentityuserflow.md) object in the response body.
## Example
GET https://graph.microsoft.com/beta/identity/b2cUserFlows/{id}
[!INCLUDE [sample-code](../includes/snippets/powershell/get-b2cuserflows-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 B2cidentityuserflow List Identityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/b2cidentityuserflow-list-identityproviders.md
Do not supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and a JSON representation of the [identityProviders](../resources/identityprovider.md) in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [identityProvider](../resources/identityprovider.md) objects in the response body.
## Example
GET https://graph.microsoft.com/beta/identity/b2cUserFlows/{id}/identityProvider
[!INCLUDE [sample-code](../includes/snippets/powershell/get-b2cuserflow-list-identityproviders-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 B2cidentityuserflow List Languages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/b2cidentityuserflow-list-languages.md
GET https://graph.microsoft.com/beta/identity/b2cUserFlows/B2C_1_CustomerSignUp/
[!INCLUDE [sample-code](../includes/snippets/powershell/get-userflowlanguageconfiguration-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/identity/b2cUserFlows/B2C_1_CustomerSignUp/
[!INCLUDE [sample-code](../includes/snippets/powershell/get-userflowlanguageconfiguration-filter-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 B2cidentityuserflow List Userattributeassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/b2cidentityuserflow-list-userattributeassignments.md
GET https://graph.microsoft.com/beta/identity/b2cUserFlows/{id}/userAttributeAss
[!INCLUDE [sample-code](../includes/snippets/powershell/get-identityuserflowattributeassignment-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/identity/b2cUserFlows/{id}/userAttributeAss
[!INCLUDE [sample-code](../includes/snippets/powershell/get-identityuserflowattributeassignment-expand-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 B2cidentityuserflow List Userflowidentityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/b2cidentityuserflow-list-userflowidentityproviders.md
Do not supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and a JSON representation of the [identityProviders](../resources/identityproviderbase.md) in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [identityProviderBase](../resources/identityproviderbase.md) objects in the response body.
## Example
GET https://graph.microsoft.com/beta/identity/b2cUserFlows/B2C_test_signin_signu
[!INCLUDE [sample-code](../includes/snippets/php/get-b2cuserflow-list-userflowidentityproviders-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 B2cidentityuserflow Post Identityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/b2cidentityuserflow-post-identityproviders.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-b2cuserflows-identityprovider-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 B2cidentityuserflow Post Userattributeassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/b2cidentityuserflow-post-userattributeassignments.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-identityuserflowattributeassignment-from--1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 B2cidentityuserflow Put Languages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/b2cidentityuserflow-put-languages.md
Content-Type: application/json
} ```
-# [C#](#tab/csharp)
-
-# [Go](#tab/go)
- # [Java](#tab/java) [!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/javascript/create-userflowlanguageconfiguration-from--1-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PHP](#tab/php)
- #### Response
Content-Type: application/json
} ```
-# [C#](#tab/csharp)
-
-# [Go](#tab/go)
- # [Java](#tab/java) [!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/javascript/create-userflowlanguageconfiguration-from--2-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PHP](#tab/php)
- #### Response
v1.0 B2cidentityuserflow Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/b2cidentityuserflow-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-b2cidentityuserflow-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 B2cidentityuserflow Userflowidentityproviders Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/b2cidentityuserflow-userflowidentityproviders-update.md
Content-type: application/json
} ```
-# [C#](#tab/csharp)
-
-# [Go](#tab/go)
- # [Java](#tab/java) [!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/javascript/update-b2cuserflows-userflowidentityproviders-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PHP](#tab/php)
- ### Response
v1.0 B2xidentityuserflow Delete Userflowidentityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/b2xidentityuserflow-delete-userflowidentityproviders.md
The work or school account needs to belong to one of the following roles:
<!-- { "blockType": "ignored" } --> ```http
-DELETE/identity/b2xUserFlows/{userflow-id}/userflowIdentityProviders/{id}/$ref
+DELETE /identity/b2xUserFlows/{userflow-id}/userflowIdentityProviders/{id}/$ref
``` ## Request headers
DELETE https://graph.microsoft.com/beta/identity/b2xUserFlows/{userflow-id}/user
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-identity-b2xuserflows-userflow-userflowidentityproviders-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 B2xidentityuserflow Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/b2xidentityuserflow-delete.md
DELETE https://graph.microsoft.com/beta/identity/b2xUserFlows/{id}
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-b2xuserflows-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 B2xidentityuserflow Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/b2xidentityuserflow-get.md
Do not supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and a JSON representation of the [b2xIdentityUserFlow](../resources/b2xidentityuserflow.md) in the response body.
+If successful, this method returns a `200 OK` response code and a [b2xIdentityUserFlow](../resources/b2xidentityuserflow.md) object in the response body.
## Example
GET https://graph.microsoft.com/beta/identity/b2xUserFlows/{id}
[!INCLUDE [sample-code](../includes/snippets/powershell/get-b2xuserflows-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 B2xidentityuserflow List Identityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/b2xidentityuserflow-list-identityproviders.md
Do not supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and a JSON representation of the [identityProviders](../resources/identityprovider.md) in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [identityProvider](../resources/identityprovider.md) objects in the response body.
## Example
GET https://graph.microsoft.com/beta/identity/b2xUserFlows/{id}/identityProvider
[!INCLUDE [sample-code](../includes/snippets/powershell/get-b2xuserflow-list-identityproviders-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 B2xidentityuserflow List Languages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/b2xidentityuserflow-list-languages.md
GET https://graph.microsoft.com/beta/identity/b2xUserFlows/B2X_1_PartnerSignUp/l
[!INCLUDE [sample-code](../includes/snippets/powershell/get-userflowlanguageconfiguration-2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 B2xidentityuserflow List Userattributeassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/b2xidentityuserflow-list-userattributeassignments.md
GET https://graph.microsoft.com/beta/identity/b2xUserFlows/{id}/userAttributeAss
[!INCLUDE [sample-code](../includes/snippets/powershell/get-identityuserflowattributeassignment-2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/identity/b2xUserFlows/{id}/userAttributeAss
[!INCLUDE [sample-code](../includes/snippets/powershell/get-identityuserflowattributeassignment-expand-2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 B2xidentityuserflow List Userflowidentityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/b2xidentityuserflow-list-userflowidentityproviders.md
Do not supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and a JSON representation of the [identityProviders](../resources/identityproviderbase.md) in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [identityProviderBase](../resources/identityproviderbase.md) objects in the response body.
## Example
GET https://graph.microsoft.com/beta/identity/b2xUserFlows/B2X_1_Test/userflowId
[!INCLUDE [sample-code](../includes/snippets/php/get-b2xuserflow-list-userflowidentityproviders-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 B2xidentityuserflow Post Identityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/b2xidentityuserflow-post-identityproviders.md
Content-type: application/json
} ```
-# [C#](#tab/csharp)
-
-# [Go](#tab/go)
- # [Java](#tab/java) [!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/javascript/update-b2xuserflows-identityprovider-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PHP](#tab/php)
- ### Response
v1.0 B2xidentityuserflow Post Userattributeassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/b2xidentityuserflow-post-userattributeassignments.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-identityuserflowattributeassignment-from--2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 B2xidentityuserflow Userflowidentityproviders Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/b2xidentityuserflow-userflowidentityproviders-update.md
Content-type: application/json
} ```
-# [C#](#tab/csharp)
-
-# [Go](#tab/go)
- # [Java](#tab/java) [!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/javascript/update-b2xuserflows-userflowidentityprovider-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PHP](#tab/php)
- ### Response
v1.0 Basesitepage Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/basesitepage-delete.md
++
+description: "Removes a sitePage from the site pages list in a site."
Last updated : 05/07/2018
+ Title: Delete a page from a SharePoint site
+ms.localizationpriority: medium
+
+# Delete baseSitePage
+
+Namespace: microsoft.graph
++
+Removes a [baseSitePage][] from the site pages [list][] in a [site][].
+
+[baseSitePage]: ../resources/basesitepage.md
+[list]: ../resources/list.md
+[site]: ../resources/site.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).
+
+>**Note:** To delete an item, the user must have granted the application write access to the item to be deleted.
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | Sites.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Sites.ReadWrite.All |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+DELETE /sites/{site-id}/pages/{page-id}
+```
+
+## Request headers
+
+| Name | Value | Description
+|:--|:|:--
+|Authorization|Bearer {token}.| Required|
+| _if-match_ | etag | If this request header is included and the eTag provided does not match the current tag on the item, a `412 Precondition Failed` response is returned and the item will not be deleted.
+
+## Request body
+
+Do not supply a request body with this method.
+
+## Response
+
+If successful, this method returns a `204 No Content`. It does not return anything in the response body.
+
+## Example
+
+<!-- { "blockType": "request", "name": "delete-page", "scopes": "files.readwrite sites.readwrite.all" } -->
+
+##### Request
+
+```http
+DELETE /sites/{site-id}/pages/{page-id}
+```
+##### Response
+
+<!-- { "blockType": "response" } -->
+
+```http
+HTTP/1.1 204 No Content
+```
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Delete a page in the SitePages list in a site.",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "Pages/Delete",
+ "suppressions": []
+}
+-->
++
v1.0 Basesitepage Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/basesitepage-get.md
++
+description: "Read the properties and relationships of a baseSitePage object."
Last updated : 03/15/2018
+ Title: Get baseSitePage
+ms.localizationpriority: medium
++
+# Get baseSitePage
+
+Namespace: microsoft.graph
++
+Get the metadata for a [baseSitePage][] in the site pages [list][] in a [site][].
+
+[baseSitePage]: ../resources/baseSitePage.md
+[list]: ../resources/list.md
+[site]: ../resources/site.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) | Sites.Read.All, Sites.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Sites.Read.All, Sites.ReadWrite.All |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+GET /sites/{site-id}/pages/{page-id}
+```
+
+## Optional query parameters
+
+This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response.
+
+## Request headers
+
+| Name | Description |
+| : | :-- |
+| Authorization | Bearer {token}. Required. |
+| Content-Type | application/json. Required. |
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200` and a [baseSitePage](../resources/baseSitePage.md) object in the response body.
+
+## Example
+
+### Request
+
+<!--
+{
+ "blockType": "request",
+ "name": "get-basesitepage",
+ "scopes": "sites.read.all",
+ "tags": "service.sharepoint"
+}
+-->
+
+```http
+GET /sites/{site-id}/pages/{page-id}
+```
+
+### Response
+
+> **Note:** The response object shown here might be shortened for readability.
+
+<!--
+{
+ "blockType": "response",
+ "@odata.type": "microsoft.graph.baseSitePage",
+ "truncated": true,
+ "isCollection":false
+}
+-->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.sitePage",
+ "@odata.etag": "\"{F45354CB-D634-45DF-8B88-2B4E96A1DC45},8\"",
+ "description": "Reiciendis placeat dolores.Mollitia veniam tempora tempora quidem voluptatum.Quos animi maiores facilis.Dolores officiis consequatur provident beatae deleniti accusamus magni quam tenetur.",
+ "eTag": "\"{F45354CB-D634-45DF-8B88-2B4E96A1DC45},8\"",
+ "id": "f45354cb-d634-45df-8b88-2b4e96a1dc45",
+ "lastModifiedDateTime": "2023-04-16T10:01:41Z",
+ "name": "Electronic Convertible.aspx",
+ "webUrl": "SitePages/Electronic Convertible.aspx",
+ "title": "Electronic Convertible",
+ "pageLayout": "article",
+ "thumbnailWebUrl": "https://media.akamai.odsp.cdn.office.net/_layouts/15/images/sitepagethumbnail.png",
+ "promotionKind": "page",
+ "showComments": false,
+ "showRecommendedPages": true,
+ "contentType": {
+ "id": "0x0101009D1CB255DA76424F860D91F20E6C4118009E6554A5E299E84FB2E07731DD6C6D4A",
+ "name": "Site Page"
+ },
+ "createdBy": {
+ "user": {
+ "displayName": "admin_contoso",
+ "email": "admin@contoso.onmicrosoft.com"
+ }
+ },
+ "lastModifiedBy": {
+ "user": {
+ "displayName": "admin_contoso",
+ "email": "admin@contoso.onmicrosoft.com"
+ }
+ },
+ "parentReference": {
+ "siteId": "45bb2a3b-0a4e-46f4-8c68-749c3fea75d3"
+ },
+ "publishingState": {
+ "level": "draft",
+ "versionId": "0.4"
+ },
+ "reactions": {}
+}
+```
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Get a page in a site",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "Pages/Get",
+ "suppressions": [
+ ]
+}
+-->
v1.0 Basesitepage List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/basesitepage-list.md
++
+description: 'Get the collection of baseSitePage objects from the site pages [list] in a site. All pages in the site are returned (with pagination).'
Last updated : 03/15/2018
+ Title: List baseSitePage
+ms.localizationpriority: medium
++
+# List baseSitePage
+
+Namespace: microsoft.graph
++
+Get the collection of [baseSitePage][] objects from the site pages [list][] in a [site][]. All pages in the site are returned (with pagination). Sort alphabetically by `name` in ascending order.
+
+> **Note:** The [baseSitePage][] specified is a parent type and does not have any instance. As a result, the returned data will only consist of available subtypes, which will be provided as a list.
+
+**The following table lists the available subtypes.**
+
+| Entity name | Description |
+| :-- | : |
+| [sitePage][] | Represents a regular page |
+
+[basesitepage]: ../resources/baseSitePage.md
+[sitepage]: ../resources/sitePage.md
+[list]: ../resources/list.md
+[site]: ../resources/site.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) | Sites.Read.All, Sites.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Sites.Read.All, Sites.ReadWrite.All |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+GET /sites/{site-id}/pages
+```
+
+## Optional query parameters
+
+This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response.
+
+## Request headers
+
+| Name | Description |
+| : | :-- |
+| Authorization | Bearer {token}. Required. |
+| Content-Type | application/json. Required. |
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200` and a list of [baseSitePage](../resources/baseSitePage.md) object in the response body.
+
+## Example
+
+### Request
+
+<!--
+{
+ "blockType": "request",
+ "name": "get-basesitepages",
+ "scopes": "sites.read.all",
+ "tags": "service.sharepoint"
+}
+-->
+
+```http
+GET /sites/{site-id}/pages
+```
+
+### Response
+
+<!--
+{
+ "blockType": "response",
+ "@odata.type": "microsoft.graph.baseSitePage",
+ "truncated": true,
+ "isCollection":true
+}
+-->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.sitePage",
+ "@odata.etag": "\"{5FA48F95-2FDF-40E8-A28C-6D0D8345BCD2},8\"",
+ "description": "Placeat porro perspiciatis maxime esse nobis illo.Voluptate vitae maxime totam consectetur fugit sit quos.Saepe ea veniam voluptate tempore quod deleniti necessitatibus repellat.",
+ "eTag": "\"{5FA48F95-2FDF-40E8-A28C-6D0D8345BCD2},8\"",
+ "id": "5fa48f95-2fdf-40e8-a28c-6d0d8345bcd2",
+ "lastModifiedDateTime": "2023-04-16T08:37:51Z",
+ "name": "Account holistic.aspx",
+ "webUrl": "SitePages/Account holistic.aspx",
+ "title": "CSS Global Lithuanian meter",
+ "pageLayout": "article",
+ "thumbnailWebUrl": "https://media.akamai.odsp.cdn.office.net/a830edad9050849vanaukyisx52.spgrid.com/_layouts/15/images/sitepagethumbnail.png",
+ "promotionKind": "page",
+ "showComments": false,
+ "showRecommendedPages": false,
+ "contentType": {
+ "id": "0x0101009D1CB255DA76424F860D91F20E6C4118009E6554A5E299E84FB2E07731DD6C6D4A",
+ "name": "Site Page"
+ },
+ "createdBy": {
+ "user": {
+ "displayName": "admin_contoso",
+ "email": "admin@contoso.onmicrosoft.com"
+ }
+ },
+ "lastModifiedBy": {
+ "user": {
+ "displayName": "admin_contoso",
+ "email": "admin@contoso.onmicrosoft.com"
+ }
+ },
+ "parentReference": {
+ "siteId": "45bb2a3b-0a4e-46f4-8c68-749c3fea75d3"
+ },
+ "publishingState": {
+ "level": "draft",
+ "versionId": "0.4"
+ },
+ "reactions": {}
+ },
+ {
+ "@odata.type": "#microsoft.graph.sitePage",
+ "@odata.etag": "\"{DA0F67BE-977E-4D09-88AC-506A1002E678},5\"",
+ "eTag": "\"{DA0F67BE-977E-4D09-88AC-506A1002E678},5\"",
+ "id": "da0f67be-977e-4d09-88ac-506a1002e678",
+ "lastModifiedDateTime": "2023-04-16T06:39:30Z",
+ "name": "Analyst Fresh.aspx",
+ "webUrl": "SitePages/Analyst Fresh.aspx",
+ "title": "Lesotho Account Metal Analyst du",
+ "pageLayout": "article",
+ "thumbnailWebUrl": "https://media.akamai.odsp.cdn.office.net/a830edad9050849vanaukyisx52.spgrid.com/_layouts/15/images/sitepagethumbnail.png",
+ "promotionKind": "page",
+ "showComments": false,
+ "showRecommendedPages": false,
+ "contentType": {
+ "id": "0x0101009D1CB255DA76424F860D91F20E6C4118009E6554A5E299E84FB2E07731DD6C6D4A",
+ "name": "Site Page"
+ },
+ "createdBy": {
+ "user": {
+ "displayName": "admin_contoso",
+ "email": "admin@contoso.onmicrosoft.com"
+ }
+ },
+ "lastModifiedBy": {
+ "user": {
+ "displayName": "admin_contoso",
+ "email": "admin@contoso.onmicrosoft.com"
+ }
+ },
+ "parentReference": {
+ "siteId": "45bb2a3b-0a4e-46f4-8c68-749c3fea75d3"
+ },
+ "publishingState": {
+ "level": "draft",
+ "versionId": "0.1"
+ },
+ "reactions": {},
+ "titleArea": {
+ "enableGradientEffect": false,
+ "imageWebUrl": "https://loremflickr.com/640/480",
+ "layout": "plain",
+ "showAuthor": false,
+ "showPublishedDate": false,
+ "showTextBlockAboveTitle": false,
+ "textAboveTitle": "generating ADP",
+ "textAlignment": "center",
+ "title": "strategic underneath protocol Buckinghamshire forecast",
+ "authors@odata.type": "#Collection(String)",
+ "authors": [],
+ "authorByline@odata.type": "#Collection(String)",
+ "authorByline": [],
+ "imageSourceType": 4,
+ "serverProcessedContent": {
+ "htmlStrings": [],
+ "searchablePlainTexts": [],
+ "links": [],
+ "imageSources": []
+ }
+ }
+ }
+ ]
+}
+
+```
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Enumerate the list of pages in a site",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "Pages/Enumerate",
+ "suppressions": [
+ ]
+}
+-->
v1.0 Basetask Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/basetask-delete.md
DELETE /me/tasks/lists/AAMkAGVjMzJmMWZjLTgyYjgtNGIyNi1hOGQ0LWRjMjNmMGRmOWNiYQAu/
- ### Response **Note:** The response object shown here might be shortened for readability. <!-- {
DELETE /me/tasks/lists/AAMkAGVjMzJmMWZjLTgyYjgtNGIyNi1hOGQ0LWRjMjNmMGRmOWNiYQAu/
HTTP/1.1 204 No Content ```
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Delete baseTask",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": [
+ "Error: microsoft.graph.microsoft.graph/me:
+ /me/tasks/lists/{var}/tasks/{var}
+ Uri path requires navigating into unknown object hierarchy: missing property 'tasks' on 'user'. Possible issues:
+ 1) Doc bug where 'tasks' isn't defined on the resource.
+ 2) Doc bug where 'tasks' is an example key and should instead be replaced with a placeholder like {item-id} or declared in the sampleKeys annotation.
+ 3) Doc bug where 'user' is supposed to be an entity type, but is being treated as a complex because it (and its ancestors) are missing the keyProperty annotation."
+ ]
+}
+-->
v1.0 Basetask Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/basetask-delta.md
Content-Type: application/json
} ```
+<!-- {
+ "type": "#page.annotation",
+ "description": "baseTask: delta",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": [
+ "Error: microsoft.graph.microsoft.graph/me:
+ /me/tasks/lists/{var}/tasks/delta
+ Uri path requires navigating into unknown object hierarchy: missing property 'tasks' on 'user'. Possible issues:
+ 1) Doc bug where 'tasks' isn't defined on the resource.
+ 2) Doc bug where 'tasks' is an example key and should instead be replaced with a placeholder like {item-id} or declared in the sampleKeys annotation.
+ 3) Doc bug where 'user' is supposed to be an entity type, but is being treated as a complex because it (and its ancestors) are missing the keyProperty annotation."
+ ]
+}-->
v1.0 Basetask Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/basetask-get.md
Content-Type: application/json
} ```
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Get baseTask",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": [
+ "Error: microsoft.graph.microsoft.graph/me:
+ /me/tasks/lists/{var}/tasks/{var}
+ Uri path requires navigating into unknown object hierarchy: missing property 'tasks' on 'user'. Possible issues:
+ 1) Doc bug where 'tasks' isn't defined on the resource.
+ 2) Doc bug where 'tasks' is an example key and should instead be replaced with a placeholder like {item-id} or declared in the sampleKeys annotation.
+ 3) Doc bug where 'user' is supposed to be an entity type, but is being treated as a complex because it (and its ancestors) are missing the keyProperty annotation."
+ ]
+}
+-->
v1.0 Basetask List Linkedresources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/basetask-list-linkedresources.md
Content-Type: application/json
} ```
+<!--
+{
+ "type": "#page.annotation",
+ "description": "List linkedResources",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": [
+ "Error: microsoft.graph.microsoft.graph/me:
+ /me/tasks/lists/{var}/tasks/{var}/linkedResources
+ Uri path requires navigating into unknown object hierarchy: missing property 'tasks' on 'user'. Possible issues:
+ 1) Doc bug where 'tasks' isn't defined on the resource.
+ 2) Doc bug where 'tasks' is an example key and should instead be replaced with a placeholder like {item-id} or declared in the sampleKeys annotation.
+ 3) Doc bug where 'user' is supposed to be an entity type, but is being treated as a complex because it (and its ancestors) are missing the keyProperty annotation."
+ ]
+}
+-->
v1.0 Basetask Move https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/basetask-move.md
Content-Type: application/json
} ```
+<!-- {
+ "type": "#page.annotation",
+ "description": "baseTask: move",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": [
+ "Error: microsoft.graph.microsoft.graph/me:
+ /me/tasks/lists/{var}/tasks/{var}/move
+ Uri path requires navigating into unknown object hierarchy: missing property 'tasks' on 'user'. Possible issues:
+ 1) Doc bug where 'tasks' isn't defined on the resource.
+ 2) Doc bug where 'tasks' is an example key and should instead be replaced with a placeholder like {item-id} or declared in the sampleKeys annotation.
+ 3) Doc bug where 'user' is supposed to be an entity type, but is being treated as a complex because it (and its ancestors) are missing the keyProperty annotation."
+ ]
+}-->
v1.0 Basetask Post Checklistitems https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/basetask-post-checklistitems.md
Content-Type: application/json
} ```
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Create checklistItem",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": [
+ "Error: microsoft.graph.microsoft.graph/me:
+ /me/tasks/lists/{var}/tasks/{var}/checklistItems
+ Uri path requires navigating into unknown object hierarchy: missing property 'tasks' on 'user'. Possible issues:
+ 1) Doc bug where 'tasks' isn't defined on the resource.
+ 2) Doc bug where 'tasks' is an example key and should instead be replaced with a placeholder like {item-id} or declared in the sampleKeys annotation.
+ 3) Doc bug where 'user' is supposed to be an entity type, but is being treated as a complex because it (and its ancestors) are missing the keyProperty annotation."
+ ]
+}
+-->
v1.0 Basetask Post Linkedresources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/basetask-post-linkedresources.md
Content-Type: application/json
} ```
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Create linkedResource_v2",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": [
+ "Error: microsoft.graph.microsoft.graph/me:
+ /me/tasks/lists/{var}/tasks/{var}/linkedResources
+ Uri path requires navigating into unknown object hierarchy: missing property 'tasks' on 'user'. Possible issues:
+ 1) Doc bug where 'tasks' isn't defined on the resource.
+ 2) Doc bug where 'tasks' is an example key and should instead be replaced with a placeholder like {item-id} or declared in the sampleKeys annotation.
+ 3) Doc bug where 'user' is supposed to be an entity type, but is being treated as a complex because it (and its ancestors) are missing the keyProperty annotation."
+ ]
+}
+-->
v1.0 Basetask Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/basetask-update.md
Content-Type: application/json
} ```
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Update baseTask",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": [
+ "Error: microsoft.graph.microsoft.graph/me:
+ /me/tasks/lists/{var}/tasks/{var}
+ Uri path requires navigating into unknown object hierarchy: missing property 'tasks' on 'user'. Possible issues:
+ 1) Doc bug where 'tasks' isn't defined on the resource.
+ 2) Doc bug where 'tasks' is an example key and should instead be replaced with a placeholder like {item-id} or declared in the sampleKeys annotation.
+ 3) Doc bug where 'user' is supposed to be an entity type, but is being treated as a complex because it (and its ancestors) are missing the keyProperty annotation."
+ ]
+}
+-->
v1.0 Basetasklist Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/basetasklist-delta.md
Content-Type: application/json
} ```
+<!-- {
+ "type": "#page.annotation",
+ "description": "baseTaskList: delta",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": [
+ "Error: microsoft.graph.microsoft.graph/me:
+ /me/tasks/lists/delta
+ Uri path requires navigating into unknown object hierarchy: missing property 'tasks' on 'user'. Possible issues:
+ 1) Doc bug where 'tasks' isn't defined on the resource.
+ 2) Doc bug where 'tasks' is an example key and should instead be replaced with a placeholder like {item-id} or declared in the sampleKeys annotation.
+ 3) Doc bug where 'user' is supposed to be an entity type, but is being treated as a complex because it (and its ancestors) are missing the keyProperty annotation."
+ ]
+}-->
v1.0 Basetasklist List Tasks https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/basetasklist-list-tasks.md
Content-Type: application/json
} ``` +
+<!--
+{
+ "type": "#page.annotation",
+ "description": "List baseTasks",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": [
+ "Error: microsoft.graph.microsoft.graph/me:
+ /me/tasks/lists/{var}/tasks
+ Uri path requires navigating into unknown object hierarchy: missing property 'tasks' on 'user'. Possible issues:
+ 1) Doc bug where 'tasks' isn't defined on the resource.
+ 2) Doc bug where 'tasks' is an example key and should instead be replaced with a placeholder like {item-id} or declared in the sampleKeys annotation.
+ 3) Doc bug where 'user' is supposed to be an entity type, but is being treated as a complex because it (and its ancestors) are missing the keyProperty annotation."
+ ]
+}
+-->
v1.0 Basetasklist Post Tasks https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/basetasklist-post-tasks.md
Content-Type: application/json
} ``` +
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Create baseTask",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": [
+ "Error: microsoft.graph.microsoft.graph/me:
+ /me/tasks/lists/{var}/tasks
+ Uri path requires navigating into unknown object hierarchy: missing property 'tasks' on 'user'. Possible issues:
+ 1) Doc bug where 'tasks' isn't defined on the resource.
+ 2) Doc bug where 'tasks' is an example key and should instead be replaced with a placeholder like {item-id} or declared in the sampleKeys annotation.
+ 3) Doc bug where 'user' is supposed to be an entity type, but is being treated as a complex because it (and its ancestors) are missing the keyProperty annotation."
+ ]
+}
+-->
v1.0 Bookingappointment Cancel https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingappointment-cancel.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/bookingappointment-cancel-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Bookingappointment Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingappointment-delete.md
DELETE https://graph.microsoft.com/beta/bookingBusinesses/contosolunchdelivery@c
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-bookingappointment-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Bookingappointment Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingappointment-get.md
GET https://graph.microsoft.com/beta/bookingBusinesses/contosolunchdelivery@cont
[!INCLUDE [sample-code](../includes/snippets/powershell/get-bookingappointment-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Bookingappointment Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingappointment-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-bookingappointment-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Bookingbusiness Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingbusiness-delete.md
DELETE https://graph.microsoft.com/beta/bookingBusinesses/fabrikam@contoso.onmic
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-bookingbusiness-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Bookingbusiness Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingbusiness-get.md
GET https://graph.microsoft.com/beta/bookingBusinesses/fabrikam@contoso.onmicros
[!INCLUDE [sample-code](../includes/snippets/powershell/get-bookingbusiness-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Bookingbusiness Getstaffavailability https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingbusiness-getstaffavailability.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/bookingbusiness-getstaffavailability-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Bookingbusiness List Appointments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingbusiness-list-appointments.md
GET https://graph.microsoft.com/beta/bookingBusinesses/contosolunchdelivery@cont
[!INCLUDE [sample-code](../includes/snippets/powershell/get-appointments-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Bookingbusiness List Calendarview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingbusiness-list-calendarview.md
GET https://graph.microsoft.com/beta/bookingBusinesses/contosolunchdelivery@cont
[!INCLUDE [sample-code](../includes/snippets/powershell/bookingbusiness-getcalendarview-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Bookingbusiness List Customers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingbusiness-list-customers.md
GET https://graph.microsoft.com/beta/bookingBusinesses/contosolunchdelivery@cont
[!INCLUDE [sample-code](../includes/snippets/powershell/get-customers-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Bookingbusiness List Customquestions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingbusiness-list-customquestions.md
GET https://graph.microsoft.com/beta/bookingBusinesses/contosolunchdelivery@cont
[!INCLUDE [sample-code](../includes/snippets/powershell/list-bookingcustomquestion-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Bookingbusiness List Services https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingbusiness-list-services.md
GET https://graph.microsoft.com/beta/bookingBusinesses/contosolunchdelivery@cont
[!INCLUDE [sample-code](../includes/snippets/powershell/get-services-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Bookingbusiness List Staffmembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingbusiness-list-staffmembers.md
GET https://graph.microsoft.com/beta/bookingBusinesses/contosolunchdelivery@cont
[!INCLUDE [sample-code](../includes/snippets/powershell/get-staffmembers-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Bookingbusiness List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingbusiness-list.md
Get a collection of [bookingBusiness](../resources/bookingbusiness.md) objects t
This operation returns only the **id** and **displayName** of each Microsoft Bookings business in the collection. For performance considerations, it does not return other properties. You can get the other properties of a Bookings business by specifying its **id** in a [GET](bookingbusiness-get.md) operation.
-You can also query for Bookings businesses by specifying a string in a `query` parameter to do substring matching among the businesses of a tenant. See an [example](#request-2) below.
+You can also query for Bookings businesses by specifying a string in a `query` parameter to do substring matching among the businesses of a tenant. For details, see [Example 2](#example-2-query-parameter).
+
+> **Note:** Results are limited to 500 mailboxes. Pagination of the results is not currently supported.
## Permissions
GET /bookingBusinesses
``` ## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
-
-This method also supports the `query` parameter which accepts a string value. This parameter limits the GET results to businesses that match the specified string. You can see an [example](#request-2) below.
+This method supports some of the [OData query parameters](/graph/query-parameters) to help customize the response.
+This method also supports the `query` parameter which accepts a string value. This parameter limits the GET results to businesses that match the specified string.
## Request headers | Name |Description|
This method also supports the `query` parameter which accepts a string value. Th
Do not supply a request body for this method. ## Response If successful, this method returns a `200 OK` response code and collection of [bookingBusiness](../resources/bookingbusiness.md) objects in the response body.
-## Example
-##### Request 1
+
+## Examples
+
+### Example 1: Get the Bookings buinsesses in a tenant
+
+#### Request
The following example gets the Bookings businesses in a tenant. # [HTTP](#tab/http)
GET https://graph.microsoft.com/beta/bookingBusinesses
[!INCLUDE [sample-code](../includes/snippets/powershell/get-bookingbusinesses-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+
-##### Response 1
+#### Response
The following is an example of the response. <!-- { "blockType": "response",
Content-type: application/json
} ```
-##### Request 2
+### Example 2: Query parameter
+
+#### Request
The following example shows how to use the `query` parameter to get one or more matching Bookings businesses in the tenant.
GET https://graph.microsoft.com/beta/bookingBusinesses?query=Adventure
[!INCLUDE [sample-code](../includes/snippets/powershell/query-bookingbusinesses-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+
-##### Response 2
+#### Response
The following is an example of the response. <!-- { "blockType": "response",
v1.0 Bookingbusiness Post Appointments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingbusiness-post-appointments.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-bookingappointment-from-bookingbusiness-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Bookingbusiness Post Bookingbusinesses https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingbusiness-post-bookingbusinesses.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-bookingbusiness-from-bookingbusinesses-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ In the request body, supply a JSON representation of [bookingBusiness](../resources/bookingbusiness.md) object.
v1.0 Bookingbusiness Post Customers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingbusiness-post-customers.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-bookingcustomer-from-bookingbusiness-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Bookingbusiness Post Customquestions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingbusiness-post-customquestions.md
Content-length: 165
} ```
-# [C#](#tab/csharp)
-
-# [Go](#tab/go)
- # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/create-bookingcustomquestion-from--javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PHP](#tab/php)
- ### Response
v1.0 Bookingbusiness Post Services https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingbusiness-post-services.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-bookingservice-from-bookingbusiness-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Bookingbusiness Publish https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingbusiness-publish.md
POST https://graph.microsoft.com/beta/bookingBusinesses/contosolunchdelivery@con
[!INCLUDE [sample-code](../includes/snippets/powershell/bookingbusiness-publish-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Bookingbusiness Unpublish https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingbusiness-unpublish.md
POST https://graph.microsoft.com/beta/bookingBusinesses/contosolunchdelivery@con
[!INCLUDE [sample-code](../includes/snippets/php/bookingbusiness-unpublish-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Bookingbusiness Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingbusiness-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-bookingbusiness-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Bookingcurrency Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingcurrency-get.md
GET https://graph.microsoft.com/beta/bookingCurrencies/USD
[!INCLUDE [sample-code](../includes/snippets/powershell/get-bookingcurrency-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Bookingcurrency List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingcurrency-list.md
GET https://graph.microsoft.com/beta/bookingCurrencies
[!INCLUDE [sample-code](../includes/snippets/powershell/get-bookingcurrencies-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Bookingcustomer Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingcustomer-delete.md
DELETE https://graph.microsoft.com/beta/bookingBusinesses/contosolunchdelivery@c
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-bookingcustomer-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Bookingcustomer Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingcustomer-get.md
GET https://graph.microsoft.com/beta/bookingBusinesses/contosolunchdelivery@cont
[!INCLUDE [sample-code](../includes/snippets/powershell/get-bookingcustomer-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Bookingcustomer Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingcustomer-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-bookingcustomer-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Bookingcustomquestion Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingcustomquestion-delete.md
DELETE https://graph.microsoft.com/beta/bookingBusinesses/contosolunchdelivery@c
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-bookingcustomquestions-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Bookingcustomquestion Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingcustomquestion-get.md
GET https://graph.microsoft.com/beta/bookingBusinesses/contosolunchdelivery@cont
[!INCLUDE [sample-code](../includes/snippets/powershell/get-bookingcustomquestion-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Bookingcustomquestion Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingcustomquestion-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-bookingcustomquestion-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Bookingservice Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingservice-delete.md
DELETE https://graph.microsoft.com/beta/bookingBusinesses/contosolunchdelivery@c
[!INCLUDE [sample-code](../includes/snippets/php/delete-bookingservice-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Bookingservice Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingservice-get.md
GET https://graph.microsoft.com/beta/bookingBusinesses/contosolunchdelivery@cont
[!INCLUDE [sample-code](../includes/snippets/powershell/get-bookingservice-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Bookingservice Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingservice-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-bookingservice-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Bookingstaffmember Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingstaffmember-delete.md
DELETE https://graph.microsoft.com/beta/bookingBusinesses/contosolunchdelivery@c
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-bookingstaffmember-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Bookingstaffmember Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingstaffmember-get.md
GET https://graph.microsoft.com/beta/bookingBusinesses/contosolunchdelivery@cont
[!INCLUDE [sample-code](../includes/snippets/powershell/get-bookingstaffmember-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Browsersharedcookie Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersharedcookie-get.md
GET https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/1
[!INCLUDE [sample-code](../includes/snippets/php/get-browsersharedcookie-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ ### Response
v1.0 Browsersharedcookie Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersharedcookie-update.md
Content-length: 349
[!INCLUDE [sample-code](../includes/snippets/php/update-browsersharedcookie-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ ### Response
v1.0 Browsersite Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersite-get.md
GET https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/2
[!INCLUDE [sample-code](../includes/snippets/php/get-browsersite-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ ### Response
v1.0 Browsersite Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersite-update.md
Content-length: 387
[!INCLUDE [sample-code](../includes/snippets/php/update-browsersite-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ ### Response
v1.0 Browsersitelist Delete Sharedcookies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-delete-sharedcookies.md
DELETE https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteList
[!INCLUDE [sample-code](../includes/snippets/php/delete-browsersharedcookie-e1-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ #### Response
DELETE https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteList
[!INCLUDE [sample-code](../includes/snippets/php/delete-browsersharedcookie-e2-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ #### Response
v1.0 Browsersitelist Delete Sites https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-delete-sites.md
DELETE https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteList
[!INCLUDE [sample-code](../includes/snippets/php/delete-browsersite-e1-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ #### Response
DELETE https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteList
[!INCLUDE [sample-code](../includes/snippets/php/delete-browsersite-e2-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ #### Response
v1.0 Browsersitelist Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-get.md
GET https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/e
[!INCLUDE [sample-code](../includes/snippets/php/get-browsersitelist-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ ### Response
v1.0 Browsersitelist List Sharedcookies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-list-sharedcookies.md
GET https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/e
[!INCLUDE [sample-code](../includes/snippets/php/list-browsersharedcookie-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ ### Response
v1.0 Browsersitelist List Sites https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-list-sites.md
GET https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/e
[!INCLUDE [sample-code](../includes/snippets/php/list-browsersite-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ ### Response
v1.0 Browsersitelist Post Sharedcookies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-post-sharedcookies.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-browsersharedcookie-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ ### Response
v1.0 Browsersitelist Post Sites https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-post-sites.md
Content-length: 387
[!INCLUDE [sample-code](../includes/snippets/php/create-browsersite-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ ### Response
v1.0 Browsersitelist Publish https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-publish.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/browsersitelist-publish-e1-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/browsersitelist-publish-e2-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Browsersitelist Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-update.md
Content-length: 283
[!INCLUDE [sample-code](../includes/snippets/php/update-browsersitelist-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ ### Response
v1.0 Bundle Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bundle-delete.md
DELETE https://graph.microsoft.com/beta/drive/items/{bundle-id}
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-bundle-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Bundle Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bundle-get.md
GET https://graph.microsoft.com/v1.0/drive/bundles/{bundle-id}
[!INCLUDE [sample-code](../includes/snippets/csharp/get-bundle-metadata-csharp-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [CLI](#tab/cli)
+ # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/get-bundle-metadata-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
GET https://graph.microsoft.com/v1.0/drive/bundles/{bundle-id}
[!INCLUDE [sample-code](../includes/snippets/powershell/get-bundle-metadata-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/v1.0/drive/items/{bundle-id}?expand=children
[!INCLUDE [sample-code](../includes/snippets/csharp/get-bundle-and-children-csharp-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [CLI](#tab/cli)
+ # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/get-bundle-and-children-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
GET https://graph.microsoft.com/v1.0/drive/items/{bundle-id}?expand=children
[!INCLUDE [sample-code](../includes/snippets/powershell/get-bundle-and-children-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Bundle List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bundle-list.md
GET https://graph.microsoft.com/beta/drive/bundles
[!INCLUDE [sample-code](../includes/snippets/powershell/list-all-bundles-e1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/drive/bundles?filter=bundle/album%20ne%20nu
[!INCLUDE [sample-code](../includes/snippets/powershell/list-album-bundles-e2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Bundle Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bundle-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/rename-bundle-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Businessflowtemplate List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/businessflowtemplate-list.md
GET https://graph.microsoft.com/beta/businessFlowTemplates
[!INCLUDE [sample-code](../includes/snippets/powershell/get-businessflowtemplate-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Businessscenario Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/businessscenario-delete.md
DELETE https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c686
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-businessscenario-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Businessscenario Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/businessscenario-get.md
GET https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c686491
[!INCLUDE [sample-code](../includes/snippets/powershell/get-businessscenario-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Businessscenario Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/businessscenario-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-businessscenario-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Businessscenarioplanner Delete Tasks https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/businessscenarioplanner-delete-tasks.md
DELETE https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c686
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-businessscenariotask-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Businessscenarioplanner Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/businessscenarioplanner-get.md
GET https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c686491
[!INCLUDE [sample-code](../includes/snippets/powershell/get-businessscenarioplanner-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Businessscenarioplanner Getplan https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/businessscenarioplanner-getplan.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/businessscenarioplannerthisgetplan-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Businessscenarioplanner List Tasks https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/businessscenarioplanner-list-tasks.md
GET https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c686491
[!INCLUDE [sample-code](../includes/snippets/powershell/list-businessscenariotask-e1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c686491
[!INCLUDE [sample-code](../includes/snippets/powershell/list-businessscenariotask-e2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c686491
[!INCLUDE [sample-code](../includes/snippets/powershell/list-businessscenariotask-e3-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Businessscenarioplanner Post Tasks https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/businessscenarioplanner-post-tasks.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-businessscenariotask-from--powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Businessscenariotask Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/businessscenariotask-get.md
GET https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c686491
[!INCLUDE [sample-code](../includes/snippets/powershell/get-businessscenariotask-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Businessscenariotask Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/businessscenariotask-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-businessscenariotask-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Calendar Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/calendar-delete.md
Here is an example of the request.
DELETE https://graph.microsoft.com/beta/me/calendar ```
-# [C#](#tab/csharp)
-
-# [Go](#tab/go)
- # [Java](#tab/java) [!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
DELETE https://graph.microsoft.com/beta/me/calendar
[!INCLUDE [sample-code](../includes/snippets/javascript/delete-calendar-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PHP](#tab/php)
- ##### Response
v1.0 Calendar Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/calendar-get.md
GET https://graph.microsoft.com/beta/me/calendar
[!INCLUDE [sample-code](../includes/snippets/powershell/get-calendar-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Calendar Getschedule https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/calendar-getschedule.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/calendar-getschedule-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Calendar List Calendarview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/calendar-list-calendarview.md
GET https://graph.microsoft.com/beta/me/calendar/calendarView?startDateTime=2017
[!INCLUDE [sample-code](../includes/snippets/powershell/get-calendarview-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Calendar List Events https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/calendar-list-events.md
GET https://graph.microsoft.com/beta/me/calendar/events
[!INCLUDE [sample-code](../includes/snippets/php/calendar-list-events-for-me-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ ##### Response
GET https://graph.microsoft.com/beta/me/calendar/events?$filter=startsWith(subje
[!INCLUDE [sample-code](../includes/snippets/php/calendar-list-events-for-me-by-subject-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ #### Response
v1.0 Calendar Post Calendarpermissions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/calendar-post-calendarpermissions.md
POST https://graph.microsoft.com/beta/users/458d4c95-124e-49da-ba9d-1dd0387e682e
[!INCLUDE [sample-code](../includes/snippets/php/create-calendarpermission-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Calendar Post Events https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/calendar-post-events.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-event-from-calendar-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-event-from-calendar-with-online-meeting-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Calendar Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/calendar-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-calendar-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Calendargroup Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/calendargroup-delete.md
DELETE https://graph.microsoft.com/beta/me/calendarGroups/{id}
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-calendargroup-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Calendargroup Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/calendargroup-get.md
GET https://graph.microsoft.com/beta/me/calendarGroups/{id}
[!INCLUDE [sample-code](../includes/snippets/powershell/get-calendargroup-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Calendargroup List Calendars https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/calendargroup-list-calendars.md
GET https://graph.microsoft.com/beta/me/calendarGroups/{id}/calendars
[!INCLUDE [sample-code](../includes/snippets/powershell/calendargroup-get-calendars-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Calendargroup Post Calendars https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/calendargroup-post-calendars.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-calendar-from-calendargroup-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ In the request body, supply a JSON representation of [calendar](../resources/calendar.md) object.
v1.0 Calendargroup Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/calendargroup-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-calendargroup-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Calendarpermission Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/calendarpermission-delete.md
DELETE https://graph.microsoft.com/beta/users/{id}/calendar/calendarPermissions/
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-calendarpermission-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Calendarpermission Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/calendarpermission-get.md
GET https://graph.microsoft.com/beta/users/{id}/calendar/calendarPermissions/{id
[!INCLUDE [sample-code](../includes/snippets/powershell/get-calendarpermission-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Calendarpermission Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/calendarpermission-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-calendarpermission-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Call Addlargegalleryview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/call-addlargegalleryview.md
Content-Length: 46
[!INCLUDE [sample-code](../includes/snippets/powershell/addlargegalleryview-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Call Answer https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/call-answer.md
Content-Length: 211
[!INCLUDE [sample-code](../includes/snippets/powershell/call-answer-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/call-answer-app-hosted-media-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Call Cancelmediaprocessing https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/call-cancelmediaprocessing.md
Content-Length: 62
[!INCLUDE [sample-code](../includes/snippets/powershell/call-cancelmediaprocessing-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Call Changescreensharingrole https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/call-changescreensharingrole.md
Content-Length: 24
[!INCLUDE [sample-code](../includes/snippets/php/call-changescreensharingrole-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Call Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/call-delete.md
DELETE https://graph.microsoft.com/beta/communications/calls/57dab8b1-894c-409a-
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-call-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Call Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/call-get.md
GET https://graph.microsoft.com/beta/communications/calls/{id}
[!INCLUDE [sample-code](../includes/snippets/powershell/get-call-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
GET https://graph.microsoft.com/beta/communications/calls/2f1a1100-b174-40a0-aba
[!INCLUDE [sample-code](../includes/snippets/powershell/get-call-2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Call Keepalive https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/call-keepalive.md
POST https://graph.microsoft.com/beta/communications/calls/2e1a0b00-2db4-4022-95
[!INCLUDE [sample-code](../includes/snippets/powershell/keep-alive-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Call List Audioroutinggroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/call-list-audioroutinggroups.md
GET https://graph.microsoft.com/beta/communications/calls/{id}/audioRoutingGroup
[!INCLUDE [sample-code](../includes/snippets/powershell/get-audioroutinggroups-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Call List Contentsharingsessions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/call-list-contentsharingsessions.md
GET https://graph.microsoft.com/beta/communications/calls/7531d31f-d10d-44de-802
[!INCLUDE [sample-code](../includes/snippets/powershell/get-contentsharingsessions-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ <!-- markdownlint-disable MD024 -->
v1.0 Call List Participants https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/call-list-participants.md
GET https://graph.microsoft.com/beta/communications/calls/7531d31f-d10d-44de-802
[!INCLUDE [sample-code](../includes/snippets/powershell/get-participants-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ <!-- markdownlint-disable MD024 -->
v1.0 Call Mute https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/call-mute.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/call-mute-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Call Playprompt https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/call-playprompt.md
Content-Length: 166
[!INCLUDE [sample-code](../includes/snippets/powershell/call-playprompt-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Call Post Audioroutinggroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/call-post-audioroutinggroups.md
Content-Length: 233
[!INCLUDE [sample-code](../includes/snippets/powershell/create-audioroutinggroup-from-call-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ In the request body, supply a JSON representation of [audioRoutingGroup](../resources/audioroutinggroup.md) object.
v1.0 Call Record https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/call-record.md
Content-Length: 394
[!INCLUDE [sample-code](../includes/snippets/powershell/call-recordresponse-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Call Redirect https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/call-redirect.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/call-redirect-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Call Reject https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/call-reject.md
Content-Length: 24
[!INCLUDE [sample-code](../includes/snippets/powershell/call-reject-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
Content-Length: 24
[!INCLUDE [sample-code](../includes/snippets/powershell/call-reject-none-reason-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Call Subscribetotone https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/call-subscribetotone.md
Content-Length: 46
[!INCLUDE [sample-code](../includes/snippets/powershell/call-subscribetotone-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Call Transfer https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/call-transfer.md
Content-Length: 430
[!INCLUDE [sample-code](../includes/snippets/powershell/call-transfer-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/call-transfer-2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Length: 430
[!INCLUDE [sample-code](../includes/snippets/powershell/call-transfer-3-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/call-transfer-4-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Length: 430
[!INCLUDE [sample-code](../includes/snippets/powershell/call-transfer-5-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Call Unmute https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/call-unmute.md
Content-Length: 46
[!INCLUDE [sample-code](../includes/snippets/powershell/call-unmute-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Call Updaterecordingstatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/call-updaterecordingstatus.md
Content-Length: 79
[!INCLUDE [sample-code](../includes/snippets/powershell/call-updaterecordingstatus-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Callrecords Callrecord Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/callrecords-callrecord-get.md
GET https://graph.microsoft.com/beta/communications/callRecords/{id}
[!INCLUDE [sample-code](../includes/snippets/powershell/get-callrecord-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/communications/callRecords/{id}?$expand=ses
[!INCLUDE [sample-code](../includes/snippets/powershell/get-callrecord-expanded-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-type: application/json
"startDateTime": "2020-02-25T18:52:21.2169889Z", "endDateTime": "2020-02-25T18:52:46.7640013Z", "id": "e523d2ed-2966-4b6b-925b-754a88034cc5",
+ "isTest": false,
"caller": { "@odata.type": "#microsoft.graph.callRecords.participantEndpoint",
+ "name": "machineName_2",
+ "cpuName": "Intel(R) Xeon(R) Platinum 8272CL CPU @ 2.60GHz",
+ "cpuCoresCount": 2,
+ "cpuProcessorSpeedInMhz": 2594,
"userAgent": { "@odata.type": "#microsoft.graph.callRecords.clientUserAgent", "headerValue": "RTCC/7.0.0.0 UCWA/7.0.0.0 AndroidLync/6.25.0.27 (SM-G930U Android 8.0.0)",
Content-type: application/json
}, "callee": { "@odata.type": "#microsoft.graph.callRecords.participantEndpoint",
+ "name": "machineName_4",
+ "cpuName": "Intel(R) Xeon(R) CPU E5-2673 v4 @ 2.30GHz",
+ "cpuCoresCount": 8,
+ "cpuProcessorSpeedInMhz": 2295,
"userAgent": { "@odata.type": "#microsoft.graph.callRecords.clientUserAgent", "headerValue": "UCCAPI/16.0.12527.20122 OC/16.0.12527.20194 (Skype for Business)",
Content-type: application/json
"id": "e523d2ed-2966-4b6b-925b-754a88034cc5", "caller": { "@odata.type": "#microsoft.graph.callRecords.participantEndpoint",
+ "name": "machineName_4",
+ "cpuName": "Intel(R) Xeon(R) CPU E5-2673 v4 @ 2.30GHz",
+ "cpuCoresCount": 8,
+ "cpuProcessorSpeedInMhz": 2295,
"userAgent": { "@odata.type": "#microsoft.graph.callRecords.clientUserAgent", "headerValue": "RTCC/7.0.0.0 UCWA/7.0.0.0 AndroidLync/6.25.0.27 (SM-G930U Android 8.0.0)",
Content-type: application/json
}, "callee": { "@odata.type": "#microsoft.graph.callRecords.participantEndpoint",
+ "name": "machineName_6",
+ "cpuName": "Intel(R) Xeon(R) CPU E5-2673 v4 @ 2.30GHz",
+ "cpuCoresCount": 8,
+ "cpuProcessorSpeedInMhz": 2295,
"userAgent": { "@odata.type": "#microsoft.graph.callRecords.clientUserAgent", "headerValue": "UCCAPI/16.0.12527.20122 OC/16.0.12527.20194 (Skype for Business)",
Content-type: application/json
"averageBandwidthEstimate": 9965083, "wasMediaBypassed": false, "averageAudioNetworkJitter": "PT0.043S",
- "maxAudioNetworkJitter": "PT0.046S"
+ "maxAudioNetworkJitter": "PT0.046S",
+ "rmsFreezeDuration": null,
+ "averageFreezeDuration": null,
+ "isAudioForwardErrorCorrectionUsed": false
}, { "streamId": "1785122252",
Content-type: application/json
"averageBandwidthEstimate": 15644878, "wasMediaBypassed": false, "averageAudioNetworkJitter": "PT0.266S",
- "maxAudioNetworkJitter": "PT0.474S"
+ "maxAudioNetworkJitter": "PT0.474S",
+ "rmsFreezeDuration": null,
+ "averageFreezeDuration": null,
+ "isAudioForwardErrorCorrectionUsed": null
} ] }
v1.0 Callrecords Callrecord Getdirectroutingcalls https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/callrecords-callrecord-getdirectroutingcalls.md
GET https://graph.microsoft.com/beta/communications/callRecords/getDirectRouting
[!INCLUDE [sample-code](../includes/snippets/php/callrecord-getdirectroutingcalls-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Callrecords Callrecord Getpstnblockeduserslog https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/callrecords-callrecord-getpstnblockeduserslog.md
GET https://graph.microsoft.com/beta/communications/callRecords/getPstnBlockedUs
[!INCLUDE [sample-code](../includes/snippets/powershell/callrecordthisgetpstnblockeduserslog-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Callrecords Callrecord Getpstncalls https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/callrecords-callrecord-getpstncalls.md
GET https://graph.microsoft.com/beta/communications/callRecords/getPstnCalls(fro
[!INCLUDE [sample-code](../includes/snippets/php/callrecord-getpstncalls-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
HTTP/1.1 200 OK
"inventoryType": "Subscriber", "operator": "Microsoft", "callDurationSource": "microsoft",
- "otherPartyCountryCode": "US"
+ "otherPartyCountryCode": "US",
+ "clientPublicIpV4Address": "99.76.33.16",
+ "clientPublicIpV6Address": "1234:fd2:5621:1:89::4500",
+ "clientLocalIpV4Address": "192.168.1.165",
+ "clientLocalIpV6Address": "2600:1700:1dca:8110::40"
} ] }
v1.0 Callrecords Callrecord Getpstnonlinemeetingdialoutreport https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/callrecords-callrecord-getpstnonlinemeetingdialoutreport.md
GET https://graph.microsoft.com/beta/communications/callRecords/getPstnOnlineMee
[!INCLUDE [sample-code](../includes/snippets/powershell/callrecordthisgetpstnonlinemeetingdialoutreport-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Callrecords Callrecord Getsmslog https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/callrecords-callrecord-getsmslog.md
GET https://graph.microsoft.com/beta
[!INCLUDE [sample-code](../includes/snippets/php/callrecordthisgetsmslog-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Callrecords Session List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/callrecords-session-list.md
GET https://graph.microsoft.com/beta/communications/callRecords/{id}/sessions
[!INCLUDE [sample-code](../includes/snippets/powershell/get-callrecord-sessions-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-type: application/json
], "startDateTime": "2020-02-25T18:52:21.2169889Z", "endDateTime": "2020-02-25T18:52:46.7640013Z",
+ "isTest": false,
"caller": { "@odata.type": "#microsoft.graph.callRecords.participantEndpoint",
+ "name": "machineName_1",
+ "cpuName": "AMD EPYC 7452 32-Core Processor",
+ "cpuCoresCount": 8,
+ "cpuProcessorSpeedInMhz": 2346,
"userAgent": { "@odata.type": "#microsoft.graph.callRecords.clientUserAgent", "headerValue": "RTCC/7.0.0.0 UCWA/7.0.0.0 AndroidLync/6.25.0.27 (SM-G930U Android 8.0.0)",
Content-type: application/json
}, "callee": { "@odata.type": "#microsoft.graph.callRecords.participantEndpoint",
+ "name": "machineName_2",
+ "cpuName": "Intel(R) Xeon(R) Platinum 8272CL CPU @ 2.60GHz",
+ "cpuCoresCount": 2,
+ "cpuProcessorSpeedInMhz": 2594,
"userAgent": { "@odata.type": "#microsoft.graph.callRecords.clientUserAgent", "headerValue": "UCCAPI/16.0.12527.20122 OC/16.0.12527.20194 (Skype for Business)",
GET https://graph.microsoft.com/beta/communications/callRecords/{id}/sessions?$e
[!INCLUDE [sample-code](../includes/snippets/powershell/get-callrecord-sessions-expanded-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-type: application/json
], "startDateTime": "2020-02-25T18:52:21.2169889Z", "endDateTime": "2020-02-25T18:52:46.7640013Z",
+ "isTest": false,
"caller": { "@odata.type": "#microsoft.graph.callRecords.participantEndpoint",
+ "name": "machineName_1",
+ "cpuName": "AMD EPYC 7452 32-Core Processor",
+ "cpuCoresCount": 8,
+ "cpuProcessorSpeedInMhz": 2346,
"userAgent": { "@odata.type": "#microsoft.graph.callRecords.clientUserAgent", "headerValue": "RTCC/7.0.0.0 UCWA/7.0.0.0 AndroidLync/6.25.0.27 (SM-G930U Android 8.0.0)",
Content-type: application/json
}, "callee": { "@odata.type": "#microsoft.graph.callRecords.participantEndpoint",
+ "name": "machineName_2",
+ "cpuName": "Intel(R) Xeon(R) Platinum 8272CL CPU @ 2.60GHz",
+ "cpuCoresCount": 2,
+ "cpuProcessorSpeedInMhz": 2594,
"userAgent": { "@odata.type": "#microsoft.graph.callRecords.clientUserAgent", "headerValue": "UCCAPI/16.0.12527.20122 OC/16.0.12527.20194 (Skype for Business)",
Content-type: application/json
"id": "e523d2ed-2966-4b6b-925b-754a88034cc5", "caller": { "@odata.type": "#microsoft.graph.callRecords.participantEndpoint",
+ "name": "machineName_1",
+ "cpuName": "AMD EPYC 7452 32-Core Processor",
+ "cpuCoresCount": 8,
+ "cpuProcessorSpeedInMhz": 2346,
"userAgent": { "@odata.type": "#microsoft.graph.callRecords.clientUserAgent", "headerValue": "RTCC/7.0.0.0 UCWA/7.0.0.0 AndroidLync/6.25.0.27 (SM-G930U Android 8.0.0)",
Content-type: application/json
}, "callee": { "@odata.type": "#microsoft.graph.callRecords.participantEndpoint",
+ "name": "machineName_2",
+ "cpuName": "Intel(R) Xeon(R) Platinum 8272CL CPU @ 2.60GHz",
+ "cpuCoresCount": 2,
"userAgent": { "@odata.type": "#microsoft.graph.callRecords.clientUserAgent", "headerValue": "UCCAPI/16.0.12527.20122 OC/16.0.12527.20194 (Skype for Business)",
Content-type: application/json
"averageBandwidthEstimate": 9965083, "wasMediaBypassed": false, "averageAudioNetworkJitter": "PT0.043S",
- "maxAudioNetworkJitter": "PT0.046S"
+ "maxAudioNetworkJitter": "PT0.046S",
+ "rmsFreezeDuration": null,
+ "averageFreezeDuration": null,
+ "isAudioForwardErrorCorrectionUsed": true
}, { "streamId": "1785122252",
Content-type: application/json
"averageBandwidthEstimate": 15644878, "wasMediaBypassed": false, "averageAudioNetworkJitter": "PT0.266S",
- "maxAudioNetworkJitter": "PT0.474S"
+ "maxAudioNetworkJitter": "PT0.474S",
+ "rmsFreezeDuration": null,
+ "averageFreezeDuration": null,
+ "isAudioForwardErrorCorrectionUsed": false
} ] }
v1.0 Calltranscript Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/calltranscript-get.md
If successful, this method returns a `200 OK` response code and a [callTranscrip
## Examples > [!NOTE]
-> The docx format for transcripts will be deprecated starting May 31, 2023.
+> The docx format for transcripts is deprecated as of May 31, 2023.
### Example 1: Get a callTranscript #### Request
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/
[!INCLUDE [sample-code](../includes/snippets/powershell/get-calltranscript-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/
[!INCLUDE [sample-code](../includes/snippets/powershell/get-calltranscript-content-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/
[!INCLUDE [sample-code](../includes/snippets/powershell/get-calltranscript-content-format-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] --
-#### Response
-
-Response contains bytes for the transcript in the body. `content-type` header specifies type of the transcript content.
->**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "stream"
-}
>
-```http
-HTTP/1.1 200 OK
-Content-type: text/vtt
-
-WEBVTT
-
-0:0:0.0 --> 0:0:5.320
-<v User Name>This is a transcript test.</v>
-```
-
-### Example 4: Get a callTranscript content specifying Accept header
-
->**Note:** The docx format and `Accept` header will be deprecated starting May 31, 2023.
-
-#### Request
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "get_callTranscript_content_Accept",
- "sampleKeys": ["ba321e0d-79ee-478d-8e28-85a19507f456", "MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ", "MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4"]
-}
>
-``` http
-GET https://graph.microsoft.com/bethkLWFkNDItOTE2ZDNmZjkwZGY4/content
-Accept: application/vnd.openxmlformats-officedocument.wordprocessingml.document
-```
-
-# [C#](#tab/csharp)
-
-# [Go](#tab/go)
-
-# [Java](#tab/java)
-
-# [JavaScript](#tab/javascript)
-
-# [PHP](#tab/php)
-
-# [PowerShell](#tab/powershell)
---
-#### Response
-
-Response contains bytes for the transcript in the body. `Content-Type` header specifies type of the transcript content.
->**Note:** The response object shown here might be shortened for readability.
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "stream"
-}
>
-```http
-HTTP/1.1 200 OK
-Content-type: application/vnd.openxmlformats-officedocument.wordprocessingml.document
-
-0:0:0.0 --> 0:0:5.320
-User Name
-This is a transcript test.
-```
-### Example 5: Get a callTranscript content with $format getting precedence over the Accept header
-
->**Note:** The docx format and `$format` query parameter will be deprecated starting May 31, 2023.
-
-#### Request
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "get_callTranscript_content_format_precedence",
- "sampleKeys": ["ba321e0d-79ee-478d-8e28-85a19507f456", "MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ", "MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4"]
-}
>
-``` http
-GET https://graph.microsoft.com/bethkLWFkNDItOTE2ZDNmZjkwZGY4/content?$format=text/vtt
-Accept: application/vnd.openxmlformats-officedocument.wordprocessingml.document
-```
-
-# [C#](#tab/csharp)
-
-# [Go](#tab/go)
-
-# [Java](#tab/java)
-
-# [JavaScript](#tab/javascript)
-
-# [PHP](#tab/php)
-
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] #### Response
-Response contains bytes for the transcript in the body. `Content-Type` header specifies type of the transcript content.
+Response contains bytes for the transcript in the body. `content-type` header specifies type of the transcript content.
>**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response",
WEBVTT
<v User Name>This is a transcript test.</v> ```
-### Example 6: Get a callTranscript metadataContent
+### Example 4: Get a callTranscript metadataContent
#### Request # [HTTP](#tab/http) <!-- {   "blockType": "request",
-  "name": "get_callTranscript_metadatacontent"
+  "name": "get_callTranscript_metadatacontent",
+ "sampleKeys": ["ba321e0d-79ee-478d-8e28-85a19507f456", "MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ", "MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4"]
} --> ``` http
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)+
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Certificatebasedauthconfiguration Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/certificatebasedauthconfiguration-delete.md
DELETE https://graph.microsoft.com/beta/organization/{id}/certificateBasedAuthCo
[!INCLUDE [sample-code](../includes/snippets/php/delete-certificatebasedauthconfiguration-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ ### Response
v1.0 Certificatebasedauthconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/certificatebasedauthconfiguration-get.md
GET https://graph.microsoft.com/beta/organization/{id}/certificateBasedAuthConfi
[!INCLUDE [sample-code](../includes/snippets/powershell/get-certificatebasedauthconfiguration-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Certificatebasedauthconfiguration List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/certificatebasedauthconfiguration-list.md
GET https://graph.microsoft.com/beta/organization/{id}/certificateBasedAuthConfi
[!INCLUDE [sample-code](../includes/snippets/powershell/get-certificatebasedauthconfigurations-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Certificatebasedauthconfiguration Post Certificatebasedauthconfiguration https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/certificatebasedauthconfiguration-post-certificatebasedauthconfiguration.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-certificatebasedauthconfiguration-from-certificatebasedauthconfiguration-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ ### Response
v1.0 Channel Completemigration https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-completemigration.md
POST https://graph.microsoft.com/beta/teams/57fb72d0-d811-46f4-8947-305e6072eaa5
[!INCLUDE [sample-code](../includes/snippets/powershell/completemigration-channel-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ <!-- markdownlint-disable MD001 -->
v1.0 Channel Delete Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-delete-members.md
DELETE https://graph.microsoft.com/beta/teams/ece6f0a1-7ca4-498b-be79-edf6c8fc4d
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-channel-member-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Channel Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-delete.md
DELETE https://graph.microsoft.com/beta/teams/{id}/channels/{id}
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-channel-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Channel Get Filesfolder https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-get-filesfolder.md
GET https://graph.microsoft.com/beta/teams/{id}/channels/{id}/filesFolder
[!INCLUDE [sample-code](../includes/snippets/powershell/get-filesfolder-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Channel Get Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-get-members.md
GET https://graph.microsoft.com/beta/teams/ece6f0a1-7ca4-498b-be79-edf6c8fc4d82/
[!INCLUDE [sample-code](../includes/snippets/powershell/channel-get-member-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Channel Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-get.md
GET /teams/{team-id}/channels/{channel-id}
This method supports the `$filter` and `$select` [OData query parameters](/graph/query-parameters) to help customize the response.
+>**Note:** The summary property can only be retrieved via the `select` parameter, as shown in Example 2 in this topic.
+ ## Request headers | Header | Value |
Do not supply a request body for this method.
If successful, this method returns a `200 OK` response code and a [channel](../resources/channel.md) object in the response body.
-## Example
+## Examples
+
+### Example 1: Get a channel
-### Request
+#### Request
-Here is an example of the request.
+The following example shows a request.
# [HTTP](#tab/http) <!-- { "blockType": "request",
- "name": "get_channel",
+ "name": "get_channel_beta_e1",
"sampleKeys": ["893075dd-2487-4122-925f-022c42e20265", "19:561fbdbbfca848a484f0a6f00ce9dbbd@thread.tacv2"] }--> ```msgraph-interactive
GET https://graph.microsoft.com/beta/teams/893075dd-2487-4122-925f-022c42e20265/
``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-### Response
+#### Response
-Here is an example of the response.
+The following example shows the response.
>**Note:** The response object shown here might be shortened for readability.
Content-type: application/json
} ```
+The following example shows the response for a standard channel with channel moderation off.
-Here is an example of the response for a standard channel with channel moderation off.
-
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.channel"
+} -->
```http HTTP/1.1 200 OK
HTTP/1.1 200 OK
} ```
-Here is an example of the response for a standard channel with channel moderation on.
+The following example shows the response for a standard channel with channel moderation on.
>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.channel"
+} -->
```http HTTP/1.1 200 OK Content-type: application/json
Content-type: application/json
} ```
-Here is an example of the response for a private channel.
+The following example shows the response for a private channel.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.channel"
+} -->
```http HTTP/1.1 200 OK Content-type: application/json
Content-type: application/json
} ```
+### Example 2: Get a channelSummary property
+
+#### Request
+
+The following example shows a request to get the **channelSummary** property.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_channelsummary_beta_e2",
+ "sampleKeys": ["893075dd-2487-4122-925f-022c42e20265", "19:561fbdbbfca848a484f0a6f00ce9dbbd@thread.tacv2"]
+}-->
+
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/teams/893075dd-2487-4122-925f-022c42e20265/channels/19:561fbdbbfca848a484f0a6f00ce9dbbd@thread.tacv2?$select=summary
+```
+
+# [C#](#tab/csharp)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [Python](#tab/python)
+++
+#### Response
+
+The following example shows the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.channelSummary"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#teams('8bb12236-b929-42e0-94a0-1c417466ebf8')/channels(summary)/$entity",
+ "summary":{
+ "hasMembersFromOtherTenants":false,
+ "guestsCount":1,
+ "membersCount":3,
+ "ownersCount":2
+ }
+}
+```
<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!--
Content-type: application/json
] } -->--
v1.0 Channel Getallmessages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-getallmessages.md
The following permissions are required to call this API. To learn more, includin
|Delegated (personal Microsoft account) | Not supported | |Application | ChannelMessage.Read.All |
-> [!NOTE]
-> Before calling this API with application permissions, you must request access. For details, see [Protected APIs in Microsoft Teams](/graph/teams-protected-apis).
- ## HTTP request <!-- { "blockType": "ignored" } -->
GET https://graph.microsoft.com/beta/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/
[!INCLUDE [sample-code](../includes/snippets/php/get-allchannelmessages-1-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Channel List Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-list-members.md
GET https://graph.microsoft.com/beta/teams/2ab9c796-2902-45f8-b712-7c5a63cf41c4/
[!INCLUDE [sample-code](../includes/snippets/powershell/channel-list-member-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Channel List Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-list-messages.md
One of the following permissions is required to call this API. To learn more, in
[!INCLUDE [teamwork-permissions-note](../../../includes/teamwork-permissions-note.md)]
-> [!NOTE]
-> Before calling this API with application permissions, you must request access. For details, see [Protected APIs in Microsoft Teams](/graph/teams-protected-apis).
- ## HTTP request <!-- { "blockType": "ignored" } -->
GET https://graph.microsoft.com/beta/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/
[!INCLUDE [sample-code](../includes/snippets/powershell/get-listchannelmessages-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
Prefer: include-unknown-enum-members
[!INCLUDE [snippet-not-available](../includes/snippets/snippet-not-available.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/
[!INCLUDE [sample-code](../includes/snippets/powershell/get-listchannelmessages-3-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Channel List Tabs https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-list-tabs.md
Namespace: microsoft.graph
Retrieve the list of [tabs](../resources/teamstab.md) in the specified [channel](../resources/channel.md) within a [team](../resources/team.md).
-> **Note**: The Files tab is native to a channel or chat and is not returned by this API.
+> **Note**: The Files tab is native to a channel or chat and isn't returned by this 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).
Do not supply a request body for this method.
## Response If successful, this method returns a `200 OK` response code and collection of [tabs](../resources/teamstab.md) objects in the response body.
+> **Note**: The Files tab is native to a channel or chat and isn't returned by this API.
+ ## Examples ### Example 1: List all the tabs in the channel along with associated Teams app
GET https://graph.microsoft.com/beta/teams/6903fa93-605b-43ef-920e-77c4729f8258/
[!INCLUDE [sample-code](../includes/snippets/powershell/list-tabs-in-channel-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response The following is an example of the response.
->**Note:** The response object shown here might be shortened for readability.
+> **Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response",
GET https://graph.microsoft.com/beta/teams/6903fa93-605b-43ef-920e-77c4729f8258/
[!INCLUDE [sample-code](../includes/snippets/powershell/list-tabs-in-channel-app-filter-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response The following is an example of the response.
->**Note:** The response object shown here might be shortened for readability.
+> **Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response",
v1.0 Channel List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-list.md
GET https://graph.microsoft.com/beta/teams/893075dd-2487-4122-925f-022c42e20265/
[!INCLUDE [sample-code](../includes/snippets/php/list-channels-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
GET https://graph.microsoft.com/beta/teams/64c323f2-226a-4e64-8ba4-3e6e3f7b9330/
[!INCLUDE [sample-code](../includes/snippets/php/list-private-channels-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
GET https://graph.microsoft.com/beta/teams/6a720ba5-7373-463b-bc9f-4cd04b5c6742/
[!INCLUDE [sample-code](../includes/snippets/php/list-shared-channels-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Channel Patch https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-patch.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/patch-channel-with-moderationsettings-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Channel Post Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-post-members.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/channel-add-member-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/channel-add-member-2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-type: application/json
{ "@odata.context": "https://graph.microsoft.com/beta/$metadata#teams('ece6f0a1-7ca4-498b-be79-edf6c8fc4d82')/channels('19%3A56eb04e133944cf69e603c5dac2d292e%40thread.skype')/members/microsoft.graph.aadUserConversationMember/$entity", "@odata.type": "#microsoft.graph.aadUserConversationMember",
- "id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
+ "id": "ZWUwZjVhZTItOGJjNi00YWU1LTg0NjYtN2RhZWViYmZhMDYyIyM3Mzc2MWYwNi0yYWM5LTQ2OWMtOWYxMC0yNzlhOGNjMjY3Zjk=",
"roles": ["owner"], "displayName": "John Doe", "userId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/channel-add-member-3-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-type: application/json
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell)+
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/shared-channel-add-x-tenant-member-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/channel-add-member-e6-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Channel Post Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-post-messages.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/post-channelmessage-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
POST https://graph.microsoft.com/beta/teams/57fb72d0-d811-46f4-8947-305e6072eaa5
[!INCLUDE [snippet-not-available](../includes/snippets/snippet-not-available.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
POST https://graph.microsoft.com/beta/teams/57fb72d0-d811-46f4-8947-305e6072eaa5
[!INCLUDE [snippet-not-available](../includes/snippets/snippet-not-available.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Channel Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-post.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-channel-from-group-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-private-channel-with-member-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-channel-for-migration-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-channel-with-moderation-settings-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-private-channel-upn-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-shared-channel-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Channel Provisionemail https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-provisionemail.md
Microsoft Teams doesn't automatically provision an email address for a **channel
To remove the email address of a **channel**, use the [removeEmail](channel-removeemail.md) method.
+> **Notes**:
+> This API works differently in one or more national clouds. For details, see [Implementation differences in national clouds](/graph/teamwork-national-cloud-differences).
+ ## Permissions 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 https://graph.microsoft.com/beta/teams/893075dd-2487-4122-925f-022c42e20265
[!INCLUDE [sample-code](../includes/snippets/powershell/channel-provisionemail-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Channel Removeemail https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-removeemail.md
POST https://graph.microsoft.com/beta/teams/893075dd-2487-4122-925f-022c42e20265
[!INCLUDE [sample-code](../includes/snippets/powershell/channel-removeemail-e1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Channel Update Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-update-members.md
content-length: 26
[!INCLUDE [sample-code](../includes/snippets/powershell/update-member-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Chart Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chart-delete.md
DELETE https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/worksheets/
[!INCLUDE [sample-code](../includes/snippets/php/chart-delete-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chart Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chart-get.md
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/worksheets/{id
[!INCLUDE [sample-code](../includes/snippets/php/get-chart-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chart List Series https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chart-list-series.md
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/worksheets/{id
[!INCLUDE [sample-code](../includes/snippets/php/get-series-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chart List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chart-list.md
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/worksheets/{id
[!INCLUDE [sample-code](../includes/snippets/php/get-chartcollection-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chart Post Series https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chart-post-series.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-chartseries-from-chart-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ In the request body, supply a JSON representation of [workbookChartSeries](../resources/workbookchartseries.md) object.
v1.0 Chart Setdata https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chart-setdata.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/chart-setdata-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chart Setposition https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chart-setposition.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/chart-setposition-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chart Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chart-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-chart-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chartaxis Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartaxis-get.md
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/worksheets/{id
[!INCLUDE [sample-code](../includes/snippets/php/get-chartaxis-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chartaxis Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartaxis-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-chartaxis-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chartaxistitle Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartaxistitle-get.md
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/worksheets/{id
[!INCLUDE [sample-code](../includes/snippets/php/get-chartaxistitle-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chartaxistitle Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartaxistitle-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-chartaxistitle-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chartcollection Add https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartcollection-add.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/chartcollection-add-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chartcollection Itemat https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartcollection-itemat.md
Content-type: application/json
} ```
-# [C#](#tab/csharp)
-
-# [Go](#tab/go)
- # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/chartcollection-itemat-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PHP](#tab/php)
- ##### Response
v1.0 Chartdatalabels Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartdatalabels-get.md
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/worksheets/{id
[!INCLUDE [sample-code](../includes/snippets/php/get-chartdatalabels-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chartdatalabels Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartdatalabels-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-chartdatalabels-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chartfill Clear https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartfill-clear.md
POST https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/worksheets/{i
[!INCLUDE [sample-code](../includes/snippets/php/chartfill-clear-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chartfill Setsolidcolor https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartfill-setsolidcolor.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/chartfill-setsolidcolor-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chartfont Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartfont-get.md
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/worksheets/{id
[!INCLUDE [sample-code](../includes/snippets/php/get-chartfont-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chartfont Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartfont-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-chartfont-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chartgridlines Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartgridlines-get.md
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/worksheets/{id
[!INCLUDE [sample-code](../includes/snippets/php/get-chartgridlines-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chartgridlines Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartgridlines-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-chartgridlines-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chartlegend Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartlegend-get.md
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/worksheets/{id
[!INCLUDE [sample-code](../includes/snippets/php/get-chartlegend-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chartlegend Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartlegend-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-chartlegend-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chartlineformat Clear https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartlineformat-clear.md
POST https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/worksheets/{i
[!INCLUDE [sample-code](../includes/snippets/php/chartlineformat-clear-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chartlineformat Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartlineformat-get.md
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/worksheets/{id
[!INCLUDE [sample-code](../includes/snippets/php/get-chartlineformat-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chartlineformat Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartlineformat-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-chartlineformat-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chartpoint Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartpoint-get.md
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/worksheets/{id
[!INCLUDE [sample-code](../includes/snippets/php/get-chartpoint-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chartpoint List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartpoint-list.md
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/worksheets/{id
[!INCLUDE [sample-code](../includes/snippets/php/get-chartpointscollection-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chartpointscollection Itemat https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartpointscollection-itemat.md
Content-type: application/json
} ```
-# [C#](#tab/csharp)
-
-# [Go](#tab/go)
- # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/chartpointscollection-itemat-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PHP](#tab/php)
- ##### Response
v1.0 Chartseries Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartseries-get.md
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/worksheets/{id
[!INCLUDE [sample-code](../includes/snippets/php/get-chartseries-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chartseries List Points https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartseries-list-points.md
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/worksheets/{id
[!INCLUDE [sample-code](../includes/snippets/php/get-points-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chartseries List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartseries-list.md
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/worksheets/{id
[!INCLUDE [sample-code](../includes/snippets/php/get-chartseriescollection-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chartseries Post Points https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartseries-post-points.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/create-chartpoints-from-chartseries-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ In the request body, supply a JSON representation of [workbookChartPoint](../resources/workbookchartpoint.md) object.
v1.0 Chartseries Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartseries-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-chartseries-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chartseriescollection Itemat https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chartseriescollection-itemat.md
Content-type: application/json
} ```
-# [C#](#tab/csharp)
-
-# [Go](#tab/go)
- # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/chartseriescollection-itemat-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PHP](#tab/php)
- ##### Response
v1.0 Charttitle Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/charttitle-get.md
GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/worksheets/{id
[!INCLUDE [sample-code](../includes/snippets/php/get-charttitle-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Charttitle Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/charttitle-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/php/update-charttitle-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ##### Response
v1.0 Chat Delete Installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-delete-installedapps.md
DELETE https://graph.microsoft.com/beta/chats/19:ea28e88c00e94c7786b065394a61f29
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-installedapps-in-chat-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Chat Delete Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-delete-members.md
DELETE https://graph.microsoft.com/beta/chats/19:cf66807577b149cca1b7af0c32eec12
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-members-from-chat-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Chat Delete Pinnedmessages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-delete-pinnedmessages.md
DELETE https://graph.microsoft.com/beta/chats/19:cf66807577b149cca1b7af0c32eec12
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-pinnedchatmessageinfo-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Chat Delete Tabs https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-delete-tabs.md
DELETE https://graph.microsoft.com/beta/chats/19:ea28e88c00e94c7786b065394a61f29
[!INCLUDE [sample-code](../includes/snippets/powershell/delete-tab-in-chat-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Chat Get Installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-get-installedapps.md
GET https://graph.microsoft.com/beta/chats/19:d65713bc498c4a428c71ef9353e6ce20@t
[!INCLUDE [sample-code](../includes/snippets/powershell/get-installedapps-in-chat-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
The following example gets the list of any [resource-specific permissions that w
<!-- { "blockType": "request", "name": "get_installedApps_in_chat_select_consentedPermissionSet",
- "sampleKeys": ["19%5bd86ec7f6b247d3b9e519b0bfef5d03%40thread.v2"]
+ "sampleKeys": ["19%5bd86ec7f6b247d3b9e519b0bfef5d03%40thread.v2", "MTk6NWJkODZlYzdmNmIyNDdkM2I5ZTUxOWIwYmZlZjVkMDNAdGhyZWFkLnYyIyMyYjUyNGUyOC05NWNlLTRjOWItOTc3My00YTViZDZlYzE3NzA="]
} -->
GET https://graph.microsoft.com/beta/chats/19%5bd86ec7f6b247d3b9e519b0bfef5d03%4
[!INCLUDE [sample-code](../includes/snippets/powershell/get-installedapps-in-chat-select-consentedpermissionset-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Chat Get Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-get-members.md
One of the following permissions is required to call this API. To learn more, in
> **Note**: Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent).
-> [!NOTE]
-> Before calling this API with application permissions, you must request access. For details, see [Protected APIs in Microsoft Teams](/graph/teams-protected-apis).
- ## HTTP request <!-- { "blockType": "ignored" } --> ```http
GET https://graph.microsoft.com/beta/chats/19:b8577894a63548969c5c92bb9c80c5e1@t
[!INCLUDE [sample-code](../includes/snippets/powershell/get-conversation-member-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Chat Get Tabs https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-get-tabs.md
GET https://graph.microsoft.com/beta/chats/19:ea28e88c00e94c7786b065394a61f296@t
[!INCLUDE [sample-code](../includes/snippets/powershell/get-tab-in-chat-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Chat Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-get.md
GET https://graph.microsoft.com/beta/chats/19:b8577894a63548969c5c92bb9c80c5e1@t
[!INCLUDE [sample-code](../includes/snippets/powershell/get-group-chat-e1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/
[!INCLUDE [sample-code](../includes/snippets/powershell/get-chat-e2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/chats/19:b8577894a63548969c5c92bb9c80c5e1@t
[!INCLUDE [sample-code](../includes/snippets/powershell/get-chat-withmembers-e3-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/chats/19:meeting_ZDZlYTYxOWUtYzdlMi00ZmMxLW
[!INCLUDE [sample-code](../includes/snippets/powershell/get-meeting-chat-e4-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/chats/19:ebe3857aa388434bab0cad9d2e09f4de@t
[!INCLUDE [sample-code](../includes/snippets/powershell/get-meeting-chat-e5-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Chat Hideforuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-hideforuser.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/chat-hideforuser-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Chat List Installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-list-installedapps.md
GET https://graph.microsoft.com/beta/chats/19%3Ad65713bc498c4a428c71ef9353e6ce20
[!INCLUDE [sample-code](../includes/snippets/powershell/list-installed-apps-in-chat-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/chats/19%3Ad65713bc498c4a428c71ef9353e6ce20
[!INCLUDE [sample-code](../includes/snippets/powershell/list-installed-apps-in-chat-expand-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/chats/19%3Ad65713bc498c4a428c71ef9353e6ce20
[!INCLUDE [sample-code](../includes/snippets/powershell/list-installed-apps-in-chat-expand-filter-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/chats/19%5bd86ec7f6b247d3b9e519b0bfef5d03%4
[!INCLUDE [sample-code](../includes/snippets/powershell/list-installed-apps-in-chat-select-consentedpermissionset-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Chat List Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-list-members.md
One of the following permissions is required to call this API. To learn more, in
> **Note**: Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent).
-> [!NOTE]
-> Before you can call this API with application permissions, you must request access. For details, see [Protected APIs in Microsoft Teams](/graph/teams-protected-apis).
- ## HTTP request <!-- { "blockType": "ignored" } --> ```http
GET https://graph.microsoft.com/beta/me/chats/19:8b081ef6-4792-4def-b2c9-c363a1b
[!INCLUDE [sample-code](../includes/snippets/powershell/list-conversation-members-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Chat List Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-list-messages.md
One of the following permissions is required to call this API. To learn more, in
> **Note**: Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent).
-> [!NOTE]
-> Before calling this API with application permissions, you must request access. For details, see [Protected APIs in Microsoft Teams](/graph/teams-protected-apis).
- ## HTTP request <!-- { "blockType": "ignored" } -->
GET https://graph.microsoft.com/beta/chats/19:2da4c29f6d7041eca70b638b43d45437@t
[!INCLUDE [sample-code](../includes/snippets/powershell/get-allchatmessages-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/chats/19:2da4c29f6d7041eca70b638b43d45437@t
[!INCLUDE [sample-code](../includes/snippets/powershell/list-chat-messages-2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Chat List Operations https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-list-operations.md
GET https://graph.microsoft.com/beta/chats/19:c253a29b5f694b55a6baad8e83510af7@t
[!INCLUDE [sample-code](../includes/snippets/powershell/list-chat-operations-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Chat List Permissiongrants https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-list-permissiongrants.md
GET https://graph.microsoft.com/beta/chats/19:089ac694c48647c68035aae675cf78ab@t
[!INCLUDE [sample-code](../includes/snippets/powershell/chat-list-permission-grants-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Chat List Pinnedmessages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-list-pinnedmessages.md
GET https://graph.microsoft.com/beta/chats/19:d65713bc498c4a428c71ef9353e6ce20@t
[!INCLUDE [sample-code](../includes/snippets/powershell/list-pinnedmessage-for-chat-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/chats/19:d65713bc498c4a428c71ef9353e6ce20@t
[!INCLUDE [sample-code](../includes/snippets/powershell/list-pinnedmessage-for-chat-expand-message-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Chat List Tabs https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-list-tabs.md
GET https://graph.microsoft.com/beta/chats/19:d65713bc498c4a428c71ef9353e6ce20@t
[!INCLUDE [sample-code](../includes/snippets/powershell/list-tabs-in-chat-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/chats/19:d65713bc498c4a428c71ef9353e6ce20@t
[!INCLUDE [sample-code](../includes/snippets/powershell/list-tabs-in-chat-app-filter-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Chat List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-list.md
GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/
[!INCLUDE [sample-code](../includes/snippets/powershell/list-chats-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/
[!INCLUDE [sample-code](../includes/snippets/powershell/list-chats-expand-members-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/chats?$expand=lastMessagePreview
[!INCLUDE [sample-code](../includes/snippets/powershell/list-chats-expand-lastmessagepreview-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/
[!INCLUDE [sample-code](../includes/snippets/powershell/list-chats-expand-members-and-filter-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/chats?$orderBy=lastMessagePreview/createdDa
[!INCLUDE [sample-code](../includes/snippets/powershell/list-chats-orderby-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Chat Markchatreadforuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-markchatreadforuser.md
Content-length: 106
[!INCLUDE [sample-code](../includes/snippets/powershell/chat-markchatreadforuser-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Chat Markchatunreadforuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-markchatunreadforuser.md
Content-length: 158
[!INCLUDE [sample-code](../includes/snippets/powershell/chat-markchatunreadforuser-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Chat Patch Tabs https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-patch-tabs.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-tabs-in-chat-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Chat Patch https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-patch.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/update-chat-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Chat Post Installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-post-installedapps.md
Install a [teamsApp](../resources/teamsapp.md) to the specified [chat](../resour
> **Notes**: > - If the chat is associated with an [onlineMeeting](../resources/onlinemeeting.md) instance, then, effectively, the **teamsApp** will get installed to the meeting.
-> - Currently, installing an app that requires resource-specific consent permissions is not supported in application context.
## Permissions
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/add-app-in-chat-beta-e1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/add-app-in-chat-beta-e2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Chat Post Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-post-members.md
If successful, this method returns a `201 Created` response code and a Location
#### Request
-Here is an example of the request.
+The following is an example of the request.
# [HTTP](#tab/http)
content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-conversation-member-with-specific-visiblehistorystartdatetime-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
-Here is an example of the response.
+The following is an example of the response.
<!-- {
HTTP/1.1 201 Created
Location: /chats/19:cf66807577b149cca1b7af0c32eec122@thread.v2/members/MCMjMjQzMmI1N2ItMGFiZC00M2RiLWFhN2ItMTZlYWRkMTE1ZDM0IyMxOTpiZDlkYTQ2MzIzYWY0MjUzOTZkMGZhNjcyMDAyODk4NEB0aHJlYWQudjIjIzQ4YmY5ZDUyLWRjYTctNGE1Zi04Mzk4LTM3Yjk1Y2M3YmQ4Mw== ```
-### Example 2: Adding a single member to a Microsoft Teams chat, sharing no chat history
+### Example 2: Add a single member to a Microsoft Teams chat, sharing no chat history
#### Request
-Here is an example of the request.
+The following is an example of the request.
# [HTTP](#tab/http) <!-- { "blockType": "request",
- "name": "create_conversation_member_with_no_visibleHistoryStartDateTime",
+ "name": "create_conversation_member_with_no_visibleHistoryStartDateTime_2",
"sampleKeys": ["19:cf66807577b149cca1b7af0c32eec122@thread.v2"] } --> ```msgraph-interactive
Content-type: application/json
``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell)+
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] #### Response
-Here is an example of the response.
+The following is an example of the response.
<!-- { "blockType": "response", "truncated": true,
- "name": "create_conversation_member_with_no_visibleHistoryStartDateTime"
+ "name": "create_conversation_member_with_no_visibleHistoryStartDateTime_2"
} --> ```http
HTTP/1.1 201 Created
Location: /chats/19:cf66807577b149cca1b7af0c32eec122@thread.v2/members/MCMjMjQzMmI1N2ItMGFiZC00M2RiLWFhN2ItMTZlYWRkMTE1ZDM0IyMxOTpiZDlkYTQ2MzIzYWY0MjUzOTZkMGZhNjcyMDAyODk4NEB0aHJlYWQudjIjIzQ4YmY5ZDUyLWRjYTctNGE1Zi04Mzk4LTM3Yjk1Y2M3YmQ4Mw== ```
-### Example 3: Adding a single member to a Microsoft Teams chat, sharing the whole history of the chat
+### Example 3: Add a single member to a Microsoft Teams chat, sharing the whole history of the chat
#### Request
-Here is an example of the request.
+The following is an example of the request.
# [HTTP](#tab/http) <!-- { "blockType": "request",
- "name": "create_conversation_member_with_all_visibleHistoryStartDateTime",
+ "name": "create_conversation_member_with_all_visibleHistoryStartDateTime_3",
"sampleKeys": ["19:cf66807577b149cca1b7af0c32eec122@thread.v2"] } --> ```msgraph-interactive
content-type: application/json
``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell)+
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] #### Response
-Here is an example of the response.
+The following is an example of the response.
<!-- { "blockType": "response", "truncated": true,
- "name": "create_conversation_member_with_all_visibleHistoryStartDateTime"
+ "name": "create_conversation_member_with_all_visibleHistoryStartDateTime_3"
} --> ```http
Location: /chats/19:cf66807577b149cca1b7af0c32eec122@thread.v2/members/MCMjMjQzM
#### Request
-Here is an example of the request.
+The following is an example of the request.
# [HTTP](#tab/http) <!-- { "blockType": "request",
- "name": "create_conversation_member_upn",
+ "name": "create_conversation_member_upn_5",
"sampleKeys": ["19:cf66807577b149cca1b7af0c32eec122@thread.v2"] } --> ```msgraph-interactive
content-type: application/json
``` # [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.
+
+<!--
+{
+ "blockType": "response",
+ "truncated": true,
+ "name": "create_conversation_member_upn_5"
+}
+-->
+```http
+HTTP/1.1 201 Created
+Location: /chats/19:cf66807577b149cca1b7af0c32eec122@thread.v2/members/MCMjMjQzMmI1N2ItMGFiZC00M2RiLWFhN2ItMTZlYWRkMTE1ZDM0IyMxOTpiZDlkYTQ2MzIzYWY0MjUzOTZkMGZhNjcyMDAyODk4NEB0aHJlYWQudjIjIzQ4YmY5ZDUyLWRjYTctNGE1Zi04Mzk4LTM3Yjk1Y2M3YmQ4Mw==
+```
+
+### Example 5: Add an in-tenant guest user to a chat, sharing no chat history
+
+#### Request
+
+The following is an example of the request.
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "create_conversation_member_with_no_visibleHistoryStartDateTime_5",
+ "sampleKeys": ["19:cf66807577b149cca1b7af0c32eec122@thread.v2"]
+} -->
+```msgraph-interactive
+POST https://graph.microsoft.com/beta/chats/19:cf66807577b149cca1b7af0c32eec122@thread.v2/members
+Content-type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.aadUserConversationMember",
+ "user@odata.bind": "https://graph.microsoft.com/beta/users/8ba98gf6-7fc2-4eb2-c7f2-aef9f21fd98g",
+ "roles": ["guest"]
+}
+```
+
+# [C#](#tab/csharp)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+++++
+#### Response
+
+The following is an example of the response.
+
+<!--
+{
+ "blockType": "response",
+ "truncated": true,
+ "name": "create_conversation_member_with_no_visibleHistoryStartDateTime_5"
+}
+-->
+```http
+HTTP/1.1 201 Created
+Location: /chats/19:cf66807577b149cca1b7af0c32eec122@thread.v2/members/MCMjMjQzMmI1N2ItMGFiZC00M2RiLWFhN2ItMTZlYWRkMTE1ZDM0IyMxOTpiZDlkYTQ2MzIzYWY0MjUzOTZkMGZhNjcyMDAyODk4NEB0aHJlYWQudjIjIzQ4YmY5ZDUyLWRjYTctNGE1Zi04Mzk4LTM3Yjk1Y2M3YmQ4Mw==
+```
+
+### Example 6: Add a out-of-tenant external user to a chat, sharing no chat history
+
+#### Request
+
+The following is an example of the request.
+++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "create_conversation_member_with_no_visibleHistoryStartDateTime_6",
+ "sampleKeys": ["19:cf66807577b149cca1b7af0c32eec122@thread.v2"]
+} -->
+```msgraph-interactive
+POST https://graph.microsoft.com/beta/chats/19:cf66807577b149cca1b7af0c32eec122@thread.v2/members
+Content-type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.aadUserConversationMember",
+ "user@odata.bind": "https://graph.microsoft.com/beta/users/82af01c5-f7cc-4a2e-a728-3a5df21afd9d",
+ "roles": ["owner"],
+ "tenantId": "4dc1fe35-8ac6-4f0d-904a-7ebcd364bea1"
+}
+```
+
+# [C#](#tab/csharp)
+
+# [Go](#tab/go)
+
+# [Java](#tab/java)
+
+# [JavaScript](#tab/javascript)
+
+# [PHP](#tab/php)
+
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+++ #### Response
-Here is an example of the response.
+The following is an example of the response.
<!-- { "blockType": "response", "truncated": true,
- "name": "create_conversation_member_upn"
+ "name": "create_conversation_member_with_no_visibleHistoryStartDateTime_6"
} --> ```http
v1.0 Chat Post Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-post-messages.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/post-chatmessages-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Chat Post Pinnedmessages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-post-pinnedmessages.md
Content-length: 63
[!INCLUDE [sample-code](../includes/snippets/powershell/create-pinnedchatmessageinfo-from--powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Chat Post Tabs https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-post-tabs.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/add-tab-to-chat-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Chat Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-post.md
The following table lists the properties that are required to create a chat obje
|:|:|:| |topic|(Optional) String|The title of the chat. The chat title can be provided only if the chat is of `group` type.| |chatType|[chatType](../resources/chat.md#chattype-values)| Specifies the type of chat. Possible values are: `group` and `oneOnOne`. |
-|members|[conversationMember](../resources/conversationmember.md) collection|List of conversation members that should be added. Every user who will participate in the chat, including the user who initiates the create request, must be specified in this list. Each member must be assigned a role of `owner` or `guest`. Guest tenant users must be assigned the `guest` role.|
+|members|[conversationMember](../resources/conversationmember.md) collection|List of conversation members that should be added. Every user who will participate in the chat, including the user who initiates the create request, must be specified in this list. Each member must be assigned a role of `owner` or `guest`. In-tenant guest users must be assigned the `guest` role. Out-of-tenant external users must be assigned with `owner` role.|
|installedApps| [teamsApp](../resources/teamsapp.md) collection|List of apps that should be installed in the chat.| > **Note:** Currently, only one app installation is supported. If multiple app installations are listed in the request, the response will be a `Bad Request` error.
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/csharp/create-chat-oneonone-csharp-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [CLI](#tab/cli)
+ # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/create-chat-oneonone-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-chat-oneonone-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/csharp/create-a-group-chat-csharp-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [CLI](#tab/cli)
+ # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/create-a-group-chat-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-a-group-chat-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/csharp/create-chat-oneonone-with-installed-apps-csharp-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [CLI](#tab/cli)
+ # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/create-chat-oneonone-with-installed-apps-go-snippets.md)] [!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)+
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/csharp/create-chat-oneonone-upn-csharp-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [CLI](#tab/cli)
+ # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/create-chat-oneonone-upn-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-chat-oneonone-upn-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
} ```
-### Example 5: Create a group chat with tenant guest user
+### Example 5: Create a group chat with in-tenant guest user
#### Request
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/csharp/create-chat-group-with-tenant-guest-user-csharp-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [CLI](#tab/cli)
+ # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/create-chat-group-with-tenant-guest-user-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-chat-group-with-tenant-guest-user-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/csharp/create-chat-oneonone-federated-csharp-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [CLI](#tab/cli)
+ # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/create-chat-oneonone-federated-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-chat-oneonone-federated-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Chat Sendactivitynotification https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-sendactivitynotification.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/chat-sendactivitynotification-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/chat-sendactivitynotification-2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/chat-sendactivitynotification-upn-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/chat-sendactivitynotification-3-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/chat-sendactivitynotification-5-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Chat Teamsappinstallation Upgrade https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-teamsappinstallation-upgrade.md
Upgrade an [app installation](../resources/teamsappinstallation.md) within a [ch
> **Notes**: > - If the chat is associated with an [onlineMeeting](../resources/onlinemeeting.md) instance, then effectively, the **teamsApp** installed in the meeting will get upgraded.
-> - Currently, upgrading an app that requires resource-specific consent permissions is not supported in application context.
## Permissions
POST https://graph.microsoft.com/beta/chats/19:ea28e88c00e94c7786b065394a61f296@
[!INCLUDE [sample-code](../includes/snippets/powershell/upgrade-installedapps-in-chat-e1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/upgrade-installedapps-in-chat-e2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Chat Unhideforuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-unhideforuser.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/chat-unhideforuser-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Chatmessage Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-delta.md
One of the following permissions is required to call this API. To learn more, in
[!INCLUDE [teamwork-permissions-note](../../../includes/teamwork-permissions-note.md)]
-> [!NOTE]
-> Before calling this API with application permissions, you must request access. For details, see [Protected APIs in Microsoft Teams](/graph/teams-protected-apis).
- ## HTTP request <!-- { "blockType": "ignored" } --> ```http
GET https://graph.microsoft.com/beta/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/
[!INCLUDE [sample-code](../includes/snippets/php/get-chatmessagedeltachannel-1-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ #### Initial request response
GET https://graph.microsoft.com/beta/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/
[!INCLUDE [sample-code](../includes/snippets/php/get-chatmessagedeltachannel-2-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ #### Second request response
GET https://graph.microsoft.com/beta/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/
[!INCLUDE [sample-code](../includes/snippets/php/get-chatmessagedeltachannel-3-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ #### Third request response
GET https://graph.microsoft.com/beta/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/
[!INCLUDE [sample-code](../includes/snippets/php/get-chatmessagedeltachannel-4-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+
+# [Python](#tab/python)
+ #### Response
v1.0 Chatmessage Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-get.md
One of the following permissions is required to call this API. To learn more, in
> **Note**: The _ChannelMessage.Read.Group_ and _ChatMessage.Read.Chat_ permissions use [resource-specific consent]( https://aka.ms/teams-rsc).
-> [!NOTE]
-> Before calling this API with application permissions, you must request access. For details, see [Protected APIs in Microsoft Teams](/graph/teams-protected-apis).
- ## HTTP request **Get message in a channel**
GET https://graph.microsoft.com/beta/chats/19:8ea0e38b-efb3-4757-924a-5f94061cf8
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell)+
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
GET https://graph.microsoft.com/beta/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/
[!INCLUDE [sample-code](../includes/snippets/powershell/get-chatmessagechannel-2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/
[!INCLUDE [sample-code](../includes/snippets/powershell/get-chatmessagechannel-3-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Chatmessage List Hostedcontents https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-list-hostedcontents.md
Retrieve the list of [chatMessageHostedContent](../resources/chatmessagehostedco
> **Note**: The _ChannelMessage.Read.Group_ and _ChatMessage.Read.Chat_ permissions use [resource-specific consent]( https://aka.ms/teams-rsc).
-> [!NOTE]
-> Before calling this API with application permissions, you must request access. For details, see [Protected APIs in Microsoft Teams](/graph/teams-protected-apis).
- ## HTTP request **Get hostedContents in a channel message**
GET https://graph.microsoft.com/beta/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell)+
+# [Python](#tab/python)
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
GET https://graph.microsoft.com/beta/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/
[!INCLUDE [sample-code](../includes/snippets/powershell/get-hostedcontentschannelmessage-2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
GET https://graph.microsoft.com/beta/chats/19:2da4c29f6d7041eca70b638b43d45437@t
[!INCLUDE [sample-code](../includes/snippets/powershell/get-hostedcontentschatmessage-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Chatmessage List Replies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-list-replies.md
One of the following permissions is required to call this API. To learn more, in
> **Note**: Permissions marked with * use [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent).
-> [!NOTE]
-> Before calling this API with application permissions, you must request access. For details, see [Protected APIs in Microsoft Teams](/graph/teams-protected-apis).
- ## HTTP request <!-- { "blockType": "ignored" } --> ```http
GET https://graph.microsoft.com/beta/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/
[!INCLUDE [sample-code](../includes/snippets/powershell/get-listmessagereplies-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ ### Response
v1.0 Chatmessage Post Replies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-post-replies.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/post-chatmessagereply-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
POST https://graph.microsoft.com/beta/teams/57fb72d0-d811-46f4-8947-305e6072eaa5
[!INCLUDE [snippet-not-available](../includes/snippets/snippet-not-available.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Chatmessage Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-post.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/post-chatmessage-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/post-chatmessage-2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/post-chatmessage-3-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/post-chatmessage-4-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/post-chatmessage-5-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/post-chatmessage-6-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/post-chatmessage-atmentionchannel-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/post-chatmessage-atmentionteam-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/post-chatmessage-atmentiontag-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/post-chatmessage-e10-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/post-chatmessage-11-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/post-chatmessage-12-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Chatmessage Setreaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-setreaction.md
To set a reaction to a **chatMessage** in a **chat**:
} --> ``` http
-POST /users/{userId}/chats/{chatsId}/messages/{chatMessageId}/setReaction
+POST /chats/{chatId}/messages/{chatMessageId}/setReaction
``` ## Request headers
v1.0 Chatmessage Softdelete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-softdelete.md
POST https://graph.microsoft.com/beta/users/8f98f01d-1a73-401a-b9e9-9fd1e6f5e5ar
[!INCLUDE [sample-code](../includes/snippets/powershell/chatmessagethis-softdelete1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
POST https://graph.microsoft.com/beta/teams/172b0cce-e65d-44ce-9a49-91d9f2e8593a
[!INCLUDE [sample-code](../includes/snippets/powershell/chatmessagethis-softdelete2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
POST https://graph.microsoft.com/beta/teams/172b0cce-e65d-44ce-9a49-91d9f2e8593a
[!INCLUDE [sample-code](../includes/snippets/powershell/chatmessagethis-softdelete3-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Chatmessage Undosoftdelete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-undosoftdelete.md
POST https://graph.microsoft.com/beta/users/8f98f01d-1a73-401a-b9e9-9fd1e6f5e5ap
[!INCLUDE [sample-code](../includes/snippets/powershell/chatmessagethis-undosoftdelete1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
POST https://graph.microsoft.com/beta/teams/172b0cce-e65d-44ce-9a49-91d9f2e8593a
[!INCLUDE [sample-code](../includes/snippets/powershell/chatmessagethis2undosoftdelete2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
POST https://graph.microsoft.com/beta/teams/172b0cce-e65d-44ce-9a49-91d9f2e8593a
[!INCLUDE [sample-code](../includes/snippets/powershell/chatmessagethis-undosoftdelete3-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Chatmessage Unsetreaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-unsetreaction.md
To unset a reaction to a **chatMessage** in a **chat**:
} --> ``` http
-POST /users/{userId}/chats/{chatId}/messages/{chatMessageId}/unsetReaction
+POST /chats/{chatId}/messages/{chatMessageId}/unsetReaction
``` ## Request headers
v1.0 Chatmessage Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-update.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/chatmessagepatchpolicyviolationall-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/patch-chatmessage-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/patch-chatmessage-2-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/patch-chatmessage-3-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/patch-chatmessage-4-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python)
+ #### Response
v1.0 Chatmessagehostedcontent Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessagehostedcontent-get.md
One of the following permissions is required to call this API. To learn more, in
> **Note**: The _ChannelMessage.Read.Group_ and _ChatMessage.Read.Chat_ permissions use [resource-specific consent]( https://aka.ms/teams-rsc).
-> [!NOTE]
-> Before calling this API with application permissions, you must request access. For details, see [Protected APIs in Microsoft Teams](/graph/teams-protected-apis).
- ## HTTP request **Get hosted content in a channel message**
GET https://graph.microsoft.com/beta/chats/19:2da4c29f6d7041eca70b638b43d45437@t
[!INCLUDE [sample-code](../includes/snippets/powershell/get-hostedcontentchatmessage-1-powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Python](#tab/python