Updates from: 11/08/2022 02:42:23
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Accesspackage Movetocatalog https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackage-movetocatalog.md
+
+ Title: "accessPackage: moveToCatalog"
+description: "Allows callers to move an access package from one catalog to the another."
+
+ms.localizationpriority: medium
++
+# accessPackage: moveToCatalog
+Namespace: microsoft.graph
++
+In [Azure AD entitlement management](../resources/entitlementmanagement-overview.md), this action moves the [accessPackage](../resources/accesspackage.md) to a specified target [accessPackageCatalog](../resources/accesspackagecatalog.md). The resources in the access package must be present in the target catalog.
+
+## Permissions
+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
+POST /identityGovernance/entitlementManagement/accessPackages/{accessPackageId}/moveToCatalog
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply a JSON representation of the parameters.
+
+The following table shows the parameters that can be used with this action.
+
+|Parameter|Type|Description|
+|:|:|:|
+|catalogId|String|ID of the catalog to which the access package will be moved.|
+++
+## Response
+
+If successful, this action returns a `200 OK` response code.
+
+## Examples
+
+### Request
+The following is an example of a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "accesspackagethis.movetocatalog"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackages/3089f957-4bfe-405d-96c0-9a7ef30c01d6/moveToCatalog
+Content-Type: application/json
+
+{
+ "catalogId": "3301434b-99bd-46be-923b-d762c30c8e8b"
+}
+```
+
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
+++++
+### Response
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 200 OK
+```
+
v1.0 Accesspackage Post Incompatiblegroup https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackage-post-incompatiblegroup.md
If successful, this method returns a `204 No Content` response code. It does not
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "add_incompatiblegroup_to_accesspackage"
Content-type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response.
v1.0 Accessreviewset Post Historydefinitions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewset-post-historydefinitions.md
The following table shows the required properties used to create an [accessRevie
|reviewHistoryPeriodStartDateTime | DateTimeOffset | A timestamp. Reviews starting on or after this date will be included in the fetched history data. Only required if **scheduleSettings** is not defined. | |reviewHistoryPeriodEndDateTime | DateTimeOffset | A timestamp. Reviews starting on or before this date will be included in the fetched history data. Only required if **scheduleSettings** is not defined. | |scopes|[accessReviewQueryScope](../resources/accessreviewqueryscope.md) collection| Used to filter which reviews are included in the fetched history data. Fetches reviews whose scope matches with this provided scope. Required. <br> For more, see [Supported scope queries for accessReviewHistoryDefinition](#supported-scope-queries-for-accessreviewhistorydefinition). |
-| scheduleSettings |[accessReviewHistoryScheduleSettings](../resources/accessReviewHistoryScheduleSettings.md)| The settings for a recurring access review history definition series. Only required if **reviewHistoryPeriodStartDateTime** or **reviewHistoryPeriodEndDateTime** are not defined. Not supported yet.|
+| scheduleSettings |[accessReviewHistoryScheduleSettings](../resources/accessReviewHistoryScheduleSettings.md)| **Not supported yet.** The settings for a recurring access review history definition series. Only required if **reviewHistoryPeriodStartDateTime** or **reviewHistoryPeriodEndDateTime** are not defined. |
### Supported scope queries for accessReviewHistoryDefinition
Content-Type: application/json
"notReviewed", "notNotified" ],
- "scheduleSettings": {
- "reportRange": "P1M",
- "recurrence": {
- "pattern": {
- "type": "monthly",
- "interval": 1
- },
- "range": {
- "type": "noEnd",
- "startDate": "2018-08-03T21:02:30.667Z",
- "count": 0
- }
- }
- },
+ "reviewHistoryPeriodStartDateTime": "2021-01-01T00:00:00Z",
+ "reviewHistoryPeriodEndDateTime": "2021-04-30T23:59:59Z",
"scopes": [ { "@odata.type": "#microsoft.graph.accessReviewQueryScope",
Content-Type: application/json
} ```
+# [C#](#tab/csharp)
+ # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/create-accessreviewhistorydefinition-from--javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.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)]
+# [PHP](#tab/php)
+ ### Response
Content-Type: application/json
"@odata.type": "#microsoft.graph.accessReviewHistoryDefinition", "id": "b2cb022f-b7e1-40f3-9854-c65a40861c38", "displayName": "Last quarter's group reviews April 2021",
- "scheduleSettings": {
- "reportRange": "P1M",
- "recurrence": {
- "pattern": {
- "type": "monthly",
- "interval": 1
- },
- "range": {
- "type": "noEnd",
- "startDate": "2018-08-03T21:02:30.667Z",
- "count": 0
- }
- }
- },
+ "reviewHistoryPeriodStartDateTime": "2021-01-01T00:00:00Z",
+ "reviewHistoryPeriodEndDateTime": "2021-04-30T23:59:59Z",
"decisions": [ "approve", "deny",
v1.0 Administrativeunit Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/administrativeunit-delta.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) | AdministrativeUnit.Read.All, Directory.Read.All, AdministrativeUnit.ReadWrite.All, Directory.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |
-|administrativeunit | AdministrativeUnit.Read.All, Directory.Read.All, AdministrativeUnit.ReadWrite.All, Directory.ReadWrite.All |
+|Application | AdministrativeUnit.Read.All, Directory.Read.All, AdministrativeUnit.ReadWrite.All, Directory.ReadWrite.All |
## HTTP request
GET /administrativeUnits/delta
## Query parameters
-Tracking changes incurs a round of one or more **delta** function calls. If you use any query parameter
-(other than `$deltatoken` and `$skiptoken`), you must specify
-it in the initial **delta** request. Microsoft Graph automatically encodes any specified parameters
-into the token portion of the `@odata.nextLink` or `@odata.deltaLink` URL provided in the response.
-You only need to specify any query parameters once up front.
-In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL from the previous response. That URL already
+Tracking changes incurs a round of one or more **delta** function calls. If you use any query parameter
+(other than `$deltatoken` and `$skiptoken`), you must specify
+it in the initial **delta** request. Microsoft Graph automatically encodes any specified parameters
+into the token portion of the `@odata.nextLink` or `@odata.deltaLink` URL provided in the response.
+You only need to specify any query parameters once up front.
+In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL from the previous response. That URL already
includes the encoded parameters. | Query parameter | Type |Description|
includes the encoded parameters.
This method supports the following OData query parameters to help customize the response: -- You can use a `$select` query parameter as in any GET request to specify only the properties your need for best performance. The
-**id** property is always returned.
+- You can use a `$select` query parameter as in any GET request to specify only the properties your need for best performance. The
+**id** property is always returned.
- There is limited support for `$filter`: * The only supported `$filter` expression is for tracking changes for specific resources, by their ID: `$filter=id+eq+{value}` or `$filter=id+eq+{value1}+or+id+eq+{value2}`. The number of IDs you can specify is limited by the maximum URL length.
Do not supply a request body for this method.
## Response
-If successful, this method returns `200 OK` response code and an [administrativeUnit](../resources/administrativeunit.md) collection object in the response body. The response also includes a `@odata.nextLink` URL or a `@odata.deltaLink` URL.
+If successful, this method returns `200 OK` response code and an [administrativeUnit](../resources/administrativeunit.md) collection object in the response body. The response also includes a `@odata.nextLink` URL or a `@odata.deltaLink` URL.
- If a `@odata.nextLink` URL is returned, there are additional pages of data to be retrieved in the session. The **administrativeUnit** continues making requests using the `@odata.nextLink` URL until a `@odata.deltaLink` URL is included in the response.
GET https://graph.microsoft.com/beta/administrativeUnits/delta
### Response >**Note:** The response object shown here might be shortened for readability.
-<!-- {
+<!-- {
"blockType": "response", "truncated": true, "@odata.type": "microsoft.graph.administrativeUnit",
- "isCollection": true
-} -->
+ "isCollection": true
+} -->
```http HTTP/1.1 200 OK Content-type: application/json
v1.0 Authenticationcombinationconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationcombinationconfiguration-get.md
If successful, this method returns a `200 OK` response code and an [authenticati
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_authenticationcombinationconfiguration"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identity/conditionalAccess/authenticationStrengths/policies/0e371351-6419-4c8a-8047-61eef0212ffb/combinationConfigurations/133b68c4-503b-4e87-839a-6c286a27381b ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationcombinationconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationcombinationconfiguration-update.md
If successful, this method returns a `204 NO CONTENT` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_authenticationcombinationconfiguration"
Content-length: 130
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationmethodmodedetail Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationmethodmodedetail-get.md
If successful, this method returns a `200 OK` response code and an [authenticati
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_authenticationmethodmodedetail"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identity/conditionalAccess/authenticationStrengths/authenticationMethodModes/windowsHelloForBusiness ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthpolicy Delete Combinationconfigurations https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-delete-combinationconfigurations.md
If successful, this method returns a `204 No Content` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_authenticationcombinationconfiguration"
The following is an example of a request.
DELETE https://graph.microsoft.com/beta/identity/conditionalAccess/authenticationStrengths/policies/0e371351-6419-4c8a-8047-61eef0212ffb/combinationConfigurations/6cbbcfd0-5054-4a59-a10e-2d21fe09305d ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthpolicy Findbymethodmode https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-findbymethodmode.md
If successful, this function returns a `200 OK` response code and a [authenticat
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "authenticationstrengthpolicythis.findbymethodmode"
The following is an example of a request.
GET https://graph.microsoft.com/beta/policies/authenticationStrengthPolicies/findByMethodMode(authenticationMethodModes=["sms"]) ```
+# [JavaScript](#tab/javascript)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
v1.0 Authenticationstrengthpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-get.md
If successful, this method returns a `200 OK` response code and an [authenticati
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_authenticationstrengthpolicy"
The following is an example of a request.
GET https://graph.microsoft.com/beta/policies/authenticationStrengthPolicies/00000000-0000-0000-0000-000000000004 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthpolicy List Combinationconfigurations https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-list-combinationconfigurations.md
If successful, this method returns a `200 OK` response code and a collection of
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_authenticationcombinationconfiguration"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identity/conditionalAccess/authenticationStrengths/policies/0e371351-6419-4c8a-8047-61eef0212ffb/combinationConfigurations ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthpolicy Post Combinationconfigurations https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-post-combinationconfigurations.md
If successful, this method returns a `201 Created` response code and a [fido2Com
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_authenticationcombinationconfiguration_from_"
Content-length: 130
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-update.md
If successful, this method returns a `204 NO CONTENT` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_authenticationstrengthpolicy"
Content-length: 239
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthpolicy Updateallowedcombinations https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-updateallowedcombinations.md
If successful, this action returns a `200 OK` response code and a [updateAllowed
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "authenticationstrengthpolicythis.updateallowedcombinations"
Content-length: 51
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthpolicy Usage https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-usage.md
If successful, this function returns a `200 OK` response code and an [authentica
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "authenticationstrengthpolicythis.usage"
The following is an example of a request.
GET https://graph.microsoft.com/beta/policies/authenticationStrengthPolicies/{authenticationStrengthPolicyId}/usage ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthroot Delete Policies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthroot-delete-policies.md
If successful, this method returns a `204 No Content` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_authenticationstrengthpolicy"
The following is an example of a request.
DELETE https://graph.microsoft.com/beta/policies/authenticationStrengthPolicies/6e7d7469-07c5-4bb2-a801-5eaef8fb7c1e/$ref ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthroot List Authenticationmethodmodes https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthroot-list-authenticationmethodmodes.md
If successful, this method returns a `200 OK` response code and a collection of
#### Request The following is an example of a request to retrieve the collection of **authenticationMethodModes** objects and their descriptions. .+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_authenticationmethodmodedetail"
The following is an example of a request to retrieve the collection of **authent
GET https://graph.microsoft.com/beta/identity/conditionalAccess/authenticationStrengths/authenticationMethodModes ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
Content-Type: application/json
#### Request The following is an example of a request to retrieve the flat collection of authenticationCombinations objects, representing all the possible allowed combinations (allowedCombinations) that may be used in an authenticationStrengthPolicy object. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_authenticationcombinations"
The following is an example of a request to retrieve the flat collection of auth
GET https://graph.microsoft.com/beta/identity/conditionalAccess/authenticationStrengths/authenticationCombinations ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
Content-Type: application/json
"Error: list_authenticationcombinations: Unable to locate a definition for resource type: microsoft.graph.authenticationMethodModes" ]
-} -->
+} -->
v1.0 Authenticationstrengthroot List Policies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthroot-list-policies.md
If successful, this method returns a `200 OK` response code and a collection of
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_authenticationstrengthpolicy"
The following is an example of a request.
GET https://graph.microsoft.com/beta/policies/authenticationStrengthPolicies ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthroot Post Policies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthroot-post-policies.md
If successful, this method returns a `201 Created` response code and an [authent
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_authenticationstrengthpolicy_from_"
Content-length: 239
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the 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/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
+
v1.0 Browsersharedcookie Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersharedcookie-get.md
+
+ Title: "Get browserSharedCookie"
+description: "Get a session cookie that can be shared between a Microsoft Edge process and an Internet Explorer process, while using Internet Explorer mode."
+
+ms.localizationpriority: medium
++
+# Get browserSharedCookie
+Namespace: microsoft.graph
++
+Get a [session cookie](../resources/browsersharedcookie.md) that can be shared between a Microsoft Edge process and an Internet Explorer process, while using [Internet Explorer mode](/deployedge/edge-ie-mode).
+
+## Permissions
+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)|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sharedCookies/{browserSharedCookieId}
+```
+
+## 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 [browserSharedCookie](../resources/browsersharedcookie.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "get_browsersharedcookie",
+ "sampleKeys": ["147713b8-4df2-4717-93a3-bfb1ebb54881", "07f4030f-45ff-4ad1-9277-3b8f6ee74141"]
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/147713b8-4df2-4717-93a3-bfb1ebb54881/sharedCookies/07f4030f-45ff-4ad1-9277-3b8f6ee74141
+```
++
+### 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.browserSharedCookie"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "status": "pendingEdit",
+ "id": "07f4030f-45ff-4ad1-9277-3b8f6ee74141",
+ "hostOrDomain": "www.microsoft.com",
+ "sourceEnvironment": "microsoftEdge",
+ "displayName": "Microsoft Cookie",
+ "path": "/",
+ "hostOnly": true,
+ "comment": "A cookie for microsoft.com",
+ "lastModifiedDateTime": "2022-06-29T11:32:39.6732721-04:00",
+ "createdDateTime": "2022-06-29T11:32:39.673272-04:00",
+ "lastModifiedBy": {
+ "user": {
+ "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c",
+ "displayName": "Joe Smith"
+ },
+ "application": null
+ },
+ "history": [
+ {
+ "publishedDateTime": "2022-06-29T14:51:23.8662592Z",
+ "hostOrDomain": "www.microsoft.com",
+ "comment": "A cookie for InternetExplorer11",
+ "displayName": "Microsoft Cookie",
+ "sourceEnvironment": "internetExplorer11",
+ "hostOnly": true,
+ "lastModifiedBy": {
+ "user": {
+ "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c",
+ "displayName": "Joe Smith"
+ },
+ "application": null
+ }
+ }
+ ]
+}
+```
+
v1.0 Browsersharedcookie Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersharedcookie-update.md
+
+ Title: "Update browserSharedCookie"
+description: "Update the properties of a browserSharedCookie object."
+
+ms.localizationpriority: medium
++
+# Update browserSharedCookie
+Namespace: microsoft.graph
++
+Update the properties of a [browserSharedCookie](../resources/browsersharedcookie.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)|BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sharedCookies/{browserSharedCookieId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+++
+|Property|Type|Description|
+|:|:|:|
+|comment|String|The comment of the cookie.|
+|displayName|String|The name of the cookie.|
+|hostOnly|Boolean|Determines whether a cookie is a host-only or domain cookie.|
+|hostOrDomain|String|The URL of the cookie.|
+|path|String|The path of the cookie.|
+|sourceEnvironment|browserSharedCookieSourceEnvironment|Specifies how the cookies are shared between Microsoft Edge and Internet Explorer. The possible values are: `microsoftEdge`, `internetExplorer11`, `both`, `unknownFutureValue`.|
++
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "update_browsersharedcookie",
+ "sampleKeys": ["20579923-e6c8-425a-b728-47f43c10bc05", "972a5778-df43-45fd-9c2a-5dd944c7a1ce"]
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/20579923-e6c8-425a-b728-47f43c10bc05/sharedCookies/972a5778-df43-45fd-9c2a-5dd944c7a1ce
+Content-Type: application/json
+Content-length: 349
+
+{
+ "hostOrDomain": "www.microsoft.com",
+ "sourceEnvironment": "microsoftEdge",
+ "displayName": "Microsoft Cookie",
+ "path": "/",
+ "hostOnly": true,
+ "comment": "Updating source environment."
+}
+```
++
+### Response
+The following is an example of the response.
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Browsersite Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersite-get.md
+
+ Title: "Get browserSite"
+description: "Get a browserSite that resides on a site list."
+
+ms.localizationpriority: medium
++
+# Get browserSite
+Namespace: microsoft.graph
++
+Get a [browserSite](../resources/browsersite.md) that resides on a [browserSiteList](../resources/browsersitelist.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)|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sites/{browserSiteId}
+```
+
+## 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 [browserSite](../resources/browsersite.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "get_browsersite",
+ "sampleKeys": ["20579923-e6c8-425a-b728-47f43c10bc05", "a22cbc85-d5d2-4e61-8414-42e6704c36f7"]
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/20579923-e6c8-425a-b728-47f43c10bc05/sites/a22cbc85-d5d2-4e61-8414-42e6704c36f7
+```
++
+### 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.browserSite"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "status": "pendingEdit",
+ "id": "a22cbc85-d5d2-4e61-8414-42e6704c36f7",
+ "webUrl": "www.microsoft.com",
+ "targetEnvironment": "microsoftEdge",
+ "mergeType": "default",
+ "compatibilityMode": "default",
+ "allowRedirect": false,
+ "comment": "Updating to Edge.",
+ "lastModifiedDateTime": "2022-06-29T15:44:27.2154899Z",
+ "createdDateTime": "2022-06-29T14:51:23.8662595Z",
+ "deletedDateTime": null,
+ "lastModifiedBy": {
+ "user": {
+ "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c",
+ "displayName": "Joe Smith"
+ },
+ "application": null
+ },
+ "history": [
+ {
+ "publishedDateTime": "2022-06-29T14:51:23.8662592Z",
+ "allowRedirect": true,
+ "comment": "A site that opens in InternetExplorer11",
+ "compatibilityMode": "default",
+ "targetEnvironment": "internetExplorer11",
+ "mergeType": "default",
+ "lastModifiedBy": {
+ "user": {
+ "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c",
+ "displayName": "Joe Smith"
+ },
+ "application": null
+ }
+ }
+ ]
+}
+```
+
v1.0 Browsersite Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersite-update.md
+
+ Title: "Update browserSite"
+description: "Update the properties of a browserSite object."
+
+ms.localizationpriority: medium
++
+# Update browserSite
+Namespace: microsoft.graph
++
+Update the properties of a [browserSite](../resources/browsersite.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)|BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sites/{browserSiteId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
++
+|Property|Type|Description|
+|:|:|:|
+|allowRedirect|Boolean|Controls the behavior of redirected sites. If `true`, indicates that the site will open in Internet Explorer 11 or Microsoft Edge even if the site is navigated to as part of a HTTP or meta refresh redirection chain.|
+|comment|String|The comment for the site.|
+|compatibilityMode|browserSiteCompatibilityMode|Controls what compatibility setting is used for specific sites or domains. The possible values are: `default`, `internetExplorer8Enterprise`, `internetExplorer7Enterprise`, `internetExplorer11`, `internetExplorer10`, `internetExplorer9`, `internetExplorer8`, `internetExplorer7`, `internetExplorer5`, `unknownFutureValue`.|
+|mergeType|browserSiteMergeType|The merge type of the site. The possible values are: `noMerge`, `default`, `unknownFutureValue`.|
+|targetEnvironment|browserSiteTargetEnvironment|The target environment that the site should open in. The possible values are: `internetExplorerMode`, `internetExplorer11`, `microsoftEdge`, `configurable`, `none`, `unknownFutureValue`.<br /><br />Prior to June 15, 2022, the `internetExplorer11` option would allow opening a site in the Internet Explorer 11 (IE11) desktop application. Following the retirement of IE11 on June 15, 2022, the `internetExplorer11` option will no longer open an IE11 window and will instead behave the same as the `internetExplorerMode` option.|
+|webUrl|String|The URL of the site.|
+
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "update_browsersite",
+ "sampleKeys": ["972a5778-df43-45fd-9c2a-5dd944c7a1ce", "7cf831d2-8a9b-4826-b120-911566f6fd6a"]
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/972a5778-df43-45fd-9c2a-5dd944c7a1ce/sites/7cf831d2-8a9b-4826-b120-911566f6fd6a
+Content-Type: application/json
+Content-length: 387
+
+{
+ "webUrl": "www.microsoft.com",
+ "targetEnvironment": "microsoftEdge",
+ "mergeType": "default",
+ "compatibilityMode": "default",
+ "allowRedirect": false,
+ "comment": "Updating to Edge."
+}
+```
++
+### Response
+The following is an example of the response.
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Browsersitelist Delete Sharedcookies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-delete-sharedcookies.md
+
+ Title: "Delete browserSharedCookie"
+description: "Delete a browserSharedCookie from a browserSiteList."
+
+ms.localizationpriority: medium
++
+# Delete browserSharedCookie
+Namespace: microsoft.graph
++
+Delete a [browserSharedCookie](../resources/browsersharedcookie.md) from a [browserSiteList](../resources/browsersitelist.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)|BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sharedCookies/{browserSharedCookieId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If the shared cookie was not previously published, then this method returns a `204 No Content` response code on a successful delete. If the shared cookie was previously published, then this method returns a `200 OK` response code and a [browserSiteList](../resources/browsersitelist.md) object in the response body with the status as `pendingDelete`. You must publish (for example, via the [browserSiteList: publish](../api/browsersitelist-publish.md) API) the shared cookie to fully remove it from the site list.
+
+## Examples
+
+### Example 1: Delete a shared cookie that was not previously published
+
+#### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "delete_browsersharedcookie",
+ "@odata.type": "microsoft.graph.browserSharedCookie",
+ "sampleKeys": ["7cf831d2-8a9b-4826-b120-911566f6fd6a", "07b4cc32-237f-4a1a-9d7f-531efc26220e"]
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/7cf831d2-8a9b-4826-b120-911566f6fd6a/sharedCookies/07b4cc32-237f-4a1a-9d7f-531efc26220e
+```
++
+#### Response
+The following is an example of the response.
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
+### Example 2: Delete a shared cookie that was previously published
+
+#### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "delete_browsersharedcookie",
+ "sampleKeys": ["7cf831d2-8a9b-4826-b120-911566f6fd6a", "07f4030f-45ff-4ad1-9277-3b8f6ee74141"]
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/7cf831d2-8a9b-4826-b120-911566f6fd6a/sharedCookies/07f4030f-45ff-4ad1-9277-3b8f6ee74141
+```
++
+#### Response
+The following is an example of the response where the **status** has changed to `pendingDelete` but the shared cookie is still published. You must publish the shared cookie to fully remove it from the site list.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.browserSharedCookie"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "status": "pendingDelete",
+ "id": "07f4030f-45ff-4ad1-9277-3b8f6ee74141",
+ "hostOrDomain": "www.microsoft.com",
+ "sourceEnvironment": "internetExplorer11",
+ "displayName": "Microsoft Cookie",
+ "path": "/",
+ "hostOnly": true,
+ "comment": "A cookie for microsoft.com",
+ "lastModifiedDateTime": "2022-06-29T11:38:39.6732721-04:00",
+ "createdDateTime": "2022-06-29T11:32:39.673272-04:00",
+ "deletedDateTime": "2022-06-29T11:38:39.673272-04:00",
+ "lastModifiedBy": {
+ "user": {
+ "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c",
+ "displayName": "Joe Smith"
+ },
+ "application": null
+ },
+ "history": []
+}
+```
v1.0 Browsersitelist Delete Sites https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-delete-sites.md
+
+ Title: "Delete browserSite"
+description: "Delete a browserSite from a browserSiteList."
+
+ms.localizationpriority: medium
++
+# Delete browserSite
+Namespace: microsoft.graph
++
+Delete a [browserSite](../resources/browsersite.md) from a [browserSiteList](../resources/browsersitelist.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)|BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sites/{browserSiteId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If the site was not previously published, then this method returns a `204 No Content` response code on a successful delete. If the site was previously published, then this method returns a `200 OK` response code and a [browserSiteList](../resources/browsersitelist.md) object in the response body with the status as `pendingDelete`. You must publish (for example, via the [browserSiteList: publish](../api/browsersitelist-publish.md) API) the site to fully remove it from the site list.
+
+## Examples
+
+### Example 1: Delete a site that was not previously published
+
+#### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "delete_browsersite",
+ "sampleKeys": ["07f4030f-45ff-4ad1-9277-3b8f6ee74141", "a22cbc85-d5d2-4e61-8414-42e6704c36f7"]
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/07f4030f-45ff-4ad1-9277-3b8f6ee74141/sites/a22cbc85-d5d2-4e61-8414-42e6704c36f7
+```
++
+#### Response
+The following is an example of the response.
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
+### Example 2: Delete a site that was previously published
+
+#### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "delete_browsersite",
+ "sampleKeys": ["07f4030f-45ff-4ad1-9277-3b8f6ee74141", "a22cbc85-d5d2-4e61-8414-42e6704c36f7"]
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/07f4030f-45ff-4ad1-9277-3b8f6ee74141/sites/a22cbc85-d5d2-4e61-8414-42e6704c36f7
+```
++
+#### Response
+The following is an example of the response where the status has changed to `pendingDelete` but the site is still published. You must publish the site to fully remove it from the site list.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.browserSite"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "status": "pendingDelete",
+ "id": "a22cbc85-d5d2-4e61-8414-42e6704c36f7",
+ "webUrl": "www.microsoft.com",
+ "targetEnvironment": "microsoftEdge",
+ "mergeType": "default",
+ "compatibilityMode": "default",
+ "allowRedirect": false,
+ "comment": "Site for Microsoft Edge",
+ "lastModifiedDateTime": "2022-06-29T15:44:27.2154899Z",
+ "createdDateTime": "2022-06-29T14:51:23.8662595Z",
+ "createdDateTime": "2022-06-29T14:55:23.8662595Z",
+ "lastModifiedBy": {
+ "user": {
+ "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c",
+ "displayName": "Joe Smith"
+ },
+ "application": null
+ },
+ "history": []
+}
+```
v1.0 Browsersitelist Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-get.md
+
+ Title: "Get browserSiteList"
+description: "Get a browserSiteList that contains browserSite and browserSharedCookie resources."
+
+ms.localizationpriority: medium
++
+# Get browserSiteList
+Namespace: microsoft.graph
++
+Get a [browserSiteList](../resources/browsersitelist.md) that contains [browserSite](../resources/browsersite.md) and [browserSharedCookie](../resources/browsersharedcookie.md) resources.
+
+## Permissions
+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)|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}
+```
+
+## 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 [browserSiteList](../resources/browsersitelist.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "get_browsersitelist",
+ "sampleKeys": ["e370d818-f650-5ab1-499e-5915e83f4573"]
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/e370d818-f650-5ab1-499e-5915e83f4573
+```
++
+### 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.browserSiteList"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.browserSiteList",
+ "id": "e370d818-f650-5ab1-499e-5915e83f4573",
+ "description": "Production site list for devices",
+ "lastModifiedBy": {
+ "user": {
+ "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
+ "displayName": "Joe Smith"
+ },
+ "application": null
+ },
+ "lastModifiedDateTime": "2016-03-21T20:01:37Z",
+ "displayName": "Production Site List A",
+ "publishedBy": {
+ "user": {
+ "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
+ "displayName": "Joe Smith"
+ },
+ "application": null
+ },
+ "publishedDateTime": "2016-03-21T20:01:37Z",
+ "status": "published",
+ "revision": "1.0"
+}
+```
+
v1.0 Browsersitelist List Sharedcookies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-list-sharedcookies.md
+
+ Title: "List browserSharedCookies"
+description: "Get a list of the browserSharedCookie objects and their properties."
+
+ms.localizationpriority: medium
++
+# List browserSharedCookies
+Namespace: microsoft.graph
++
+Get a list of the [browserSharedCookie](../resources/browsersharedcookie.md) objects and their 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)|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sharedCookies
+```
+
+## 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 collection of [browserSharedCookie](../resources/browsersharedcookie.md) objects in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "list_browsersharedcookie",
+ "sampleKeys": ["e370d818-f650-5ab1-499e-5915e83f4573"]
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/e370d818-f650-5ab1-499e-5915e83f4573/sharedCookies
+```
++
+### 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.browserSharedCookie",
+ "isCollection": true
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "status": "published",
+ "id": "07f4030f-45ff-4ad1-9277-3b8f6ee74141",
+ "hostOrDomain": "www.microsoft.com",
+ "sourceEnvironment": "internetExplorer11",
+ "displayName": "Microsoft Cookie",
+ "path": "/",
+ "hostOnly": true,
+ "comment": "A cookie for microsoft.com",
+ "lastModifiedDateTime": "2022-06-29T11:32:39.6732721-04:00",
+ "createdDateTime": "2022-06-29T11:32:39.673272-04:00",
+ "lastModifiedBy": {
+ "user": {
+ "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c",
+ "displayName": "Joe Smith"
+ },
+ "application": null
+ },
+ "history": []
+ }
+ ]
+}
+```
+
v1.0 Browsersitelist List Sites https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-list-sites.md
+
+ Title: "List browserSites"
+description: "Get a list of the browserSite objects and their properties."
+
+ms.localizationpriority: medium
++
+# List browserSites
+Namespace: microsoft.graph
++
+Get a list of the [browserSite](../resources/browsersite.md) objects and their 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)|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sites
+```
+
+## 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 collection of [browserSite](../resources/browsersite.md) objects in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "list_browsersite",
+ "sampleKeys": ["e370d818-f650-5ab1-499e-5915e83f4573"]
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/e370d818-f650-5ab1-499e-5915e83f4573/sites
+```
++
+### 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.browserSite",
+ "isCollection": true
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "status": "pendingEdit",
+ "id": "a22cbc85-d5d2-4e61-8414-42e6704c36f7",
+ "webUrl": "www.microsoft.com",
+ "targetEnvironment": "microsoftEdge",
+ "mergeType": "default",
+ "compatibilityMode": "default",
+ "allowRedirect": false,
+ "comment": "Updating to Edge.",
+ "lastModifiedDateTime": "2022-06-29T15:44:27.2154899Z",
+ "createdDateTime": "2022-06-29T14:51:23.8662595Z",
+ "deletedDateTime": null,
+ "lastModifiedBy": {
+ "user": {
+ "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c",
+ "displayName": "Joe Smith"
+ },
+ "application": null
+ },
+ "history": [
+ {
+ "publishedDateTime": "2022-06-29T14:51:23.8662592Z",
+ "allowRedirect": true,
+ "comment": "A site that opens in InternetExplorer11",
+ "compatibilityMode": "default",
+ "targetEnvironment": "internetExplorer11",
+ "mergeType": "default",
+ "lastModifiedBy": {
+ "user": {
+ "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c",
+ "displayName": "Joe Smith"
+ },
+ "application": null
+ }
+ }
+ ]
+ }
+ ]
+}
+```
+
v1.0 Browsersitelist Post Sharedcookies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-post-sharedcookies.md
+
+ Title: "Create browserSharedCookie"
+description: "Create a new browserSharedCookie object in a browserSiteList."
+
+ms.localizationpriority: medium
++
+# Create browserSharedCookie
+Namespace: microsoft.graph
++
+Create a new [browserSharedCookie](../resources/browsersharedcookie.md) object in a [browserSiteList](../resources/browsersitelist.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)|BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sharedCookies
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply a JSON representation of the [browserSharedCookie](../resources/browsersharedcookie.md) object.
+
+You can specify the following properties when you create a **browserSharedCookie**.
+
+|Property|Type|Description|
+|:|:|:|
+|comment|String|The comment of the cookie. Required.|
+|displayName|String|The name of the cookie. Required.|
+|hostOnly|Boolean|Determines whether a cookie is a host-only or domain cookie. Required.|
+|hostOrDomain|String|The URL of the cookie. Required.|
+|path|String|The path of the cookie. Required.|
+|sourceEnvironment|browserSharedCookieSourceEnvironment|Specifies how the cookies are shared between Microsoft Edge and Internet Explorer. The possible values are: `microsoftEdge`, `internetExplorer11`, `both`, `unknownFutureValue`. Required.|
+
+## Response
+
+If successful, this method returns a `201 Created` response code and a [browserSharedCookie](../resources/browsersharedcookie.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "create_browsersharedcookie",
+ "sampleKeys": ["e370d818-f650-5ab1-499e-5915e83f4573"]
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/e370d818-f650-5ab1-499e-5915e83f4573/sharedCookies
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.browserSharedCookie",
+ "hostOrDomain": "www.microsoft.com",
+ "sourceEnvironment": "InternetExplorer11",
+ "displayName": "Microsoft Cookie",
+ "hostOnly": true,
+ "comment": "A cookie for microsoft.com",
+ "path": "/"
+}
+```
++
+### 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.browserSharedCookie"
+}
+-->
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "status": "pendingAdd",
+ "id": "07f4030f-45ff-4ad1-9277-3b8f6ee74141",
+ "hostOrDomain": "www.microsoft.com",
+ "sourceEnvironment": "internetExplorer11",
+ "displayName": "Microsoft Cookie",
+ "path": "/",
+ "hostOnly": true,
+ "comment": "A cookie for microsoft.com",
+ "lastModifiedDateTime": "2022-06-29T15:32:39.6732721Z",
+ "createdDateTime": "2022-06-29T15:32:39.673272Z",
+ "deletedDateTime": null,
+ "lastModifiedBy": {
+ "user": {
+ "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c",
+ "displayName": "Joe Smith"
+ },
+ "application": null
+ },
+ "history": []
+}
+```
+
v1.0 Browsersitelist Post Sites https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-post-sites.md
+
+ Title: "Create browserSite"
+description: "Create a new browserSite object in a browserSiteList."
+
+ms.localizationpriority: medium
++
+# Create browserSite
+Namespace: microsoft.graph
++
+Create a new [browserSite](../resources/browsersite.md) object in a [browserSiteList](../resources/browsersitelist.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)|BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sites
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply a JSON representation of the [browserSite](../resources/browsersite.md) object.
+
+You can specify the following properties when you create a **browserSite**.
+
+|Property|Type|Description|
+|:|:|:|
+|allowRedirect|Boolean|Controls the behavior of redirected sites. If `true`, indicates that the site will open in Internet Explorer 11 or Microsoft Edge even if the site is navigated to as part of a HTTP or meta refresh redirection chain. Required.|
+|comment|String|The comment for the site. Required|
+|compatibilityMode|browserSiteCompatibilityMode|Controls what compatibility setting is used for specific sites or domains. The possible values are: `default`, `internetExplorer8Enterprise`, `internetExplorer7Enterprise`, `internetExplorer11`, `internetExplorer10`, `internetExplorer9`, `internetExplorer8`, `internetExplorer7`, `internetExplorer5`, `unknownFutureValue`. Required.|
+|mergeType|browserSiteMergeType|The merge type of the site. The possible values are: `noMerge`, `default`, `unknownFutureValue`. Required.|
+|targetEnvironment|browserSiteTargetEnvironment|The target environment that the site should open in. The possible values are: `internetExplorerMode`, `internetExplorer11`, `microsoftEdge`, `configurable`, `none`, `unknownFutureValue`. Required.<br /><br />Prior to June 15, 2022, the `internetExplorer11` option would allow opening a site in the Internet Explorer 11 (IE11) desktop application. Following the retirement of IE11 on June 15, 2022, the `internetExplorer11` option will no longer open an IE11 window and will instead behave the same as the `internetExplorerMode` option.|
+|webUrl|String|The URL of the site. Required.|
++
+## Response
+
+If successful, this method returns a `201 Created` response code and a [browserSite](../resources/browsersite.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "create_browsersite",
+ "sampleKeys": ["e370d818-f650-5ab1-499e-5915e83f4573"]
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/e370d818-f650-5ab1-499e-5915e83f4573/sites
+Content-Type: application/json
+Content-length: 387
+
+{
+ "@odata.type": "#microsoft.graph.browserSite",
+ "webUrl": "www.microsoft.com",
+ "targetEnvironment": "InternetExplorer11",
+ "comment": "A site that opens in InternetExplorer11",
+ "mergeType": "default",
+ "compatibilityMode": "default",
+ "allowRedirect": true
+}
+```
++
+### 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.browserSite"
+}
+-->
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "status": "pendingAdd",
+ "id": "a22cbc85-d5d2-4e61-8414-42e6704c36f7",
+ "webUrl": "www.microsoft.com",
+ "targetEnvironment": "internetExplorer11",
+ "mergeType": "default",
+ "compatibilityMode": "default",
+ "allowRedirect": true,
+ "comment": "A site that opens in InternetExplorer11",
+ "lastModifiedDateTime": "2022-06-29T14:51:23.8662592Z",
+ "createdDateTime": "2022-06-29T14:51:23.8662595Z",
+ "deletedDateTime": null,
+ "lastModifiedBy": {
+ "user": {
+ "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c",
+ "displayName": "Joe Smith"
+ },
+ "application": null
+ },
+ "history": []
+}
+```
+
v1.0 Browsersitelist Publish https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-publish.md
+
+ Title: "browserSiteList: publish"
+description: "Publish the specified browserSiteList for devices to download."
+
+ms.localizationpriority: medium
++
+# browserSiteList: publish
+Namespace: microsoft.graph
++
+Publish the specified [browserSiteList](../resources/browsersitelist.md) for devices to download.
+
+## Permissions
+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)|BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/publish
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
++
+## Request body
+
+In the request body, omit both sites and share cookies to publish the entire site list. Optionally, you can publish specific sites and shared cookies by specifying a collection of IDs.
++
+|Property|Type|Description|
+|:|:|:|
+|revision|String|The revision of the site list to publish. Required.|
+|sharedCookies|[browserSharedCookie](../resources/browsersharedcookie.md) collection|The collection of shared cookies to publish. Optional. Only requires the shared cookie ID. All other fields are ignored.|
+|sites|[browserSite](../resources/browsersite.md) collection|The collection of sites to publish. Optional. Only requires the site ID. All other fields are ignored.|
++
+## Response
+
+If successful, this action returns a `200 OK` response code and a [browserSiteList](../resources/browsersitelist.md) in the response body.
+
+## Examples
+
+### Example 1: Publish all sites and shared cookies
+
+#### Request
+
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "browsersitelist_publish",
+ "sampleKeys": ["36ba61eb-c492-4283-a38b-963a1dbb2f69"]
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/36ba61eb-c492-4283-a38b-963a1dbb2f69/publish
+Content-Type: application/json
+
+{
+ "revision": "1.0"
+}
+```
++
+#### 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.browserSiteList"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.browserSiteList",
+ "id": "36ba61eb-c492-4283-a38b-963a1dbb2f69",
+ "revision": "1.0",
+ "displayName": "Product Site List A",
+ "description": "A production site list for team A",
+ "lastModifiedDateTime": "2022-06-28T19:29:52.8752365Z",
+ "publishedDateTime": "2022-06-28T19:29:52.8752365Z",
+ "status": "published",
+ "lastModifiedBy": {
+ "user": {
+ "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c",
+ "displayName": "Joe Smith"
+ },
+ "application": null
+ },
+ "publishedBy": {
+ "user": {
+ "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c",
+ "displayName": "Joe Smith"
+ },
+ "application": null
+ }
+}
+```
+
+### Example 2: Publish specific sites and shared cookies
+
+#### Request
+
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "browsersitelist_publish",
+ "sampleKeys": ["36ba61eb-c492-4283-a38b-963a1dbb2f69"]
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/36ba61eb-c492-4283-a38b-963a1dbb2f69/publish
+Content-Type: application/json
+
+{
+ "revision": "1.0",
+ "sites": [
+ {
+ "id": "53e5f971-fc7b-4cd3-a1bf-34d7c0416882"
+ },
+ {
+ "id": "2e27cc86-3662-447e-b751-274fb9f869ea"
+ }
+ ],
+ "sharedCookies": [
+ {
+ "id": "7f639835-23ab-4793-b1e6-1a06fad127a2"
+ }
+ ]
+}
+```
++
+#### Response
+The following is an example of the response. The **status** will show `pending` if the request contains sites or shared cookies that you have not published yet.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.browserSiteList"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.browserSiteList",
+ "id": "36ba61eb-c492-4283-a38b-963a1dbb2f69",
+ "revision": "1.0",
+ "displayName": "Product Site List A",
+ "description": "A production site list for team A",
+ "lastModifiedDateTime": "2022-06-28T19:29:52.8752365Z",
+ "publishedDateTime": "2022-06-28T19:29:52.8752365Z",
+ "status": "pending",
+ "lastModifiedBy": {
+ "user": {
+ "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c",
+ "displayName": "Joe Smith"
+ },
+ "application": null
+ },
+ "publishedBy": {
+ "user": {
+ "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c",
+ "displayName": "Joe Smith"
+ },
+ "application": null
+ }
+}
+```
v1.0 Browsersitelist Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-update.md
+
+ Title: "Update browserSiteList"
+description: "Update the properties of a browserSiteList object."
+
+ms.localizationpriority: medium
++
+# Update browserSiteList
+Namespace: microsoft.graph
++
+Update the properties of a [browserSiteList](../resources/browsersitelist.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)|BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
++
+|Property|Type|Description|
+|:|:|:|
+|description|String|Description for the site list.|
+|displayName|String|Display name of this site list.|
+++
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "update_browsersitelist",
+ "sampleKeys": ["36ba61eb-c492-4283-a38b-963a1dbb2f69"]
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/36ba61eb-c492-4283-a38b-963a1dbb2f69
+Content-Type: application/json
+Content-length: 283
+
+{
+ "displayName": "Production Site List A",
+ "description": "Production site list for team A"
+}
+```
++
+### Response
+The following is an example of the response.
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Call Addlargegalleryview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/call-addlargegalleryview.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Add the large gallery view to a call.
+Add the large gallery view to a call.
+
+For details about how to identify a large gallery view participant in a roster so that you can retrieve the relevant data to subscribe to the video feed, see [Identify large gallery view participants in a roster](https://learn.microsoft.com/en-us/graph/cloud-communications-identifylargegalleryview).
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Channel Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-get.md
GET https://graph.microsoft.com/beta/teams/893075dd-2487-4122-925f-022c42e20265/
[!INCLUDE [sample-code](../includes/snippets/go/get-channel-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [PHP](#tab/php) [!INCLUDE [sample-code](../includes/snippets/php/get-channel-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
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/go/list-channels-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [PHP](#tab/php) [!INCLUDE [sample-code](../includes/snippets/php/list-channels-php-snippets.md)] [!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/go/list-private-channels-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [PHP](#tab/php) [!INCLUDE [sample-code](../includes/snippets/php/list-private-channels-php-snippets.md)] [!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/go/list-shared-channels-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [PHP](#tab/php) [!INCLUDE [sample-code](../includes/snippets/php/list-shared-channels-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Chat Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-get.md
Content-type: application/json
#### Request The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_meeting_chat", "sampleKeys": ["19:meeting_ZDZlYTYxOWUtYzdlMi00ZmMxLWIxMTAtN2YzODZlZjAxYzI4@thread.v2"] }-->
-```http
+```msgraph-interactive
GET https://graph.microsoft.com/beta/chats/19:ebe3857aa388434bab0cad9d2e09f4de@thread.v2?$expand=lastMessagePreview ```+
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
+++
Content-type: application/json
} } }
-```
+```
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/javascript/chat-hideforuser-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Java](#tab/java)
- # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/chat-hideforuser-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Chat List Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-list-messages.md
The following is an example of a request that lists the top two messages (`$top=
The following example shows the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_chat_messages_2",
The following example shows the request.
GET https://graph.microsoft.com/beta/chats/19:2da4c29f6d7041eca70b638b43d45437@thread.v2/messages?$top=2&$orderBy=lastModifiedDateTime desc&$filter=lastModifiedDateTime ge 2022-09-22T00:00:00.000Z and lastModifiedDateTime le 2022-09-24T00:00:00.000Z ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following example shows the 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/javascript/chat-markchatreadforuser-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Java](#tab/java)
- # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/chat-markchatreadforuser-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
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/javascript/chat-markchatunreadforuser-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Java](#tab/java)
- # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/chat-markchatunreadforuser-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
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/javascript/chat-unhideforuser-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Java](#tab/java)
- # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/chat-unhideforuser-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Chatmessage Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-post.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | ChannelMessage.Send, Group.ReadWrite.All** | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Teamwork.Migrate.All, ChannelMessage.ReadWrite.All |
+| Application | Teamwork.Migrate.All |
> **Note**: Permissions marked with ** are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward.
Content-type: application/json
#### Request The following is an example of the request.
-> **Note:** The attachment's ID must be unique and can be a new randomly generated GUID. However, the attachment's ID must be the same in the _body_ and _attachments_ elements.
+> **Note:** The attachment ID must be unique and can be a new randomly generated GUID. However, the attachment ID must be the same in the _body_ and _attachments_ elements.
# [HTTP](#tab/http)
Content-type: application/json
#### Request The following is an example of the request.
-> **Note:** The **temporaryId** in the **hostedContents** collection is a random ID, but must be same across the **body** and **hostedContents** elements. (Notice the **temporaryId** set to **1** and the reference in body as `../hostedContents/1/$value`.)
+> **Note:** The **temporaryId** in the **hostedContents** collection is a random ID, but must be same across the **body** and **hostedContents** elements. (Notice the **temporaryId** set to `1` and the reference in body as `../hostedContents/1/$value`.).
-**contentBytes** must be set to binary string Base64-encoded bytes. You can do this in C# by using `Convert.ToBase64String(File.ReadAllBytes("image.png"));`
+**contentBytes** must be set to binary string Base64-encoded bytes. You can do this in C# by using `Convert.ToBase64String(File.ReadAllBytes("image.png"));`.
# [HTTP](#tab/http)
Content-type: application/json
#### Request The following is an example of the request.
-> **Note:** The **temporaryId** in the **hostedContents** collection is a random ID, but must be same across the **content** (in **attachments**) and **hostedContents** elements. (Notice the **temporaryId** set to **1** and the reference in content as `../hostedContents/1/$value`.)
+> **Note:** The **temporaryId** in the **hostedContents** collection is a random ID, but must be same across the **content** (in **attachments**) and **hostedContents** elements. (Notice the **temporaryId** set to `1` and the reference in content as `../hostedContents/1/$value`.).
-**contentBytes** must be set to binary string Base64-encoded bytes. You can do this in C# by using `Convert.ToBase64String(File.ReadAllBytes("image.png"));`
+**contentBytes** must be set to binary string Base64-encoded bytes. You can do this in C# by using `Convert.ToBase64String(File.ReadAllBytes("image.png"));`.
# [HTTP](#tab/http)
Content-type: application/json
#### Response
+The following is an example of the response.
+ <!-- { "blockType": "response", "truncated": true,
Content-type: application/json
} ```
-### Example 8 : @mention a team in a channel message
+### Example 8: @mention a team in a channel message
#### Request The following is an example of the request.
v1.0 Chatmessage Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-update.md
ms.prod: "microsoft-teams"
Update a [chatMessage](../resources/chatMessage.md) object.
-With the exception of the **policyViolation** property, all properties of a **chatMessage** can be updated in delegated permissions scenarios.
+All properties of a **chatMessage** can be updated in delegated permissions scenarios,
+except for read-only properties and the **policyViolation** property.
Only the **policyViolation** property of a **chatMessage** can be updated in application permissions scenarios. The update only works for chats where members are Microsoft Teams users. If one of the participants is using Skype, the operation will fail.
v1.0 Cloudpccrosscloudgovernmentorganizationmapping Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpccrosscloudgovernmentorganizationmapping-get.md
If successful, this method returns a `200 OK` response code and a [cloudPcCrossC
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_cloudpccrosscloudgovernmentorganizationmapping"
GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/crossCloud
X-MS-CloudPC-USGovCloudTenantAADToken: {token} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response <!-- {
v1.0 Cloudpcexportjob Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcexportjob-get.md
If successful, this method returns a `200 OK` response code and a [cloudPcExport
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_cloudpcexportjob"
The following is an example of a request.
GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/reports/exportJobs/TotalAggregatedRemoteConnectionReports__d39979c9-a0a2-4916-a158-1b984742ffff ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Cloudpcreports Getdailyaggregatedremoteconnectionreports https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcreports-getdailyaggregatedremoteconnectionreports.md
If successful, this action returns a `200 OK` response code and a Stream in the
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "cloudpcreportsthis.getdailyaggregatedremoteconnectionreports"
Content-length: 199
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Cloudpcreports Getrealtimeremoteconnectionlatency https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcreports-getrealtimeremoteconnectionlatency.md
If successful, this function returns a `200 OK` response code and a Stream in th
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "cloudpcreportsthis.getrealtimeremoteconnectionlatency"
The following is an example of a request.
GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/reports/getRealTimeRemoteConnectionLatency(cloudPcId='f5ff445f-7488-40f8-8ab9-ee784a9fffff') ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
++++ ### Response The following is an example of the response
v1.0 Cloudpcreports Getrealtimeremoteconnectionstatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcreports-getrealtimeremoteconnectionstatus.md
If successful, this function returns a `200 OK` response code and a Stream in th
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "cloudpcreportsthis.getrealtimeremoteconnectionstatus"
The following is an example of a request.
GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/reports/getRealTimeRemoteConnectionStatus(cloudPcId='f5ff445f-7488-40f8-8ab9-ee784a9fffff') ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
++++ ### Response The following is an example of the response
v1.0 Cloudpcreports Getremoteconnectionhistoricalreports https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcreports-getremoteconnectionhistoricalreports.md
If successful, this action returns a `200 OK` response code and a Stream in the
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "cloudpcreportsthis.getremoteconnectionhistoricalreports"
Content-length: 199
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Cloudpcreports Gettotalaggregatedremoteconnectionreports https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcreports-gettotalaggregatedremoteconnectionreports.md
If successful, this action returns a `200 OK` response code and a Stream in the
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "cloudpcreportsthis.gettotalaggregatedremoteconnectionreports"
Content-length: 199
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Cloudpcreports Post Exportjobs https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcreports-post-exportjobs.md
If successful, this method returns a `201 Created` response code and a [cloudPcE
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_cloudpcexportjob_from_"
Content-length: 315
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Conditionalaccessroot List Templates https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/conditionalaccessroot-list-templates.md
If successful, this method returns a `200 OK` response code and a collection of
#### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_conditionalaccesstemplate"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identity/conditionalAccess/templates ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
Content-Type: application/json
#### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_conditionalaccesstemplate_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identity/conditionalAccess/templates?$select=name,description,id,scenarios&$filter=scenarios has 'secureFoundation' ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
Content-Type: application/json
} ] }
-```
+```
v1.0 Conditionalaccesstemplate Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/conditionalaccesstemplate-get.md
If successful, this method returns a `200 OK` response code and a [conditionalAc
#### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_conditionalaccesstemplate"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identity/conditionalAccess/templates/c7503427-338e-4c5e-902d-abe252abfb43 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
Content-Type: application/json
#### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_conditionalaccesstemplate_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identity/conditionalAccess/templates/c7503427-338e-4c5e-902d-abe252abfb43?$select=details ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
Content-Type: application/json
} } }
-```
+```
v1.0 Devicemanagement Alertrecord Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrecord-get.md
If successful, this method returns a `200 OK` response code and an [microsoft.gr
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_alertrecord"
The following is an example of a request.
GET https://graph.microsoft.com/beta/deviceManagement/monitoring/alertRecords/6c46a7ba-e78a-45e5-a81c-179ab8fd3e8e ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response.
v1.0 Devicemanagement Alertrecord Getportalnotifications https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrecord-getportalnotifications.md
If successful, this function returns a `200 OK` response code and a collection o
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "alertrecordthis.getportalnotifications"
The following is an example of a request.
GET https://graph.microsoft.com/beta/deviceManagement/monitoring/alertRecords/getPortalNotifications ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response.
v1.0 Devicemanagement Alertrecord List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrecord-list.md
If successful, this method returns a `200 OK` response code and a collection of
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_alertrecord"
The following is an example of a request.
GET https://graph.microsoft.com/beta/deviceManagement/monitoring/alertRecords ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response.
v1.0 Devicemanagement Alertrecord Setportalnotificationassent https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrecord-setportalnotificationassent.md
If successful, this action returns a `204 No Content` response code.
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "alertrecordthis.setportalnotificationassent"
The following is an example of a request.
POST https://graph.microsoft.com/beta/deviceManagement/monitoring/alertRecords/6c46a7ba-e78a-45e5-a81c-179ab8fd3e8e/setPortalNotificationAsSent ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response.
v1.0 Devicemanagement Alertrule Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrule-get.md
If successful, this method returns a `200 OK` response code and an [microsoft.gr
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_alertrule"
The following is an example of a request.
GET https://graph.microsoft.com/beta/deviceManagement/monitoring/alertRules/30070507-6514-443b-8fa5-06979cedacdf ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response.
v1.0 Devicemanagement Alertrule List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrule-list.md
If successful, this method returns a `200 OK` response code and a collection of
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_alertrule"
The following is an example of a request.
GET https://graph.microsoft.com/beta/deviceManagement/monitoring/alertRules ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response.
v1.0 Devicemanagement Alertrule Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrule-post.md
If successful, this method returns a `201 Created` response code and an [microso
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "post_alertrule"
Content-Type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response.
v1.0 Devicemanagement Alertrule Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrule-update.md
If successful, this method returns a `200 OK` response code and an updated [micr
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_alertrule"
Content-Type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response.
v1.0 Driveitem Createuploadsession https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/driveitem-createuploadsession.md
Alternatively, you can defer final creation of the file in the destination until
POST /drives/{driveId}/items/{itemId}/createUploadSession POST /groups/{groupId}/drive/items/{itemId}/createUploadSession POST /me/drive/items/{itemId}/createUploadSession
+POST /me/drive/items/{itemId}:/{fileName}:/createUploadSession
POST /sites/{siteId}/drive/items/{itemId}/createUploadSession POST /users/{userId}/drive/items/{itemId}/createUploadSession ```
v1.0 Ediscovery Legalhold Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/ediscovery-legalhold-update.md
In the request body, supply the values for relevant fields that should be update
|Property|Type|Description| |:|:|:|
-|contentQuery|String|KQL query that specifies content to be held in the specified locations. For more information about KQL in eDiscovery, see [Keyword queries and search conditions for Content Search and eDiscovery](/microsoft-365/compliance/keyword-queries-and-search-conditions). To hold all content in the specified locations, leave **contentQuery** blank. |
|description|String| The legal hold description. | |displayName|String| The display name of the legal hold. | |isEnabled|Boolean|Indicates whether the hold is enabled and actively holding content. |
v1.0 Educationassignment List Submissions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignment-list-submissions.md
The following is an example of the request.
# [HTTP](#tab/http) <!-- { "blockType": "request",
- "sampleKeys": ["f4a941ff-9da6-4707-ba5b-0eae93cad0b4","3c77de7f-539b-49e1-9c96-1274f2f0ee3b"],
+ "sampleKeys": ["2003c52e-807a-4186-9b49-60c573095461","2be08d97-b140-4eec-8cbd-88238d571060"],
"name": "get_submissions" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/education/classes/f4a941ff-9da6-4707-ba5b-0eae93cad0b4/assignments/3c77de7f-539b-49e1-9c96-1274f2f0ee3b/submissions
+GET https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions
``` # [C#](#tab/csharp)
Content-type: application/json
Content-length: 873 {
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions",
"value": [ {
- "status": "working",
+ "status": "returned",
"submittedDateTime": null, "unsubmittedDateTime": null,
- "returnedDateTime": null,
- "resourcesFolderUrl": "https://graph.microsoft.com/beta/drives/b!DPA6q59Tw0mtgmyXRUmrQRqBZTesG-lMkl1cBmvvMeUEWrOk89nKRpUEr4ZhNYBc/items/016XPCQEDJCE5LX4OXABF37QSORAK5WKQD",
- "id": "4af73d2b-6b9c-493f-0688-979087bed39b",
+ "returnedDateTime": "2022-04-13T05:11:50.756165Z",
+ "reassignedDateTime": null,
+ "resourcesFolderUrl": null,
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226"
+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a",
"displayName": null } },
Content-length: 873
} }, "returnedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ },
+ "reassignedBy": {
"application": null, "device": null, "user": {
The following is an example of the request.
"name": "get_submissions_expand" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/efcdf80b-a5de-42ac-8579-e40b0223d48b/submissions?$expand=outcomes
+GET https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions?$expand=outcomes
``` # [C#](#tab/csharp)
Content-type: application/json
Content-length: 4492 {
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('72a7baec-c3e9-4213-a850-f62de0adad5f')/assignments('efcdf80b-a5de-42ac-8579-e40b0223d48b')/submissions(outcomes())",
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions(outcomes())",
"value": [ { "status": "returned", "submittedDateTime": null, "unsubmittedDateTime": null,
- "returnedDateTime": "2021-10-13T15:57:00.0349869Z",
+ "returnedDateTime": "2022-04-13T05:11:50.756165Z",
"reassignedDateTime": null, "resourcesFolderUrl": null,
- "id": "9bc724ee-d314-1ec5-725d-5f81228e85a6",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226"
+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a",
"displayName": null } },
Content-length: 4492
"application": null, "device": null, "user": {
- "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
Content-length: 4492
"displayName": null } },
+ "outcomes@odata.context": "https://canary.graph.microsoft.com/testprodbetaeduasg_local_submissions-deeplink/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions('d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a')/outcomes",
"outcomes": [ { "@odata.type": "#microsoft.graph.educationFeedbackOutcome",
Content-length: 4492
"lastModifiedBy": null, "points": null, "publishedPoints": null
- },
- {
- "@odata.type": "#microsoft.graph.educationRubricOutcome",
- "lastModifiedDateTime": "2021-10-13T15:57:00.0076092Z",
- "id": "65a46d78-1a2b-4a7e-bcf8-78a22ac2611b",
- "lastModifiedBy": {
- "application": null,
- "device": null,
- "user": {
- "id": null,
- "displayName": null
- }
- },
- "rubricQualityFeedback": [
- {
- "qualityId": "f4c7b781-4c0c-4113-a5fb-c0885b7ab510",
- "feedback": null
- }
- ],
- "rubricQualitySelectedLevels": [
- {
- "qualityId": "f4c7b781-4c0c-4113-a5fb-c0885b7ab510",
- "columnId": "ef99fe68-b6f8-4f67-a13b-9a81c1724788"
- }
- ],
- "publishedRubricQualityFeedback": [
- {
- "qualityId": "f4c7b781-4c0c-4113-a5fb-c0885b7ab510",
- "feedback": null
- }
- ],
- "publishedRubricQualitySelectedLevels": [
- {
- "qualityId": "f4c7b781-4c0c-4113-a5fb-c0885b7ab510",
- "columnId": "ef99fe68-b6f8-4f67-a13b-9a81c1724788"
- }
- ]
} ] }
The following is an example of the request.
"name": "get_submissions_prefer" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/education/classes/59069eb2-2a09-4d90-bb19-2089cc69d613/assignments/80da1069-a635-4913-813f-d775a5470a8f/submissions
+GET https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions
Prefer: include-unknown-enum-members ```
Content-type: application/json
Content-length: 4492 {
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('59069eb2-2a09-4d90-bb19-2089cc69d613')/assignments('80da1069-a635-4913-813f-d775a5470a8f')/submissions",
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions",
"value": [ {
- "status": "working",
+ "status": "returned",
"submittedDateTime": null, "unsubmittedDateTime": null,
- "returnedDateTime": null,
+ "returnedDateTime": "2022-04-13T05:11:50.756165Z",
"reassignedDateTime": null, "resourcesFolderUrl": null,
- "id": "f51a6687-a4a3-a8d9-ac4a-6ff81c5a8da7",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "0ca0dd79-57eb-4903-97dc-88c769dd2a3d"
+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "0ca0dd79-57eb-4903-97dc-88c769dd2a3d",
+ "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a",
"displayName": null } },
Content-length: 4492
"application": null, "device": null, "user": {
- "id": null,
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
Content-length: 4492
}, { "status": "reassigned",
- "submittedDateTime": "2021-11-10T00:57:17.0495233Z",
+ "submittedDateTime": "2022-04-13T05:10:00.4660243Z",
"unsubmittedDateTime": null,
- "returnedDateTime": null,
- "reassignedDateTime": "2021-11-10T01:03:25.7812455Z",
+ "returnedDateTime": "2022-04-13T05:12:14.6531582Z",
+ "reassignedDateTime": null,
"resourcesFolderUrl": null,
- "id": "869369de-3e5a-89eb-6f2d-83cd88f860b5",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22efbecaf4-6956-4a76-6e10-b901e4de91c5%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "efbecaf4-6956-4a76-6e10-b901e4de91c5",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "723e2402-f503-4825-a4d5-5143fbe6f53d"
+ "userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "723e2402-f503-4825-a4d5-5143fbe6f53d",
+ "id": "51cf5a99-d234-4e43-96de-cd65df14bfa1",
"displayName": null } },
Content-length: 4492
"application": null, "device": null, "user": {
- "id": null,
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
Content-length: 4492
"application": null, "device": null, "user": {
- "id": "afc58f1f-7c9e-4770-a448-e53ba43463a5",
+ "id": null,
"displayName": null } }
v1.0 Educationassignment Setupfeedbackresourcesfolder https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignment-setupfeedbackresourcesfolder.md
Content-type: application/json
### Response+ The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
+ <!-- { "blockType": "response", "truncated": true,
v1.0 Educationfeedbackresourceoutcome Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationfeedbackresourceoutcome-delete.md
Title: "Delete educationFeedbackResourceOutcome"
-description: "Delete a feedback resource from a submission. This can only be done by a teacher."
+description: "Delete a feedback resource from a submission."
ms.localizationpriority: medium ms.prod: "education"
DELETE /education/classes/{classId}/assignments/{assignmentId}/submissions/{subm
| Authorization | Bearer {token}. Required. | ## Request body
-Don't supply a request body for this method.
+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.
v1.0 Educationfeedbackresourceoutcome Post Outcomes https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationfeedbackresourceoutcome-post-outcomes.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Create a new [feedback resource](../resources/educationfeedbackresourceoutcome.md) for a submission.
-
-Only a teacher can perform this operation.
+Create a new [feedback resource](../resources/educationfeedbackresourceoutcome.md) for a submission. Only a teacher can perform this operation.
To create a new file-based resource, upload the file to the feedback resources folder associated with the assignment. If the file doesn't exist or is not in that folder, the `POST` request will fail.
Content-type: application/json
} } }- ```
+## See also
+
+To upload an existing file, see [Upload feedback files for education submissions](/graph/education-upload-feedback-resource-overview).
+ <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2022-05-06 14:57:30 UTC --> <!--
v1.0 Educationrubric Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationrubric-get.md
The following is an example of the request.
GET https://graph.microsoft.com/beta/education/me/rubrics/bf040af7-a5ff-4abe-a8c8-1bdc532344c2 ```
-## 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).
- # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-educationrubric-csharp-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Educationsubmission Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-get.md
The following is an example of the request.
"name": "get_educationsubmission" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/education/classes/59069eb2-2a09-4d90-bb19-2089cc69d613/assignments/80da1069-a635-4913-813f-d775a5470a8f/submissions/869369de-3e5a-89eb-6f2d-83cd88f860b5
+GET https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions/d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a
``` # [C#](#tab/csharp)
Content-type: application/json
Content-length: 712 {
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('59069eb2-2a09-4d90-bb19-2089cc69d613')/assignments('80da1069-a635-4913-813f-d775a5470a8f')/submissions/$entity",
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions/$entity",
"status": "returned",
- "submittedDateTime": "2021-11-10T00:57:17.0495233Z",
+ "submittedDateTime": null,
"unsubmittedDateTime": null,
- "returnedDateTime": "2021-11-10T01:03:25.7812455Z",
- "reassignedDateTime": "2021-11-10T01:03:25.7812455Z",
+ "returnedDateTime": "2022-04-13T05:11:50.756165Z",
+ "reassignedDateTime": null,
"resourcesFolderUrl": null,
- "id": "869369de-3e5a-89eb-6f2d-83cd88f860b5",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "723e2402-f503-4825-a4d5-5143fbe6f53d"
+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "723e2402-f503-4825-a4d5-5143fbe6f53d",
+ "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a",
"displayName": null } },
Content-length: 712
"application": null, "device": null, "user": {
- "id": "afc58f1f-7c9e-4770-a448-e53ba43463a5",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
Content-length: 712
"application": null, "device": null, "user": {
- "id": "afc58f1f-7c9e-4770-a448-e53ba43463a5",
+ "id": null,
"displayName": null } }
The following is an example of the request.
"name": "get_educationsubmission_prefer" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/education/classes/59069eb2-2a09-4d90-bb19-2089cc69d613/assignments/80da1069-a635-4913-813f-d775a5470a8f/submissions/869369de-3e5a-89eb-6f2d-83cd88f860b5
+GET https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions/efbecaf4-6956-4a76-6e10-b901e4de91c5
Prefer: include-unknown-enum-members ```
Content-type: application/json
Content-length: 712 {
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('59069eb2-2a09-4d90-bb19-2089cc69d613')/assignments('80da1069-a635-4913-813f-d775a5470a8f')/submissions/$entity",
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions/$entity",
"status": "reassigned",
- "submittedDateTime": "2021-11-10T00:57:17.0495233Z",
+ "submittedDateTime": "2022-04-13T05:10:00.4660243Z",
"unsubmittedDateTime": null,
- "returnedDateTime": null,
- "reassignedDateTime": "2021-11-10T01:03:25.7812455Z",
+ "returnedDateTime": "2022-04-13T05:12:14.6531582Z",
+ "reassignedDateTime": "2022-04-13T05:12:14.6531582Z",
"resourcesFolderUrl": null,
- "id": "869369de-3e5a-89eb-6f2d-83cd88f860b5",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22efbecaf4-6956-4a76-6e10-b901e4de91c5%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "efbecaf4-6956-4a76-6e10-b901e4de91c5",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "723e2402-f503-4825-a4d5-5143fbe6f53d"
+ "userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "723e2402-f503-4825-a4d5-5143fbe6f53d",
+ "id": "51cf5a99-d234-4e43-96de-cd65df14bfa1",
"displayName": null } },
Content-length: 712
"application": null, "device": null, "user": {
- "id": null,
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
Content-length: 712
"application": null, "device": null, "user": {
- "id": "afc58f1f-7c9e-4770-a448-e53ba43463a5",
+ "id": null,
"displayName": null } }
The following is an example of the request.
"name": "get_submission_expand" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/education/classes/59069eb2-2a09-4d90-bb19-2089cc69d613/assignments/80da1069-a635-4913-813f-d775a5470a8f/submissions/869369de-3e5a-89eb-6f2d-83cd88f860b5?$expand=*
+GET https://graph.microsoft.com/beta/education/classes/a86a5c30-0437-49d6-9c6b-b1ce0d8d5574/assignments/95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f/submissions/e1a0240e-f3af-f039-63e7-09c3cbf8d176?$expand=*
``` # [C#](#tab/csharp)
Content-type: application/json
Content-length: 4492 {
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('59069eb2-2a09-4d90-bb19-2089cc69d613')/assignments('80da1069-a635-4913-813f-d775a5470a8f')/submissions(outcomes(),resources(),submittedResources())/$entity",
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('a86a5c30-0437-49d6-9c6b-b1ce0d8d5574')/assignments('95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f')/submissions(outcomes(),resources(),submittedResources())/$entity",
"status": "returned",
- "submittedDateTime": "2021-11-10T00:57:17.0495233Z",
+ "submittedDateTime": "2022-10-24T21:03:53.3664034Z",
"unsubmittedDateTime": null,
- "returnedDateTime": "2021-11-10T01:03:25.7812455Z",
- "reassignedDateTime": "2021-11-10T01:03:25.7812455Z",
+ "returnedDateTime": "2022-10-24T21:04:42.7101616Z",
+ "reassignedDateTime": null,
"resourcesFolderUrl": null,
- "id": "869369de-3e5a-89eb-6f2d-83cd88f860b5",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%22a86a5c30-0437-49d6-9c6b-b1ce0d8d5574%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%2295da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22e1a0240e-f3af-f039-63e7-09c3cbf8d176%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "e1a0240e-f3af-f039-63e7-09c3cbf8d176",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "723e2402-f503-4825-a4d5-5143fbe6f53d"
+ "userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "723e2402-f503-4825-a4d5-5143fbe6f53d",
+ "id": "51cf5a99-d234-4e43-96de-cd65df14bfa1",
"displayName": null } },
Content-length: 4492
"application": null, "device": null, "user": {
- "id": "afc58f1f-7c9e-4770-a448-e53ba43463a5",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
Content-length: 4492
"application": null, "device": null, "user": {
- "id": "afc58f1f-7c9e-4770-a448-e53ba43463a5",
+ "id": null,
"displayName": null } },
+ "outcomes@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('a86a5c30-0437-49d6-9c6b-b1ce0d8d5574')/assignments('95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f')/submissions('e1a0240e-f3af-f039-63e7-09c3cbf8d176')/outcomes",
"outcomes": [ { "@odata.type": "#microsoft.graph.educationFeedbackOutcome",
- "lastModifiedDateTime": null,
+ "lastModifiedDateTime": "2022-10-24T21:04:42.3073523Z",
"id": "ca05367a-b292-42d5-aff7-5d279feeace8",
- "lastModifiedBy": null,
- "feedback": null,
- "publishedFeedback": null
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ },
+ "feedback": {
+ "feedbackDateTime": "2022-10-24T21:04:42.3073523Z",
+ "text": {
+ "content": "New feedback!",
+ "contentType": "text"
+ },
+ "feedbackBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ }
+ },
+ "publishedFeedback": {
+ "feedbackDateTime": "2022-10-24T21:04:25.2783852Z",
+ "text": {
+ "content": "Feedback",
+ "contentType": "text"
+ },
+ "feedbackBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ }
+ }
}, { "@odata.type": "#microsoft.graph.educationPointsOutcome",
- "lastModifiedDateTime": null,
+ "lastModifiedDateTime": "2022-10-24T21:04:42.7101541Z",
"id": "ea1351f6-ba33-4940-b2cb-6a7254af2dc8",
- "lastModifiedBy": null,
- "points": null,
- "publishedPoints": null
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ },
+ "points": {
+ "gradedDateTime": "2022-10-24T21:04:42.7101541Z",
+ "points": 456,
+ "gradedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ }
+ },
+ "publishedPoints": {
+ "gradedDateTime": "2022-10-24T21:04:25.6308301Z",
+ "points": 123,
+ "gradedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ }
+ }
}, { "@odata.type": "#microsoft.graph.educationRubricOutcome",
- "lastModifiedDateTime": "2021-11-10T01:03:25.7712076Z",
+ "lastModifiedDateTime": "2022-10-24T21:04:26.5833776Z",
"id": "65a46d78-1a2b-4a7e-bcf8-78a22ac2611b", "lastModifiedBy": { "application": null,
Content-length: 4492
}, "rubricQualityFeedback": [ {
- "qualityId": "a660004a-608d-4cd2-a6dc-4f43812444ee",
+ "qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c",
"feedback": null }, {
- "qualityId": "2c5ae75d-d347-426b-be2c-cfc81a6f0b32",
- "feedback": null
+ "qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b",
+ "feedback": {
+ "content": "Needs improvement",
+ "contentType": "text"
+ }
}, {
- "qualityId": "32fdea06-5cbb-4881-9093-96e59f59b8b8",
- "feedback": null
- },
- {
- "qualityId": "66137bd8-b9c2-40e1-a360-40b7ee75eaef",
+ "qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de",
"feedback": null } ], "rubricQualitySelectedLevels": [ {
- "qualityId": "a660004a-608d-4cd2-a6dc-4f43812444ee",
+ "qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c",
"columnId": null }, {
- "qualityId": "2c5ae75d-d347-426b-be2c-cfc81a6f0b32",
- "columnId": null
+ "qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b",
+ "columnId": "0f9823a2-174c-4ce0-8f12-e298c291f29b"
}, {
- "qualityId": "32fdea06-5cbb-4881-9093-96e59f59b8b8",
- "columnId": null
- },
- {
- "qualityId": "66137bd8-b9c2-40e1-a360-40b7ee75eaef",
+ "qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de",
"columnId": null } ], "publishedRubricQualityFeedback": [ {
- "qualityId": "a660004a-608d-4cd2-a6dc-4f43812444ee",
- "feedback": null
- },
- {
- "qualityId": "2c5ae75d-d347-426b-be2c-cfc81a6f0b32",
+ "qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c",
"feedback": null }, {
- "qualityId": "32fdea06-5cbb-4881-9093-96e59f59b8b8",
- "feedback": null
+ "qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b",
+ "feedback": {
+ "content": "Needs improvement",
+ "contentType": "text"
+ }
}, {
- "qualityId": "66137bd8-b9c2-40e1-a360-40b7ee75eaef",
+ "qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de",
"feedback": null } ], "publishedRubricQualitySelectedLevels": [ {
- "qualityId": "a660004a-608d-4cd2-a6dc-4f43812444ee",
+ "qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c",
"columnId": null }, {
- "qualityId": "2c5ae75d-d347-426b-be2c-cfc81a6f0b32",
- "columnId": null
- },
- {
- "qualityId": "32fdea06-5cbb-4881-9093-96e59f59b8b8",
- "columnId": null
+ "qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b",
+ "columnId": "0f9823a2-174c-4ce0-8f12-e298c291f29b"
}, {
- "qualityId": "66137bd8-b9c2-40e1-a360-40b7ee75eaef",
+ "qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de",
"columnId": null } ] } ],
+ "resources@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('a86a5c30-0437-49d6-9c6b-b1ce0d8d5574')/assignments('95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f')/submissions('e1a0240e-f3af-f039-63e7-09c3cbf8d176')/resources",
"resources": [],
+ "submittedResources@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('a86a5c30-0437-49d6-9c6b-b1ce0d8d5574')/assignments('95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f')/submissions('e1a0240e-f3af-f039-63e7-09c3cbf8d176')/submittedResources",
"submittedResources": [] } ```
v1.0 Educationsubmission List Outcomes https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-list-outcomes.md
Title: "List outcomes"
-description: "Retrieve a list of educationoutcome objects."
+description: "Retrieve a list of educationOutcome objects."
ms.localizationpriority: medium ms.prod: "education"
A submission for a points assignment (one that has a point value assigned) will
A submission for an assignment with an attached rubric, if the rubric is a credit rubric (no points), will have an [educationFeedbackOutcome](../resources/educationpointsoutcome.md) and an [educationRubricOutcome](../resources/educationrubricoutcome.md). (It might also return an [educationPointsOutcome](../resources/educationpointsoutcome.md), but that outcome is ignored.)
-A submission for an assignment with an attached rubric, if the rubric is a points rubric, will have an [educationFeedbackOutcome](../resources/educationpointsoutcome.md), an [educationPointsOutcome](../resources/educationpointsoutcome.md, and an [educationRubricOutcome](../resources/educationrubricoutcome.md).
+A submission for an assignment with an attached rubric, if the rubric is a points rubric, will have an [educationFeedbackOutcome](../resources/educationpointsoutcome.md), an [educationPointsOutcome](../resources/educationpointsoutcome.md), and an [educationRubricOutcome](../resources/educationrubricoutcome.md).
A submission for a feedback resource will have an [educationFeedbackResourceOutcome](../resources/educationfeedbackresourceoutcome.md).
-All outcome types have a regular and a published property appropriate to that type of outcome; for example, **points** and **publishedPoints**, **feedback** and **publishedFeedback**. The regular property is the most recent value updated by the teacher; the published property is the most recent value returned to the student.
+All outcome types have a regular and a published property appropriate to that type of outcome; for example, **points** and **publishedPoints**, **feedback** and **publishedFeedback**. The regular property is the most recent value updated by the teacher; the published property is the most recent value returned to the student.
## Permissions
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-GET /education/classes/{id}/assignments/{id}/submissions/{id}/outcomes
+GET /education/classes/{classId}/assignments/{assignmentId}/submissions/{submissionId}/outcomes
``` ## Optional query parameters
v1.0 Educationsubmission Reassign https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-reassign.md
The following is an example of the request.
}--> ```http
-POST /education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/7192332b-e904-4891-81e2-356242ab1858/submissions/02bb5de1-7205-2a25-fe33-f99cf53de1c4/reassign
+POST https://graph.microsoft.com/beta/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/assignments/db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a/submissions/4bca096a-7de3-8675-5e86-2fa149923860/reassign
``` # [C#](#tab/csharp)
HTTP/1.1 200 OK
"@odata.context": "https://graph.microsoft.com/beta/$metadata#educationSubmission", "@odata.type": "#microsoft.graph.educationSubmission", "status": "returned",
- "submittedDateTime": "2021-09-07T14:54:46.1606962Z",
- "unsubmittedDateTime": "2021-09-07T14:41:18.9512645Z",
- "returnedDateTime": "2021-09-07T21:38:40.5254847Z",
- "reassignedDateTime": "2021-09-07T21:38:40.5254847Z",
+ "submittedDateTime": "2022-10-19T23:32:49.3314767Z",
+ "unsubmittedDateTime": null,
+ "returnedDateTime": "2022-10-19T23:32:58.1079737Z",
+ "reassignedDateTime": "2022-10-19T23:32:58.1079737Z",
"resourcesFolderUrl": null,
- "id": "02bb5de1-7205-2a25-fe33-f99cf53de1c4",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%22bf1f1963-05f6-4cba-903c-5892b4ce3bd7%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%22db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%224bca096a-7de3-8675-5e86-2fa149923860%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "4bca096a-7de3-8675-5e86-2fa149923860",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226"
+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
HTTP/1.1 200 OK
"application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": null,
"displayName": null } },
HTTP/1.1 200 OK
"application": null, "device": null, "user": {
- "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
HTTP/1.1 200 OK
"application": null, "device": null, "user": {
- "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } }
The following is an example of the request.
}--> ```http
-POST /education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/7192332b-e904-4891-81e2-356242ab1858/submissions/02bb5de1-7205-2a25-fe33-f99cf53de1c4/reassign
+POST https://graph.microsoft.com/beta/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/assignments/db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a/submissions/b9dab587-5fcc-30ae-f7fa-41a47fb89972/reassign
Prefer: include-unknown-enum-members ```
HTTP/1.1 200 OK
"@odata.context": "https://graph.microsoft.com/beta/$metadata#educationSubmission", "@odata.type": "#microsoft.graph.educationSubmission", "status": "reassigned",
- "submittedDateTime": "2021-09-07T21:44:41.8377109Z",
- "unsubmittedDateTime": "2021-09-07T14:41:18.9512645Z",
+ "submittedDateTime": "2022-10-19T23:34:34.5246354Z",
+ "unsubmittedDateTime": null,
"returnedDateTime": null,
- "reassignedDateTime": "2021-09-07T21:45:42.9027726Z",
+ "reassignedDateTime": "2022-10-19T23:35:07.2786612Z",
"resourcesFolderUrl": null,
- "id": "02bb5de1-7205-2a25-fe33-f99cf53de1c4",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%22bf1f1963-05f6-4cba-903c-5892b4ce3bd7%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%22db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22b9dab587-5fcc-30ae-f7fa-41a47fb89972%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "b9dab587-5fcc-30ae-f7fa-41a47fb89972",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226"
+ "userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
HTTP/1.1 200 OK
"application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": null,
"displayName": null } },
HTTP/1.1 200 OK
"application": null, "device": null, "user": {
- "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } }
v1.0 Educationsubmission Return https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-return.md
The following is an example of the request.
}--> ```http
-POST https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/7192332b-e904-4891-81e2-356242ab1858/submissions/022fb52d-1278-d21f-e827-2221a6a3e516/return
+POST https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions/d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a/return
``` # [C#](#tab/csharp)
HTTP/1.1 200 Ok
"@odata.context": "https://graph.microsoft.com/beta/$metadata#educationSubmission", "@odata.type": "#microsoft.graph.educationSubmission", "status": "returned",
- "submittedDateTime": "2021-09-03T18:20:11.2167718Z",
+ "submittedDateTime": null,
"unsubmittedDateTime": null,
- "returnedDateTime": "2021-09-03T19:01:45.6526389Z",
- "resourcesFolderUrl": "https://graph.microsoft.com/beta/drives/b!OPmUsPgnBUiMIXMxWcj3neC1xck6I5NIsnFxfrLdmXodJYOAkI7rTLhw7ME_e42J/items/01QTY63RKYRQDN3FDQWNA24OCLHBD5C2SH",
- "id": "022fb52d-1278-d21f-e827-2221a6a3e516",
+ "returnedDateTime": "2022-10-19T23:00:30.9243194Z",
+ "reassignedDateTime": null,
+ "resourcesFolderUrl": null,
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226"
+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a",
"displayName": null } },
HTTP/1.1 200 Ok
"application": null, "device": null, "user": {
- "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ },
+ "reassignedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": null,
"displayName": null } }
v1.0 Educationsubmission Submit https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-submit.md
The following is an example of the request.
}--> ```http
-POST https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/7192332b-e904-4891-81e2-356242ab1858/submissions/02bb5de1-7205-2a25-fe33-f99cf53de1c4/submit
+POST https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions/efbecaf4-6956-4a76-6e10-b901e4de91c5/submit
``` # [C#](#tab/csharp)
HTTP/1.1 200 Ok
"@odata.context": "https://graph.microsoft.com/beta/$metadata#educationSubmission", "@odata.type": "#microsoft.graph.educationSubmission", "status": "submitted",
- "submittedDateTime": "2021-09-07T14:54:46.1606962Z",
- "unsubmittedDateTime": "2021-09-07T14:41:18.9512645Z",
- "returnedDateTime": null,
+ "submittedDateTime": "2022-10-19T23:02:20.4995757Z",
+ "unsubmittedDateTime": null,
+ "returnedDateTime": "2022-04-13T05:12:14.6531582Z",
+ "reassignedDateTime": null,
"resourcesFolderUrl": null,
- "id": "02bb5de1-7205-2a25-fe33-f99cf53de1c4",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22efbecaf4-6956-4a76-6e10-b901e4de91c5%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "efbecaf4-6956-4a76-6e10-b901e4de91c5",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226"
+ "userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
HTTP/1.1 200 Ok
"application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": null,
"displayName": null } }, "returnedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ },
+ "reassignedBy": {
"application": null, "device": null, "user": {
v1.0 Educationsubmission Unsubmit https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-unsubmit.md
The following is an example of the request.
}--> ```http
-POST https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/7192332b-e904-4891-81e2-356242ab1858/submissions/02bb5de1-7205-2a25-fe33-f99cf53de1c4/unsubmit
+POST https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/7242e03e-048c-437b-8810-3e89b285a362/submissions/3cea5cf6-55dc-d6c7-2f5b-3b5cd2e79c3a/unsubmit
``` # [C#](#tab/csharp)
HTTP/1.1 200 Ok
"@odata.type": "#microsoft.graph.educationSubmission", "status": "returned", "submittedDateTime": null,
- "unsubmittedDateTime": "2021-09-07T14:41:18.9512645Z",
- "returnedDateTime": null,
+ "unsubmittedDateTime": "2022-10-19T23:14:41.2934772Z",
+ "returnedDateTime": "2022-04-13T02:09:15.7223872Z",
+ "reassignedDateTime": null,
"resourcesFolderUrl": null,
- "id": "02bb5de1-7205-2a25-fe33-f99cf53de1c4",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%227242e03e-048c-437b-8810-3e89b285a362%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%223cea5cf6-55dc-d6c7-2f5b-3b5cd2e79c3a%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "3cea5cf6-55dc-d6c7-2f5b-3b5cd2e79c3a",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226"
+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a",
"displayName": null } },
HTTP/1.1 200 Ok
"application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } }, "returnedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ },
+ "reassignedBy": {
"application": null, "device": null, "user": {
v1.0 Educationsynchronizationprofile Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsynchronizationprofile-post.md
Title: "Create an educationSynchronizationProfile"
-description: "Create a request for a new school data synchronization profile in the tenant. Query the status to get the status of the profile. "
+description: "Create a request for a new school data synchronization profile in the tenant."
ms.localizationpriority: medium ms.prod: "education"
POST /education/synchronizationProfiles
In the request body, supply a JSON representation of the [educationSynchronizationProfile](../resources/educationsynchronizationprofile.md) object. ## Response
-If successful, this method returns a `202, Accepted` response code and an [educationSynchronizationProfile](../resources/educationsynchronizationprofile.md) object in the response body.
+If successful, this method returns a `202 Accepted` response code and an [educationSynchronizationProfile](../resources/educationsynchronizationprofile.md) object in the response body.
## Example
-##### Request
+### Request
The following is an example of the request. <!-- { "blockType": "ignored",
Content-type: application/json
{ "displayName": "Test Profile", "dataProvider": {
- "@odata.type": "#Microsoft.Education.DataSync.educationCsvDataProvider",
+ "@odata.type": "#microsoft.graph.educationCsvDataProvider",
"customizations": { "student": { "optionalPropertiesToSync": [
Content-type: application/json
} }, "identitySynchronizationConfiguration": {
- "@odata.type": "#Microsoft.Education.DataSync.educationIdentityCreationConfiguration",
+ "@odata.type": "#microsoft.graph.educationIdentityCreationConfiguration",
"userDomains": [ { "appliesTo": "student",
Content-type: application/json
} ```
-##### Response
+### Response
The following is an example of the response. >**Note:** The response object shown here might be shortened for readability.
v1.0 Group List Transitivemembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/group-list-transitivemembers.md
GET /groups/{id}/transitiveMembers
This method supports the [OData query parameters](/graph/query-parameters) to help customize the response, including `$search`, `$count`, and `$filter`. You can use `$search` on the **displayName** and **description** properties. When items are added or updated for this resource, they are specially indexed for use with the `$count` and `$search` query parameters. There can be a slight delay between when an item is added or updated and when it is available in the index.
+This API returns up to 100 member objects by default. The maximum page size that you can request through the `$top` query parameter is 999 objects.
+ To filter the results on the OData type, such as `microsoft.graph.user` or `microsoft.graph.group`, you must use the [advanced query parameters](/graph/aad-advanced-queries). That is, the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string. ## Request headers
v1.0 Group List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/group-list.md
GET /groups
## Optional query parameters
-This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$search`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. The default and maximum page sizes are 100 and 999 group objects respectively. Some queries are supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
+This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$search`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. `$skip` isn't supported. The default and maximum page sizes are 100 and 999 group objects respectively. Some queries are supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
To list only Microsoft 365 groups (aka unified groups), apply a filter on **groupTypes**:
v1.0 Identitygovernance Deleteditemcontainer Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-deleteditemcontainer-get.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_get_deleteditemcontainer_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/deletedItems/workflows/952b23c5-cc25-48c9-8848-95da4dd9dc6d?$select=id,category,displayName,description,version,executionConditions ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
Content-Type: application/json
"tasks@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/deletedItems/workflows('952b23c5-cc25-48c9-8848-95da4dd9dc6d')/tasks", "tasks": [] }
-```
+```
v1.0 Identitygovernance Lifecycleworkflowscontainer List Deleteditems https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-lifecycleworkflowscontainer-list-deleteditems.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_list_deleteditemcontainer_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/deletedItems/workflows?$select=id,category,displayName,description,version&$filter=category eq 'leaver' ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
Content-Type: application/json
} ] }
-```
+```
v1.0 Identitygovernance Lifecycleworkflowscontainer List Taskdefinitions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-lifecycleworkflowscontainer-list-taskdefinitions.md
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/taskD
``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go)
v1.0 Identitygovernance Run Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-run-get.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_get_workflow_run"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/runs/e65e08a0-d68d-41dc-915b-8c4019af5cc2?$select=id,failedTasksCount,failedUsersCount,processingStatus,totalTasksCount,totalUnprocessedTasksCount,totalUsersCount ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response
Content-Type: application/json
"totalUsersCount": 1, "totalUnprocessedTasksCount": 0 }
-```
+```
v1.0 Identitygovernance Run List Taskprocessingresults https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-run-list-taskprocessingresults.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_list_run_taskprocessingresult_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/runs/e65e08a0-d68d-41dc-915b-8c4019af5cc2/userProcessingResults/40efc576-840f-47d0-ab95-5abca800f8a2//taskProcessingResults?$select=id,failureReason,processingStatus,subject,task ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
Content-Type: application/json
} ] }
-```
+```
v1.0 Identitygovernance Run List Userprocessingresults https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-run-list-userprocessingresults.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_get_run_taskprocessingresult_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/runs/e65e08a0-d68d-41dc-915b-8c4019af5cc2/userProcessingResults?$select=id,failedTasksCount,processingStatus,totalTasksCount,totalUnprocessedTasksCount,subject ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
Content-Type: application/json
} ] }
-```
+```
v1.0 Identitygovernance Taskreport List Taskprocessingresults https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-taskreport-list-taskprocessingresults.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_list_taskreport_taskprocessingresult_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/taskReports/443c7611-45df-48c0-bf5e-dc6068c402f0/taskProcessingResults?$select=id,failureReason,processingStatus,subject,task ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
Content-Type: application/json
} ] }
-```
+```
v1.0 Identitygovernance Userprocessingresult Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-userprocessingresult-get.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_get_run_userprocessingresult"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/runs/e65e08a0-d68d-41dc-915b-8c4019af5cc2/userProcessingResults/40efc576-840f-47d0-ab95-5abca800f8a2?$select=id,failedTasksCount,processingStatus,totalTasksCount,totalUnprocessedTasksCount,subject ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
v1.0 Identitygovernance Userprocessingresult List Taskprocessingresults https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-userprocessingresult-list-taskprocessingresults.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_list_workflow_userprocessingresult_taskprocessingresult_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/userProcessingResults/40efc576-840f-47d0-ab95-5abca800f8a2/taskProcessingResults?$select=id,processingStatus,failureReason,subject,task ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response
Content-Type: application/json
} ] }
-```
+```
v1.0 Identitygovernance Workflow List Runs https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-workflow-list-runs.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_list_run_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/runs?$select=id,failedTasksCount,failedUsersCount,processingStatus,totalTasksCount,totalUnprocessedTasksCount,totalUsersCount,id ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
Content-Type: application/json
} ] }
-```
+```
v1.0 Identitygovernance Workflow List Taskreports https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-workflow-list-taskreports.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_list_taskreport_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/taskReports?$select=id,failedUsersCount,processingStatus,successfulUsersCount,totalUsersCount,unprocessedUsersCount,taskDefinition,taskProcessingResults ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
Content-Type: application/json
} ] }
-```
+```
v1.0 Identitygovernance Workflow List Userprocessingresults https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-workflow-list-userprocessingresults.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_list_userprocessingresult_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/156ce798-1eb6-4e0a-8515-e79f54d04390/userProcessingResults?$select=id,failedTasksCount,processingStatus,totalTasksCount,totalUnprocessedTasksCount,workflowExecutionType,subject ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
Content-Type: application/json
} ] }
-```
+```
v1.0 Identitygovernance Workflow List Versions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-workflow-list-versions.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_list_workflowversion_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/versions?$select=category,displayName,versionNumber ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response <!-- {
Content-Type: application/json
} ] }
-```
+```
v1.0 Identitygovernance Workflowversion Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-workflowversion-get.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_get_workflowversion_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/versions/2?$select=category,displayName,versionNumber,executionConditions&$expand=tasks ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response <!-- { "blockType": "response",
Content-Type: application/json
} ] }
-```
+```
v1.0 Internetexplorermode Delete Sitelists https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/internetexplorermode-delete-sitelists.md
+
+ Title: "Delete browserSiteList"
+description: "Delete a browserSiteList object."
+
+ms.localizationpriority: medium
++
+# Delete browserSiteList
+Namespace: microsoft.graph
++
+Delete a [browserSiteList](../resources/browsersitelist.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)|BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}
+```
+
+## 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.
+<!-- {
+ "blockType": "request",
+ "name": "delete_browsersitelist",
+ "sampleKeys": ["36ba61eb-c492-4283-a38b-963a1dbb2f69"]
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/36ba61eb-c492-4283-a38b-963a1dbb2f69
+```
++
+### Response
+The following is an example of the response.
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Internetexplorermode List Sitelists https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/internetexplorermode-list-sitelists.md
+
+ Title: "List browserSiteLists"
+description: "Get a list of the browserSiteList objects and their properties."
+
+ms.localizationpriority: medium
++
+# List browserSiteLists
+Namespace: microsoft.graph
++
+Get a list of the [browserSiteList](../resources/browsersitelist.md) objects and their 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)|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/edge/internetExplorerMode/siteLists
+```
+
+## 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 collection of [browserSiteList](../resources/browsersitelist.md) objects in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "list_browsersitelist"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists
+```
++
+### 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.browserSiteList",
+ "isCollection": true
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.browserSiteList",
+ "id": "e370d818-f650-5ab1-499e-5915e83f4573",
+ "description": "Production site list for devices",
+ "lastModifiedBy": {
+ "user": {
+ "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
+ "displayName": "Joe Smith"
+ },
+ "application": null
+ },
+ "lastModifiedDateTime": "2016-03-21T20:01:37Z",
+ "displayName": "Production Site List A",
+ "publishedBy": {
+ "user": {
+ "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
+ "displayName": "Joe Smith"
+ },
+ "application": null
+ },
+ "publishedDateTime": "2016-03-21T20:01:37Z",
+ "status": "published",
+ "revision": "1.0"
+ }
+ ]
+}
+```
+
v1.0 Internetexplorermode Post Sitelists https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/internetexplorermode-post-sitelists.md
+
+ Title: "Create browserSiteList"
+description: "Create a new browserSiteList object to support Internet Explorer mode."
+
+ms.localizationpriority: medium
++
+# Create browserSiteList
+Namespace: microsoft.graph
++
+Create a new [browserSiteList](../resources/browsersitelist.md) object to support [Internet Explorer mode](/deployedge/edge-ie-mode).
+
+## Permissions
+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)|BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /admin/edge/internetExplorerMode/siteLists
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply a JSON representation of the [browserSiteList](../resources/browsersitelist.md) object.
+
+You can specify the following properties when you create a **browserSiteList**.
+
+|Property|Type|Description|
+|:|:|:|
+|description|String|Description for the site list. Required.|
+|displayName|String|Display name of the site list. Required.|
++
+## Response
+
+If successful, this method returns a `201 Created` response code and a [browserSiteList](../resources/browsersitelist.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "create_browsersitelist_from_"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists
+Content-Type: application/json
+Content-length: 283
+
+{
+ "displayName": "Production Site List A",
+ "description": "Production site list for team A"
+}
+```
++
+### 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.browserSiteList"
+}
+-->
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.browserSiteList",
+ "id": "36ba61eb-c492-4283-a38b-963a1dbb2f69",
+ "revision": "",
+ "displayName": "Production Site List A",
+ "description": "Production site list for team A",
+ "lastModifiedDateTime": "2022-06-28T18:05:05.9569126Z",
+ "publishedDateTime": null,
+ "status": "draft",
+ "lastModifiedBy": {
+ "user": {
+ "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c",
+ "displayName": "Joe Smith"
+ },
+ "application": null
+ },
+ "publishedBy": null
+}
+```
+
v1.0 Intune Apps Ioslobapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-ioslobapp-create.md
The following table shows the properties that are required when you create the i
|expirationDateTime|DateTimeOffset|The expiration time.| |versionNumber|String|The version number of iOS Line of Business (LoB) app.| |buildNumber|String|The build number of iOS Line of Business (LoB) app.|
-|identityVersion|String|The identity version.|
+|identityVersion|String|The identity version. This property is being deprecated in 2211(November 2022)|
v1.0 Intune Apps Ioslobapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-ioslobapp-update.md
The following table shows the properties that are required when you create the [
|expirationDateTime|DateTimeOffset|The expiration time.| |versionNumber|String|The version number of iOS Line of Business (LoB) app.| |buildNumber|String|The build number of iOS Line of Business (LoB) app.|
-|identityVersion|String|The identity version.|
+|identityVersion|String|The identity version. This property is being deprecated in 2211(November 2022)|
v1.0 Intune Apps Macoslobapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macoslobapp-create.md
The following table shows the properties that are required when you create the m
|committedContentVersion|String|The internal committed content version. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |fileName|String|The name of the main Lob application file. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |size|Int64|The total size, including all uploaded files. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)|
-|bundleId|String|The bundle id.|
-|minimumSupportedOperatingSystem|[macOSMinimumOperatingSystem](../resources/intune-apps-macosminimumoperatingsystem.md)|The value for the minimum applicable operating system.|
-|buildNumber|String|The build number of MacOS Line of Business (LoB) app.|
-|versionNumber|String|The version number of MacOS Line of Business (LoB) app.|
-|childApps|[macOSLobChildApp](../resources/intune-apps-macoslobchildapp.md) collection|The app list in this bundle package|
-|identityVersion|String|The identity version.|
-|md5HashChunkSize|Int32|The chunk size for MD5 hash|
-|md5Hash|String collection|The MD5 hash codes|
-|ignoreVersionDetection|Boolean|A boolean to control whether the app's version will be used to detect the app after it is installed on a device. Set this to true for macOS Line of Business (LoB) apps that use a self update feature.|
-|installAsManaged|Boolean|A boolean to control whether the app will be installed as managed (requires macOS 11.0 and other PKG restrictions).|
+|bundleId|String|The primary bundleId of the package.|
+|minimumSupportedOperatingSystem|[macOSMinimumOperatingSystem](../resources/intune-apps-macosminimumoperatingsystem.md)|ComplexType macOSMinimumOperatingSystem that indicates the minimum operating system applicable for the application.|
+|buildNumber|String|The build number of the package. This should match the package CFBundleShortVersionString of the .pkg file.|
+|versionNumber|String|The version number of the package. This should match the package CFBundleVersion in the packageinfo file.|
+|childApps|[macOSLobChildApp](../resources/intune-apps-macoslobchildapp.md) collection|List of ComplexType macOSLobChildApp objects. Represents the apps expected to be installed by the package.|
+|identityVersion|String|The identity version. This property is being deprecated in 2211(November 2022).|
+|md5HashChunkSize|Int32|The chunk size for MD5 hash. This is '0' or empty if the package was uploaded directly. If the Intune App Wrapping Tool is used to create a .intunemac, this value can be found inside the Detection.xml file.|
+|md5Hash|String collection|The MD5 hash codes. This is empty if the package was uploaded directly. If the Intune App Wrapping Tool is used to create a .intunemac, this value can be found inside the Detection.xml file.|
+|ignoreVersionDetection|Boolean|When TRUE, indicates that the app's version will NOT be used to detect if the app is installed on a device. When FALSE, indicates that the app's version will be used to detect if the app is installed on a device. Set this to true for apps that use a self update feature.|
+|installAsManaged|Boolean|When TRUE, indicates that the app will be installed as managed (requires macOS 11.0 and other managed package restrictions). When FALSE, indicates that the app will be installed as unmanaged.|
v1.0 Intune Apps Macoslobapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macoslobapp-update.md
The following table shows the properties that are required when you create the [
|committedContentVersion|String|The internal committed content version. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |fileName|String|The name of the main Lob application file. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |size|Int64|The total size, including all uploaded files. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)|
-|bundleId|String|The bundle id.|
-|minimumSupportedOperatingSystem|[macOSMinimumOperatingSystem](../resources/intune-apps-macosminimumoperatingsystem.md)|The value for the minimum applicable operating system.|
-|buildNumber|String|The build number of MacOS Line of Business (LoB) app.|
-|versionNumber|String|The version number of MacOS Line of Business (LoB) app.|
-|childApps|[macOSLobChildApp](../resources/intune-apps-macoslobchildapp.md) collection|The app list in this bundle package|
-|identityVersion|String|The identity version.|
-|md5HashChunkSize|Int32|The chunk size for MD5 hash|
-|md5Hash|String collection|The MD5 hash codes|
-|ignoreVersionDetection|Boolean|A boolean to control whether the app's version will be used to detect the app after it is installed on a device. Set this to true for macOS Line of Business (LoB) apps that use a self update feature.|
-|installAsManaged|Boolean|A boolean to control whether the app will be installed as managed (requires macOS 11.0 and other PKG restrictions).|
+|bundleId|String|The primary bundleId of the package.|
+|minimumSupportedOperatingSystem|[macOSMinimumOperatingSystem](../resources/intune-apps-macosminimumoperatingsystem.md)|ComplexType macOSMinimumOperatingSystem that indicates the minimum operating system applicable for the application.|
+|buildNumber|String|The build number of the package. This should match the package CFBundleShortVersionString of the .pkg file.|
+|versionNumber|String|The version number of the package. This should match the package CFBundleVersion in the packageinfo file.|
+|childApps|[macOSLobChildApp](../resources/intune-apps-macoslobchildapp.md) collection|List of ComplexType macOSLobChildApp objects. Represents the apps expected to be installed by the package.|
+|identityVersion|String|The identity version. This property is being deprecated in 2211(November 2022).|
+|md5HashChunkSize|Int32|The chunk size for MD5 hash. This is '0' or empty if the package was uploaded directly. If the Intune App Wrapping Tool is used to create a .intunemac, this value can be found inside the Detection.xml file.|
+|md5Hash|String collection|The MD5 hash codes. This is empty if the package was uploaded directly. If the Intune App Wrapping Tool is used to create a .intunemac, this value can be found inside the Detection.xml file.|
+|ignoreVersionDetection|Boolean|When TRUE, indicates that the app's version will NOT be used to detect if the app is installed on a device. When FALSE, indicates that the app's version will be used to detect if the app is installed on a device. Set this to true for apps that use a self update feature.|
+|installAsManaged|Boolean|When TRUE, indicates that the app will be installed as managed (requires macOS 11.0 and other managed package restrictions). When FALSE, indicates that the app will be installed as unmanaged.|
v1.0 Intune Apps Macosmicrosoftdefenderapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmicrosoftdefenderapp-create.md
+
+ Title: "Create macOSMicrosoftDefenderApp"
+description: "Create a new macOSMicrosoftDefenderApp object."
+
+localization_priority: Normal
++
+# Create macOSMicrosoftDefenderApp
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Create a new [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object.
+
+## Prerequisites
+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)|DeviceManagementApps.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementApps.ReadWrite.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceAppManagement/mobileApps
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+In the request body, supply a JSON representation for the macOSMicrosoftDefenderApp object.
+
+The following table shows the properties that are required when you create the macOSMicrosoftDefenderApp.
+
+|Property|Type|Description|
+|:|:|:|
+|id|String|Key of the entity. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|displayName|String|The admin provided or imported title of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|description|String|The description of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|publisher|String|The publisher of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|largeIcon|[mimeContent](../resources/intune-shared-mimecontent.md)|The large icon, to be displayed in the app details and used for upload of the icon. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|createdDateTime|DateTimeOffset|The date and time the app was created. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|lastModifiedDateTime|DateTimeOffset|The date and time the app was last modified. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|isFeatured|Boolean|The value indicating whether the app is marked as featured by the admin. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|privacyInformationUrl|String|The privacy statement Url. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|informationUrl|String|The more information Url. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|owner|String|The owner of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|developer|String|The developer of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|notes|String|Notes for the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|uploadState|Int32|The upload state. Possible values are: 0 - `Not Ready`, 1 - `Ready`, 2 - `Processing`. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|publishingState|[mobileAppPublishingState](../resources/intune-apps-mobileapppublishingstate.md)|The publishing state for the app. The app cannot be assigned unless the app is published. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md). Possible values are: `notPublished`, `processing`, `published`.|
+|isAssigned|Boolean|The value indicating whether the app is assigned to at least one group. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|roleScopeTagIds|String collection|List of scope tag ids for this mobile app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+++
+## Response
+If successful, this method returns a `201 Created` response code and a [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps
+Content-type: application/json
+Content-length: 781
+
+{
+ "@odata.type": "#microsoft.graph.macOSMicrosoftDefenderApp",
+ "displayName": "Display Name value",
+ "description": "Description value",
+ "publisher": "Publisher value",
+ "largeIcon": {
+ "@odata.type": "microsoft.graph.mimeContent",
+ "type": "Type value",
+ "value": "dmFsdWU="
+ },
+ "isFeatured": true,
+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
+ "informationUrl": "https://example.com/informationUrl/",
+ "owner": "Owner value",
+ "developer": "Developer value",
+ "notes": "Notes value",
+ "uploadState": 11,
+ "publishingState": "processing",
+ "isAssigned": true,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ],
+ "dependentAppCount": 1,
+ "supersedingAppCount": 3,
+ "supersededAppCount": 2
+}
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+Content-Length: 953
+
+{
+ "@odata.type": "#microsoft.graph.macOSMicrosoftDefenderApp",
+ "id": "ca25fa0c-fa0c-ca25-0cfa-25ca0cfa25ca",
+ "displayName": "Display Name value",
+ "description": "Description value",
+ "publisher": "Publisher value",
+ "largeIcon": {
+ "@odata.type": "microsoft.graph.mimeContent",
+ "type": "Type value",
+ "value": "dmFsdWU="
+ },
+ "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
+ "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
+ "isFeatured": true,
+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
+ "informationUrl": "https://example.com/informationUrl/",
+ "owner": "Owner value",
+ "developer": "Developer value",
+ "notes": "Notes value",
+ "uploadState": 11,
+ "publishingState": "processing",
+ "isAssigned": true,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ],
+ "dependentAppCount": 1,
+ "supersedingAppCount": 3,
+ "supersededAppCount": 2
+}
+```
+++++
v1.0 Intune Apps Macosmicrosoftdefenderapp Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmicrosoftdefenderapp-delete.md
+
+ Title: "Delete macOSMicrosoftDefenderApp"
+description: "Deletes a macOSMicrosoftDefenderApp."
+
+localization_priority: Normal
++
+# Delete macOSMicrosoftDefenderApp
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Deletes a [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md).
+
+## Prerequisites
+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)|DeviceManagementApps.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementApps.ReadWrite.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /deviceAppManagement/mobileApps/{mobileAppId}
+DELETE /deviceAppManagement/mobileApps/{mobileAppId}/userStatuses/{userAppInstallStatusId}/app
+DELETE /deviceAppManagement/mobileApps/{mobileAppId}/deviceStatuses/{mobileAppInstallStatusId}/app
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns a `204 No Content` response code.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 204 No Content
+```
+++++
v1.0 Intune Apps Macosmicrosoftdefenderapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmicrosoftdefenderapp-get.md
+
+ Title: "Get macOSMicrosoftDefenderApp"
+description: "Read properties and relationships of the macOSMicrosoftDefenderApp object."
+
+localization_priority: Normal
++
+# Get macOSMicrosoftDefenderApp
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Read properties and relationships of the [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object.
+
+## Prerequisites
+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)|DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /deviceAppManagement/mobileApps/{mobileAppId}
+GET /deviceAppManagement/mobileApps/{mobileAppId}/userStatuses/{userAppInstallStatusId}/app
+GET /deviceAppManagement/mobileApps/{mobileAppId}/deviceStatuses/{mobileAppInstallStatusId}/app
+```
+
+## Optional query parameters
+This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns a `200 OK` response code and [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+GET https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 1026
+
+{
+ "value": {
+ "@odata.type": "#microsoft.graph.macOSMicrosoftDefenderApp",
+ "id": "ca25fa0c-fa0c-ca25-0cfa-25ca0cfa25ca",
+ "displayName": "Display Name value",
+ "description": "Description value",
+ "publisher": "Publisher value",
+ "largeIcon": {
+ "@odata.type": "microsoft.graph.mimeContent",
+ "type": "Type value",
+ "value": "dmFsdWU="
+ },
+ "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
+ "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
+ "isFeatured": true,
+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
+ "informationUrl": "https://example.com/informationUrl/",
+ "owner": "Owner value",
+ "developer": "Developer value",
+ "notes": "Notes value",
+ "uploadState": 11,
+ "publishingState": "processing",
+ "isAssigned": true,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ],
+ "dependentAppCount": 1,
+ "supersedingAppCount": 3,
+ "supersededAppCount": 2
+ }
+}
+```
+++++
v1.0 Intune Apps Macosmicrosoftdefenderapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmicrosoftdefenderapp-list.md
+
+ Title: "List macOSMicrosoftDefenderApps"
+description: "List properties and relationships of the macOSMicrosoftDefenderApp objects."
+
+localization_priority: Normal
++
+# List macOSMicrosoftDefenderApps
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+List properties and relationships of the [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) objects.
+
+## Prerequisites
+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)|DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /deviceAppManagement/mobileApps
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns a `200 OK` response code and a collection of [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) objects in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+GET https://graph.microsoft.com/beta/deviceAppManagement/mobileApps
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 1094
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.macOSMicrosoftDefenderApp",
+ "id": "ca25fa0c-fa0c-ca25-0cfa-25ca0cfa25ca",
+ "displayName": "Display Name value",
+ "description": "Description value",
+ "publisher": "Publisher value",
+ "largeIcon": {
+ "@odata.type": "microsoft.graph.mimeContent",
+ "type": "Type value",
+ "value": "dmFsdWU="
+ },
+ "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
+ "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
+ "isFeatured": true,
+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
+ "informationUrl": "https://example.com/informationUrl/",
+ "owner": "Owner value",
+ "developer": "Developer value",
+ "notes": "Notes value",
+ "uploadState": 11,
+ "publishingState": "processing",
+ "isAssigned": true,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ],
+ "dependentAppCount": 1,
+ "supersedingAppCount": 3,
+ "supersededAppCount": 2
+ }
+ ]
+}
+```
+++++
v1.0 Intune Apps Macosmicrosoftdefenderapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmicrosoftdefenderapp-update.md
+
+ Title: "Update macOSMicrosoftDefenderApp"
+description: "Update the properties of a macOSMicrosoftDefenderApp object."
+
+localization_priority: Normal
++
+# Update macOSMicrosoftDefenderApp
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Update the properties of a [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object.
+
+## Prerequisites
+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)|DeviceManagementApps.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementApps.ReadWrite.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /deviceAppManagement/mobileApps/{mobileAppId}
+PATCH /deviceAppManagement/mobileApps/{mobileAppId}/userStatuses/{userAppInstallStatusId}/app
+PATCH /deviceAppManagement/mobileApps/{mobileAppId}/deviceStatuses/{mobileAppInstallStatusId}/app
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+In the request body, supply a JSON representation for the [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object.
+
+The following table shows the properties that are required when you create the [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md).
+
+|Property|Type|Description|
+|:|:|:|
+|id|String|Key of the entity. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|displayName|String|The admin provided or imported title of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|description|String|The description of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|publisher|String|The publisher of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|largeIcon|[mimeContent](../resources/intune-shared-mimecontent.md)|The large icon, to be displayed in the app details and used for upload of the icon. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|createdDateTime|DateTimeOffset|The date and time the app was created. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|lastModifiedDateTime|DateTimeOffset|The date and time the app was last modified. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|isFeatured|Boolean|The value indicating whether the app is marked as featured by the admin. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|privacyInformationUrl|String|The privacy statement Url. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|informationUrl|String|The more information Url. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|owner|String|The owner of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|developer|String|The developer of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|notes|String|Notes for the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|uploadState|Int32|The upload state. Possible values are: 0 - `Not Ready`, 1 - `Ready`, 2 - `Processing`. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|publishingState|[mobileAppPublishingState](../resources/intune-apps-mobileapppublishingstate.md)|The publishing state for the app. The app cannot be assigned unless the app is published. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md). Possible values are: `notPublished`, `processing`, `published`.|
+|isAssigned|Boolean|The value indicating whether the app is assigned to at least one group. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|roleScopeTagIds|String collection|List of scope tag ids for this mobile app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+++
+## Response
+If successful, this method returns a `200 OK` response code and an updated [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}
+Content-type: application/json
+Content-length: 781
+
+{
+ "@odata.type": "#microsoft.graph.macOSMicrosoftDefenderApp",
+ "displayName": "Display Name value",
+ "description": "Description value",
+ "publisher": "Publisher value",
+ "largeIcon": {
+ "@odata.type": "microsoft.graph.mimeContent",
+ "type": "Type value",
+ "value": "dmFsdWU="
+ },
+ "isFeatured": true,
+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
+ "informationUrl": "https://example.com/informationUrl/",
+ "owner": "Owner value",
+ "developer": "Developer value",
+ "notes": "Notes value",
+ "uploadState": 11,
+ "publishingState": "processing",
+ "isAssigned": true,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ],
+ "dependentAppCount": 1,
+ "supersedingAppCount": 3,
+ "supersededAppCount": 2
+}
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 953
+
+{
+ "@odata.type": "#microsoft.graph.macOSMicrosoftDefenderApp",
+ "id": "ca25fa0c-fa0c-ca25-0cfa-25ca0cfa25ca",
+ "displayName": "Display Name value",
+ "description": "Description value",
+ "publisher": "Publisher value",
+ "largeIcon": {
+ "@odata.type": "microsoft.graph.mimeContent",
+ "type": "Type value",
+ "value": "dmFsdWU="
+ },
+ "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
+ "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
+ "isFeatured": true,
+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
+ "informationUrl": "https://example.com/informationUrl/",
+ "owner": "Owner value",
+ "developer": "Developer value",
+ "notes": "Notes value",
+ "uploadState": 11,
+ "publishingState": "processing",
+ "isAssigned": true,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ],
+ "dependentAppCount": 1,
+ "supersedingAppCount": 3,
+ "supersededAppCount": 2
+}
+```
+++++
v1.0 Intune Apps Macosmicrosoftedgeapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmicrosoftedgeapp-create.md
The following table shows the properties that are required when you create the m
|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
-|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`.|
+|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`, `unknownFutureValue`.|
v1.0 Intune Apps Macosmicrosoftedgeapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmicrosoftedgeapp-update.md
The following table shows the properties that are required when you create the [
|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
-|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`.|
+|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`, `unknownFutureValue`.|
v1.0 Intune Apps Windowsmicrosoftedgeapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-windowsmicrosoftedgeapp-create.md
The following table shows the properties that are required when you create the w
|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
-|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`.|
+|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`, `unknownFutureValue`.|
|displayLanguageLocale|String|The language locale to use when the Edge app displays text to the user.|
v1.0 Intune Apps Windowsmicrosoftedgeapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-windowsmicrosoftedgeapp-update.md
The following table shows the properties that are required when you create the [
|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
-|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`.|
+|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`, `unknownFutureValue`.|
|displayLanguageLocale|String|The language locale to use when the Edge app displays text to the user.|
v1.0 Intune Apps Wingetapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-wingetapp-create.md
The following table shows the properties that are required when you create the w
|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|manifestHash|String|Hash of package metadata properties used to validate that the application matches the metadata in the source repository.|
|packageIdentifier|String|The PackageIdentifier from the WinGet source repository REST API. This also maps to the Id when using the WinGet client command line application. Required at creation time, cannot be modified on existing objects.| |installExperience|[winGetAppInstallExperience](../resources/intune-apps-wingetappinstallexperience.md)|The install experience settings associated with this application, which are used to ensure the desired install experiences on the target device are taken into account. This includes the account type (System or User) that actions should be run as on target devices. Required at creation time.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps Content-type: application/json
-Content-length: 943
+Content-length: 985
{ "@odata.type": "#microsoft.graph.winGetApp",
Content-length: 943
"dependentAppCount": 1, "supersedingAppCount": 3, "supersededAppCount": 2,
+ "manifestHash": "Manifest Hash value",
"packageIdentifier": "Package Identifier value", "installExperience": { "@odata.type": "microsoft.graph.winGetAppInstallExperience",
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 1115
+Content-Length: 1157
{ "@odata.type": "#microsoft.graph.winGetApp",
Content-Length: 1115
"dependentAppCount": 1, "supersedingAppCount": 3, "supersededAppCount": 2,
+ "manifestHash": "Manifest Hash value",
"packageIdentifier": "Package Identifier value", "installExperience": { "@odata.type": "microsoft.graph.winGetAppInstallExperience",
v1.0 Intune Apps Wingetapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-wingetapp-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1198
+Content-Length: 1242
{ "value": {
Content-Length: 1198
"dependentAppCount": 1, "supersedingAppCount": 3, "supersededAppCount": 2,
+ "manifestHash": "Manifest Hash value",
"packageIdentifier": "Package Identifier value", "installExperience": { "@odata.type": "microsoft.graph.winGetAppInstallExperience",
v1.0 Intune Apps Wingetapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-wingetapp-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1276
+Content-Length: 1322
{ "value": [
Content-Length: 1276
"dependentAppCount": 1, "supersedingAppCount": 3, "supersededAppCount": 2,
+ "manifestHash": "Manifest Hash value",
"packageIdentifier": "Package Identifier value", "installExperience": { "@odata.type": "microsoft.graph.winGetAppInstallExperience",
v1.0 Intune Apps Wingetapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-wingetapp-update.md
The following table shows the properties that are required when you create the [
|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|manifestHash|String|Hash of package metadata properties used to validate that the application matches the metadata in the source repository.|
|packageIdentifier|String|The PackageIdentifier from the WinGet source repository REST API. This also maps to the Id when using the WinGet client command line application. Required at creation time, cannot be modified on existing objects.| |installExperience|[winGetAppInstallExperience](../resources/intune-apps-wingetappinstallexperience.md)|The install experience settings associated with this application, which are used to ensure the desired install experiences on the target device are taken into account. This includes the account type (System or User) that actions should be run as on target devices. Required at creation time.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId} Content-type: application/json
-Content-length: 943
+Content-length: 985
{ "@odata.type": "#microsoft.graph.winGetApp",
Content-length: 943
"dependentAppCount": 1, "supersedingAppCount": 3, "supersededAppCount": 2,
+ "manifestHash": "Manifest Hash value",
"packageIdentifier": "Package Identifier value", "installExperience": { "@odata.type": "microsoft.graph.winGetAppInstallExperience",
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1115
+Content-Length: 1157
{ "@odata.type": "#microsoft.graph.winGetApp",
Content-Length: 1115
"dependentAppCount": 1, "supersedingAppCount": 3, "supersededAppCount": 2,
+ "manifestHash": "Manifest Hash value",
"packageIdentifier": "Package Identifier value", "installExperience": { "@odata.type": "microsoft.graph.winGetAppInstallExperience",
v1.0 Intune Deviceconfig Androiddeviceownergeneraldeviceconfiguration Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownergeneraldeviceconfiguration-create.md
The following table shows the properties that are required when you create the a
|networkEscapeHatchAllowed|Boolean|Indicates whether or not the device will allow connecting to a temporary network connection at boot time.| |nfcBlockOutgoingBeam|Boolean|Indicates whether or not to block NFC outgoing beam.| |passwordBlockKeyguard|Boolean|Indicates whether or not the keyguard is disabled.|
-|passwordBlockKeyguardFeatures|[androidKeyguardFeature](../resources/intune-deviceconfig-androidkeyguardfeature.md) collection|List of device keyguard features to block. This collection can contain a maximum of 7 elements. Possible values are: `notConfigured`, `camera`, `notifications`, `unredactedNotifications`, `trustAgents`, `fingerprint`, `remoteInput`, `allFeatures`, `face`, `iris`, `biometrics`.|
+|passwordBlockKeyguardFeatures|[androidKeyguardFeature](../resources/intune-deviceconfig-androidkeyguardfeature.md) collection|List of device keyguard features to block. This collection can contain a maximum of 11 elements. Possible values are: `notConfigured`, `camera`, `notifications`, `unredactedNotifications`, `trustAgents`, `fingerprint`, `remoteInput`, `allFeatures`, `face`, `iris`, `biometrics`.|
|passwordExpirationDays|Int32|Indicates the amount of time that a password can be set for before it expires and a new password will be required. Valid values 1 to 365| |passwordMinimumLength|Int32|Indicates the minimum length of the password required on the device. Valid values 4 to 16| |passwordMinimumLetterCharacters|Int32|Indicates the minimum number of letter characters required for device password. Valid values 1 to 16|
v1.0 Intune Deviceconfig Androiddeviceownergeneraldeviceconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownergeneraldeviceconfiguration-update.md
The following table shows the properties that are required when you create the [
|networkEscapeHatchAllowed|Boolean|Indicates whether or not the device will allow connecting to a temporary network connection at boot time.| |nfcBlockOutgoingBeam|Boolean|Indicates whether or not to block NFC outgoing beam.| |passwordBlockKeyguard|Boolean|Indicates whether or not the keyguard is disabled.|
-|passwordBlockKeyguardFeatures|[androidKeyguardFeature](../resources/intune-deviceconfig-androidkeyguardfeature.md) collection|List of device keyguard features to block. This collection can contain a maximum of 7 elements. Possible values are: `notConfigured`, `camera`, `notifications`, `unredactedNotifications`, `trustAgents`, `fingerprint`, `remoteInput`, `allFeatures`, `face`, `iris`, `biometrics`.|
+|passwordBlockKeyguardFeatures|[androidKeyguardFeature](../resources/intune-deviceconfig-androidkeyguardfeature.md) collection|List of device keyguard features to block. This collection can contain a maximum of 11 elements. Possible values are: `notConfigured`, `camera`, `notifications`, `unredactedNotifications`, `trustAgents`, `fingerprint`, `remoteInput`, `allFeatures`, `face`, `iris`, `biometrics`.|
|passwordExpirationDays|Int32|Indicates the amount of time that a password can be set for before it expires and a new password will be required. Valid values 1 to 365| |passwordMinimumLength|Int32|Indicates the minimum length of the password required on the device. Valid values 4 to 16| |passwordMinimumLetterCharacters|Int32|Indicates the minimum number of letter characters required for device password. Valid values 1 to 16|
v1.0 Intune Deviceconfig Devicecompliancepolicy Setscheduledretirestate https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfig-devicecompliancepolicy-setscheduledretirestate.md
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
+|scopedToAllDevices|Boolean|Not yet documented|
|state|[scheduledRetireState](../resources/intune-deviceconfig-scheduledretirestate.md)|Not yet documented| |managedDeviceIds|String collection|Not yet documented|
Here is an example of the request.
POST https://graph.microsoft.com/beta/deviceManagement/deviceCompliancePolicies/setScheduledRetireState Content-type: application/json
-Content-length: 95
+Content-length: 126
{
+ "scopedToAllDevices": true,
"state": "confirmRetire", "managedDeviceIds": [ "Managed Device Ids value"
v1.0 Intune Deviceconfigv2 Devicemanagementcompliancepolicy Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementcompliancepolicy-create.md
The following table shows the properties that are required when you create the d
|name|String|Policy name| |description|String|Policy description| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this policy. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
|createdDateTime|DateTimeOffset|Policy creation date and time. This property is read-only.| |lastModifiedDateTime|DateTimeOffset|Policy last modification date and time. This property is read-only.| |settingCount|Int32|Number of settings. This property is read-only.|
v1.0 Intune Deviceconfigv2 Devicemanagementcompliancepolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementcompliancepolicy-update.md
The following table shows the properties that are required when you create the [
|name|String|Policy name| |description|String|Policy description| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this policy. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
|createdDateTime|DateTimeOffset|Policy creation date and time. This property is read-only.| |lastModifiedDateTime|DateTimeOffset|Policy last modification date and time. This property is read-only.| |settingCount|Int32|Number of settings. This property is read-only.|
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationcategory Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationcategory-create.md
The following table shows the properties that are required when you create the d
|name|String|Name of the item| |displayName|String|Display name of the item| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms types, which settings in the category have. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies types, which settings in the category have. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies types, which settings in the category have. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicates that the category contains settings that are used for Compliance or Configuration. Possible values are: `none`, `configuration`, `compliance`.| |parentCategoryId|String|Parent id of the category.| |rootCategoryId|String|Root id of the category.|
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationcategory Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationcategory-update.md
The following table shows the properties that are required when you create the [
|name|String|Name of the item| |displayName|String|Display name of the item| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms types, which settings in the category have. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies types, which settings in the category have. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies types, which settings in the category have. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicates that the category contains settings that are used for Compliance or Configuration. Possible values are: `none`, `configuration`, `compliance`.| |parentCategoryId|String|Parent id of the category.| |rootCategoryId|String|Root id of the category.|
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Assign https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-assign.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-POST /deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}/assign
POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assign POST /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId}/assign ```
If successful, this action returns a `200 OK` response code and a [deviceManagem
### Request Here is an example of the request. ``` http
-POST https://graph.microsoft.com/beta/deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}/assign
+POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assign
Content-type: application/json Content-length: 593
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-create.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-POST /deviceManagementConfigurationPolicy
POST /deviceManagement/configurationPolicies POST /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies ```
The following table shows the properties that are required when you create the d
|name|String|Policy name| |description|String|Policy description| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this policy. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
|createdDateTime|DateTimeOffset|Policy creation date and time| |lastModifiedDateTime|DateTimeOffset|Policy last modification date and time| |settingCount|Int32|Number of settings|
If successful, this method returns a `201 Created` response code and a [deviceMa
### Request Here is an example of the request. ``` http
-POST https://graph.microsoft.com/beta/deviceManagementConfigurationPolicy
+POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies
Content-type: application/json
-Content-length: 789
+Content-length: 809
{ "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicy",
Content-length: 789
"templateDisplayVersion": "Template Display Version value" }, "priorityMetaData": {
- "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData"
+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
+ "priority": 8
} } ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 961
+Content-Length: 981
{ "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicy",
Content-Length: 961
"templateDisplayVersion": "Template Display Version value" }, "priorityMetaData": {
- "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData"
+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
+ "priority": 8
} } ```
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Createcopy https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-createcopy.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-POST /deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}/createCopy
POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/createCopy POST /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId}/createCopy ```
If successful, this action returns a `200 OK` response code and a [deviceManagem
### Request Here is an example of the request. ``` http
-POST https://graph.microsoft.com/beta/deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}/createCopy
+POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/createCopy
Content-type: application/json Content-length: 82
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1028
+Content-Length: 1050
{ "value": {
Content-Length: 1028
"templateDisplayVersion": "Template Display Version value" }, "priorityMetaData": {
- "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData"
+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
+ "priority": 8
} } }
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-delete.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-DELETE /deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}
DELETE /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId} DELETE /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId} ```
If successful, this method returns a `204 No Content` response code.
### Request Here is an example of the request. ``` http
-DELETE https://graph.microsoft.com/beta/deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}
+DELETE https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}
``` ### Response
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-get.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-GET /deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}
GET /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId} GET /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId} ```
If successful, this method returns a `200 OK` response code and [deviceManagemen
### Request Here is an example of the request. ``` http
-GET https://graph.microsoft.com/beta/deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}
+GET https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}
``` ### Response
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1028
+Content-Length: 1050
{ "value": {
Content-Length: 1028
"templateDisplayVersion": "Template Display Version value" }, "priorityMetaData": {
- "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData"
+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
+ "priority": 8
} } }
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-list.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-GET /deviceManagementConfigurationPolicy
GET /deviceManagement/configurationPolicies GET /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies ```
If successful, this method returns a `200 OK` response code and a collection of
### Request Here is an example of the request. ``` http
-GET https://graph.microsoft.com/beta/deviceManagementConfigurationPolicy
+GET https://graph.microsoft.com/beta/deviceManagement/configurationPolicies
``` ### Response
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1090
+Content-Length: 1114
{ "value": [
Content-Length: 1090
"templateDisplayVersion": "Template Display Version value" }, "priorityMetaData": {
- "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData"
+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
+ "priority": 8
} } ]
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Reorder https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-reorder.md
+
+ Title: "reorder action"
+description: "Not yet documented"
+
+localization_priority: Normal
++
+# reorder action
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Not yet documented
+
+## Prerequisites
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementConfiguration.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementConfiguration.Read.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/reorder
+POST /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId}/reorder
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+In the request body, supply JSON representation of the parameters.
+
+The following table shows the parameters that can be used with this action.
+
+|Property|Type|Description|
+|:|:|:|
+|priority|Int32|Not yet documented|
+++
+## Response
+If successful, this action returns a `204 No Content` response code.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/reorder
+
+Content-type: application/json
+Content-length: 21
+
+{
+ "priority": 8
+}
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 204 No Content
+```
+++++
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-update.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-PATCH /deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}
PATCH /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId} PATCH /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId} ```
The following table shows the properties that are required when you create the [
|name|String|Policy name| |description|String|Policy description| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this policy. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
|createdDateTime|DateTimeOffset|Policy creation date and time| |lastModifiedDateTime|DateTimeOffset|Policy last modification date and time| |settingCount|Int32|Number of settings|
If successful, this method returns a `200 OK` response code and an updated [devi
### Request Here is an example of the request. ``` http
-PATCH https://graph.microsoft.com/beta/deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}
+PATCH https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}
Content-type: application/json
-Content-length: 789
+Content-length: 809
{ "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicy",
Content-length: 789
"templateDisplayVersion": "Template Display Version value" }, "priorityMetaData": {
- "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData"
+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
+ "priority": 8
} } ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 961
+Content-Length: 981
{ "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicy",
Content-Length: 961
"templateDisplayVersion": "Template Display Version value" }, "priorityMetaData": {
- "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData"
+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
+ "priority": 8
} } ```
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicytemplate Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicytemplate-create.md
The following table shows the properties that are required when you create the d
|displayVersion|String|Description of template version| |lifecycleState|[deviceManagementTemplateLifecycleState](../resources/intune-deviceconfigv2-devicemanagementtemplatelifecyclestate.md)|Indicate current lifecycle state of template. Possible values are: `invalid`, `draft`, `active`, `superseded`, `deprecated`, `retired`.| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this template. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this template. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
-|templateFamily|[deviceManagementConfigurationTemplateFamily](../resources/intune-deviceconfigv2-devicemanagementconfigurationtemplatefamily.md)|TemplateFamily for this template. Possible values are: `none`, `endpointSecurityAntivirus`, `endpointSecurityDiskEncryption`, `endpointSecurityFirewall`, `endpointSecurityEndpointDetectionAndResponse`, `endpointSecurityAttackSurfaceReduction`, `endpointSecurityAccountProtection`, `endpointSecurityApplicationControl`, `enrollmentConfiguration`, `baseline`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this template. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
+|templateFamily|[deviceManagementConfigurationTemplateFamily](../resources/intune-deviceconfigv2-devicemanagementconfigurationtemplatefamily.md)|TemplateFamily for this template. Possible values are: `none`, `endpointSecurityAntivirus`, `endpointSecurityDiskEncryption`, `endpointSecurityFirewall`, `endpointSecurityEndpointDetectionAndResponse`, `endpointSecurityAttackSurfaceReduction`, `endpointSecurityAccountProtection`, `endpointSecurityApplicationControl`, `endpointSecurityEndpointPrivilegeManagement`, `enrollmentConfiguration`, `appQuietTime`, `baseline`, `unknownFutureValue`.|
|allowUnmanagedSettings|Boolean|Allow unmanaged setting templates| |settingTemplateCount|Int32|Number of setting templates. Valid values 0 to 2147483647. This property is read-only.|
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicytemplate Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicytemplate-update.md
The following table shows the properties that are required when you create the [
|displayVersion|String|Description of template version| |lifecycleState|[deviceManagementTemplateLifecycleState](../resources/intune-deviceconfigv2-devicemanagementtemplatelifecyclestate.md)|Indicate current lifecycle state of template. Possible values are: `invalid`, `draft`, `active`, `superseded`, `deprecated`, `retired`.| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this template. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this template. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
-|templateFamily|[deviceManagementConfigurationTemplateFamily](../resources/intune-deviceconfigv2-devicemanagementconfigurationtemplatefamily.md)|TemplateFamily for this template. Possible values are: `none`, `endpointSecurityAntivirus`, `endpointSecurityDiskEncryption`, `endpointSecurityFirewall`, `endpointSecurityEndpointDetectionAndResponse`, `endpointSecurityAttackSurfaceReduction`, `endpointSecurityAccountProtection`, `endpointSecurityApplicationControl`, `enrollmentConfiguration`, `baseline`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this template. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
+|templateFamily|[deviceManagementConfigurationTemplateFamily](../resources/intune-deviceconfigv2-devicemanagementconfigurationtemplatefamily.md)|TemplateFamily for this template. Possible values are: `none`, `endpointSecurityAntivirus`, `endpointSecurityDiskEncryption`, `endpointSecurityFirewall`, `endpointSecurityEndpointDetectionAndResponse`, `endpointSecurityAttackSurfaceReduction`, `endpointSecurityAccountProtection`, `endpointSecurityApplicationControl`, `endpointSecurityEndpointPrivilegeManagement`, `enrollmentConfiguration`, `appQuietTime`, `baseline`, `unknownFutureValue`.|
|allowUnmanagedSettings|Boolean|Allow unmanaged setting templates| |settingTemplateCount|Int32|Number of setting templates. Valid values 0 to 2147483647. This property is read-only.|
v1.0 Intune Devices Comanagementeligibledevice Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-comanagementeligibledevice-create.md
The following table shows the properties that are required when you create the c
|upn|String|UPN| |userEmail|String|UserEmail| |userName|String|UserName|
-|status|[comanagementEligibleType](../resources/intune-devices-comanagementeligibletype.md)|ComanagementEligibleStatus. Possible values are: `comanaged`, `eligible`, `eligibleButNotAzureAdJoined`, `needsOsUpdate`, `ineligible`, `scheduledForEnrollment`.|
+|status|[comanagementEligibleType](../resources/intune-devices-comanagementeligibletype.md)|ComanagementEligibleStatus. Possible values are: `comanaged`, `eligible`, `eligibleButNotAzureAdJoined`, `needsOsUpdate`, `ineligible`, `scheduledForEnrollment`, `unknownFutureValue`.|
v1.0 Intune Devices Comanagementeligibledevice Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-comanagementeligibledevice-update.md
The following table shows the properties that are required when you create the [
|upn|String|UPN| |userEmail|String|UserEmail| |userName|String|UserName|
-|status|[comanagementEligibleType](../resources/intune-devices-comanagementeligibletype.md)|ComanagementEligibleStatus. Possible values are: `comanaged`, `eligible`, `eligibleButNotAzureAdJoined`, `needsOsUpdate`, `ineligible`, `scheduledForEnrollment`.|
+|status|[comanagementEligibleType](../resources/intune-devices-comanagementeligibletype.md)|ComanagementEligibleStatus. Possible values are: `comanaged`, `eligible`, `eligibleButNotAzureAdJoined`, `needsOsUpdate`, `ineligible`, `scheduledForEnrollment`, `unknownFutureValue`.|
v1.0 Intune Devices Detectedapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-detectedapp-create.md
The following table shows the properties that are required when you create the d
|sizeInByte|Int64|Discovered application size in bytes. Read-only| |deviceCount|Int32|The number of devices that have installed this application| |publisher|String|Indicates the publisher of the discovered application. For example: 'Microsoft'. The default value is an empty string.|
-|platform|[detectedAppPlatformType](../resources/intune-devices-detectedappplatformtype.md)|Indicates the operating system / platform of the discovered application. Some possible values are Windows, iOS, macOS. The default value is unknown (0). Possible values are: `unknown`, `windows`, `windowsMobile`, `windowsHolographic`, `ios`, `macOS`, `chromeOS`, `androidOSP`, `androidDeviceAdministrator`, `androidWorkProfile`, `androidDedicatedAndFullyManaged`.|
+|platform|[detectedAppPlatformType](../resources/intune-devices-detectedappplatformtype.md)|Indicates the operating system / platform of the discovered application. Some possible values are Windows, iOS, macOS. The default value is unknown (0). Possible values are: `unknown`, `windows`, `windowsMobile`, `windowsHolographic`, `ios`, `macOS`, `chromeOS`, `androidOSP`, `androidDeviceAdministrator`, `androidWorkProfile`, `androidDedicatedAndFullyManaged`, `unknownFutureValue`.|
v1.0 Intune Devices Detectedapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-detectedapp-update.md
The following table shows the properties that are required when you create the [
|sizeInByte|Int64|Discovered application size in bytes. Read-only| |deviceCount|Int32|The number of devices that have installed this application| |publisher|String|Indicates the publisher of the discovered application. For example: 'Microsoft'. The default value is an empty string.|
-|platform|[detectedAppPlatformType](../resources/intune-devices-detectedappplatformtype.md)|Indicates the operating system / platform of the discovered application. Some possible values are Windows, iOS, macOS. The default value is unknown (0). Possible values are: `unknown`, `windows`, `windowsMobile`, `windowsHolographic`, `ios`, `macOS`, `chromeOS`, `androidOSP`, `androidDeviceAdministrator`, `androidWorkProfile`, `androidDedicatedAndFullyManaged`.|
+|platform|[detectedAppPlatformType](../resources/intune-devices-detectedappplatformtype.md)|Indicates the operating system / platform of the discovered application. Some possible values are Windows, iOS, macOS. The default value is unknown (0). Possible values are: `unknown`, `windows`, `windowsMobile`, `windowsHolographic`, `ios`, `macOS`, `chromeOS`, `androidOSP`, `androidDeviceAdministrator`, `androidWorkProfile`, `androidDedicatedAndFullyManaged`, `unknownFutureValue`.|
v1.0 Intune Devices Devicelogcollectionresponse Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-devicelogcollectionresponse-create.md
The following table shows the properties that are required when you create the d
|initiatedByUserPrincipalName|String|The UPN for who initiated the request| |expirationDateTimeUTC|DateTimeOffset|The DateTime of the expiration of the logs| |size|Double|The size of the logs. Valid values -1.79769313486232E+308 to 1.79769313486232E+308|
+|enrolledByUser|String|The User Principal Name (UPN) of the user that enrolled the device|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/logCollectionRequests Content-type: application/json
-Content-length: 479
+Content-length: 526
{ "@odata.type": "#microsoft.graph.deviceLogCollectionResponse",
Content-length: 479
"receivedDateTimeUTC": "2016-12-31T23:59:48.6545758-08:00", "initiatedByUserPrincipalName": "Initiated By User Principal Name value", "expirationDateTimeUTC": "2017-01-01T00:02:49.2157996-08:00",
- "size": 1.3333333333333333
+ "size": 1.3333333333333333,
+ "enrolledByUser": "Enrolled By User value"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 528
+Content-Length: 575
{ "@odata.type": "#microsoft.graph.deviceLogCollectionResponse",
Content-Length: 528
"receivedDateTimeUTC": "2016-12-31T23:59:48.6545758-08:00", "initiatedByUserPrincipalName": "Initiated By User Principal Name value", "expirationDateTimeUTC": "2017-01-01T00:02:49.2157996-08:00",
- "size": 1.3333333333333333
+ "size": 1.3333333333333333,
+ "enrolledByUser": "Enrolled By User value"
} ```
v1.0 Intune Devices Devicelogcollectionresponse Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-devicelogcollectionresponse-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 567
+Content-Length: 616
{ "value": {
Content-Length: 567
"receivedDateTimeUTC": "2016-12-31T23:59:48.6545758-08:00", "initiatedByUserPrincipalName": "Initiated By User Principal Name value", "expirationDateTimeUTC": "2017-01-01T00:02:49.2157996-08:00",
- "size": 1.3333333333333333
+ "size": 1.3333333333333333,
+ "enrolledByUser": "Enrolled By User value"
} } ```
v1.0 Intune Devices Devicelogcollectionresponse List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-devicelogcollectionresponse-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 601
+Content-Length: 652
{ "value": [
Content-Length: 601
"receivedDateTimeUTC": "2016-12-31T23:59:48.6545758-08:00", "initiatedByUserPrincipalName": "Initiated By User Principal Name value", "expirationDateTimeUTC": "2017-01-01T00:02:49.2157996-08:00",
- "size": 1.3333333333333333
+ "size": 1.3333333333333333,
+ "enrolledByUser": "Enrolled By User value"
} ] }
v1.0 Intune Devices Devicelogcollectionresponse Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-devicelogcollectionresponse-update.md
The following table shows the properties that are required when you create the [
|initiatedByUserPrincipalName|String|The UPN for who initiated the request| |expirationDateTimeUTC|DateTimeOffset|The DateTime of the expiration of the logs| |size|Double|The size of the logs. Valid values -1.79769313486232E+308 to 1.79769313486232E+308|
+|enrolledByUser|String|The User Principal Name (UPN) of the user that enrolled the device|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/logCollectionRequests/{deviceLogCollectionResponseId} Content-type: application/json
-Content-length: 479
+Content-length: 526
{ "@odata.type": "#microsoft.graph.deviceLogCollectionResponse",
Content-length: 479
"receivedDateTimeUTC": "2016-12-31T23:59:48.6545758-08:00", "initiatedByUserPrincipalName": "Initiated By User Principal Name value", "expirationDateTimeUTC": "2017-01-01T00:02:49.2157996-08:00",
- "size": 1.3333333333333333
+ "size": 1.3333333333333333,
+ "enrolledByUser": "Enrolled By User value"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 528
+Content-Length: 575
{ "@odata.type": "#microsoft.graph.deviceLogCollectionResponse",
Content-Length: 528
"receivedDateTimeUTC": "2016-12-31T23:59:48.6545758-08:00", "initiatedByUserPrincipalName": "Initiated By User Principal Name value", "expirationDateTimeUTC": "2017-01-01T00:02:49.2157996-08:00",
- "size": 1.3333333333333333
+ "size": 1.3333333333333333,
+ "enrolledByUser": "Enrolled By User value"
} ```
v1.0 Intune Devices Devicemanagement Getcomanagementeligibledevicessummary https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-devicemanagement-getcomanagementeligibledevicessummary.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 251
+Content-Length: 291
{ "value": { "@odata.type": "microsoft.graph.comanagementEligibleDevicesSummary", "comanagedCount": 14, "eligibleCount": 13,
+ "scheduledForEnrollmentCount": 11,
"eligibleButNotAzureAdJoinedCount": 0, "needsOsUpdateCount": 2, "ineligibleCount": 15
v1.0 Intune Devices Devicemanagement Userexperienceanalyticssummarizeddevicescopes https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-devicemanagement-userexperienceanalyticssummarizeddevicescopes.md
+
+ Title: "userExperienceAnalyticsSummarizedDeviceScopes function"
+description: "Not yet documented"
+
+localization_priority: Normal
++
+# userExperienceAnalyticsSummarizedDeviceScopes function
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Not yet documented
+
+## Prerequisites
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementManagedDevices.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementConfiguration.Read.All, DeviceManagementManagedDevices.Read.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /deviceManagement/userExperienceAnalyticsSummarizedDeviceScopes
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this function returns a `200 OK` response code and a [userExperienceAnalyticsDeviceScopeSummary](../resources/intune-devices-userexperienceanalyticsdevicescopesummary.md) in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+GET https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsSummarizedDeviceScopes
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 351
+
+{
+ "value": {
+ "@odata.type": "microsoft.graph.userExperienceAnalyticsDeviceScopeSummary",
+ "totalDeviceScopes": 1,
+ "totalDeviceScopesEnabled": 8,
+ "completedDeviceScopeIds": [
+ "Completed Device Scope Ids value"
+ ],
+ "insufficientDataDeviceScopeIds": [
+ "Insufficient Data Device Scope Ids value"
+ ]
+ }
+}
+```
+++++
v1.0 Intune Devices Manageddevice Createdevicelogcollectionrequest https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-manageddevice-createdevicelogcollectionrequest.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 567
+Content-Length: 616
{ "value": {
Content-Length: 567
"receivedDateTimeUTC": "2016-12-31T23:59:48.6545758-08:00", "initiatedByUserPrincipalName": "Initiated By User Principal Name value", "expirationDateTimeUTC": "2017-01-01T00:02:49.2157996-08:00",
- "size": 1.3333333333333333
+ "size": 1.3333333333333333,
+ "enrolledByUser": "Enrolled By User value"
} } ```
v1.0 Intune Devices Manageddevice Initiatemobiledevicemanagementkeyrecovery https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-manageddevice-initiatemobiledevicemanagementkeyrecovery.md
+
+ Title: "initiateMobileDeviceManagementKeyRecovery action"
+description: "Perform MDM key recovery and TPM attestation"
+
+localization_priority: Normal
++
+# initiateMobileDeviceManagementKeyRecovery action
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Perform MDM key recovery and TPM attestation
+
+## Prerequisites
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementManagedDevices.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementConfiguration.Read.All, DeviceManagementManagedDevices.Read.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceManagement/managedDevices/{managedDeviceId}/initiateMobileDeviceManagementKeyRecovery
+POST /deviceManagement/comanagedDevices/{managedDeviceId}/initiateMobileDeviceManagementKeyRecovery
+POST /deviceManagement/deviceHealthScripts/{deviceHealthScriptId}/deviceRunStates/{deviceHealthScriptDeviceStateId}/managedDevice/initiateMobileDeviceManagementKeyRecovery
+POST /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/initiateMobileDeviceManagementKeyRecovery
+POST /deviceManagement/deviceComplianceScripts/{deviceComplianceScriptId}/deviceRunStates/{deviceComplianceScriptDeviceStateId}/managedDevice/initiateMobileDeviceManagementKeyRecovery
+POST /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/users/{userId}/managedDevices/{managedDeviceId}/initiateMobileDeviceManagementKeyRecovery
+POST /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/detectedApps/{detectedAppId}/managedDevices/{managedDeviceId}/initiateMobileDeviceManagementKeyRecovery
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this action returns a `204 No Content` response code.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/managedDevices/{managedDeviceId}/initiateMobileDeviceManagementKeyRecovery
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 204 No Content
+```
+++++
v1.0 Intune Devices Manageddevice Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-manageddevice-update.md
The following table shows the properties that are required when you create the [
|id|String|Unique Identifier for the device. This property is read-only.| |userId|String|Unique Identifier for the user associated with the device. This property is read-only.| |deviceName|String|Name of the device. This property is read-only.|
-|hardwareInformation|[hardwareInformation](../resources/intune-devices-hardwareinformation.md)|The hardward details for the device. Includes information such as storage space, manufacturer, serial number, etc. This property is read-only.|
+|hardwareInformation|[hardwareInformation](../resources/intune-devices-hardwareinformation.md)|The hardward details for the device. Includes information such as storage space, manufacturer, serial number, etc. Return default value in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only.|
|ownerType|[ownerType](../resources/intune-shared-ownertype.md)|Ownership of the device. Can be 'company' or 'personal'. Possible values are: `unknown`, `company`, `personal`.| |managedDeviceOwnerType|[managedDeviceOwnerType](../resources/intune-shared-manageddeviceownertype.md)|Ownership of the device. Can be 'company' or 'personal'. Possible values are: `unknown`, `company`, `personal`.| |deviceActionResults|[deviceActionResult](../resources/intune-devices-deviceactionresult.md) collection|List of ComplexType deviceActionResult objects. This property is read-only.|
The following table shows the properties that are required when you create the [
|subscriberCarrier|String|Subscriber Carrier. This property is read-only.| |meid|String|MEID. This property is read-only.| |totalStorageSpaceInBytes|Int64|Total Storage in Bytes. This property is read-only.|
-|freeStorageSpaceInBytes|Int64|Free Storage in Bytes. This property is read-only.|
+|freeStorageSpaceInBytes|Int64|Free Storage in Bytes. Default value is 0. Read-only. This property is read-only.|
|managedDeviceName|String|Automatically generated name to identify a device. Can be overwritten to a user friendly name.| |partnerReportedThreatState|[managedDevicePartnerReportedHealthState](../resources/intune-devices-manageddevicepartnerreportedhealthstate.md)|Indicates the threat state of a device when a Mobile Threat Defense partner is in use by the account and device. Read Only. This property is read-only. Possible values are: `unknown`, `activated`, `deactivated`, `secured`, `lowSeverity`, `mediumSeverity`, `highSeverity`, `unresponsive`, `compromised`, `misconfigured`.| |retireAfterDateTime|DateTimeOffset|Indicates the time after when a device will be auto retired because of scheduled action. This property is read-only.|
The following table shows the properties that are required when you create the [
|autopilotEnrolled|Boolean|Reports if the managed device is enrolled via auto-pilot. This property is read-only.| |requireUserEnrollmentApproval|Boolean|Reports if the managed iOS device is user approval enrollment. This property is read-only.| |managementCertificateExpirationDate|DateTimeOffset|Reports device management certificate expiration date. This property is read-only.|
-|iccid|String|Integrated Circuit Card Identifier, it is A SIM card's unique identification number. This property is read-only.|
-|udid|String|Unique Device Identifier for iOS and macOS devices. This property is read-only.|
+|iccid|String|Integrated Circuit Card Identifier, it is A SIM card's unique identification number. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only.|
+|udid|String|Unique Device Identifier for iOS and macOS devices. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only.|
|roleScopeTagIds|String collection|List of Scope Tag IDs for this Device instance.| |windowsActiveMalwareCount|Int32|Count of active malware for this windows device. This property is read-only.| |windowsRemediatedMalwareCount|Int32|Count of remediated malware for this windows device. This property is read-only.|
-|notes|String|Notes on the device created by IT Admin|
+|notes|String|Notes on the device created by IT Admin. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported.|
|configurationManagerClientHealthState|[configurationManagerClientHealthState](../resources/intune-devices-configurationmanagerclienthealthstate.md)|Configuration manager client health state, valid only for devices managed by MDM/ConfigMgr Agent| |configurationManagerClientInformation|[configurationManagerClientInformation](../resources/intune-devices-configurationmanagerclientinformation.md)|Configuration manager client information, valid only for devices managed, duel-managed or tri-managed by ConfigMgr Agent| |ethernetMacAddress|String|Ethernet MAC. This property is read-only.|
-|physicalMemoryInBytes|Int64|Total Memory in Bytes. This property is read-only.|
+|physicalMemoryInBytes|Int64|Total Memory in Bytes. Return default value 0 in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. Default value is 0. Read-only. This property is read-only.|
|processorArchitecture|[managedDeviceArchitecture](../resources/intune-devices-manageddevicearchitecture.md)|Processor architecture. This property is read-only. Possible values are: `unknown`, `x86`, `x64`, `arm`, `arM64`.| |specificationVersion|String|Specification version. This property is read-only.| |joinType|[joinType](../resources/intune-devices-jointype.md)|Device join type. Possible values are: `unknown`, `azureADJoined`, `azureADRegistered`, `hybridAzureADJoined`.| |skuFamily|String|Device sku family|
-|skuNumber|Int32|Device sku number, see also: https://docs.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only.|
+|skuNumber|Int32|Device sku number, see also: https://learn.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only.|
|managementFeatures|[managedDeviceManagementFeatures](../resources/intune-devices-manageddevicemanagementfeatures.md)|Device management features. Possible values are: `none`, `microsoftManagedDesktop`.| |chromeOSDeviceInfo|[chromeOSDeviceProperty](../resources/intune-devices-chromeosdeviceproperty.md) collection|List of properties of the ChromeOS Device.| |enrollmentProfileName|String|Name of the enrollment profile assigned to the device. Default value is empty string, indicating no enrollment profile was assgined. This property is read-only.|
Content-Length: 9187
+
v1.0 Intune Devices Remoteactionaudit Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-remoteactionaudit-create.md
The following table shows the properties that are required when you create the r
|deviceDisplayName|String|Intune device name.| |userName|String|\[deprecated\] Please use InitiatedByUserPrincipalName instead.| |initiatedByUserPrincipalName|String|User who initiated the device action, format is UPN.|
-|action|[remoteAction](../resources/intune-devices-remoteaction.md)|The action name. Possible values are: `unknown`, `factoryReset`, `removeCompanyData`, `resetPasscode`, `remoteLock`, `enableLostMode`, `disableLostMode`, `locateDevice`, `rebootNow`, `recoverPasscode`, `cleanWindowsDevice`, `logoutSharedAppleDeviceActiveUser`, `quickScan`, `fullScan`, `windowsDefenderUpdateSignatures`, `factoryResetKeepEnrollmentData`, `updateDeviceAccount`, `automaticRedeployment`, `shutDown`, `rotateBitLockerKeys`, `rotateFileVaultKey`, `getFileVaultKey`, `setDeviceName`, `activateDeviceEsim`, `deprovision`, `disable`, `reenable`, `moveDeviceToOrganizationalUnit`.|
+|action|[remoteAction](../resources/intune-devices-remoteaction.md)|The action name. Possible values are: `unknown`, `factoryReset`, `removeCompanyData`, `resetPasscode`, `remoteLock`, `enableLostMode`, `disableLostMode`, `locateDevice`, `rebootNow`, `recoverPasscode`, `cleanWindowsDevice`, `logoutSharedAppleDeviceActiveUser`, `quickScan`, `fullScan`, `windowsDefenderUpdateSignatures`, `factoryResetKeepEnrollmentData`, `updateDeviceAccount`, `automaticRedeployment`, `shutDown`, `rotateBitLockerKeys`, `rotateFileVaultKey`, `getFileVaultKey`, `setDeviceName`, `activateDeviceEsim`, `deprovision`, `disable`, `reenable`, `moveDeviceToOrganizationalUnit`, `initiateMobileDeviceManagementKeyRecovery`.|
|requestDateTime|DateTimeOffset|Time when the action was issued, given in UTC.| |deviceOwnerUserPrincipalName|String|Upn of the device owner.| |deviceIMEI|String|IMEI of the device.|
v1.0 Intune Devices Remoteactionaudit Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-remoteactionaudit-update.md
The following table shows the properties that are required when you create the [
|deviceDisplayName|String|Intune device name.| |userName|String|\[deprecated\] Please use InitiatedByUserPrincipalName instead.| |initiatedByUserPrincipalName|String|User who initiated the device action, format is UPN.|
-|action|[remoteAction](../resources/intune-devices-remoteaction.md)|The action name. Possible values are: `unknown`, `factoryReset`, `removeCompanyData`, `resetPasscode`, `remoteLock`, `enableLostMode`, `disableLostMode`, `locateDevice`, `rebootNow`, `recoverPasscode`, `cleanWindowsDevice`, `logoutSharedAppleDeviceActiveUser`, `quickScan`, `fullScan`, `windowsDefenderUpdateSignatures`, `factoryResetKeepEnrollmentData`, `updateDeviceAccount`, `automaticRedeployment`, `shutDown`, `rotateBitLockerKeys`, `rotateFileVaultKey`, `getFileVaultKey`, `setDeviceName`, `activateDeviceEsim`, `deprovision`, `disable`, `reenable`, `moveDeviceToOrganizationalUnit`.|
+|action|[remoteAction](../resources/intune-devices-remoteaction.md)|The action name. Possible values are: `unknown`, `factoryReset`, `removeCompanyData`, `resetPasscode`, `remoteLock`, `enableLostMode`, `disableLostMode`, `locateDevice`, `rebootNow`, `recoverPasscode`, `cleanWindowsDevice`, `logoutSharedAppleDeviceActiveUser`, `quickScan`, `fullScan`, `windowsDefenderUpdateSignatures`, `factoryResetKeepEnrollmentData`, `updateDeviceAccount`, `automaticRedeployment`, `shutDown`, `rotateBitLockerKeys`, `rotateFileVaultKey`, `getFileVaultKey`, `setDeviceName`, `activateDeviceEsim`, `deprovision`, `disable`, `reenable`, `moveDeviceToOrganizationalUnit`, `initiateMobileDeviceManagementKeyRecovery`.|
|requestDateTime|DateTimeOffset|Time when the action was issued, given in UTC.| |deviceOwnerUserPrincipalName|String|Upn of the device owner.| |deviceIMEI|String|IMEI of the device.|
v1.0 Intune Devices Userexperienceanalyticsmetric Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-userexperienceanalyticsmetric-create.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-POST /deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression
-POST /deviceManagement/userExperienceAnalyticsRegressionSummary/manufacturerRegression
-POST /deviceManagement/userExperienceAnalyticsRegressionSummary/operatingSystemRegression
POST /deviceManagement/userExperienceAnalyticsBaselines/{userExperienceAnalyticsBaselineId}/deviceBootPerformanceMetrics/metricValues ```
If successful, this method returns a `201 Created` response code and a [userExpe
### Request Here is an example of the request. ``` http
-POST https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression
+POST https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsBaselines/{userExperienceAnalyticsBaselineId}/deviceBootPerformanceMetrics/metricValues
Content-type: application/json Content-length: 128
v1.0 Intune Devices Userexperienceanalyticsmetric Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-userexperienceanalyticsmetric-delete.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-DELETE /deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression/{userExperienceAnalyticsMetricId}
-DELETE /deviceManagement/userExperienceAnalyticsRegressionSummary/manufacturerRegression/{userExperienceAnalyticsMetricId}
-DELETE /deviceManagement/userExperienceAnalyticsRegressionSummary/operatingSystemRegression/{userExperienceAnalyticsMetricId}
DELETE /deviceManagement/userExperienceAnalyticsMetricHistory/{userExperienceAnalyticsMetricHistoryId}/userExperienceAnalyticsMetric DELETE /deviceManagement/userExperienceAnalyticsBaselines/{userExperienceAnalyticsBaselineId}/deviceBootPerformanceMetrics/metricValues/{userExperienceAnalyticsMetricId} ```
If successful, this method returns a `204 No Content` response code.
### Request Here is an example of the request. ``` http
-DELETE https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression/{userExperienceAnalyticsMetricId}
+DELETE https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsMetricHistory/{userExperienceAnalyticsMetricHistoryId}/userExperienceAnalyticsMetric
``` ### Response
v1.0 Intune Devices Userexperienceanalyticsmetric Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-userexperienceanalyticsmetric-get.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-GET /deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression/{userExperienceAnalyticsMetricId}
-GET /deviceManagement/userExperienceAnalyticsRegressionSummary/manufacturerRegression/{userExperienceAnalyticsMetricId}
-GET /deviceManagement/userExperienceAnalyticsRegressionSummary/operatingSystemRegression/{userExperienceAnalyticsMetricId}
GET /deviceManagement/userExperienceAnalyticsMetricHistory/{userExperienceAnalyticsMetricHistoryId}/userExperienceAnalyticsMetric GET /deviceManagement/userExperienceAnalyticsBaselines/{userExperienceAnalyticsBaselineId}/deviceBootPerformanceMetrics/metricValues/{userExperienceAnalyticsMetricId} ```
If successful, this method returns a `200 OK` response code and [userExperienceA
### Request Here is an example of the request. ``` http
-GET https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression/{userExperienceAnalyticsMetricId}
+GET https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsMetricHistory/{userExperienceAnalyticsMetricHistoryId}/userExperienceAnalyticsMetric
``` ### Response
v1.0 Intune Devices Userexperienceanalyticsmetric List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-userexperienceanalyticsmetric-list.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-GET /deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression
-GET /deviceManagement/userExperienceAnalyticsRegressionSummary/manufacturerRegression
-GET /deviceManagement/userExperienceAnalyticsRegressionSummary/operatingSystemRegression
GET /deviceManagement/userExperienceAnalyticsBaselines/{userExperienceAnalyticsBaselineId}/deviceBootPerformanceMetrics/metricValues ```
If successful, this method returns a `200 OK` response code and a collection of
### Request Here is an example of the request. ``` http
-GET https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression
+GET https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsBaselines/{userExperienceAnalyticsBaselineId}/deviceBootPerformanceMetrics/metricValues
``` ### Response
v1.0 Intune Devices Userexperienceanalyticsmetric Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-userexperienceanalyticsmetric-update.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-PATCH /deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression/{userExperienceAnalyticsMetricId}
-PATCH /deviceManagement/userExperienceAnalyticsRegressionSummary/manufacturerRegression/{userExperienceAnalyticsMetricId}
-PATCH /deviceManagement/userExperienceAnalyticsRegressionSummary/operatingSystemRegression/{userExperienceAnalyticsMetricId}
PATCH /deviceManagement/userExperienceAnalyticsMetricHistory/{userExperienceAnalyticsMetricHistoryId}/userExperienceAnalyticsMetric PATCH /deviceManagement/userExperienceAnalyticsBaselines/{userExperienceAnalyticsBaselineId}/deviceBootPerformanceMetrics/metricValues/{userExperienceAnalyticsMetricId} ```
If successful, this method returns a `200 OK` response code and an updated [user
### Request Here is an example of the request. ``` http
-PATCH https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression/{userExperienceAnalyticsMetricId}
+PATCH https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsMetricHistory/{userExperienceAnalyticsMetricHistoryId}/userExperienceAnalyticsMetric
Content-type: application/json Content-length: 128
v1.0 Intune Devices Windowsmanageddevice Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-windowsmanageddevice-create.md
The following table shows the properties that are required when you create the w
|id|String|Unique Identifier for the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |userId|String|Unique Identifier for the user associated with the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |deviceName|String|Name of the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|hardwareInformation|[hardwareInformation](../resources/intune-devices-hardwareinformation.md)|The hardward details for the device. Includes information such as storage space, manufacturer, serial number, etc. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|hardwareInformation|[hardwareInformation](../resources/intune-devices-hardwareinformation.md)|The hardward details for the device. Includes information such as storage space, manufacturer, serial number, etc. Return default value in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|ownerType|[ownerType](../resources/intune-shared-ownertype.md)|Ownership of the device. Can be 'company' or 'personal' Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `company`, `personal`.| |managedDeviceOwnerType|[managedDeviceOwnerType](../resources/intune-shared-manageddeviceownertype.md)|Ownership of the device. Can be 'company' or 'personal' Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `company`, `personal`.| |deviceActionResults|[deviceActionResult](../resources/intune-devices-deviceactionresult.md) collection|List of ComplexType deviceActionResult objects. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
The following table shows the properties that are required when you create the w
|subscriberCarrier|String|Subscriber Carrier. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |meid|String|MEID. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |totalStorageSpaceInBytes|Int64|Total Storage in Bytes. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|freeStorageSpaceInBytes|Int64|Free Storage in Bytes. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|freeStorageSpaceInBytes|Int64|Free Storage in Bytes. Default value is 0. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|managedDeviceName|String|Automatically generated name to identify a device. Can be overwritten to a user friendly name. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |partnerReportedThreatState|[managedDevicePartnerReportedHealthState](../resources/intune-devices-manageddevicepartnerreportedhealthstate.md)|Indicates the threat state of a device when a Mobile Threat Defense partner is in use by the account and device. Read Only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `activated`, `deactivated`, `secured`, `lowSeverity`, `mediumSeverity`, `highSeverity`, `unresponsive`, `compromised`, `misconfigured`.| |retireAfterDateTime|DateTimeOffset|Indicates the time after when a device will be auto retired because of scheduled action. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
The following table shows the properties that are required when you create the w
|autopilotEnrolled|Boolean|Reports if the managed device is enrolled via auto-pilot. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |requireUserEnrollmentApproval|Boolean|Reports if the managed iOS device is user approval enrollment. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |managementCertificateExpirationDate|DateTimeOffset|Reports device management certificate expiration date. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|iccid|String|Integrated Circuit Card Identifier, it is A SIM card's unique identification number. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|udid|String|Unique Device Identifier for iOS and macOS devices. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|iccid|String|Integrated Circuit Card Identifier, it is A SIM card's unique identification number. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|udid|String|Unique Device Identifier for iOS and macOS devices. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|roleScopeTagIds|String collection|List of Scope Tag IDs for this Device instance. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |windowsActiveMalwareCount|Int32|Count of active malware for this windows device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |windowsRemediatedMalwareCount|Int32|Count of remediated malware for this windows device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|notes|String|Notes on the device created by IT Admin Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|notes|String|Notes on the device created by IT Admin. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|configurationManagerClientHealthState|[configurationManagerClientHealthState](../resources/intune-devices-configurationmanagerclienthealthstate.md)|Configuration manager client health state, valid only for devices managed by MDM/ConfigMgr Agent Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |configurationManagerClientInformation|[configurationManagerClientInformation](../resources/intune-devices-configurationmanagerclientinformation.md)|Configuration manager client information, valid only for devices managed, duel-managed or tri-managed by ConfigMgr Agent Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |ethernetMacAddress|String|Ethernet MAC. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|physicalMemoryInBytes|Int64|Total Memory in Bytes. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|physicalMemoryInBytes|Int64|Total Memory in Bytes. Return default value 0 in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. Default value is 0. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|processorArchitecture|[managedDeviceArchitecture](../resources/intune-devices-manageddevicearchitecture.md)|Processor architecture. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `x86`, `x64`, `arm`, `arM64`.| |specificationVersion|String|Specification version. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |joinType|[joinType](../resources/intune-devices-jointype.md)|Device join type Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `azureADJoined`, `azureADRegistered`, `hybridAzureADJoined`.| |skuFamily|String|Device sku family Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|skuNumber|Int32|Device sku number, see also: https://docs.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|skuNumber|Int32|Device sku number, see also: https://learn.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|managementFeatures|[managedDeviceManagementFeatures](../resources/intune-devices-manageddevicemanagementfeatures.md)|Device management features Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `none`, `microsoftManagedDesktop`.| |chromeOSDeviceInfo|[chromeOSDeviceProperty](../resources/intune-devices-chromeosdeviceproperty.md) collection|List of properties of the ChromeOS Device. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |enrollmentProfileName|String|Name of the enrollment profile assigned to the device. Default value is empty string, indicating no enrollment profile was assgined. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
Content-Length: 9194
+
v1.0 Intune Devices Windowsmanageddevice Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-windowsmanageddevice-update.md
The following table shows the properties that are required when you create the [
|id|String|Unique Identifier for the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |userId|String|Unique Identifier for the user associated with the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |deviceName|String|Name of the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|hardwareInformation|[hardwareInformation](../resources/intune-devices-hardwareinformation.md)|The hardward details for the device. Includes information such as storage space, manufacturer, serial number, etc. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|hardwareInformation|[hardwareInformation](../resources/intune-devices-hardwareinformation.md)|The hardward details for the device. Includes information such as storage space, manufacturer, serial number, etc. Return default value in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|ownerType|[ownerType](../resources/intune-shared-ownertype.md)|Ownership of the device. Can be 'company' or 'personal' Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `company`, `personal`.| |managedDeviceOwnerType|[managedDeviceOwnerType](../resources/intune-shared-manageddeviceownertype.md)|Ownership of the device. Can be 'company' or 'personal' Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `company`, `personal`.| |deviceActionResults|[deviceActionResult](../resources/intune-devices-deviceactionresult.md) collection|List of ComplexType deviceActionResult objects. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
The following table shows the properties that are required when you create the [
|subscriberCarrier|String|Subscriber Carrier. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |meid|String|MEID. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |totalStorageSpaceInBytes|Int64|Total Storage in Bytes. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|freeStorageSpaceInBytes|Int64|Free Storage in Bytes. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|freeStorageSpaceInBytes|Int64|Free Storage in Bytes. Default value is 0. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|managedDeviceName|String|Automatically generated name to identify a device. Can be overwritten to a user friendly name. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |partnerReportedThreatState|[managedDevicePartnerReportedHealthState](../resources/intune-devices-manageddevicepartnerreportedhealthstate.md)|Indicates the threat state of a device when a Mobile Threat Defense partner is in use by the account and device. Read Only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `activated`, `deactivated`, `secured`, `lowSeverity`, `mediumSeverity`, `highSeverity`, `unresponsive`, `compromised`, `misconfigured`.| |retireAfterDateTime|DateTimeOffset|Indicates the time after when a device will be auto retired because of scheduled action. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
The following table shows the properties that are required when you create the [
|autopilotEnrolled|Boolean|Reports if the managed device is enrolled via auto-pilot. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |requireUserEnrollmentApproval|Boolean|Reports if the managed iOS device is user approval enrollment. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |managementCertificateExpirationDate|DateTimeOffset|Reports device management certificate expiration date. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|iccid|String|Integrated Circuit Card Identifier, it is A SIM card's unique identification number. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|udid|String|Unique Device Identifier for iOS and macOS devices. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|iccid|String|Integrated Circuit Card Identifier, it is A SIM card's unique identification number. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|udid|String|Unique Device Identifier for iOS and macOS devices. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|roleScopeTagIds|String collection|List of Scope Tag IDs for this Device instance. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |windowsActiveMalwareCount|Int32|Count of active malware for this windows device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |windowsRemediatedMalwareCount|Int32|Count of remediated malware for this windows device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|notes|String|Notes on the device created by IT Admin Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|notes|String|Notes on the device created by IT Admin. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|configurationManagerClientHealthState|[configurationManagerClientHealthState](../resources/intune-devices-configurationmanagerclienthealthstate.md)|Configuration manager client health state, valid only for devices managed by MDM/ConfigMgr Agent Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |configurationManagerClientInformation|[configurationManagerClientInformation](../resources/intune-devices-configurationmanagerclientinformation.md)|Configuration manager client information, valid only for devices managed, duel-managed or tri-managed by ConfigMgr Agent Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |ethernetMacAddress|String|Ethernet MAC. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|physicalMemoryInBytes|Int64|Total Memory in Bytes. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|physicalMemoryInBytes|Int64|Total Memory in Bytes. Return default value 0 in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. Default value is 0. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|processorArchitecture|[managedDeviceArchitecture](../resources/intune-devices-manageddevicearchitecture.md)|Processor architecture. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `x86`, `x64`, `arm`, `arM64`.| |specificationVersion|String|Specification version. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |joinType|[joinType](../resources/intune-devices-jointype.md)|Device join type Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `azureADJoined`, `azureADRegistered`, `hybridAzureADJoined`.| |skuFamily|String|Device sku family Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|skuNumber|Int32|Device sku number, see also: https://docs.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|skuNumber|Int32|Device sku number, see also: https://learn.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|managementFeatures|[managedDeviceManagementFeatures](../resources/intune-devices-manageddevicemanagementfeatures.md)|Device management features Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `none`, `microsoftManagedDesktop`.| |chromeOSDeviceInfo|[chromeOSDeviceProperty](../resources/intune-devices-chromeosdeviceproperty.md) collection|List of properties of the ChromeOS Device. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |enrollmentProfileName|String|Name of the enrollment profile assigned to the device. Default value is empty string, indicating no enrollment profile was assgined. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
Content-Length: 9194
+
v1.0 Intune Enrollment Depenrollmentprofile Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-enrollment-depenrollmentprofile-create.md
The following table shows the properties that are required when you create the d
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information.|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information.|
|supportDepartment|String|Support department information| |passCodeDisabled|Boolean|Indicates if Passcode setup pane is disabled| |isMandatory|Boolean|Indicates if the profile is mandatory|
Content-Length: 1403
+
v1.0 Intune Enrollment Depenrollmentprofile Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-enrollment-depenrollmentprofile-update.md
The following table shows the properties that are required when you create the [
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information.|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information.|
|supportDepartment|String|Support department information| |passCodeDisabled|Boolean|Indicates if Passcode setup pane is disabled| |isMandatory|Boolean|Indicates if the profile is mandatory|
Content-Length: 1403
+
v1.0 Intune Enrollment Depiosenrollmentprofile Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-enrollment-depiosenrollmentprofile-create.md
The following table shows the properties that are required when you create the d
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
|supportDepartment|String|Support department information Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |isMandatory|Boolean|Indicates if the profile is mandatory Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |locationDisabled|Boolean|Indicates if Location service setup pane is disabled Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
The following table shows the properties that are required when you create the d
|userSessionTimeoutInSeconds|Int32|Indicates timeout of temporary session| |passcodeLockGracePeriodInSeconds|Int32|Indicates timeout before locked screen requires the user to enter the device passocde to unlock it| |carrierActivationUrl|String|Carrier URL for activating device eSIM.|
-|userlessSharedAadModeEnabled|Boolean|Indicates that this apple device is designated to support 'shared device mode' scenarios. This is distinct from the 'shared iPad' scenario. See https://docs.microsoft.com/mem/intune/enrollment/device-enrollment-shared-ios|
+|userlessSharedAadModeEnabled|Boolean|Indicates that this apple device is designated to support 'shared device mode' scenarios. This is distinct from the 'shared iPad' scenario. See https://learn.microsoft.com/mem/intune/enrollment/device-enrollment-shared-ios|
Content-Length: 2426
+
v1.0 Intune Enrollment Depiosenrollmentprofile Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-enrollment-depiosenrollmentprofile-update.md
The following table shows the properties that are required when you create the [
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
|supportDepartment|String|Support department information Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |isMandatory|Boolean|Indicates if the profile is mandatory Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |locationDisabled|Boolean|Indicates if Location service setup pane is disabled Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
The following table shows the properties that are required when you create the [
|userSessionTimeoutInSeconds|Int32|Indicates timeout of temporary session| |passcodeLockGracePeriodInSeconds|Int32|Indicates timeout before locked screen requires the user to enter the device passocde to unlock it| |carrierActivationUrl|String|Carrier URL for activating device eSIM.|
-|userlessSharedAadModeEnabled|Boolean|Indicates that this apple device is designated to support 'shared device mode' scenarios. This is distinct from the 'shared iPad' scenario. See https://docs.microsoft.com/mem/intune/enrollment/device-enrollment-shared-ios|
+|userlessSharedAadModeEnabled|Boolean|Indicates that this apple device is designated to support 'shared device mode' scenarios. This is distinct from the 'shared iPad' scenario. See https://learn.microsoft.com/mem/intune/enrollment/device-enrollment-shared-ios|
Content-Length: 2426
+
v1.0 Intune Enrollment Depmacosenrollmentprofile Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-enrollment-depmacosenrollmentprofile-create.md
The following table shows the properties that are required when you create the d
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
|supportDepartment|String|Support department information Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |isMandatory|Boolean|Indicates if the profile is mandatory Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |locationDisabled|Boolean|Indicates if Location service setup pane is disabled Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
Content-Length: 1993
+
v1.0 Intune Enrollment Depmacosenrollmentprofile Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-enrollment-depmacosenrollmentprofile-update.md
The following table shows the properties that are required when you create the [
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
|supportDepartment|String|Support department information Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |isMandatory|Boolean|Indicates if the profile is mandatory Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |locationDisabled|Boolean|Indicates if Location service setup pane is disabled Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
Content-Length: 1993
+
v1.0 Intune Gpanalyticsservice Grouppolicymigrationreport Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-gpanalyticsservice-grouppolicymigrationreport-create.md
The following table shows the properties that are required when you create the g
|totalSettingsCount|Int32|The total number of Group Policy Settings from GPO file.| |supportedSettingsCount|Int32|The number of Group Policy Settings supported by Intune.| |supportedSettingsPercent|Int32|The Percentage of Group Policy Settings supported by Intune.|
+|roleScopeTagIds|String collection|The list of scope tags for the configuration.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/groupPolicyMigrationReports Content-type: application/json
-Content-length: 544
+Content-length: 606
{ "@odata.type": "#microsoft.graph.groupPolicyMigrationReport",
Content-length: 544
"targetedInActiveDirectory": true, "totalSettingsCount": 2, "supportedSettingsCount": 6,
- "supportedSettingsPercent": 8
+ "supportedSettingsPercent": 8,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 716
+Content-Length: 778
{ "@odata.type": "#microsoft.graph.groupPolicyMigrationReport",
Content-Length: 716
"targetedInActiveDirectory": true, "totalSettingsCount": 2, "supportedSettingsCount": 6,
- "supportedSettingsPercent": 8
+ "supportedSettingsPercent": 8,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ```
v1.0 Intune Gpanalyticsservice Grouppolicymigrationreport Createmigrationreport https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-gpanalyticsservice-grouppolicymigrationreport-createmigrationreport.md
Here is an example of the request.
POST https://graph.microsoft.com/beta/deviceManagement/groupPolicyMigrationReports/createMigrationReport Content-type: application/json
-Content-length: 438
+Content-length: 506
{ "groupPolicyObjectFile": {
Content-length: 438
"ouDistinguishedName": "Ou Distinguished Name value", "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "content": "Content value"
+ "content": "Content value",
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} } ```
v1.0 Intune Gpanalyticsservice Grouppolicymigrationreport Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-gpanalyticsservice-grouppolicymigrationreport-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 763
+Content-Length: 831
{ "value": {
Content-Length: 763
"targetedInActiveDirectory": true, "totalSettingsCount": 2, "supportedSettingsCount": 6,
- "supportedSettingsPercent": 8
+ "supportedSettingsPercent": 8,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} } ```
v1.0 Intune Gpanalyticsservice Grouppolicymigrationreport List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-gpanalyticsservice-grouppolicymigrationreport-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 805
+Content-Length: 879
{ "value": [
Content-Length: 805
"targetedInActiveDirectory": true, "totalSettingsCount": 2, "supportedSettingsCount": 6,
- "supportedSettingsPercent": 8
+ "supportedSettingsPercent": 8,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ] }
v1.0 Intune Gpanalyticsservice Grouppolicymigrationreport Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-gpanalyticsservice-grouppolicymigrationreport-update.md
The following table shows the properties that are required when you create the [
|totalSettingsCount|Int32|The total number of Group Policy Settings from GPO file.| |supportedSettingsCount|Int32|The number of Group Policy Settings supported by Intune.| |supportedSettingsPercent|Int32|The Percentage of Group Policy Settings supported by Intune.|
+|roleScopeTagIds|String collection|The list of scope tags for the configuration.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/groupPolicyMigrationReports/{groupPolicyMigrationReportId} Content-type: application/json
-Content-length: 544
+Content-length: 606
{ "@odata.type": "#microsoft.graph.groupPolicyMigrationReport",
Content-length: 544
"targetedInActiveDirectory": true, "totalSettingsCount": 2, "supportedSettingsCount": 6,
- "supportedSettingsPercent": 8
+ "supportedSettingsPercent": 8,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 716
+Content-Length: 778
{ "@odata.type": "#microsoft.graph.groupPolicyMigrationReport",
Content-Length: 716
"targetedInActiveDirectory": true, "totalSettingsCount": 2, "supportedSettingsCount": 6,
- "supportedSettingsPercent": 8
+ "supportedSettingsPercent": 8,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ```
v1.0 Intune Gpanalyticsservice Grouppolicyobjectfile Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-gpanalyticsservice-grouppolicyobjectfile-create.md
The following table shows the properties that are required when you create the g
|createdDateTime|DateTimeOffset|The date and time at which the GroupPolicy was first uploaded.| |lastModifiedDateTime|DateTimeOffset|The date and time at which the GroupPolicyObjectFile was last modified.| |content|String|The Group Policy Object file content.|
+|roleScopeTagIds|String collection|The list of scope tags for the configuration.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/groupPolicyObjectFiles Content-type: application/json
-Content-length: 217
+Content-length: 279
{ "@odata.type": "#microsoft.graph.groupPolicyObjectFile", "groupPolicyObjectId": "ca1c97af-97af-ca1c-af97-1ccaaf971cca", "ouDistinguishedName": "Ou Distinguished Name value",
- "content": "Content value"
+ "content": "Content value",
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 389
+Content-Length: 451
{ "@odata.type": "#microsoft.graph.groupPolicyObjectFile",
Content-Length: 389
"ouDistinguishedName": "Ou Distinguished Name value", "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "content": "Content value"
+ "content": "Content value",
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ```
v1.0 Intune Gpanalyticsservice Grouppolicyobjectfile Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-gpanalyticsservice-grouppolicyobjectfile-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 422
+Content-Length: 490
{ "value": {
Content-Length: 422
"ouDistinguishedName": "Ou Distinguished Name value", "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "content": "Content value"
+ "content": "Content value",
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} } ```
v1.0 Intune Gpanalyticsservice Grouppolicyobjectfile List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-gpanalyticsservice-grouppolicyobjectfile-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 450
+Content-Length: 524
{ "value": [
Content-Length: 450
"ouDistinguishedName": "Ou Distinguished Name value", "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "content": "Content value"
+ "content": "Content value",
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ] }
v1.0 Intune Gpanalyticsservice Grouppolicyobjectfile Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-gpanalyticsservice-grouppolicyobjectfile-update.md
The following table shows the properties that are required when you create the [
|createdDateTime|DateTimeOffset|The date and time at which the GroupPolicy was first uploaded.| |lastModifiedDateTime|DateTimeOffset|The date and time at which the GroupPolicyObjectFile was last modified.| |content|String|The Group Policy Object file content.|
+|roleScopeTagIds|String collection|The list of scope tags for the configuration.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/groupPolicyObjectFiles/{groupPolicyObjectFileId} Content-type: application/json
-Content-length: 217
+Content-length: 279
{ "@odata.type": "#microsoft.graph.groupPolicyObjectFile", "groupPolicyObjectId": "ca1c97af-97af-ca1c-af97-1ccaaf971cca", "ouDistinguishedName": "Ou Distinguished Name value",
- "content": "Content value"
+ "content": "Content value",
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 389
+Content-Length: 451
{ "@odata.type": "#microsoft.graph.groupPolicyObjectFile",
Content-Length: 389
"ouDistinguishedName": "Ou Distinguished Name value", "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "content": "Content value"
+ "content": "Content value",
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ```
v1.0 Intune Mam Defaultmanagedappprotection Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-mam-defaultmanagedappprotection-create.md
The following table shows the properties that are required when you create the d
|requireClass3Biometrics|Boolean|Require user to apply Class 3 Biometrics on their Android device.| |requirePinAfterBiometricChange|Boolean|A PIN prompt will override biometric prompts if class 3 biometrics are updated on the device.| |fingerprintAndBiometricEnabled|Boolean|Indicate to the client to enable both biometrics and fingerprints for the app.|
+|minimumWarningSdkVersion|String|Versions less than the specified version will result in warning message on the managed app from accessing company data. (iOS only)|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceAppManagement/defaultManagedAppProtections Content-type: application/json
-Content-length: 5790
+Content-length: 5858
{ "@odata.type": "#microsoft.graph.defaultManagedAppProtection",
Content-length: 5790
"appActionIfDevicePasscodeComplexityLessThanHigh": "wipe", "requireClass3Biometrics": true, "requirePinAfterBiometricChange": true,
- "fingerprintAndBiometricEnabled": true
+ "fingerprintAndBiometricEnabled": true,
+ "minimumWarningSdkVersion": "Minimum Warning Sdk Version value"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 5962
+Content-Length: 6030
{ "@odata.type": "#microsoft.graph.defaultManagedAppProtection",
Content-Length: 5962
"appActionIfDevicePasscodeComplexityLessThanHigh": "wipe", "requireClass3Biometrics": true, "requirePinAfterBiometricChange": true,
- "fingerprintAndBiometricEnabled": true
+ "fingerprintAndBiometricEnabled": true,
+ "minimumWarningSdkVersion": "Minimum Warning Sdk Version value"
} ```
v1.0 Intune Mam Defaultmanagedappprotection Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-mam-defaultmanagedappprotection-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 6243
+Content-Length: 6313
{ "value": {
Content-Length: 6243
"appActionIfDevicePasscodeComplexityLessThanHigh": "wipe", "requireClass3Biometrics": true, "requirePinAfterBiometricChange": true,
- "fingerprintAndBiometricEnabled": true
+ "fingerprintAndBiometricEnabled": true,
+ "minimumWarningSdkVersion": "Minimum Warning Sdk Version value"
} } ```
v1.0 Intune Mam Defaultmanagedappprotection List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-mam-defaultmanagedappprotection-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 6519
+Content-Length: 6591
{ "value": [
Content-Length: 6519
"appActionIfDevicePasscodeComplexityLessThanHigh": "wipe", "requireClass3Biometrics": true, "requirePinAfterBiometricChange": true,
- "fingerprintAndBiometricEnabled": true
+ "fingerprintAndBiometricEnabled": true,
+ "minimumWarningSdkVersion": "Minimum Warning Sdk Version value"
} ] }
v1.0 Intune Mam Defaultmanagedappprotection Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-mam-defaultmanagedappprotection-update.md
The following table shows the properties that are required when you create the [
|requireClass3Biometrics|Boolean|Require user to apply Class 3 Biometrics on their Android device.| |requirePinAfterBiometricChange|Boolean|A PIN prompt will override biometric prompts if class 3 biometrics are updated on the device.| |fingerprintAndBiometricEnabled|Boolean|Indicate to the client to enable both biometrics and fingerprints for the app.|
+|minimumWarningSdkVersion|String|Versions less than the specified version will result in warning message on the managed app from accessing company data. (iOS only)|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceAppManagement/defaultManagedAppProtections/{defaultManagedAppProtectionId} Content-type: application/json
-Content-length: 5790
+Content-length: 5858
{ "@odata.type": "#microsoft.graph.defaultManagedAppProtection",
Content-length: 5790
"appActionIfDevicePasscodeComplexityLessThanHigh": "wipe", "requireClass3Biometrics": true, "requirePinAfterBiometricChange": true,
- "fingerprintAndBiometricEnabled": true
+ "fingerprintAndBiometricEnabled": true,
+ "minimumWarningSdkVersion": "Minimum Warning Sdk Version value"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 5962
+Content-Length: 6030
{ "@odata.type": "#microsoft.graph.defaultManagedAppProtection",
Content-Length: 5962
"appActionIfDevicePasscodeComplexityLessThanHigh": "wipe", "requireClass3Biometrics": true, "requirePinAfterBiometricChange": true,
- "fingerprintAndBiometricEnabled": true
+ "fingerprintAndBiometricEnabled": true,
+ "minimumWarningSdkVersion": "Minimum Warning Sdk Version value"
} ```
v1.0 Intune Mam Devicemanagementreports Getmobileapplicationmanagementappconfigurationreport https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-mam-devicemanagementreports-getmobileapplicationmanagementappconfigurationreport.md
+
+ Title: "getMobileApplicationManagementAppConfigurationReport action"
+description: "Not yet documented"
+
+localization_priority: Normal
++
+# getMobileApplicationManagementAppConfigurationReport action
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Not yet documented
+
+## Prerequisites
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceManagement/reports/getMobileApplicationManagementAppConfigurationReport
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+In the request body, supply JSON representation of the parameters.
+
+The following table shows the parameters that can be used with this action.
+
+|Property|Type|Description|
+|:|:|:|
+|name|String|Not yet documented|
+|select|String collection|Not yet documented|
+|search|String|Not yet documented|
+|groupBy|String collection|Not yet documented|
+|orderBy|String collection|Not yet documented|
+|skip|Int32|Not yet documented|
+|top|Int32|Not yet documented|
+|sessionId|String|Not yet documented|
+|filter|String|Not yet documented|
+++
+## Response
+If successful, this action returns a `200 OK` response code and a Stream in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/reports/getMobileApplicationManagementAppConfigurationReport
+
+Content-type: application/json
+Content-length: 278
+
+{
+ "name": "Name value",
+ "select": [
+ "Select value"
+ ],
+ "search": "Search value",
+ "groupBy": [
+ "Group By value"
+ ],
+ "orderBy": [
+ "Order By value"
+ ],
+ "skip": 4,
+ "top": 3,
+ "sessionId": "Session Id value",
+ "filter": "Filter value"
+}
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 127
+
+{
+ "value": "Z2V0TW9iaWxlQXBwbGljYXRpb25NYW5hZ2VtZW50QXBwQ29uZmlndXJhdGlvblJlcG9ydCBJbnR1bmUgRG9jIFNhbXBsZSA1NTA5OTkwMDg="
+}
+```
+++++
v1.0 Intune Onboarding Devicemanagementpartner Terminate https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-onboarding-devicemanagementpartner-terminate.md
+
+ Title: "terminate action"
+description: "Not yet documented"
+
+localization_priority: Normal
++
+# terminate action
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Not yet documented
+
+## Prerequisites
+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)|DeviceManagementServiceConfig.Read.All, DeviceManagementConfiguration.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementServiceConfig.Read.All, DeviceManagementConfiguration.Read.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceManagement/deviceManagementPartners/{deviceManagementPartnerId}/terminate
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this action returns a `204 No Content` response code.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/deviceManagementPartners/{deviceManagementPartnerId}/terminate
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 204 No Content
+```
+++++
v1.0 Intune Onboarding Windows10enrollmentcompletionpageconfiguration Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-onboarding-windows10enrollmentcompletionpageconfiguration-create.md
The following table shows the properties that are required when you create the w
|allowDeviceUseOnInstallFailure|Boolean|Allow the user to continue using the device on installation failure| |selectedMobileAppIds|String collection|Selected applications to track the installation status| |allowNonBlockingAppInstallation|Boolean|Install all required apps as non blocking apps during white glove|
+|installQualityUpdates|Boolean|Allows quality updates installation during OOBE|
|trackInstallProgressForAutopilotOnly|Boolean|Only show installation progress for Autopilot enrollment scenarios| |disableUserStatusTrackingAfterFirstUser|Boolean|Only show installation progress for first user post enrollment|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/deviceEnrollmentConfigurations Content-type: application/json
-Content-length: 839
+Content-length: 873
{ "@odata.type": "#microsoft.graph.windows10EnrollmentCompletionPageConfiguration",
Content-length: 839
"Selected Mobile App Ids value" ], "allowNonBlockingAppInstallation": true,
+ "installQualityUpdates": true,
"trackInstallProgressForAutopilotOnly": true, "disableUserStatusTrackingAfterFirstUser": true }
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 1011
+Content-Length: 1045
{ "@odata.type": "#microsoft.graph.windows10EnrollmentCompletionPageConfiguration",
Content-Length: 1011
"Selected Mobile App Ids value" ], "allowNonBlockingAppInstallation": true,
+ "installQualityUpdates": true,
"trackInstallProgressForAutopilotOnly": true, "disableUserStatusTrackingAfterFirstUser": true }
v1.0 Intune Onboarding Windows10enrollmentcompletionpageconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-onboarding-windows10enrollmentcompletionpageconfiguration-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1080
+Content-Length: 1116
{ "value": {
Content-Length: 1080
"Selected Mobile App Ids value" ], "allowNonBlockingAppInstallation": true,
+ "installQualityUpdates": true,
"trackInstallProgressForAutopilotOnly": true, "disableUserStatusTrackingAfterFirstUser": true }
v1.0 Intune Onboarding Windows10enrollmentcompletionpageconfiguration List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-onboarding-windows10enrollmentcompletionpageconfiguration-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1144
+Content-Length: 1182
{ "value": [
Content-Length: 1144
"Selected Mobile App Ids value" ], "allowNonBlockingAppInstallation": true,
+ "installQualityUpdates": true,
"trackInstallProgressForAutopilotOnly": true, "disableUserStatusTrackingAfterFirstUser": true }
v1.0 Intune Onboarding Windows10enrollmentcompletionpageconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-onboarding-windows10enrollmentcompletionpageconfiguration-update.md
The following table shows the properties that are required when you create the [
|allowDeviceUseOnInstallFailure|Boolean|Allow the user to continue using the device on installation failure| |selectedMobileAppIds|String collection|Selected applications to track the installation status| |allowNonBlockingAppInstallation|Boolean|Install all required apps as non blocking apps during white glove|
+|installQualityUpdates|Boolean|Allows quality updates installation during OOBE|
|trackInstallProgressForAutopilotOnly|Boolean|Only show installation progress for Autopilot enrollment scenarios| |disableUserStatusTrackingAfterFirstUser|Boolean|Only show installation progress for first user post enrollment|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/deviceEnrollmentConfigurations/{deviceEnrollmentConfigurationId} Content-type: application/json
-Content-length: 839
+Content-length: 873
{ "@odata.type": "#microsoft.graph.windows10EnrollmentCompletionPageConfiguration",
Content-length: 839
"Selected Mobile App Ids value" ], "allowNonBlockingAppInstallation": true,
+ "installQualityUpdates": true,
"trackInstallProgressForAutopilotOnly": true, "disableUserStatusTrackingAfterFirstUser": true }
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1011
+Content-Length: 1045
{ "@odata.type": "#microsoft.graph.windows10EnrollmentCompletionPageConfiguration",
Content-Length: 1011
"Selected Mobile App Ids value" ], "allowNonBlockingAppInstallation": true,
+ "installQualityUpdates": true,
"trackInstallProgressForAutopilotOnly": true, "disableUserStatusTrackingAfterFirstUser": true }
v1.0 Intune Partnerintegration Organizationalmessagedetail Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-partnerintegration-organizationalmessagedetail-create.md
- Title: "Create organizationalMessageDetail"
-description: "Create a new organizationalMessageDetail object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Create organizationalMessageDetail
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Create a new [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object.
-
-## Prerequisites
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
-
-## HTTP Request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-POST /deviceManagement/organizationalMessageDetails
-```
-
-## Request headers
-|Header|Value|
-|:|:|
-|Authorization|Bearer &lt;token&gt; Required.|
-|Accept|application/json|
-
-## Request body
-In the request body, supply a JSON representation for the organizationalMessageDetail object.
-
-The following table shows the properties that are required when you create the organizationalMessageDetail.
-
-|Property|Type|Description|
-|:|:|:|
-|id|String|A unique identifier for the organizational message|
-|scenario|[organizationalMessageScenario](../resources/intune-partnerintegration-organizationalmessagescenario.md)|Indicates the scenario for the message. Possible values are: `onboarding`, `lifecycle`, `unknownFutureValue`.|
-|surface|[organizationalMessageSurface](../resources/intune-partnerintegration-organizationalmessagesurface.md)|Indicates the area where content will be displayed to customers. Possible values are: `actionCenter`, `getStarted`, `softLanding`, `unknownFutureValue`.|
-|status|[organizationalMessageStatus](../resources/intune-partnerintegration-organizationalmessagestatus.md)|Indicates the deployment status of the message. Possible values are: `scheduled`, `active`, `completed`, `cancelled`, `unknownFutureValue`.|
-|startDateTime|DateTimeOffset|The date and time of when the message will start being displayed to clients|
-|endDateTime|DateTimeOffset|The date and time of when the message will stop being displayed to clients|
-|createdDateTime|DateTimeOffset|The date and time of when the message was created|
-|lastModifiedDateTime|DateTimeOffset|The date and time of when the message was last modified|
-|userEngagementStatistics|[organizationalMessageInsights](../resources/intune-partnerintegration-organizationalmessageinsights.md)|The statistics containing how the message was interacted with by clients. This includes the number of impressions, clicks, and dismisses from targeted clients.|
-|frequency|[organizationalMessageFrequency](../resources/intune-partnerintegration-organizationalmessagefrequency.md)|The frequency at which a client will see the message. Possible values are: `weeklyOnce`, `monthlyOnce`, `monthlyTwice`, `unknownFutureValue`.|
-|targeting|[organizationalMessageTargeting](../resources/intune-partnerintegration-organizationalmessagetargeting.md)|The groups of devices that will receive the message. This also contains a list of excluded groups that will not receive the message regardless of the device being part of an included group|
-|content|[organizationalMessageContent](../resources/intune-partnerintegration-organizationalmessagecontent.md)|The content that will be displayed to clients for the message. This includes the text portion of the message and the displayed logo|
-|theme|[organizationalMessageTheme](../resources/intune-partnerintegration-organizationalmessagetheme.md)|Indicates the theme for the experience. Possible values are: `update`, `training`, `welcomeToWindows`, `explore`, `unknownFutureValue`.|
-|variant|String|Indicates the corresponding variant for the experience|
---
-## Response
-If successful, this method returns a `201 Created` response code and a [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object in the response body.
-
-## Example
-
-### Request
-Here is an example of the request.
-``` http
-POST https://graph.microsoft.com/beta/deviceManagement/organizationalMessageDetails
-Content-type: application/json
-Content-length: 2049
-
-{
- "@odata.type": "#microsoft.graph.organizationalMessageDetail",
- "scenario": "lifecycle",
- "surface": "getStarted",
- "status": "active",
- "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
- "endDateTime": "2017-01-01T00:03:30.9241974-08:00",
- "userEngagementStatistics": {
- "@odata.type": "microsoft.graph.organizationalMessageInsights",
- "impressions": 11,
- "clicks": 6,
- "dismisses": 9
- },
- "frequency": "monthlyOnce",
- "targeting": {
- "@odata.type": "microsoft.graph.organizationalMessageTargeting",
- "targetingType": "unknownFutureValue",
- "includeIds": [
- "Include Ids value"
- ],
- "excludeIds": [
- "Exclude Ids value"
- ]
- },
- "content": {
- "@odata.type": "microsoft.graph.organizationalMessageContent",
- "guidedContentId": "Guided Content Id value",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logoInfo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogo",
- "logo": "bG9nbw==",
- "contentType": "unknownFutureValue",
- "logoCdnUrl": "https://example.com/logoCdnUrl/"
- }
- },
- "theme": "training",
- "variant": "Variant value"
-}
-```
-
-### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
-``` http
-HTTP/1.1 201 Created
-Content-Type: application/json
-Content-Length: 2221
-
-{
- "@odata.type": "#microsoft.graph.organizationalMessageDetail",
- "id": "affbf3ad-f3ad-affb-adf3-fbafadf3fbaf",
- "scenario": "lifecycle",
- "surface": "getStarted",
- "status": "active",
- "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
- "endDateTime": "2017-01-01T00:03:30.9241974-08:00",
- "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
- "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "userEngagementStatistics": {
- "@odata.type": "microsoft.graph.organizationalMessageInsights",
- "impressions": 11,
- "clicks": 6,
- "dismisses": 9
- },
- "frequency": "monthlyOnce",
- "targeting": {
- "@odata.type": "microsoft.graph.organizationalMessageTargeting",
- "targetingType": "unknownFutureValue",
- "includeIds": [
- "Include Ids value"
- ],
- "excludeIds": [
- "Exclude Ids value"
- ]
- },
- "content": {
- "@odata.type": "microsoft.graph.organizationalMessageContent",
- "guidedContentId": "Guided Content Id value",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logoInfo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogo",
- "logo": "bG9nbw==",
- "contentType": "unknownFutureValue",
- "logoCdnUrl": "https://example.com/logoCdnUrl/"
- }
- },
- "theme": "training",
- "variant": "Variant value"
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessagedetail Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-partnerintegration-organizationalmessagedetail-get.md
- Title: "Get organizationalMessageDetail"
-description: "Read properties and relationships of the organizationalMessageDetail object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Get organizationalMessageDetail
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Read properties and relationships of the [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object.
-
-## Prerequisites
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
-
-## HTTP Request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-GET /deviceManagement/organizationalMessageDetails/{organizationalMessageDetailId}
-```
-
-## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
-
-## Request headers
-|Header|Value|
-|:|:|
-|Authorization|Bearer &lt;token&gt; Required.|
-|Accept|application/json|
-
-## Request body
-Do not supply a request body for this method.
-
-## Response
-If successful, this method returns a `200 OK` response code and [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object in the response body.
-
-## Example
-
-### Request
-Here is an example of the request.
-``` http
-GET https://graph.microsoft.com/beta/deviceManagement/organizationalMessageDetails/{organizationalMessageDetailId}
-```
-
-### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-Content-Length: 2368
-
-{
- "value": {
- "@odata.type": "#microsoft.graph.organizationalMessageDetail",
- "id": "affbf3ad-f3ad-affb-adf3-fbafadf3fbaf",
- "scenario": "lifecycle",
- "surface": "getStarted",
- "status": "active",
- "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
- "endDateTime": "2017-01-01T00:03:30.9241974-08:00",
- "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
- "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "userEngagementStatistics": {
- "@odata.type": "microsoft.graph.organizationalMessageInsights",
- "impressions": 11,
- "clicks": 6,
- "dismisses": 9
- },
- "frequency": "monthlyOnce",
- "targeting": {
- "@odata.type": "microsoft.graph.organizationalMessageTargeting",
- "targetingType": "unknownFutureValue",
- "includeIds": [
- "Include Ids value"
- ],
- "excludeIds": [
- "Exclude Ids value"
- ]
- },
- "content": {
- "@odata.type": "microsoft.graph.organizationalMessageContent",
- "guidedContentId": "Guided Content Id value",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logoInfo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogo",
- "logo": "bG9nbw==",
- "contentType": "unknownFutureValue",
- "logoCdnUrl": "https://example.com/logoCdnUrl/"
- }
- },
- "theme": "training",
- "variant": "Variant value"
- }
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessagedetail List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-partnerintegration-organizationalmessagedetail-list.md
- Title: "List organizationalMessageDetails"
-description: "List properties and relationships of the organizationalMessageDetail objects."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# List organizationalMessageDetails
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-List properties and relationships of the [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) objects.
-
-## Prerequisites
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
-
-## HTTP Request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-GET /deviceManagement/organizationalMessageDetails
-```
-
-## Request headers
-|Header|Value|
-|:|:|
-|Authorization|Bearer &lt;token&gt; Required.|
-|Accept|application/json|
-
-## Request body
-Do not supply a request body for this method.
-
-## Response
-If successful, this method returns a `200 OK` response code and a collection of [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) objects in the response body.
-
-## Example
-
-### Request
-Here is an example of the request.
-``` http
-GET https://graph.microsoft.com/beta/deviceManagement/organizationalMessageDetails
-```
-
-### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-Content-Length: 2510
-
-{
- "value": [
- {
- "@odata.type": "#microsoft.graph.organizationalMessageDetail",
- "id": "affbf3ad-f3ad-affb-adf3-fbafadf3fbaf",
- "scenario": "lifecycle",
- "surface": "getStarted",
- "status": "active",
- "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
- "endDateTime": "2017-01-01T00:03:30.9241974-08:00",
- "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
- "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "userEngagementStatistics": {
- "@odata.type": "microsoft.graph.organizationalMessageInsights",
- "impressions": 11,
- "clicks": 6,
- "dismisses": 9
- },
- "frequency": "monthlyOnce",
- "targeting": {
- "@odata.type": "microsoft.graph.organizationalMessageTargeting",
- "targetingType": "unknownFutureValue",
- "includeIds": [
- "Include Ids value"
- ],
- "excludeIds": [
- "Exclude Ids value"
- ]
- },
- "content": {
- "@odata.type": "microsoft.graph.organizationalMessageContent",
- "guidedContentId": "Guided Content Id value",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logoInfo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogo",
- "logo": "bG9nbw==",
- "contentType": "unknownFutureValue",
- "logoCdnUrl": "https://example.com/logoCdnUrl/"
- }
- },
- "theme": "training",
- "variant": "Variant value"
- }
- ]
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessagedetail Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-partnerintegration-organizationalmessagedetail-update.md
- Title: "Update organizationalMessageDetail"
-description: "Update the properties of a organizationalMessageDetail object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Update organizationalMessageDetail
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Update the properties of a [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object.
-
-## Prerequisites
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
-
-## HTTP Request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-PATCH /deviceManagement/organizationalMessageDetails/{organizationalMessageDetailId}
-```
-
-## Request headers
-|Header|Value|
-|:|:|
-|Authorization|Bearer &lt;token&gt; Required.|
-|Accept|application/json|
-
-## Request body
-In the request body, supply a JSON representation for the [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object.
-
-The following table shows the properties that are required when you create the [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md).
-
-|Property|Type|Description|
-|:|:|:|
-|id|String|A unique identifier for the organizational message|
-|scenario|[organizationalMessageScenario](../resources/intune-partnerintegration-organizationalmessagescenario.md)|Indicates the scenario for the message. Possible values are: `onboarding`, `lifecycle`, `unknownFutureValue`.|
-|surface|[organizationalMessageSurface](../resources/intune-partnerintegration-organizationalmessagesurface.md)|Indicates the area where content will be displayed to customers. Possible values are: `actionCenter`, `getStarted`, `softLanding`, `unknownFutureValue`.|
-|status|[organizationalMessageStatus](../resources/intune-partnerintegration-organizationalmessagestatus.md)|Indicates the deployment status of the message. Possible values are: `scheduled`, `active`, `completed`, `cancelled`, `unknownFutureValue`.|
-|startDateTime|DateTimeOffset|The date and time of when the message will start being displayed to clients|
-|endDateTime|DateTimeOffset|The date and time of when the message will stop being displayed to clients|
-|createdDateTime|DateTimeOffset|The date and time of when the message was created|
-|lastModifiedDateTime|DateTimeOffset|The date and time of when the message was last modified|
-|userEngagementStatistics|[organizationalMessageInsights](../resources/intune-partnerintegration-organizationalmessageinsights.md)|The statistics containing how the message was interacted with by clients. This includes the number of impressions, clicks, and dismisses from targeted clients.|
-|frequency|[organizationalMessageFrequency](../resources/intune-partnerintegration-organizationalmessagefrequency.md)|The frequency at which a client will see the message. Possible values are: `weeklyOnce`, `monthlyOnce`, `monthlyTwice`, `unknownFutureValue`.|
-|targeting|[organizationalMessageTargeting](../resources/intune-partnerintegration-organizationalmessagetargeting.md)|The groups of devices that will receive the message. This also contains a list of excluded groups that will not receive the message regardless of the device being part of an included group|
-|content|[organizationalMessageContent](../resources/intune-partnerintegration-organizationalmessagecontent.md)|The content that will be displayed to clients for the message. This includes the text portion of the message and the displayed logo|
-|theme|[organizationalMessageTheme](../resources/intune-partnerintegration-organizationalmessagetheme.md)|Indicates the theme for the experience. Possible values are: `update`, `training`, `welcomeToWindows`, `explore`, `unknownFutureValue`.|
-|variant|String|Indicates the corresponding variant for the experience|
---
-## Response
-If successful, this method returns a `200 OK` response code and an updated [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object in the response body.
-
-## Example
-
-### Request
-Here is an example of the request.
-``` http
-PATCH https://graph.microsoft.com/beta/deviceManagement/organizationalMessageDetails/{organizationalMessageDetailId}
-Content-type: application/json
-Content-length: 2049
-
-{
- "@odata.type": "#microsoft.graph.organizationalMessageDetail",
- "scenario": "lifecycle",
- "surface": "getStarted",
- "status": "active",
- "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
- "endDateTime": "2017-01-01T00:03:30.9241974-08:00",
- "userEngagementStatistics": {
- "@odata.type": "microsoft.graph.organizationalMessageInsights",
- "impressions": 11,
- "clicks": 6,
- "dismisses": 9
- },
- "frequency": "monthlyOnce",
- "targeting": {
- "@odata.type": "microsoft.graph.organizationalMessageTargeting",
- "targetingType": "unknownFutureValue",
- "includeIds": [
- "Include Ids value"
- ],
- "excludeIds": [
- "Exclude Ids value"
- ]
- },
- "content": {
- "@odata.type": "microsoft.graph.organizationalMessageContent",
- "guidedContentId": "Guided Content Id value",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logoInfo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogo",
- "logo": "bG9nbw==",
- "contentType": "unknownFutureValue",
- "logoCdnUrl": "https://example.com/logoCdnUrl/"
- }
- },
- "theme": "training",
- "variant": "Variant value"
-}
-```
-
-### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-Content-Length: 2221
-
-{
- "@odata.type": "#microsoft.graph.organizationalMessageDetail",
- "id": "affbf3ad-f3ad-affb-adf3-fbafadf3fbaf",
- "scenario": "lifecycle",
- "surface": "getStarted",
- "status": "active",
- "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
- "endDateTime": "2017-01-01T00:03:30.9241974-08:00",
- "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
- "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "userEngagementStatistics": {
- "@odata.type": "microsoft.graph.organizationalMessageInsights",
- "impressions": 11,
- "clicks": 6,
- "dismisses": 9
- },
- "frequency": "monthlyOnce",
- "targeting": {
- "@odata.type": "microsoft.graph.organizationalMessageTargeting",
- "targetingType": "unknownFutureValue",
- "includeIds": [
- "Include Ids value"
- ],
- "excludeIds": [
- "Exclude Ids value"
- ]
- },
- "content": {
- "@odata.type": "microsoft.graph.organizationalMessageContent",
- "guidedContentId": "Guided Content Id value",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logoInfo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogo",
- "logo": "bG9nbw==",
- "contentType": "unknownFutureValue",
- "logoCdnUrl": "https://example.com/logoCdnUrl/"
- }
- },
- "theme": "training",
- "variant": "Variant value"
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessageguidedcontent Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-partnerintegration-organizationalmessageguidedcontent-create.md
- Title: "Create organizationalMessageGuidedContent"
-description: "Create a new organizationalMessageGuidedContent object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Create organizationalMessageGuidedContent
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Create a new [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object.
-
-## Prerequisites
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
-
-## HTTP Request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-POST /deviceManagement/organizationalMessageGuidedContents
-```
-
-## Request headers
-|Header|Value|
-|:|:|
-|Authorization|Bearer &lt;token&gt; Required.|
-|Accept|application/json|
-
-## Request body
-In the request body, supply a JSON representation for the organizationalMessageGuidedContent object.
-
-The following table shows the properties that are required when you create the organizationalMessageGuidedContent.
-
-|Property|Type|Description|
-|:|:|:|
-|id|String|A unique identifier for the guided content|
-|scenario|[organizationalMessageScenario](../resources/intune-partnerintegration-organizationalmessagescenario.md)|Indicates the scenario for the guided content. Possible values are: `onboarding`, `lifecycle`, `unknownFutureValue`.|
-|theme|[organizationalMessageTheme](../resources/intune-partnerintegration-organizationalmessagetheme.md)|Indicates the theme for the guided content. Possible values are: `update`, `training`, `welcomeToWindows`, `explore`, `unknownFutureValue`.|
-|surface|[organizationalMessageSurface](../resources/intune-partnerintegration-organizationalmessagesurface.md)|Indicates the area where content will be displayed to customers. Possible values are: `actionCenter`, `getStarted`, `softLanding`, `unknownFutureValue`.|
-|placementDetails|[organizationalMessagePlacementDetail](../resources/intune-partnerintegration-organizationalmessageplacementdetail.md) collection|Contains the different types of text content that can be displayed to customers along with their localized values|
-|logo|[organizationalMessageLogoGuide](../resources/intune-partnerintegration-organizationalmessagelogoguide.md)|Example of the logo that will be displayed to customers and its size requirements|
---
-## Response
-If successful, this method returns a `201 Created` response code and a [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object in the response body.
-
-## Example
-
-### Request
-Here is an example of the request.
-``` http
-POST https://graph.microsoft.com/beta/deviceManagement/organizationalMessageGuidedContents
-Content-type: application/json
-Content-length: 1403
-
-{
- "@odata.type": "#microsoft.graph.organizationalMessageGuidedContent",
- "scenario": "lifecycle",
- "theme": "training",
- "surface": "getStarted",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide",
- "logoCdnUrl": "https://example.com/logoCdnUrl/",
- "assetName": "Asset Name value",
- "dimensions": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",
- "minWidth": 8,
- "maxWidth": 8,
- "minHeight": 9,
- "maxHeight": 9
- }
- }
-}
-```
-
-### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
-``` http
-HTTP/1.1 201 Created
-Content-Type: application/json
-Content-Length: 1452
-
-{
- "@odata.type": "#microsoft.graph.organizationalMessageGuidedContent",
- "id": "13e64843-4843-13e6-4348-e6134348e613",
- "scenario": "lifecycle",
- "theme": "training",
- "surface": "getStarted",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide",
- "logoCdnUrl": "https://example.com/logoCdnUrl/",
- "assetName": "Asset Name value",
- "dimensions": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",
- "minWidth": 8,
- "maxWidth": 8,
- "minHeight": 9,
- "maxHeight": 9
- }
- }
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessageguidedcontent Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-partnerintegration-organizationalmessageguidedcontent-get.md
- Title: "Get organizationalMessageGuidedContent"
-description: "Read properties and relationships of the organizationalMessageGuidedContent object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Get organizationalMessageGuidedContent
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Read properties and relationships of the [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object.
-
-## Prerequisites
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
-
-## HTTP Request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-GET /deviceManagement/organizationalMessageGuidedContents/{organizationalMessageGuidedContentId}
-```
-
-## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
-
-## Request headers
-|Header|Value|
-|:|:|
-|Authorization|Bearer &lt;token&gt; Required.|
-|Accept|application/json|
-
-## Request body
-Do not supply a request body for this method.
-
-## Response
-If successful, this method returns a `200 OK` response code and [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object in the response body.
-
-## Example
-
-### Request
-Here is an example of the request.
-``` http
-GET https://graph.microsoft.com/beta/deviceManagement/organizationalMessageGuidedContents/{organizationalMessageGuidedContentId}
-```
-
-### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-Content-Length: 1557
-
-{
- "value": {
- "@odata.type": "#microsoft.graph.organizationalMessageGuidedContent",
- "id": "13e64843-4843-13e6-4348-e6134348e613",
- "scenario": "lifecycle",
- "theme": "training",
- "surface": "getStarted",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide",
- "logoCdnUrl": "https://example.com/logoCdnUrl/",
- "assetName": "Asset Name value",
- "dimensions": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",
- "minWidth": 8,
- "maxWidth": 8,
- "minHeight": 9,
- "maxHeight": 9
- }
- }
- }
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessageguidedcontent List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-partnerintegration-organizationalmessageguidedcontent-list.md
- Title: "List organizationalMessageGuidedContents"
-description: "List properties and relationships of the organizationalMessageGuidedContent objects."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# List organizationalMessageGuidedContents
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-List properties and relationships of the [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) objects.
-
-## Prerequisites
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
-
-## HTTP Request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-GET /deviceManagement/organizationalMessageGuidedContents
-```
-
-## Request headers
-|Header|Value|
-|:|:|
-|Authorization|Bearer &lt;token&gt; Required.|
-|Accept|application/json|
-
-## Request body
-Do not supply a request body for this method.
-
-## Response
-If successful, this method returns a `200 OK` response code and a collection of [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) objects in the response body.
-
-## Example
-
-### Request
-Here is an example of the request.
-``` http
-GET https://graph.microsoft.com/beta/deviceManagement/organizationalMessageGuidedContents
-```
-
-### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-Content-Length: 1657
-
-{
- "value": [
- {
- "@odata.type": "#microsoft.graph.organizationalMessageGuidedContent",
- "id": "13e64843-4843-13e6-4348-e6134348e613",
- "scenario": "lifecycle",
- "theme": "training",
- "surface": "getStarted",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide",
- "logoCdnUrl": "https://example.com/logoCdnUrl/",
- "assetName": "Asset Name value",
- "dimensions": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",
- "minWidth": 8,
- "maxWidth": 8,
- "minHeight": 9,
- "maxHeight": 9
- }
- }
- }
- ]
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessageguidedcontent Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-partnerintegration-organizationalmessageguidedcontent-update.md
- Title: "Update organizationalMessageGuidedContent"
-description: "Update the properties of a organizationalMessageGuidedContent object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Update organizationalMessageGuidedContent
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Update the properties of a [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object.
-
-## Prerequisites
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
-
-## HTTP Request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-PATCH /deviceManagement/organizationalMessageGuidedContents/{organizationalMessageGuidedContentId}
-```
-
-## Request headers
-|Header|Value|
-|:|:|
-|Authorization|Bearer &lt;token&gt; Required.|
-|Accept|application/json|
-
-## Request body
-In the request body, supply a JSON representation for the [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object.
-
-The following table shows the properties that are required when you create the [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md).
-
-|Property|Type|Description|
-|:|:|:|
-|id|String|A unique identifier for the guided content|
-|scenario|[organizationalMessageScenario](../resources/intune-partnerintegration-organizationalmessagescenario.md)|Indicates the scenario for the guided content. Possible values are: `onboarding`, `lifecycle`, `unknownFutureValue`.|
-|theme|[organizationalMessageTheme](../resources/intune-partnerintegration-organizationalmessagetheme.md)|Indicates the theme for the guided content. Possible values are: `update`, `training`, `welcomeToWindows`, `explore`, `unknownFutureValue`.|
-|surface|[organizationalMessageSurface](../resources/intune-partnerintegration-organizationalmessagesurface.md)|Indicates the area where content will be displayed to customers. Possible values are: `actionCenter`, `getStarted`, `softLanding`, `unknownFutureValue`.|
-|placementDetails|[organizationalMessagePlacementDetail](../resources/intune-partnerintegration-organizationalmessageplacementdetail.md) collection|Contains the different types of text content that can be displayed to customers along with their localized values|
-|logo|[organizationalMessageLogoGuide](../resources/intune-partnerintegration-organizationalmessagelogoguide.md)|Example of the logo that will be displayed to customers and its size requirements|
---
-## Response
-If successful, this method returns a `200 OK` response code and an updated [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object in the response body.
-
-## Example
-
-### Request
-Here is an example of the request.
-``` http
-PATCH https://graph.microsoft.com/beta/deviceManagement/organizationalMessageGuidedContents/{organizationalMessageGuidedContentId}
-Content-type: application/json
-Content-length: 1403
-
-{
- "@odata.type": "#microsoft.graph.organizationalMessageGuidedContent",
- "scenario": "lifecycle",
- "theme": "training",
- "surface": "getStarted",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide",
- "logoCdnUrl": "https://example.com/logoCdnUrl/",
- "assetName": "Asset Name value",
- "dimensions": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",
- "minWidth": 8,
- "maxWidth": 8,
- "minHeight": 9,
- "maxHeight": 9
- }
- }
-}
-```
-
-### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-Content-Length: 1452
-
-{
- "@odata.type": "#microsoft.graph.organizationalMessageGuidedContent",
- "id": "13e64843-4843-13e6-4348-e6134348e613",
- "scenario": "lifecycle",
- "theme": "training",
- "surface": "getStarted",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide",
- "logoCdnUrl": "https://example.com/logoCdnUrl/",
- "assetName": "Asset Name value",
- "dimensions": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",
- "minWidth": 8,
- "maxWidth": 8,
- "minHeight": 9,
- "maxHeight": 9
- }
- }
-}
-```
-----
v1.0 Intune Shared Devicemanagementscript Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-shared-devicemanagementscript-create.md
The following table shows the properties that are required when you create the d
|id|String|Unique Identifier for the device management script.| |displayName|String|Name of the device management script.| |description|String|Optional description for the device management script.|
-|runSchedule|[runSchedule](../resources/intune-devices-runschedule.md)|The interval for script to run. If not defined the script will run once|
|scriptContent|Binary|The script content.| |createdDateTime|DateTimeOffset|The date and time the device management script was created. This property is read-only.| |lastModifiedDateTime|DateTimeOffset|The date and time the device management script was last modified. This property is read-only.|
Content-length: 443
"@odata.type": "#microsoft.graph.deviceManagementScript", "displayName": "Display Name value", "description": "Description value",
+ "runSchedule": {
+ "@odata.type": "microsoft.graph.runSchedule"
+ },
"scriptContent": "c2NyaXB0Q29udGVudA==", "runAsAccount": "user", "enforceSignatureCheck": true,
v1.0 Intune Shared Devicemanagementscript List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-shared-devicemanagementscript-list.md
Content-Length: 716
"id": "59ea4525-4525-59ea-2545-ea592545ea59", "displayName": "Display Name value", "description": "Description value",
+ "runSchedule": {
+ "@odata.type": "microsoft.graph.runSchedule"
+ },
"scriptContent": "c2NyaXB0Q29udGVudA==", "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
v1.0 Intune Shared Devicemanagementscript Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-shared-devicemanagementscript-update.md
The following table shows the properties that are required when you create the [
|id|String|Unique Identifier for the device management script.| |displayName|String|Name of the device management script.| |description|String|Optional description for the device management script.|
-|runSchedule|[runSchedule](../resources/intune-devices-runschedule.md)|The interval for script to run. If not defined the script will run once|
|scriptContent|Binary|The script content.| |createdDateTime|DateTimeOffset|The date and time the device management script was created. This property is read-only.| |lastModifiedDateTime|DateTimeOffset|The date and time the device management script was last modified. This property is read-only.|
Content-length: 443
"@odata.type": "#microsoft.graph.deviceManagementScript", "displayName": "Display Name value", "description": "Description value",
+ "runSchedule": {
+ "@odata.type": "microsoft.graph.runSchedule"
+ },
"scriptContent": "c2NyaXB0Q29udGVudA==", "runAsAccount": "user", "enforceSignatureCheck": true,
v1.0 Intune Wip Intunebrandingprofile Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-wip-intunebrandingprofile-create.md
The following table shows the properties that are required when you create the i
|companyPortalBlockedActions|[companyPortalBlockedAction](../resources/intune-shared-companyportalblockedaction.md) collection|Collection of blocked actions on the company portal as per platform and device ownership types.| |showAzureADEnterpriseApps|Boolean|Boolean that indicates if AzureAD Enterprise Apps will be shown in Company Portal| |showOfficeWebApps|Boolean|Boolean that indicates if Office WebApps will be shown in Company Portal|
+|showConfigurationManagerApps|Boolean|Boolean that indicates if Configuration Manager Apps will be shown in Company Portal|
|sendDeviceOwnershipChangePushNotification|Boolean|Boolean that indicates if a push notification is sent to users when their device ownership type changes from personal to corporate| |enrollmentAvailability|[enrollmentAvailabilityOptions](../resources/intune-shared-enrollmentavailabilityoptions.md)|Customized device enrollment flow displayed to the end user . Possible values are: `availableWithPrompts`, `availableWithoutPrompts`, `unavailable`.| |disableClientTelemetry|Boolean|Applies to telemetry sent from all clients to the Intune service. When disabled, all proactive troubleshooting and issue warnings within the client are turned off, and telemetry settings appear inactive or hidden to the device user.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/intuneBrandingProfiles Content-type: application/json
-Content-length: 1975
+Content-length: 2016
{ "@odata.type": "#microsoft.graph.intuneBrandingProfile",
Content-length: 1975
], "showAzureADEnterpriseApps": true, "showOfficeWebApps": true,
+ "showConfigurationManagerApps": true,
"sendDeviceOwnershipChangePushNotification": true, "enrollmentAvailability": "availableWithoutPrompts", "disableClientTelemetry": true,
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 2147
+Content-Length: 2188
{ "@odata.type": "#microsoft.graph.intuneBrandingProfile",
Content-Length: 2147
], "showAzureADEnterpriseApps": true, "showOfficeWebApps": true,
+ "showConfigurationManagerApps": true,
"sendDeviceOwnershipChangePushNotification": true, "enrollmentAvailability": "availableWithoutPrompts", "disableClientTelemetry": true,
v1.0 Intune Wip Intunebrandingprofile Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-wip-intunebrandingprofile-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 2284
+Content-Length: 2327
{ "value": {
Content-Length: 2284
], "showAzureADEnterpriseApps": true, "showOfficeWebApps": true,
+ "showConfigurationManagerApps": true,
"sendDeviceOwnershipChangePushNotification": true, "enrollmentAvailability": "availableWithoutPrompts", "disableClientTelemetry": true,
v1.0 Intune Wip Intunebrandingprofile List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-wip-intunebrandingprofile-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 2416
+Content-Length: 2461
{ "value": [
Content-Length: 2416
], "showAzureADEnterpriseApps": true, "showOfficeWebApps": true,
+ "showConfigurationManagerApps": true,
"sendDeviceOwnershipChangePushNotification": true, "enrollmentAvailability": "availableWithoutPrompts", "disableClientTelemetry": true,
v1.0 Intune Wip Intunebrandingprofile Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-wip-intunebrandingprofile-update.md
The following table shows the properties that are required when you create the [
|companyPortalBlockedActions|[companyPortalBlockedAction](../resources/intune-shared-companyportalblockedaction.md) collection|Collection of blocked actions on the company portal as per platform and device ownership types.| |showAzureADEnterpriseApps|Boolean|Boolean that indicates if AzureAD Enterprise Apps will be shown in Company Portal| |showOfficeWebApps|Boolean|Boolean that indicates if Office WebApps will be shown in Company Portal|
+|showConfigurationManagerApps|Boolean|Boolean that indicates if Configuration Manager Apps will be shown in Company Portal|
|sendDeviceOwnershipChangePushNotification|Boolean|Boolean that indicates if a push notification is sent to users when their device ownership type changes from personal to corporate| |enrollmentAvailability|[enrollmentAvailabilityOptions](../resources/intune-shared-enrollmentavailabilityoptions.md)|Customized device enrollment flow displayed to the end user . Possible values are: `availableWithPrompts`, `availableWithoutPrompts`, `unavailable`.| |disableClientTelemetry|Boolean|Applies to telemetry sent from all clients to the Intune service. When disabled, all proactive troubleshooting and issue warnings within the client are turned off, and telemetry settings appear inactive or hidden to the device user.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/intuneBrandingProfiles/{intuneBrandingProfileId} Content-type: application/json
-Content-length: 1975
+Content-length: 2016
{ "@odata.type": "#microsoft.graph.intuneBrandingProfile",
Content-length: 1975
], "showAzureADEnterpriseApps": true, "showOfficeWebApps": true,
+ "showConfigurationManagerApps": true,
"sendDeviceOwnershipChangePushNotification": true, "enrollmentAvailability": "availableWithoutPrompts", "disableClientTelemetry": true,
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 2147
+Content-Length: 2188
{ "@odata.type": "#microsoft.graph.intuneBrandingProfile",
Content-Length: 2147
], "showAzureADEnterpriseApps": true, "showOfficeWebApps": true,
+ "showConfigurationManagerApps": true,
"sendDeviceOwnershipChangePushNotification": true, "enrollmentAvailability": "availableWithoutPrompts", "disableClientTelemetry": true,
v1.0 Learningcontent Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/learningcontent-update.md
PATCH /employeeExperience/learningProviders/{learningProviderId}/learningContent
|contributors|String collection|The authors, creators, or contributors of the learning content. Optional.| |createdDateTime|DateTimeOffset|The date when the learning content was created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Optional.| |description|String|The description or summary for the learning content. Optional.|
-|duration|Duration|The duration of the learning content in seconds. Optional.|
+|duration|Duration|The duration of the learning content in seconds. The value is represented in ISO 8601 format for durations. Optional.|
|externalId|String|Unique external content ID for the learning content. Required.| |format|String|The format of the learning content. For example, `Course`, `Video`, `Book`, `Book Summary`, `Audiobook Summary`. Optional.| |isActive|Boolean|Indicates whether the content is active or not. Inactive content will not show up in the UI. The default value is `true`. Optional.|
Content-Type: application/json
"numberOfPages": 9, "duration": "PT20M", "format": "Book",
- "createdDateTime": "2018-01-01T00:00:00",
+ "createdDateTime": "2018-01-01T00:00:00Z",
"lastModifiedDateTime": "2021-04-01T04:26:06.1995367Z",
- "contributor": "Scott Simpson",
+ "contributors": ["Scott Simpson"],
"additionalTags": [ "Create private or public teams", "Add members to teams"
v1.0 Managedtenants Auditevent Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-auditevent-get.md
Title: "Get auditEvent"
description: "Read the properties and relationships of an auditEvent object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Cloudpcconnection Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-cloudpcconnection-get.md
Title: "Get cloudPcConnection"
description: "Read the properties and relationships of a cloudPcConnection object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Cloudpcdevice Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-cloudpcdevice-get.md
Title: "Get cloudPcDevice"
description: "Read the properties and relationships of a cloudPcDevice object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Cloudpcoverview Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-cloudpcoverview-get.md
Title: "Get cloudPcOverview"
description: "Read the properties and relationships of a cloudPcOverview object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Conditionalaccesspolicycoverage Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-conditionalaccesspolicycoverage-get.md
Title: "Get conditionalAccessPolicyCoverage"
description: "Read the properties and relationships of a conditionalAccessPolicyCoverage object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Credentialuserregistrationssummary Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-credentialuserregistrationssummary-get.md
Title: "Get credentialUserRegistrationsSummary"
description: "Read the properties and relationships of a credentialUserRegistrationsSummary object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Devicecompliancepolicysettingstatesummary Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-devicecompliancepolicysettingstatesummary-get.md
Title: "Get deviceCompliancePolicySettingStateSummary"
description: "Read the properties and relationships of a deviceCompliancePolicySettingStateSummary object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Manageddevicecompliance Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-manageddevicecompliance-get.md
Title: "Get managedDeviceCompliance"
description: "Read the properties and relationships of a managedDeviceCompliance object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Manageddevicecompliancetrend Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-manageddevicecompliancetrend-get.md
Title: "Get managedDeviceComplianceTrend"
description: "Read the properties and relationships of a managedDeviceComplianceTrend object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Aggregatedpolicycompliances https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-aggregatedpolicycompliances.md
Title: "List aggregatedPolicyCompliances"
description: "Get a list of the aggregatedPolicyCompliance objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Auditevents https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-auditevents.md
Title: "List auditEvents"
description: "Get a list of the auditEvent objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Cloudpcconnections https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-cloudpcconnections.md
Title: "List cloudPcConnections"
description: "Get a list of the cloudPcConnection objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Cloudpcdevices https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-cloudpcdevices.md
Title: "List cloudPcDevices"
description: "Get a list of the cloudPcDevice objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Cloudpcsoverview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-cloudpcsoverview.md
Title: "List cloudPcOverviews"
description: "Get a list of the cloudPcOverview objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Conditionalaccesspolicycoverages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-conditionalaccesspolicycoverages.md
Title: "List conditionalAccessPolicyCoverages"
description: "Get a list of the conditionalAccessPolicyCoverage objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Credentialuserregistrationssummaries https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-credentialuserregistrationssummaries.md
Title: "List credentialUserRegistrationsSummaries"
description: "Get a list of the credentialUserRegistrationsSummary objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Devicecompliancepolicysettingstatesummary https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-devicecompliancepolicysettingstatesummary.md
Title: "List deviceCompliancePolicySettingStateSummary"
description: "Get a list of the deviceCompliancePolicySettingStateSummary objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Manageddevicecompliances https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-manageddevicecompliances.md
Title: "List managedDeviceCompliances"
description: "Get a list of the managedDeviceCompliance objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Manageddevicecompliancetrends https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-manageddevicecompliancetrends.md
Title: "List managedDeviceComplianceTrends"
description: "Get a list of the managedDeviceComplianceTrend objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Managementactions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-managementactions.md
Title: "List managementActions"
description: "Get a list of the managementAction objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Managementactiontenantdeploymentstatuses https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-managementactiontenantdeploymentstatuses.md
Title: "List managementActionTenantDeploymentStatus"
description: "Get a list of the managementActionTenantDeploymentStatus objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Managementintents https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-managementintents.md
Title: "List managementIntents"
description: "Get a list of the managementIntent objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Managementtemplates https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-managementtemplates.md
Title: "List managementTemplates"
description: "Get a list of the managementTemplate objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Myroles https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-myroles.md
Title: "List myRoles"
description: "Get the roles that a signed-in user has through a delegated relationship across managed tenants." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Tenantgroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-tenantgroups.md
Title: "List tenantGroups"
description: "Get a list of the tenantGroup objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Tenants https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-tenants.md
Title: "List tenants"
description: "Get a list of the tenant objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Tenantscustomizedinformation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-tenantscustomizedinformation.md
Title: "List tenantCustomizedInformation"
description: "Get a list of the tenantCustomizedInformation objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Tenantsdetailedinformation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-tenantsdetailedinformation.md
Title: "List tenantDetailedInformation"
description: "Get a list of the tenantDetailedInformation objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Tenanttags https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-tenanttags.md
Title: "List tenantTags"
description: "Get a list of the tenantTag objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Tenantusage https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-tenantusage.md
Title: "List tenantUsage"
description: "Get a list of the tenantUsage objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Windowsdevicemalwarestates https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-windowsdevicemalwarestates.md
Title: "List windowsDeviceMalwareStates"
description: "Get a list of the windowsDeviceMalwareState objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Windowsprotectionstates https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-windowsprotectionstates.md
Title: "List windowsProtectionStates"
description: "Get a list of the windowsProtectionState objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant Post Tenanttags https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-post-tenanttags.md
Title: "Create tenantTag"
description: "Create a new tenantTag object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managementaction Apply https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managementaction-apply.md
Title: "managementAction: apply"
description: "Applies a management action against a specific managed tenant. By performing this operation the appropriate configurations will be made and policies created. As example when applying the require multi-factor authentication for admins management action will create an Azure Active Directory conditional access policy that requires multi-factor authentication for all users that have been assigned an administrative directory role." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managementaction Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managementaction-get.md
Title: "Get managementAction"
description: "Read the properties and relationships of a managementAction object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managementactiontenantdeploymentstatus Changedeploymentstatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managementactiontenantdeploymentstatus-changedeploymentstatus.md
Title: "managementActionTenantDeploymentStatus: changeDeploymentStatus"
description: "Changes the tenant level deployment status for the management action. This information is used to provide insights into what management actions are in a specific state. As example there might be a plan to apply the require multi-factor authentication for admins, so it would be ideal to change the status to planned to reflect the appropriate status." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managementactiontenantdeploymentstatus Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managementactiontenantdeploymentstatus-get.md
Title: "Get managementActionTenantDeploymentStatus"
description: "Read the properties and relationships of a managementActionTenantDeploymentStatus object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managementintent Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managementintent-get.md
Title: "Get managementIntent"
description: "Read the properties and relationships of a managementIntent object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managementtemplate Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managementtemplate-get.md
Title: "Get managementTemplate"
description: "Read the properties and relationships of a managementTemplate object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenant Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenant-get.md
Title: "Get tenant"
description: "Read the properties and relationships of a tenant object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenant Offboardtenant https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenant-offboardtenant.md
Title: "tenant: offboardTenant"
description: "Carries out the appropriate procedures to remove a managed tenant from the multi-tenant management platform. No relationships, such as commerce and delegate administrative privileges, will be impacted. The only change made by invoking this action is the tenant will be deprovisioned from the multi-tenant management platform." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenant Resettenantonboardingstatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenant-resettenantonboardingstatus.md
Title: "tenant: resetTenantOnboardingStatus"
description: "Carries out the appropriate procedures to reset the onboarding status for the managed tenant that was removed from the multi-tenant management platform using the offboardTenant action. By invoking this action the platform will attempt to onboard the managed tenant for management." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenantcustomizedinformation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenantcustomizedinformation-get.md
Title: "Get tenantCustomizedInformation"
description: "Read the properties and relationships of a tenantCustomizedInformation object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenantcustomizedinformation Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenantcustomizedinformation-update.md
Title: "Update tenantCustomizedInformation"
description: "Update the properties of a tenantCustomizedInformation object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenantdetailedinformation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenantdetailedinformation-get.md
Title: "Get tenantDetailedInformation"
description: "Read the properties and relationships of a tenantDetailedInformation object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenantgroup Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenantgroup-get.md
Title: "Get tenantGroup"
description: "Read the properties and relationships of a tenantGroup object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenantgroup Tenantsearch https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenantgroup-tenantsearch.md
Title: "tenantGroup: tenantSearch"
description: "Searches for the specified managed tenants across tenant groups." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenanttag Assigntag https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenanttag-assigntag.md
Title: "tenantTag: assignTag"
description: "Assign the tenant tag to the specified managed tenants." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenanttag Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenanttag-delete.md
Title: "Delete tenantTag"
description: "Delete a tenantTag object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenanttag Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenanttag-get.md
Title: "Get tenantTag"
description: "Read the properties and relationships of a tenantTag object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenanttag Unassigntag https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenanttag-unassigntag.md
Title: "tenantTag: unassignTag"
description: "Un-assigns the tenant tag from the specified managed tenants." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenanttag Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenanttag-update.md
Title: "Update tenantTag"
description: "Update the properties of a tenantTag object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Windowsdevicemalwarestate Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-windowsdevicemalwarestate-get.md
Title: "Get windowsDeviceMalwareState"
description: "Read the properties and relationships of a windowsDeviceMalwareState object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Windowsprotectionstate Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-windowsprotectionstate-get.md
Title: "Get windowsProtectionState"
description: "Read the properties and relationships of a windowsProtectionState object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Oauth2permissiongrant Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/oauth2permissiongrant-delta.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) | Directory.Read.All, Directory.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |
-|oauth2permissiongrant | Directory.Read.All, DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All |
+|Application | Directory.Read.All, DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All |
## HTTP request
GET /oauth2PermissionGrants/delta
## Query parameters
-Tracking changes incurs a round of one or more **delta** function calls. If you use any query parameter
-(other than `$deltatoken` and `$skiptoken`), you must specify
-it in the initial **delta** request. Microsoft Graph automatically encodes any specified parameters
-into the token portion of the `@odata.nextLink` or `@odata.deltaLink` URL provided in the response.
-You only need to specify any query parameters once up front.
-In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL from the previous response. That URL already
+Tracking changes incurs a round of one or more **delta** function calls. If you use any query parameter
+(other than `$deltatoken` and `$skiptoken`), you must specify
+it in the initial **delta** request. Microsoft Graph automatically encodes any specified parameters
+into the token portion of the `@odata.nextLink` or `@odata.deltaLink` URL provided in the response.
+You only need to specify any query parameters once up front.
+In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL from the previous response. That URL already
includes the encoded parameters. | Query parameter | Type |Description|
GET https://graph.microsoft.com/beta/oauth2PermissionGrants/delta
### Response >**Note:** The response object shown here might be shortened for readability.
-<!-- {
+<!-- {
"blockType": "response", "truncated": true, "@odata.type": "microsoft.graph.oAuth2PermissionGrant",
- "isCollection": true
-} -->
+ "isCollection": true
+} -->
```http HTTP/1.1 200 OK Content-type: application/json
v1.0 Organization Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/organization-get.md
Content-type: application/json
"country": null, "countryLetterCode": "NL", "createdDateTime": "2021-08-02T10:30:06Z",
+ "defaultUsageLocation": "String",
"displayName": "Contoso", "isMultipleDataLocationsForServicesEnabled": null, "marketingNotificationEmails": [],
v1.0 Organization List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/organization-list.md
Content-type: application/json
"country": null, "countryLetterCode": "NL", "createdDateTime": "2021-08-02T10:30:06Z",
+ "defaultUsageLocation": "String",
"displayName": "Contoso", "isMultipleDataLocationsForServicesEnabled": null, "marketingNotificationEmails": [],
v1.0 Plannerbucket List Tasks https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/plannerbucket-list-tasks.md
Title: "List tasks"
-description: "Retrieve a list of **plannerTask** objects associated to a plannerBucket object."
+description: "Retrieve a list of plannerTask objects associated to a plannerBucket object."
ms.localizationpriority: medium ms.prod: "planner"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve a list of **plannerTask** objects associated to a [plannerBucket](../resources/plannerbucket.md) object.
+Retrieve a list of [plannerTask](../resources/plannertask.md) objects associated to a [plannerBucket](../resources/plannerbucket.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).
Do not supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and collection of [plannerTask](../resources/plannertask.md) objects in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [plannerTask](../resources/plannertask.md) objects in the response body.
This method can return any of the [HTTP status codes](/graph/errors). The most common errors that apps should handle for this method are the 403 and 404 responses. For more information about these errors, see [Common Planner error conditions](../resources/planner-overview.md#common-planner-error-conditions). ## Example
-##### Request
-Here is an example of the request.
+### Request
+The following is an example of the request.
# [HTTP](#tab/http) <!-- {
GET https://graph.microsoft.com/beta/planner/buckets/gcrYAaAkgU2EQUvpkNNXLGQAGTt
-##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+### Response
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
v1.0 Plannertask Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/plannertask-get.md
Title: "Get plannerTask"
-description: "Retrieve the properties and relationships of **plannertask** object."
+description: "Retrieve the properties and relationships of plannerTask object."
ms.localizationpriority: medium ms.prod: "planner"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve the properties and relationships of **plannertask** object.
+Retrieve the properties and relationships of [plannerTask](../resources/plannertask.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).
Do not supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and [plannerTask](../resources/plannertask.md) object in the response body.
+If successful, this method returns a `200 OK` response code and a [plannerTask](../resources/plannertask.md) object in the response body.
This method can return any of the [HTTP status codes](/graph/errors). The most common errors that apps should handle for this method are the 403 and 404 responses. For more information about these errors, see [Common Planner error conditions](../resources/planner-overview.md#common-planner-error-conditions). ## Example
-##### Request
-Here is an example of the request.
+### Request
+The following is an example of the request.
# [HTTP](#tab/http) <!-- {
GET https://graph.microsoft.com/beta/planner/tasks/01gzSlKkIUSUl6DF_EilrmQAKDhh
-##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+### Response
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
v1.0 Presence Setpresence https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/presence-setpresence.md
Similarly, an application can have its own presence session for a user and be ab
The following is the precedence for how session states are aggregated, with "A > B" representing A having precedence over B: * User-preferred state > session-level states (user-preferred state overrides session-level states)
-* Among session-level states: DoNotDisturb (currently not supported for **setPresence**) > Busy > Available > Away
+* Among session-level states: DoNotDisturb > Busy > Available > Away
### Timeout, expiration, and keep alive A presence session may **time out** and **expire**, so the application needs to call this API before the **timeout**, to maintain the state for the session; or before the **expiration**, to keep the session alive.
In the request body, provide a JSON object with the following parameters.
Supported combinations of `availability` and `activity` are:
-| availability | activity | Description |
-| :-- | :- | :- |
-| Available | Available | Updates the presence session as Available. |
-| Busy | InACall | Updates the presence session as Busy, InACall. |
-| Busy | InAConferenceCall | Updates the presence session as Busy, InAConferenceCall. |
-| Away | Away | Updates the presence session as Away. |
+| availability | activity | Description |
+| :-- | :- | :-- |
+| Available | Available | Updates the presence session as Available. |
+| Busy | InACall | Updates the presence session as Busy, InACall. |
+| Busy | InAConferenceCall | Updates the presence session as Busy, InAConferenceCall. |
+| Away | Away | Updates the presence session as Away. |
+| DoNotDisturb | Presenting | Updates the presence session as DoNotDisturb, Presenting. |
## Response If successful, this method returns a `200 OK` response code.
v1.0 Print List Recentshares https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/print-list-recentshares.md
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", "name": "get_recentprintershares"
The following is an example of the request.
GET https://graph.microsoft.com/beta/me/print/recentPrinterShares ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
++++ ### Response The following is an example of the response. >**Note:** The response object shown here might be shortened for readability.
v1.0 Security Alert Post Comments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-alert-post-comments.md
If successful, this method returns a `200 OK` response code and an updated list
### Request The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "sampleKeys": ["da637865765418431569_-773071023"],
Content-Type: application/json
} ```
+# [JavaScript](#tab/javascript)
++++ ### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
v1.0 Security Ediscoverycase Post Legalholds https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycase-post-legalholds.md
You can specify the following properties when you create an **ediscoveryHoldPoli
|:|:|:| |displayName|String|The display name of the legal hold policy. Required.| |description|String|The description of the legal hold policy. Optional.|
-|contentQuery|String|The content query of the legal hold policy. Optional.|
## Response
Content-Type: application/json
{ "displayname": "My legalHold with sources", "description": "Created from Graph API",
- "contentQuery": "Bazooka",
"userSources@odata.bind": [ { "@odata.type": "microsoft.graph.security.userSource",
Content-Type: application/json
"@odata.context": "https://graph.microsoft.com/beta/$metadata#security/cases/ediscoveryCases('b0073e4e-4184-41c6-9eb7-8c8cc3e2288b')/legalHolds/$entity", "isEnabled": true, "errors": [],
- "contentQuery": "Bazooka",
"description": "Created from Graph API", "createdDateTime": "2022-05-23T03:54:11.1Z", "lastModifiedDateTime": "2022-05-23T03:54:11.1Z",
v1.0 Security Ediscoveryholdpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoveryholdpolicy-update.md
PATCH /security/cases/ediscoveryCases/{ediscoveryCaseId}/legalHolds/{ediscoveryH
|Property|Type|Description| |:|:|:| |description|String|The description of the legal hold policy. Optional.|
-|contentQuery|String|The content query of the legal hold policy. Optional.|
## Response
PATCH https://graph.microsoft.com/beta/security/cases/ediscoveryCases/b0073e4e-4
{ "description": "updated description",
- "contentQuery": "bazooka bazooka"
} ```
v1.0 Security Incident Post Comments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-incident-post-comments.md
If successful, this method returns a `200 OK` response code and an updated list
### Request The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "sampleKeys": ["3962396"],
Content-Type: application/json
} ```
+# [JavaScript](#tab/javascript)
++++ ### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
v1.0 Security Security Runhuntingquery https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-security-runhuntingquery.md
POST /security/runHuntingQuery
## Request body
-In the request body, provide a JSON object for the parameter, `query`.
+In the request body, provide a JSON object for the parameter, `Query`.
| Parameter | Type |Description| |:|:--|:-|
-|query|String|The hunting query in Kusto Query Language (KQL). For more information on KQL syntax, see [KQL quick reference](/azure/data-explorer/kql-quick-reference).|
+|Query|String|The hunting query in Kusto Query Language (KQL). For more information on KQL syntax, see [KQL quick reference](/azure/data-explorer/kql-quick-reference).|
## Response
This example specifies a KQL query which does the following:
- Sorts the output by the `Timestamp` value. - Limits the output to 2 records (2 rows). +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "security_runhuntingquery"
This example specifies a KQL query which does the following:
POST https://graph.microsoft.com/beta/security/runHuntingQuery {
- "query":"DeviceProcessEvents | where InitiatingProcessFileName =~ \"powershell.exe\" | project Timestamp, FileName, InitiatingProcessFileName | order by Timestamp desc | limit 2"
+ "Query": "DeviceProcessEvents | where InitiatingProcessFileName =~ \"powershell.exe\" | project Timestamp, FileName, InitiatingProcessFileName | order by Timestamp desc | limit 2"
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PHP](#tab/php)
++++ ### Response >**Note:** The response object shown here might be shortened for readability.
Content-type: application/json
} ] }
-```
+```
v1.0 Serviceprincipal Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/serviceprincipal-get.md
GET https://graph.microsoft.com/beta/servicePrincipals/{id}?$select=customSecuri
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php)
v1.0 Sites List Followed https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/sites-list-followed.md
Namespace: microsoft.graph
List the [sites](../resources/site.md) that have been followed by the signed in user.
+>**Note:** This API has a [known issue](/graph/known-issues#sites-and-lists-sharepoint) and might return incorrect results.
+ ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Team Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/team-get.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (work or school account) | Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, Group.Read.All**, Group.ReadWrite.All**, Directory.Read.All**, Directory.ReadWrite.All** | |Delegated (personal Microsoft account) | Not supported. | |Application | TeamSettings.Read.Group*, TeamSettings.ReadWrite.Group*, Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, Group.Read.All**, Group.ReadWrite.All**, Directory.Read.All**, Directory.ReadWrite.All** |+ [!INCLUDE [teamwork-permissions-note](../../../includes/teamwork-permissions-note.md)] > **Note**: This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they are not a member of.
v1.0 Team Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/team-post.md
Content-Type: application/json
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go)
v1.0 Team Put Schedule https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/team-put-schedule.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/go/team-put-schedule-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [PHP](#tab/php) [!INCLUDE [sample-code](../includes/snippets/php/team-put-schedule-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
PUT https://graph.microsoft.com/beta/teams/871dbd5c-3a6a-4392-bfe1-042452793a50/
[!INCLUDE [sample-code](../includes/snippets/go/team-put-schedule-2-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [PHP](#tab/php) [!INCLUDE [sample-code](../includes/snippets/php/team-put-schedule-2-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Unifiedroledefinition Assignedprincipals https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroledefinition-assignedprincipals.md
+
+ Title: "unifiedRoleDefinition: assignedPrincipals"
+description: "Get the list of security principals (users, groups, and service principals) directly or transitively assigned to a specific role for different scopes."
+
+ms.localizationpriority: medium
++
+# unifiedRoleDefinition: assignedPrincipals
+Namespace: microsoft.graph
++
+Get the list of security principals (users, groups, and service principals) that are assigned to a specific role for different scopes either directly or transitively. You can use the `$count` query parameter to also get the count.
+
+To list the direct and transitive role assignments for a specific principal, use the [List transitiveRoleAssignments](rbacapplication-list-transitiveroleassignments.md) API.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|RoleManagement.Read.Directory, Directory.Read.All, RoleManagement.ReadWrite.Directory|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|RoleManagement.Read.Directory, Directory.Read.All, RoleManagement.ReadWrite.Directory|
+
+If the caller does not have the permission to read properties for some of the objects included in the result set, the response will follow the [limited information returned for inaccessible member objects](/graph/permissions-reference#limited-information-returned-for-inaccessible-member-objects) pattern.
+
+To read the properties that may require permissions for the object, grant the permissions to retrieve information about the object. For more information, see permissions for [users](user-list.md#permissions), [groups](group-list.md#permissions), and [service principals](serviceprincipal-list.md#permissions).
++
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /roleManagement/directory/roleDefinitions/{unifiedRoleDefinitionId}/assignedPrincipals
+```
+
+## Function parameters
+In the request URL, provide the following query parameters with values.
+The following table shows the parameters that can be used with this function.
+
+|Parameter|Type|Description|
+|:|:|:|
+|transitive|Boolean|Indicates whether to include principals assigned through group membership (direct or transitive). `false` by default.|
+|directoryScopeType|String|The directory scope to get assigned principals for. Supported values are `tenant`, `administrativeUnit`, and `resource`.|
+|directoryScopeId|String|ID of the directory scope to get assigned principals for. By default, all scopes are considered.|
+
+You can also combine all the supported function parameters in one request for fine-grained results.
+
+### Example query patterns for directoryScopeType
+
+|Scope|Query|Supported for|
+|:|:|:|
+|All scopes|`/assignedPrincipals(transitive={true | false})`|All roles|
+|Tenant scope|`/assignedPrincipals(directoryScopeType='tenant', transitive={true | false})`|All roles|
+|All administrative unit scopes|`/assignedPrincipals(directoryScopeType='administrativeUnit', transitive={true | false})`|Directory roles|
+|Specific administrative unit scope|`/assignedPrincipals(directoryScopeType='administrativeUnit', directoryScopeId ='{roleDefinitionId | templateId}', transitive={true | false})`|Directory roles|
+|All resource scopes|`/assignedPrincipals(directoryScopeType='resource', transitive={true | false})`|Directory roles|
+|Specific resource scope|`/assignedPrincipals(directoryScopeType='resource', directoryScopeId ='{roleDefinitionId | templateId}', transitive={true | false})`|Directory roles|
+
+## Optional query parameters
+
+This method supports the `$count`, `$select`, `$filter`, and `$orderBy` OData query parameters to help customize the response. You can also filter by the type of object using OData casting. For example, `/assignedPrincipals(transitive=false)/microsoft.graph.user` and `/assignedPrincipals(transitive=true)/microsoft.graph.servicePrincipal/$count`. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|ConsistencyLevel|eventual. Required. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this function returns a `200 OK` response code and a [directoryObject](../resources/directoryobject.md) collection in the response body.
+
+## Examples
+
+For the examples in this section, consider the following role assignment scenario. A user named User1 has both direct and transitive role assignments as follows:
+
+| User | Group | Role | Scope |
+| :: | :: | :: | :: |
+| User1<br/>`6c62e70d-f5f5-4b9d-9eea-ed517ed9341f` | | Role1 | Scope1 |
+| User1<br/>`6c62e70d-f5f5-4b9d-9eea-ed517ed9341f` | | Role1 | Scope2 |
+| | Group1<br/>`86b38db7-6e8b-4ad2-b2aa-ced7f09486c1`<br/>(User1 is a member) | Role1 | Scope1 |
+| | Group2<br/>`182351a6-d974-4d18-88ae-8a148da44cd2`<br/>(User1 is a member) | Role1 | Scope1 |
+| | Group3<br/>`b93d5379-a464-4db5-b8e1-694910f1e11e`<br/>(User2 is a member)<br/>(User3 is a member) | Role1 | Scope3 |
+++ User1 is assigned the Role1 role directly at Scope1 scope.++ User1 is assigned the Role1 role directly at Scope2 scope.++ User1 is member of the Group1 group and Group1 is assigned the Role1 role at Scope1 scope.++ User1 is member of the Group2 group and Group2 is assigned the Role1 role at Scope1 scope.++ User2 is member of the Group3 group and Group3 is assigned the Role1 role at Scope3 scope.++ User3 is member of the Group3 group and Group3 is assigned the Role1 role at Scope3 scope.+
+### Example 1: Get a count of direct and transitive assigned principals for all scopes
+
+#### Request
+
+<!-- {
+ "blockType": "ignored",
+ "name": "unifiedroledefinition_assignedprincipals_count"
+}
+-->
+```http
+GET https://graph.microsoft.com/beta/roleManagement/directory/roleDefinitions/644ef478-e28f-4e28-b9dc-3fdde9aa0b1f/assignedPrincipals(transitive=true)/$count
+```
+
+#### Response
+
+The above request will return a count of 6 representing the following role assignments:
++ Two direct role assignments to User1 at Scope1 and Scope2++ Two transitive role assignments to User1 through Group1 and Group2++ Two transitive role assignments to User 2 and User3 through Group3.+
+<!-- {
+ "blockType": "response"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: text/plain
+
+6
+```
+
+Using the same scenario, the following examples show the counts that will be returned for each query pattern:
+
+| Example | Count |
+| | |
+| `/assignedPrincipals(transitive=false)/$count` | 4<br/>(User1, Group1, Group2, Group3) |
+| `/assignedPrincipals(transitive=false)/microsoft.graph.user/$count` | 1<br/>(User1) |
+| `/assignedPrincipals(transitive=true)/microsoft.graph.user/$count` | 3<br/>(User1, User2, User3) |
+| `/assignedPrincipals(transitive=false)/microsoft.graph.group/$count` | 3<br/>(Group1, Group2, Group3) |
+| `/assignedPrincipals(transitive=true)/microsoft.graph.group/$count` | 3<br/>(Group1, Group2, Group3) |
+
+### Example 2: Get directly assigned principals for a specific administrative unit scope and directory role
+
+#### Request
+<!-- {
+ "blockType": "request",
+ "name": "unifiedroledefinition_assignedprincipals_scope_role"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/roleManagement/directory/roleDefinitions/644ef478-e28f-4e28-b9dc-3fdde9aa0b1f/assignedPrincipals(directoryScopeType='administrativeUnit', directoryScopeId ='d0c2e067-9ae9-4dbf-a280-51a51c46f432')
+```
+
+#### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.directoryObject)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#directoryObjects",
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.user",
+ "id": "6c62e70d-f5f5-4b9d-9eea-ed517ed9341f"
+ }
+ ]
+}
+```
+
+### Example 3: Get directly assigned principals for all scopes
+
+#### Request
+<!-- {
+ "blockType": "request",
+ "name": "unifiedroledefinition_assignedprincipals_allscopes"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/roleManagement/directory/roleDefinitions/644ef478-e28f-4e28-b9dc-3fdde9aa0b1f/assignedPrincipals
+```
+
+#### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.directoryObject)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#directoryObjects",
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.user",
+ "id": "6c62e70d-f5f5-4b9d-9eea-ed517ed9341f",
+ "displayName": null,
+ "userPrincipalName": null
+ },
+ {
+ "@odata.type": "#microsoft.graph.group",
+ "id": "86b38db7-6e8b-4ad2-b2aa-ced7f09486c1",
+ "displayName": "Group1"
+ },
+ {
+ "@odata.type": "#microsoft.graph.group",
+ "id": "182351a6-d974-4d18-88ae-8a148da44cd2",
+ "displayName": "Group2"
+ },
+ {
+ "@odata.type": "#microsoft.graph.group",
+ "id": "b93d5379-a464-4db5-b8e1-694910f1e11e",
+ "displayName": "Group3"
+ }
+ ]
+}
+```
+
+### Example 4: Get directly assigned users only for a tenant-wide scope
+
+#### Request
+<!-- {
+ "blockType": "request",
+ "name": "unifiedroledefinition_assignedprincipals_scope"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/roleManagement/directory/roleDefinitions/644ef478-e28f-4e28-b9dc-3fdde9aa0b1f/assignedPrincipals(directoryScopeType='tenant')/microsoft.graph.user
+```
+
+#### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.directoryObject)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#users",
+ "value": [
+ {
+ "id": "6c62e70d-f5f5-4b9d-9eea-ed517ed9341f",
+ "displayName": null,
+ "userPrincipalName": null
+ }
+ ]
+}
+```
+
+### Example 5: Get directly assigned principals and inline count
+
+The following example gets the directly assigned principals and displays an inline count.
+
+#### Request
+<!-- {
+ "blockType": "request",
+ "name": "unifiedroledefinition_assignedprincipals_minimumpermission_count"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/roleManagement/directory/roleDefinitions/644ef478-e28f-4e28-b9dc-3fdde9aa0b1f/assignedPrincipals?$count=true
+```
+
+#### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.directoryObject)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#directoryObjects",
+ "@odata.count": 4,
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.user",
+ "id": "6c62e70d-f5f5-4b9d-9eea-ed517ed9341f",
+ "displayName": null,
+ "userPrincipalName": null
+ },
+ {
+ "@odata.type": "#microsoft.graph.group",
+ "id": "86b38db7-6e8b-4ad2-b2aa-ced7f09486c1",
+ "displayName": "Group1"
+ },
+ {
+ "@odata.type": "#microsoft.graph.group",
+ "id": "182351a6-d974-4d18-88ae-8a148da44cd2",
+ "displayName": "Group2"
+ },
+ {
+ "@odata.type": "#microsoft.graph.group",
+ "id": "b93d5379-a464-4db5-b8e1-694910f1e11e",
+ "displayName": "Group3"
+ }
+ ]
+}
+```
v1.0 User List People https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/user-list-people.md
This method supports the following OData query parameters to help customize the
|:|:--|:-| |$filter|string|Limits the response to only those people whose record contains the specified criteria.| |$orderby|string|By default the people in the response are sorted by their relevance to your query. You can change the order of the people in the response using the *$orderby* parameter.|
-|$search|string|Search for people by name or alias. Supports Fuzzy matching. Parameter only works for searching the signed-in user's relevant people, not for searching people relevant to other users. Also supports the `topic` keyword to find people based on topics extracted from e-mail conversations with that person. See the *Perform a fuzzy search* section at [Get relevant information about people](/graph/people-example#perform-a-fuzzy-search) for information and examples.|
+|$search|string|Search for people by name or alias. Supports Fuzzy matching. Parameter only works for searching the signed-in user's relevant people, not for searching people relevant to other users. Also supports the `topic` keyword to find people based on topics extracted from e-mail conversations with that person. For information and examples, see the *Perform a fuzzy search* section at [Use the People API to get information about the people most relevant to you](/graph/people-insights-overview#perform-a-fuzzy-search).|
|$select|string|Comma-separated list of properties to include in the response. For optimal performance, only select the subset of properties needed.| |$skip|int|Skip the first n results, useful for paging. This is not supported when using *$search*.| |$top|int|Number of results to be returned.|
v1.0 Virtualendpoint Post Crosscloudgovernmentorganizationmapping https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/virtualendpoint-post-crosscloudgovernmentorganizationmapping.md
If successful, this method returns a `200 OK` response code and a [cloudPcCrossC
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_cloudpccrosscloudgovernmentorganizationmapping_from_"
X-MS-CloudPC-USGovCloudTenantAADToken: {token}
{} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PHP](#tab/php)
++++ ### Response <!-- {
v1.0 Accesspackage https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/accesspackage.md
To assign a user to an access package, [create an accessPackageAssignmentRequest
| [List accessPackagesIncompatibleWith](../api/accesspackage-list-accesspackagesincompatiblewith.md) | [accessPackage](accesspackage.md) collection | Retrieve a list of the **accesspackage** objects which list this access package as incompatible. | |[filterByCurrentUser](../api/accesspackage-filterbycurrentuser.md)|[accessPackage](../resources/accesspackage.md) collection|Retrieve the list of **accessPackage** objects filtered on the signed-in user.| | [getApplicablePolicyRequirements](../api/accesspackage-getapplicablepolicyrequirements.md) | [accessPackageAssignmentRequestRequirements](../resources/accesspackageassignmentrequestrequirements.md) collection | Retrieve a list of **accessPackageAssignmentRequestRequirement** objects with request requirements. |
+| [moveToCatalog](../api/accesspackage-movetocatalog.md) | None | Move an access package to a different catalog.|
## Properties
v1.0 Admin https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/admin.md
None.
## Relationships |Relationship|Type|Description| |:|:|:|
+| edge | [edge](edge.md) | A container for Microsoft Edge resources. Read-only. |
| reportSettings |[microsoft.graph.adminReportSettings](../resources/adminreportsettings.md)|A container for administrative resources to manage reports.| | serviceAnnouncement | [serviceAnnouncement](serviceannouncement.md) | A container for service communications resources. Read-only. | | sharepoint |[microsoft.graph.tenantAdmin.sharepoint](../resources/tenantadmin-sharepoint.md)|A container for administrative resources to manage tenant-level settings for SharePoint and OneDrive.|
v1.0 Browser Edge Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/browser-edge-api-overview.md
+
+ Title: "Use the Edge API in Microsoft Graph"
+description: "The Edge API in Microsoft Graph lets apps manage administrator tasks for organizations."
+
+ms.localizationpriority: medium
++
+# Use the Edge API in Microsoft Graph
+
+The Edge API in Microsoft Graph lets apps manage administrator tasks for organizations. With proper authorization, an app can get access to an organization's browser site lists for Internet Explorer (IE) mode that reside in the cloud, allowing administrators to manage the same data available in the [Microsoft 365 admin center](https://admin.microsoft.com/). After configuring the appropriate permissions, your app can create browser site lists, add browser sites and shared cookies, and publish the site lists for Microsoft Edge to download.
+
+## Authorization
+
+To call the Edge API in Microsoft Graph, your app needs to acquire an access token. For details about access tokens, see [Get access tokens to call Microsoft Graph](/graph/auth/). Your app also needs the appropriate permissions. For more information, see [Browser management permissions](/graph/permissions-reference#browser-management-permissions).
+
+## Common use cases
+
+The Edge API provides methods and actions that support some administrator's tasks in the Microsoft 365 admin center. The following describes common use cases of the API that manages site lists for IE mode.
+
+| Use cases | REST resources | See also |
+|:-|:|:|
+| Create, read, update, delete, and publish browser site lists | [browserSiteList](../resources/browsersitelist.md) | [Methods of browserSiteList](../resources/browsersitelist.md#methods) |
+| Modify the browser sites on a browser site list | [browserSite](../resources/browsersite.md) | [Methods of browserSite](../resources/browsersite.md#methods) |
+| Modify the browser shared cookies on a browser site list | [browserSharedCookie](../resources/browsersharedcookie.md) | [Methods of browserSharedCookie](../resources/browsersharedcookie.md#methods) |
+
+## What's new
+Find out about the [latest new features and updates](/graph/whats-new-overview) for this API set.
+
+## Next steps
+The Edge API in Microsoft Graph can streamline the way you manage your site lists for IE mode. To learn more:
+
+- Drill down on the methods and properties of the resources most helpful to your scenario.
+- Try the API in the [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer).
+
+Need more ideas? See [how some of our partners are using Microsoft Graph](https://developer.microsoft.com/graph/partners).
v1.0 Browsersharedcookie https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/browsersharedcookie.md
+
+ Title: "browserSharedCookie resource type"
+description: "Represents a session cookie for Internet Explorer mode that resides on a site list."
+
+ms.localizationpriority: medium
++
+# browserSharedCookie resource type
+
+Namespace: microsoft.graph
++
+Represents a session cookie for [Internet Explorer mode](/deployedge/edge-ie-mode) that resides on a [site list](../resources/browsersitelist.md). Microsoft Edge and Internet Explorer processes use [shared session cookies](../resources/browsersharedcookie.md) to allow a streamlined experience when performing tasks such as authentication. For more details, see [Cookie sharing between Microsoft Edge and Internet Explorer](/deployedge/edge-ie-mode-add-guidance-cookieshare).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List browserSharedCookies](../api/browsersitelist-list-sharedcookies.md)|[browserSharedCookie](../resources/browsersharedcookie.md) collection|Get a list of the [browserSharedCookie](../resources/browsersharedcookie.md) objects and their properties.|
+|[Create browserSharedCookie](../api/browsersitelist-post-sharedcookies.md)|[browserSharedCookie](../resources/browsersharedcookie.md)|Create a new [browserSharedCookie](../resources/browsersharedcookie.md) object in a [browserSiteList](../resources/browsersitelist.md).|
+|[Get browserSharedCookie](../api/browsersharedcookie-get.md)|[browserSharedCookie](../resources/browsersharedcookie.md)|Get a [session cookie](../resources/browsersharedcookie.md) that can be shared between a Microsoft Edge process and an Internet Explorer process, while using [Internet Explorer mode](/deployedge/edge-ie-mode).|
+|[Update browserSharedCookie](../api/browsersharedcookie-update.md)|None|Update the properties of a [browserSharedCookie](../resources/browsersharedcookie.md) object.|
+|[Delete browserSharedCookie](../api/browsersitelist-delete-sharedcookies.md)|None|Delete a [browserSharedCookie](../resources/browsersharedcookie.md) from a [browserSiteList](../resources/browsersitelist.md).|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|comment|String|The comment for the shared cookie.|
+|createdDateTime|DateTimeOffset|The date and time when the shared cookie was created.|
+|deletedDateTime|DateTimeOffset|The date and time when the shared cookie was deleted.|
+|displayName|String|The name of the cookie.|
+|history|[browserSharedCookieHistory](../resources/browsersharedcookiehistory.md) collection|The history of modifications applied to the cookie.|
+|hostOnly|Boolean|Controls whether a cookie is a host-only or domain cookie.|
+|hostOrDomain|String|The URL of the cookie.|
+|id|String|The unique identifier for the cookie.|
+|lastModifiedBy|[identitySet](../resources/identityset.md)|The user who last modified the cookie.|
+|lastModifiedDateTime|DateTimeOffset|The date and time when the cookie was last modified.|
+|path|String|The path of the cookie.|
+|sourceEnvironment|browserSharedCookieSourceEnvironment|Specifies how the cookies are shared between Microsoft Edge and Internet Explorer. The possible values are: `microsoftEdge`, `internetExplorer11`, `both`, `unknownFutureValue`.|
+|status|browserSharedCookieStatus|The status of the cookie. The possible values are: `published`, `pendingAdd`, `pendingEdit`, `pendingDelete`, `unknownFutureValue`.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.browserSharedCookie",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.browserSharedCookie",
+ "comment": "String",
+ "createdDateTime": "String (timestamp)",
+ "deletedDateTime": "String (timestamp)",
+ "displayName": "String",
+ "history": [
+ {
+ "@odata.type": "microsoft.graph.browserSharedCookieHistory"
+ }
+ ],
+ "hostOnly": "Boolean",
+ "hostOrDomain": "String",
+ "id": "String (identifier)",
+ "lastModifiedBy": {
+ "@odata.type": "microsoft.graph.identitySet"
+ },
+ "lastModifiedDateTime": "String (timestamp)",
+ "path": "String",
+ "sourceEnvironment": "String",
+ "status": "String"
+}
+```
+
v1.0 Browsersharedcookiehistory https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/browsersharedcookiehistory.md
+
+ Title: "browserSharedCookieHistory resource type"
+description: "Represents the history of modifications applied to a browserSharedCookie."
+
+ms.localizationpriority: medium
++
+# browserSharedCookieHistory resource type
+
+Namespace: microsoft.graph
++
+Represents the history of modifications applied to a [browserSharedCookie](../resources/browsersharedcookie.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|comment|String|The comment for the shared cookie.|
+|displayName|String|The name of the cookie.|
+|hostOnly|Boolean|Controls whether a cookie is a host-only or domain cookie.|
+|hostOrDomain|String|The URL of the cookie.|
+|lastModifiedBy|[identitySet](../resources/identityset.md)|The user who last modified the cookie.|
+|path|String|The path of the cookie.|
+|publishedDateTime|DateTimeOffset|The date and time when the cookie was last published.|
+|sourceEnvironment|browserSharedCookieSourceEnvironment|Specifies how the cookies are shared between Microsoft Edge and Internet Explorer. The possible values are: `microsoftEdge`, `internetExplorer11`, `both`, `unknownFutureValue`.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.browserSharedCookieHistory"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.browserSharedCookieHistory",
+ "comment": "String",
+ "displayName": "String",
+ "hostOnly": "Boolean",
+ "hostOrDomain": "String",
+ "lastModifiedBy": {
+ "@odata.type": "microsoft.graph.identitySet"
+ },
+ "path": "String",
+ "publishedDateTime": "String (timestamp)",
+ "sourceEnvironment": "String"
+}
+```
+
v1.0 Browsersite https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/browsersite.md
+
+ Title: "browserSite resource type"
+description: "Represents a site to use in Internet Explorer mode that resides on a site list."
+
+ms.localizationpriority: medium
++
+# browserSite resource type
+
+Namespace: microsoft.graph
++
+Represents a site to use in [Internet Explorer mode](/deployedge/edge-ie-mode) that resides on a [site list](../resources/browsersitelist.md).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List browserSites](../api/browsersitelist-list-sites.md)|[browserSite](../resources/browsersite.md) collection|Get a list of the [browserSite](../resources/browsersite.md) objects and their properties.|
+|[Create browserSite](../api/browsersitelist-post-sites.md)|[browserSite](../resources/browsersite.md)|Create a new [browserSite](../resources/browsersite.md) object in a [browserSiteList](../resources/browsersitelist.md).|
+|[Get browserSite](../api/browsersite-get.md)|[browserSite](../resources/browsersite.md)|Get a [browserSite](../resources/browsersite.md) that resides on a [browserSiteList](../resources/browsersitelist.md).|
+|[Update browserSite](../api/browsersite-update.md)|None|Update the properties of a [browserSite](../resources/browsersite.md) object.|
+|[Delete browserSite](../api/browsersitelist-delete-sites.md)|None|Delete a [browserSite](../resources/browsersite.md) from a [browserSiteList](../resources/browsersitelist.md).|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|allowRedirect|Boolean|Controls the behavior of redirected sites. If `true`, indicates that the site will open in Internet Explorer 11 or Microsoft Edge even if the site is navigated to as part of a HTTP or meta refresh redirection chain.|
+|comment|String|The comment for the site.|
+|compatibilityMode|browserSiteCompatibilityMode|Controls what compatibility setting is used for specific sites or domains. The possible values are: `default`, `internetExplorer8Enterprise`, `internetExplorer7Enterprise`, `internetExplorer11`, `internetExplorer10`, `internetExplorer9`, `internetExplorer8`, `internetExplorer7`, `internetExplorer5`, `unknownFutureValue`.|
+|createdDateTime|DateTimeOffset|The date and time when the site was created.|
+|deletedDateTime|DateTimeOffset|The date and time when the site was deleted.|
+|history|[browserSiteHistory](../resources/browsersitehistory.md) collection|The history of modifications applied to the site.|
+|id|String|The unique identifier for the site.|
+|lastModifiedBy|[identitySet](../resources/identityset.md)|The user who last modified the site.|
+|lastModifiedDateTime|DateTimeOffset|The date and time when the site was last modified.|
+|mergeType|browserSiteMergeType|The merge type of the site. The possible values are: `noMerge`, `default`, `unknownFutureValue`.|
+|status|browserSiteStatus|Indicates the status of the site. The possible values are: `published`, `pendingAdd`, `pendingEdit`, `pendingDelete`, `unknownFutureValue`.|
+|targetEnvironment|browserSiteTargetEnvironment|The target environment that the site should open in. The possible values are: `internetExplorerMode`, `internetExplorer11`, `microsoftEdge`, `configurable`, `none`, `unknownFutureValue`.<br /><br />Prior to June 15, 2022, the `internetExplorer11` option would allow opening a site in the Internet Explorer 11 (IE11) desktop application. Following the retirement of IE11 on June 15, 2022, the `internetExplorer11` option will no longer open an IE11 window and will instead behave the same as the `internetExplorerMode` option.|
+|webUrl|String|The URL of the site.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.browserSite",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.browserSite",
+ "allowRedirect": "Boolean",
+ "comment": "String",
+ "compatibilityMode": "String",
+ "createdDateTime": "String (timestamp)",
+ "deletedDateTime": "String (timestamp)",
+ "history": [
+ {
+ "@odata.type": "microsoft.graph.browserSiteHistory"
+ }
+ ],
+ "id": "String (identifier)",
+ "lastModifiedBy": {
+ "@odata.type": "microsoft.graph.identitySet"
+ },
+ "lastModifiedDateTime": "String (timestamp)",
+ "mergeType": "String",
+ "status": "String",
+ "targetEnvironment": "String",
+ "webUrl": "String"
+}
+```
+
+## See also
+
+- [Internet Explorer mode (IE mode)](https://www.microsoft.com/edge/business/ie-mode)
+- [What is Internet Explorer (IE) mode?](/deployedge/edge-ie-mode)
+- [Cloud Site List Management for Internet Explorer (IE) mode](/deployedge/edge-ie-mode-cloud-site-list-mgmt)
v1.0 Browsersitehistory https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/browsersitehistory.md
+
+ Title: "browserSiteHistory resource type"
+description: "Represents the history of modifications applied to a browserSite."
+
+ms.localizationpriority: medium
++
+# browserSiteHistory resource type
+
+Namespace: microsoft.graph
++
+The history of modifications applied to a [browserSite](../resources/browsersite.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|allowRedirect|Boolean|Controls the behavior of redirected sites. If `true`, indicates that the site will open in Internet Explorer 11 or Microsoft Edge even if the site is navigated to as part of a HTTP or meta refresh redirection chain.|
+|comment|String|The comment for the site.|
+|compatibilityMode|browserSiteCompatibilityMode|Controls what compatibility setting is used for specific sites or domains. The possible values are: `default`, `internetExplorer8Enterprise`, `internetExplorer7Enterprise`, `internetExplorer11`, `internetExplorer10`, `internetExplorer9`, `internetExplorer8`, `internetExplorer7`, `internetExplorer5`, `unknownFutureValue`.|
+|lastModifiedBy|[identitySet](../resources/identityset.md)|The user who last modified the site.|
+|mergeType|browserSiteMergeType|The merge type of the site. The possible values are: `noMerge`, `default`, `unknownFutureValue`.|
+|publishedDateTime|DateTimeOffset|The date and time when the site was last published.|
+|targetEnvironment|browserSiteTargetEnvironment|The target environment that the site should open in. The possible values are: `internetExplorerMode`, `internetExplorer11`, `microsoftEdge`, `configurable`, `none`, `unknownFutureValue`.<br /><br />Prior to June 15, 2022, the `internetExplorer11` option would allow opening a site in the Internet Explorer 11 (IE11) desktop application. Following the retirement of IE11 on June 15, 2022, the `internetExplorer11` option will no longer open an IE11 window and will instead behave the same as the `internetExplorerMode` option.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.browserSiteHistory"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.browserSiteHistory",
+ "allowRedirect": "Boolean",
+ "comment": "String",
+ "compatibilityMode": "String",
+ "lastModifiedBy": {
+ "@odata.type": "microsoft.graph.identitySet"
+ },
+ "mergeType": "String",
+ "publishedDateTime": "String (timestamp)",
+ "targetEnvironment": "String"
+}
+```
+
v1.0 Browsersitelist https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/browsersitelist.md
+
+ Title: "browserSiteList resource type"
+description: "Represents an enterprise site list in a compliant cloud location that specifies sites to be opened in Internet Explorer mode."
+
+ms.localizationpriority: medium
++
+# browserSiteList resource type
+
+Namespace: microsoft.graph
++
+Represents an enterprise site list in a compliant cloud location that specifies sites to be opened in [Internet Explorer mode](/deployedge/edge-ie-mode). The site list contains one or more [browserSite](../resources/browsersite.md) and [browserSharedCookie](../resources/browsersharedcookie.md) resources.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List browserSiteLists](../api/internetexplorermode-list-sitelists.md)|[browserSiteList](../resources/browsersitelist.md) collection|Get a list of the [browserSiteList](../resources/browsersitelist.md) objects and their properties.|
+|[Create browserSiteList](../api/internetexplorermode-post-sitelists.md)|[browserSiteList](../resources/browsersitelist.md)|Create a new [browserSiteList](../resources/browsersitelist.md) object to support [Internet Explorer mode](/deployedge/edge-ie-mode).|
+|[Get browserSiteList](../api/browsersitelist-get.md)|[browserSiteList](../resources/browsersitelist.md)|Get a [browserSiteList](../resources/browsersitelist.md) that contains [browserSite](../resources/browsersite.md) and [browserSharedCookie](../resources/browsersharedcookie.md) resources.|
+|[Update browserSiteList](../api/browsersitelist-update.md)|None|Update the properties of a [browserSiteList](../resources/browsersitelist.md) object.|
+|[Delete browserSiteList](../api/internetexplorermode-delete-sitelists.md)|None|Delete a [browserSiteList](../resources/browsersitelist.md) object.|
+|[Publish a browserSiteList](../api/browsersitelist-publish.md)|[browserSiteList](../resources/browsersitelist.md)|Publish the specified [browserSiteList](../resources/browsersitelist.md) for devices to download.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|description|String|The description of the site list.|
+|displayName|String|The name of the site list.|
+|id|String|The unique identifier for the site list.|
+|lastModifiedBy|[identitySet](../resources/identityset.md)|The user who last modified the site list.|
+|lastModifiedDateTime|DateTimeOffset|The date and time when the site list was last modified.|
+|publishedBy|[identitySet](../resources/identityset.md)|The user who published the site list.|
+|publishedDateTime|DateTimeOffset|The date and time when the site list was published.|
+|revision|String|The current revision of the site list.|
+|status|browserSiteListStatus|The current status of the site list. The possible values are: `draft`, `published`, `pending`, `unknownFutureValue`.|
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|sharedCookies|[browserSharedCookie](../resources/browsersharedcookie.md) collection|A collection of shared cookies defined for the site list.|
+|sites|[browserSite](../resources/browsersite.md) collection|A collection of sites defined for the site list.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.browserSiteList",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.browserSiteList",
+ "description": "String",
+ "displayName": "String",
+ "id": "String (identifier)",
+ "lastModifiedBy": {
+ "@odata.type": "microsoft.graph.identitySet"
+ },
+ "lastModifiedDateTime": "String (timestamp)",
+ "publishedBy": {
+ "@odata.type": "microsoft.graph.identitySet"
+ },
+ "publishedDateTime": "String (timestamp)",
+ "revision": "String",
+ "status": "String"
+}
+```
+
+## See also
+
+- [Internet Explorer mode (IE mode)](https://www.microsoft.com/edge/business/ie-mode)
+- [What is Internet Explorer (IE) mode?](/deployedge/edge-ie-mode)
+- [Cloud Site List Management for Internet Explorer (IE) mode](/deployedge/edge-ie-mode-cloud-site-list-mgmt)
v1.0 Collapseproperty https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/collapseproperty.md
+
+ Title: "collapseProperty resource type"
+description: "Specifies the collapse criteria of search results."
+ms.localizationpriority: medium
+++
+# collapseProperty resource type
+
+Namespace: microsoft.graph
++
+Specifies the criteria used for collapsing search results. Applies only to sortable/refinable properties.
+
+## Properties
+
+| Property | Type | Description |
+|:-|:|:|
+|fields|String Collection| Defines the collapse group to trim results. The properties in this collection must be sortable/refinable properties. Required.|
+|limit|Int16| Defines a maximum limit count for this field. This numeric value must be a positive integer. Required.|
+
+## JSON representation
+
+The following is a JSON representation of the resource.
+
+<!-- {
+ "blockType": "resource",
+ "optionalProperties": [
+
+ ],
+ "@odata.type": "microsoft.graph.collapseProperty",
+ "baseType": null
+}-->
+
+```json
+{
+ "fields": ["String"],
+ "limit": 1024
+}
+```
+
+<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
+2019-02-04 14:57:30 UTC -->
+<!-- {
+ "type": "#page.annotation",
+ "description": "collapseProperty resource",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": ""
+}-->
v1.0 Conditionalaccessapplications https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/conditionalaccessapplications.md
Represents the applications and user actions included in and excluded from the c
|:-- |:- |:-- | | includeApplications | String collection | Can be one of the following: <li> The list of client IDs (**appId**) the policy applies to, unless explicitly excluded (in **excludeApplications**) <li> `All` <li> `Office365` - For the list of apps included in `Office365`, see [Conditional Access target apps: Office 365](/azure/active-directory/conditional-access/concept-conditional-access-cloud-apps) | | excludeApplications | String collection | Can be one of the following: <li> The list of client IDs (**appId**) explicitly excluded from the policy.<li> `Office365` - For the list of apps included in `Office365`, see [Conditional Access target apps: Office 365](/azure/active-directory/conditional-access/concept-conditional-access-cloud-apps) |
+| applicationFilter | [conditionalAccessFilter](conditionalaccessfilter.md) | Filter that defines the dynamic-application-syntax rule to include/exclude cloud applications. A filter can use custom security attributes to include/exclude applications. |
| includeUserActions | String collection | User actions to include. Supported values are `urn:user:registersecurityinfo` and `urn:user:registerdevice` | | includeAuthenticationContextClassReferences | String collection | Authentication context class references include. Supported values are `c1` through `c25`. |
The following is a JSON representation of the resource.
"optionalProperties": [ "includeApplications", "excludeApplications",
+ "applicationFilter",
"includeUserActions" ], "@odata.type": "microsoft.graph.conditionalAccessApplications"
The following is a JSON representation of the resource.
{ "includeApplications": ["String"], "excludeApplications": ["String"],
+ "applicationFilter": {"@odata.type": "microsoft.graph.conditionalAccessFilter"},
"includeUserActions": ["String"] } ```
v1.0 Conditionalaccessclientapplications https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/conditionalaccessclientapplications.md
Represents client applications (service principals and workload identities) incl
|:|:|:| |excludeServicePrincipals|String collection|Service principal IDs excluded from the policy scope.| |includeServicePrincipals|String collection|Service principal IDs included in the policy scope, or `ServicePrincipalsInMyTenant`. |
+|servicePrincipalFilter | [conditionalAccessFilter](conditionalaccessfilter.md) | Filter that defines the dynamic-servicePrincipal-syntax rule to include/exclude service principals. A filter can use custom security attributes to include/exclude service principals. |
## Relationships None.
The following is a JSON representation of the resource.
], "excludeServicePrincipals": [ "String"
- ]
+ ],
+ "servicePrincipalFilter": {"@odata.type": "microsoft.graph.conditionalAccessFilter"},
} ```
v1.0 Edge https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/edge.md
+
+ Title: "edge resource type"
+description: "Represents an entity that acts as a container for Microsoft Edge functionalities."
+
+ms.localizationpriority: medium
++
+# edge resource type
+
+Namespace: microsoft.graph
++
+Represents an entity that acts as a container for Microsoft Edge functionalities.
++
+## Properties
+
+None.
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|internetExplorerMode|[internetExplorerMode](../resources/internetexplorermode.md)|A container for [Internet Explorer mode](/deployedge/edge-ie-mode) resources.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.edge",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.edge"
+}
+```
+
v1.0 Educationassignment https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/educationassignment.md
When an **assignment** is created, it is in a Draft state. Students can't see th
The **assignment** APIs are exposed in the class namespace.
+Inherits from [entity](../resources/entity.md).
+ ## Methods | Method | Return Type |Description|
The **assignment** APIs are exposed in the class namespace.
## Properties | Property | Type |Description| |:|:--|:-|
-|id|String| Read-only.|
|addedStudentAction|String|Optional field to control the **assignment** behavior for students who are added after the **assignment** is published. If not specified, defaults to `none` value. Currently supports only two values: `none` or `assignIfOpen`.| |addToCalendarAction| educationAddToCalendarOptions|Optional field to control the **assignment** behavior for adding **assignments** to students' and teachers' calendars when the **assignment** is published. The possible values are: `none`, `studentsAndPublisher`, `studentsAndTeamOwners`, `unknownFutureValue`, and `studentsOnly`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value(s) in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `studentsOnly`. The default value is `none`.| |allowLateSubmissions|Boolean| Identifies whether students can submit after the due date. If this property is not specified during create, it defaults to true. |
The **assignment** APIs are exposed in the class namespace.
|dueDateTime|DateTimeOffset|Date when the students **assignment** is due. 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`| |feedbackResourcesFolderUrl|String|Folder URL where all the feedback file resources for this **assignment** are stored.| |grading|[educationAssignmentGradeType](educationassignmentgradetype.md)|How the **assignment** will be graded. |
+|id|String| The unique identifier for the **assignment**. Inherited from [entity](../resources/entity.md). Read-only.|
|instructions|[itemBody](itembody.md)| Instructions for the **assignment**. This along with the display name tell the student what to do. | |lastModifiedBy|[identitySet](identityset.md)| Who last modified the **assignment**. | |lastModifiedDateTime|DateTimeOffset|Moment when the **assignment** was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`|
The following is a JSON representation of the resource.
```json {
- "id": "String (identifier)",
- "addedStudentAction": "none",
- "addToCalendarAction": "string",
- "allowLateSubmissions": true,
- "allowStudentsToAddResourcesToSubmission": true,
+ "addedStudentAction": "String",
+ "addToCalendarAction": "String",
+ "allowLateSubmissions": "Boolean",
+ "allowStudentsToAddResourcesToSubmission": "Boolean",
"assignDateTime": "String (timestamp)", "assignTo": {"@odata.type": "microsoft.graph.educationAssignmentRecipient"}, "assignedDateTime": "String (timestamp)",
The following is a JSON representation of the resource.
"createdDateTime": "String (timestamp)", "displayName": "String", "dueDateTime": "String (timestamp)",
+ "feedbackResourcesFolderUrl": "String",
"grading": {"@odata.type": "microsoft.graph.educationAssignmentGradeType"},
+ "id": "String (identifier)",
"instructions": {"@odata.type": "microsoft.graph.itemBody"}, "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"}, "lastModifiedDateTime": "String (timestamp)",
- "notificationChannelUrl": "string",
- "status": "string",
- "webUrl": "string",
- "resourcesFolderUrl": "string"
+ "notificationChannelUrl": "String",
+ "status": "String",
+ "webUrl": "String",
+ "resourcesFolderUrl": "String"
} ```
v1.0 Educationfeedbackresourceoutcome https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/educationfeedbackresourceoutcome.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Represents feedback on an [educationOutcome](educationoutcome.md) object in the form of a document.
+Represents feedback on an [educationOutcome](../resources/educationoutcome.md) object in the form of a document.
+
+Inherits from [educationOutcome](../resources/educationoutcome.md).
## Methods | Method | Return Type | Description | |:-|:|:|
-| [Create educationFeedbackResourceOutcome](../api/educationfeedbackresourceoutcome-post-outcomes.md) | [educationOutcome](educationoutcome.md) | Create a new [feedback resource](../resources/educationfeedbackresourceoutcome.md) for a submission. |
+| [Create educationFeedbackResourceOutcome](../api/educationfeedbackresourceoutcome-post-outcomes.md) | [educationOutcome](../resources/educationoutcome.md) | Create a new [feedback resource](../resources/educationfeedbackresourceoutcome.md) for a submission. |
| [Delete educationFeedbackResourceOutcome](../api/educationfeedbackresourceoutcome-delete.md) | None | Delete a [feedback resource](../resources/educationfeedbackresourceoutcome.md) from a submission. | ## Properties | Property | Type | Description | |:-|:|:|
-|feedbackResource|[educationResource](educationresource.md)|The actual feedback resource.|
-|id|String|Unique identifier for the **educationFeedbackResourceOutcome**.|
-|resourceStatus|educationFeedbackResourceOutcomeStatus|The status of the feedback resource. The possible values are: `notPublished`, `pendingPublish`, `published`, `failedPublish`, and `unknownFutureValue`.|
+|feedbackResource|[educationResource](../resources/educationresource.md)|The actual feedback resource.|
+|id|String|Unique identifier for the **educationFeedbackResourceOutcome**. Inherited from [entity](../resources/entity.md).|
+|lastModifiedBy|[identitySet](../resources/identityset.md)|The individual who updated the resource. Inherited from [educationOutcome](../resources/educationoutcome.md).|
+|lastModifiedDateTime|DateTimeOffset|The moment in time when the resource was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2021 is `2021-01-01T00:00:00Z`. Inherited from [educationOutcome](../resources/educationoutcome.md).|
+|resourceStatus|educationFeedbackResourceOutcomeStatus|The status of the feedback resource. The possible values are: `notPublished`, `pendingPublish`, `published`, `failedPublish`, `unknownFutureValue`.|
## Relationships
The following is a JSON representation of the resource.
{ "feedbackResource": {"@odata.type": "microsoft.graph.educationResource"}, "id": "String (identifier)",
+ "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
+ "lastModifiedDateTime": "String (timestamp)",
"resourceStatus": {"@odata.type": "microsoft.graph.educationFeedbackResourceOutcomeStatus"} } ```
v1.0 Educationoutcome https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/educationoutcome.md
Title: "educationOutcome resource type"
-description: "The result of grading an assignment"
+description: "Represents a base class for the result of grading an assignment."
ms.localizationpriority: medium ms.prod: "education"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-The result of grading an assignment. This is a base class; the derived types are [educationFeedbackOutcome](educationfeedbackoutcome.md), [educationPointsOutcome](educationpointsoutcome.md), [educationRubricOutcome](educationrubricoutcome.md), and [educationFeedbackResourceOutcome](educationfeedbackresourceoutcome.md).
+Represents a base class for the result of grading an assignment. The derived types are [educationFeedbackOutcome](educationfeedbackoutcome.md), [educationPointsOutcome](educationpointsoutcome.md), [educationRubricOutcome](educationrubricoutcome.md), and [educationFeedbackResourceOutcome](educationfeedbackresourceoutcome.md).
+
+Inherits from [entity](../resources/entity.md).
## Methods | Method | Return Type | Description | |:-|:|:|
-| [Update educationOutcome](../api/educationoutcome-update.md) | [educationOutcome](educationoutcome.md) | Update educationOutcome object. |
+| [Update educationOutcome](../api/educationoutcome-update.md) | [educationOutcome](educationoutcome.md) | Update the **educationOutcome** object. |
## Properties | Property | Type |Description| |:|:--|:-|
-|id|String|Read-only.|
+|id|String|Unique identifier for the **educationOutcome** object. Inherited from [entity](../resources/entity.md). Read-only.|
|lastModifiedBy|[identitySet](identityset.md)|The individual who updated the resource.|
-|lastModifiedDateTime|DateTimeOffset|Moment in time when the resource was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2021 is `2021-01-01T00:00:00Z`.|
+|lastModifiedDateTime|DateTimeOffset|The moment in time when the resource was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2021 is `2021-01-01T00:00:00Z`.|
## Relationships
v1.0 Educationsubmission https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/educationsubmission.md
If [setUpResourcesFolder](../api/educationsubmission-setupResourcesFolder.md) ha
|unsubmittedDateTime|DateTimeOffset|Moment in time when the submission was moved from submitted into the working state. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`| |reassignedBy|[identitySet](identityset.md)|User who moved the status of this submission to reassigned.| |reassignedDateTime|DateTimeOffset|Moment in time when the submission was reassigned. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`|
+|webUrl|String| The deep link URL for the given **submission**.|
## Relationships | Relationship | Type |Description|
The following is a JSON representation of the resource.
```json {
- "id":"String (identifier)",
- "recipient":{"@odata.type":"microsoft.graph.educationSubmissionRecipient"},
- "returnedBy":{"@odata.type":"microsoft.graph.identitySet"},
- "returnedDateTime":"String (timestamp)",
- "resourcesFolderUrl":"String",
- "status":"string",
- "submittedBy":{"@odata.type":"microsoft.graph.identitySet"},
- "submittedDateTime":"String (timestamp)",
- "unsubmittedBy":{"@odata.type":"microsoft.graph.identitySet"},
- "unsubmittedDateTime":"String (timestamp)",
- "reassignedBy":{"@odata.type":"microsoft.graph.identitySet"},
- "reassignedDateTime":"String (timestamp)"
+ "id": "String (identifier)",
+ "reassignedBy": {"@odata.type":"microsoft.graph.identitySet"},
+ "reassignedDateTime": "String (timestamp)",
+ "recipient": {"@odata.type":"microsoft.graph.educationSubmissionRecipient"},
+ "resourcesFolderUrl": "String",
+ "returnedBy": {"@odata.type":"microsoft.graph.identitySet"},
+ "returnedDateTime": "String (timestamp)",
+ "status": "String",
+ "submittedBy": {"@odata.type":"microsoft.graph.identitySet"},
+ "submittedDateTime": "String (timestamp)",
+ "unsubmittedBy": {"@odata.type":"microsoft.graph.identitySet"},
+ "unsubmittedDateTime": "String (timestamp)",
+ "webUrl": "String"
} ```
v1.0 Entitlementmanagement Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/entitlementmanagement-overview.md
The following table lists the methods that you can use to interact with entitlem
| [Add group to incompatibleGroups](../api/accesspackage-post-incompatiblegroup.md) | None | Add a link to indicate membership of a **group** is incompatible with a specified access package. | | [Remove group from incompatibleGroups](../api/accesspackage-delete-incompatiblegroup.md) | None | Remove a link that indicated a **group** membership was incompatible.| | [List accessPackagesIncompatibleWith](../api/accesspackage-list-accesspackagesincompatiblewith.md) | [accessPackage](accesspackage.md) collection | Retrieve a list of the **accesspackage** objects which list this access package as incompatible. |
+| [moveToCatalog](../api/accesspackage-movetocatalog.md) | None | Move an access package to a different catalog.|
| [List accessPackageAssignmentPolicies](../api/entitlementmanagement-list-accesspackageassignmentpolicies.md) | [accessPackageAssignmentPolicy](accesspackageassignmentpolicy.md) collection | Retrieve a list of **accessPackageAssignmentPolicy** objects. | | [Create accessPackageAssignmentPolicy](../api/entitlementmanagement-post-accesspackageassignmentpolicies.md) | [accessPackageAssignmentPolicy](accesspackageassignmentpolicy.md)| Create a new **accessPackageAssignmentPolicy** object. | | [Get accessPackageAssignmentPolicy](../api/accesspackageassignmentpolicy-get.md) | [accessPackageAssignmentPolicy](accesspackageassignmentpolicy.md) | Read properties and relationships of an **accessPackageAssignmentPolicy** object. |
v1.0 Enums Managedtenants https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/enums-managedtenants.md
Title: "Multi-tenant management enumeration values"
description: "Microsoft Graph multi-tenant management enumeration values" ms.localizationpriority: medium doc_type: enumTypes
v1.0 Enums https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/enums.md
Namespace: microsoft.graph
|unknownFutureValue| ### educationAddToCalendarOptions values+ |Member| |:| |none|
Namespace: microsoft.graph
|studentsOnly| ### educationAssignmentStatus values+ |Member| |:| |draft|
Namespace: microsoft.graph
|unknownFutureValue| ### educationSubmissionStatus values+ |Member| |:| |working|
Namespace: microsoft.graph
|reassigned| ### educationFeedbackResourceOutcomeStatus values+ |Member| |:| |notPublished|
Possible values for user account types (group membership), per Windows definitio
|unknownFutureValue|
+### browserSharedCookieSourceEnvironment values
+
+| Member|
+|:--|
+|microsoftEdge|
+|internetExplorer11|
+|both|
+|unknownFutureValue|
+
+### browserSiteCompatibilityMode values
+
+| Member|
+|:--|
+|default|
+|internetExplorer8Enterprise|
+|internetExplorer7Enterprise|
+|internetExplorer11|
+|internetExplorer10|
+|internetExplorer9|
+|internetExplorer8|
+|internetExplorer7|
+|internetExplorer5|
+|unknownFutureValue|
+
+### browserSiteMergeType values
+
+| Member|
+|:--|
+|noMerge|
+|default|
+|unknownFutureValue|
+
+### browserSiteTargetEnvironment values
+
+| Member|
+|:--|
+|internetExplorerMode|
+|internetExplorer11|
+|microsoftEdge|
+|configurable|
+|none|
+|unknownFutureValue|
+
+### browserSiteStatus values
+
+| Member|
+|:--|
+|published|
+|pendingAdd|
+|pendingEdit|
+|pendingDelete|
+|unknownFutureValue|
+
+### browserSharedCookieStatus values
+
+| Member|
+|:--|
+|published|
+|pendingAdd|
+|pendingEdit|
+|pendingDelete|
+|unknownFutureValue|
+
+### browserSiteListStatus values
+
+| Member|
+|:--|
+|draft|
+|published|
+|pending|
+|unknownFutureValue|
+ ### authenticationStrengthPolicyType values |Member|
Possible values for user account types (group membership), per Windows definitio
|sharedContent| |unknownFutureValue| +
v1.0 Group https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/group.md
This resource supports:
| [List deleted groups](../api/directory-deleteditems-list.md) | [directoryObject](directoryobject.md) collection | Retrieve the groups deleted in the tenant in the last 30 days. | | [List deleted groups owned by user](../api/directory-deleteditems-getuserownedobjects.md) | [directoryObject](directoryobject.md) collection | Retrieve the groups deleted in the tenant in the last 30 days and that are owned by a user. | | [Get deleted group](../api/directory-deleteditems-get.md) | [directoryObject](directoryobject.md) collection | Retrieve a deleted group by ID. |
-| [Restore deleted group](../api/directory-deleteditems-delete.md) | [directoryObject](directoryobject.md) collection | Restore a group deleted in the tenant in the last 30 days. |
-| [Permanently delete group](../api/directory-deleteditems-restore.md) | [directoryObject](directoryobject.md) collection | Permanently delete a deleted group from the tenant. |
+| [Restore deleted group](../api/directory-deleteditems-restore.md) | [directoryObject](directoryobject.md) collection | Restore a group deleted in the tenant in the last 30 days. |
+| [Permanently delete group](../api/directory-deleteditems-delete.md) | [directoryObject](directoryobject.md) collection | Permanently delete a deleted group from the tenant. |
| [checkMemberGroups](../api/directoryobject-checkmembergroups.md) | String collection | Check for membership in a list of groups. The function is transitive. | | [getMemberGroups](../api/directoryobject-getmembergroups.md) | String collection | Return all the groups that the group is a member of. The function is transitive. | | [checkMemberObjects](../api/directoryobject-checkmemberobjects.md) | String collection | Check for membership in a list of group, directory role, or administrative unit objects. The function is transitive. |
v1.0 Internetexplorermode https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/internetexplorermode.md
+
+ Title: "internetExplorerMode resource type"
+description: "Represents a container for Internet Explorer mode resources."
+
+ms.localizationpriority: medium
++
+# internetExplorerMode resource type
+
+Namespace: microsoft.graph
++
+Represents a container for [Internet Explorer mode](/deployedge/edge-ie-mode) resources.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List browserSiteLists](../api/internetexplorermode-list-sitelists.md)|[browserSiteList](../resources/browsersitelist.md) collection|Get a list of the [browserSiteList](../resources/browsersitelist.md) objects and their properties.|
+|[Create browserSiteList](../api/internetexplorermode-post-sitelists.md)|[browserSiteList](../resources/browsersitelist.md)|Create a new [browserSiteList](../resources/browsersitelist.md) object to support [Internet Explorer mode](/deployedge/edge-ie-mode).|
+|[Delete browserSiteList](../api/internetexplorermode-delete-sitelists.md)|None|Delete a [browserSiteList](../resources/browsersitelist.md) object.|
+
+## Properties
+
+None.
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|siteLists|[browserSiteList](../resources/browsersitelist.md) collection|A collection of site lists to support Internet Explorer mode.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.internetExplorerMode",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.internetExplorerMode"
+}
+```
+
v1.0 Intune Apps Ioslobapp https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-apps-ioslobapp.md
Inherits from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)
|expirationDateTime|DateTimeOffset|The expiration time.| |versionNumber|String|The version number of iOS Line of Business (LoB) app.| |buildNumber|String|The build number of iOS Line of Business (LoB) app.|
-|identityVersion|String|The identity version.|
+|identityVersion|String|The identity version. This property is being deprecated in 2211(November 2022)|
## Relationships |Relationship|Type|Description|
v1.0 Intune Apps Macoslobapp https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-apps-macoslobapp.md
Title: "macOSLobApp resource type"
-description: "Contains properties and inherited properties for the MacOS LOB App."
+description: "Contains properties and inherited properties for the macOS LOB App."
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Contains properties and inherited properties for the MacOS LOB App.
+Contains properties and inherited properties for the macOS LOB App.
Inherits from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)
Inherits from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)
|committedContentVersion|String|The internal committed content version. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |fileName|String|The name of the main Lob application file. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |size|Int64|The total size, including all uploaded files. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)|
-|bundleId|String|The bundle id.|
-|minimumSupportedOperatingSystem|[macOSMinimumOperatingSystem](../resources/intune-apps-macosminimumoperatingsystem.md)|The value for the minimum applicable operating system.|
-|buildNumber|String|The build number of MacOS Line of Business (LoB) app.|
-|versionNumber|String|The version number of MacOS Line of Business (LoB) app.|
-|childApps|[macOSLobChildApp](../resources/intune-apps-macoslobchildapp.md) collection|The app list in this bundle package|
-|identityVersion|String|The identity version.|
-|md5HashChunkSize|Int32|The chunk size for MD5 hash|
-|md5Hash|String collection|The MD5 hash codes|
-|ignoreVersionDetection|Boolean|A boolean to control whether the app's version will be used to detect the app after it is installed on a device. Set this to true for macOS Line of Business (LoB) apps that use a self update feature.|
-|installAsManaged|Boolean|A boolean to control whether the app will be installed as managed (requires macOS 11.0 and other PKG restrictions).|
+|bundleId|String|The primary bundleId of the package.|
+|minimumSupportedOperatingSystem|[macOSMinimumOperatingSystem](../resources/intune-apps-macosminimumoperatingsystem.md)|ComplexType macOSMinimumOperatingSystem that indicates the minimum operating system applicable for the application.|
+|buildNumber|String|The build number of the package. This should match the package CFBundleShortVersionString of the .pkg file.|
+|versionNumber|String|The version number of the package. This should match the package CFBundleVersion in the packageinfo file.|
+|childApps|[macOSLobChildApp](../resources/intune-apps-macoslobchildapp.md) collection|List of ComplexType macOSLobChildApp objects. Represents the apps expected to be installed by the package.|
+|identityVersion|String|The identity version. This property is being deprecated in 2211(November 2022).|
+|md5HashChunkSize|Int32|The chunk size for MD5 hash. This is '0' or empty if the package was uploaded directly. If the Intune App Wrapping Tool is used to create a .intunemac, this value can be found inside the Detection.xml file.|
+|md5Hash|String collection|The MD5 hash codes. This is empty if the package was uploaded directly. If the Intune App Wrapping Tool is used to create a .intunemac, this value can be found inside the Detection.xml file.|
+|ignoreVersionDetection|Boolean|When TRUE, indicates that the app's version will NOT be used to detect if the app is installed on a device. When FALSE, indicates that the app's version will be used to detect if the app is installed on a device. Set this to true for apps that use a self update feature.|
+|installAsManaged|Boolean|When TRUE, indicates that the app will be installed as managed (requires macOS 11.0 and other managed package restrictions). When FALSE, indicates that the app will be installed as unmanaged.|
## Relationships |Relationship|Type|Description|
v1.0 Intune Apps Macoslobappassignmentsettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-apps-macoslobappassignmentsettings.md
+
+ Title: "macOsLobAppAssignmentSettings resource type"
+description: "Contains properties used to assign a macOS LOB app to a group."
+
+localization_priority: Normal
++
+# macOsLobAppAssignmentSettings resource type
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Contains properties used to assign a macOS LOB app to a group.
++
+Inherits from [mobileAppAssignmentSettings](../resources/intune-shared-mobileappassignmentsettings.md)
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|uninstallOnDeviceRemoval|Boolean|When TRUE, indicates that the app should be uninstalled when the device is removed from Intune. When FALSE, indicates that the app will not be uninstalled when the device is removed from Intune.|
+
+## Relationships
+None
+
+## JSON Representation
+Here is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.macOsLobAppAssignmentSettings"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.macOsLobAppAssignmentSettings",
+ "uninstallOnDeviceRemoval": true
+}
+```
+++++
v1.0 Intune Apps Macoslobchildapp https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-apps-macoslobchildapp.md
Title: "macOSLobChildApp resource type"
-description: "Contains properties the MacOS LOB App in a bundle package"
+description: "Contains properties of a macOS .app in the package"
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Contains properties the MacOS LOB App in a bundle package
+Contains properties of a macOS .app in the package
## Properties |Property|Type|Description| |:|:|:|
-|bundleId|String|The Identity Name.|
-|buildNumber|String|The build number of MacOS Line of Business (LoB) app.|
-|versionNumber|String|The version number of MacOS Line of Business (LoB) app.|
+|bundleId|String|The bundleId of the app.|
+|buildNumber|String|The build number of the app.|
+|versionNumber|String|The version number of the app.|
## Relationships None
v1.0 Intune Apps Macosmdatpapp https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-apps-macosmdatpapp.md
Title: "macOSMdatpApp resource type"
-description: "Contains properties and inherited properties for the macOS Microsoft Defender Advanced Threat Protection (MDATP) App."
+description: "Contains properties and inherited properties for the macOS Microsoft Defender Advanced Threat Protection (MDATP) App. This will be deprecated for MacOSMicrosoftDefenderApp."
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Contains properties and inherited properties for the macOS Microsoft Defender Advanced Threat Protection (MDATP) App.
+Contains properties and inherited properties for the macOS Microsoft Defender Advanced Threat Protection (MDATP) App. This will be deprecated for MacOSMicrosoftDefenderApp.
Inherits from [mobileApp](../resources/intune-shared-mobileapp.md)
v1.0 Intune Apps Macosmicrosoftdefenderapp https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-apps-macosmicrosoftdefenderapp.md
+
+ Title: "macOSMicrosoftDefenderApp resource type"
+description: "Contains properties and inherited properties for the macOS Microsoft Defender App."
+
+localization_priority: Normal
++
+# macOSMicrosoftDefenderApp resource type
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Contains properties and inherited properties for the macOS Microsoft Defender App.
++
+Inherits from [mobileApp](../resources/intune-shared-mobileapp.md)
+
+## Methods
+|Method|Return Type|Description|
+|:|:|:|
+|[List macOSMicrosoftDefenderApps](../api/intune-apps-macosmicrosoftdefenderapp-list.md)|[macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) collection|List properties and relationships of the [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) objects.|
+|[Get macOSMicrosoftDefenderApp](../api/intune-apps-macosmicrosoftdefenderapp-get.md)|[macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md)|Read properties and relationships of the [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object.|
+|[Create macOSMicrosoftDefenderApp](../api/intune-apps-macosmicrosoftdefenderapp-create.md)|[macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md)|Create a new [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object.|
+|[Delete macOSMicrosoftDefenderApp](../api/intune-apps-macosmicrosoftdefenderapp-delete.md)|None|Deletes a [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md).|
+|[Update macOSMicrosoftDefenderApp](../api/intune-apps-macosmicrosoftdefenderapp-update.md)|[macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md)|Update the properties of a [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String|Key of the entity. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|displayName|String|The admin provided or imported title of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|description|String|The description of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|publisher|String|The publisher of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|largeIcon|[mimeContent](../resources/intune-shared-mimecontent.md)|The large icon, to be displayed in the app details and used for upload of the icon. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|createdDateTime|DateTimeOffset|The date and time the app was created. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|lastModifiedDateTime|DateTimeOffset|The date and time the app was last modified. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|isFeatured|Boolean|The value indicating whether the app is marked as featured by the admin. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|privacyInformationUrl|String|The privacy statement Url. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|informationUrl|String|The more information Url. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|owner|String|The owner of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|developer|String|The developer of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|notes|String|Notes for the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|uploadState|Int32|The upload state. Possible values are: 0 - `Not Ready`, 1 - `Ready`, 2 - `Processing`. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|publishingState|[mobileAppPublishingState](../resources/intune-apps-mobileapppublishingstate.md)|The publishing state for the app. The app cannot be assigned unless the app is published. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md). Possible values are: `notPublished`, `processing`, `published`.|
+|isAssigned|Boolean|The value indicating whether the app is assigned to at least one group. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|roleScopeTagIds|String collection|List of scope tag ids for this mobile app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|categories|[mobileAppCategory](../resources/intune-apps-mobileappcategory.md) collection|The list of categories for this app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|assignments|[mobileAppAssignment](../resources/intune-apps-mobileappassignment.md) collection|The list of group assignments for this mobile app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|installSummary|[mobileAppInstallSummary](../resources/intune-apps-mobileappinstallsummary.md)|Mobile App Install Summary. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|deviceStatuses|[mobileAppInstallStatus](../resources/intune-apps-mobileappinstallstatus.md) collection|The list of installation states for this mobile app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|userStatuses|[userAppInstallStatus](../resources/intune-apps-userappinstallstatus.md) collection|The list of installation states for this mobile app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|relationships|[mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md) collection|The set of direct relationships for this app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+
+## JSON Representation
+Here is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.macOSMicrosoftDefenderApp"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.macOSMicrosoftDefenderApp",
+ "id": "String (identifier)",
+ "displayName": "String",
+ "description": "String",
+ "publisher": "String",
+ "largeIcon": {
+ "@odata.type": "microsoft.graph.mimeContent",
+ "type": "String",
+ "value": "binary"
+ },
+ "createdDateTime": "String (timestamp)",
+ "lastModifiedDateTime": "String (timestamp)",
+ "isFeatured": true,
+ "privacyInformationUrl": "String",
+ "informationUrl": "String",
+ "owner": "String",
+ "developer": "String",
+ "notes": "String",
+ "uploadState": 1024,
+ "publishingState": "String",
+ "isAssigned": true,
+ "roleScopeTagIds": [
+ "String"
+ ],
+ "dependentAppCount": 1024,
+ "supersedingAppCount": 1024,
+ "supersededAppCount": 1024
+}
+```
+++++
v1.0 Intune Apps Macosmicrosoftedgeapp https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-apps-macosmicrosoftedgeapp.md
Title: "macOSMicrosoftEdgeApp resource type"
-description: "Contains properties and inherited properties for the MacOS Microsoft Edge App."
+description: "Contains properties and inherited properties for the macOS Microsoft Edge App."
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Contains properties and inherited properties for the MacOS Microsoft Edge App.
+Contains properties and inherited properties for the macOS Microsoft Edge App.
Inherits from [mobileApp](../resources/intune-shared-mobileapp.md)
Inherits from [mobileApp](../resources/intune-shared-mobileapp.md)
|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
-|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`.|
+|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`, `unknownFutureValue`.|
## Relationships |Relationship|Type|Description|
v1.0 Intune Apps Macosminimumoperatingsystem https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-apps-macosminimumoperatingsystem.md
Title: "macOSMinimumOperatingSystem resource type"
-description: "The minimum operating system required for a MacOS app."
+description: "The minimum operating system required for a macOS app."
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-The minimum operating system required for a MacOS app.
+The minimum operating system required for a macOS app.
## Properties |Property|Type|Description| |:|:|:|
-|v10_7|Boolean|When TRUE, indicates macOS 10.7 or later is required to install the app. When FALSE, indicates some other OS version is the minimum OS to install the app. Default value is FALSE.|
-|v10_8|Boolean|When TRUE, indicates macOS 10.8 or later is required to install the app. When FALSE, indicates some other OS version is the minimum OS to install the app. Default value is FALSE.|
-|v10_9|Boolean|When TRUE, indicates macOS 10.9 or later is required to install the app. When FALSE, indicates some other OS version is the minimum OS to install the app. Default value is FALSE.|
-|v10_10|Boolean|When TRUE, indicates macOS 10.10 or later is required to install the app. When FALSE, indicates some other OS version is the minimum OS to install the app. Default value is FALSE.|
-|v10_11|Boolean|When TRUE, indicates macOS 10.11 or later is required to install the app. When FALSE, indicates some other OS version is the minimum OS to install the app. Default value is FALSE.|
+|v10_7|Boolean|When TRUE, indicates Mac OS X 10.7 or later is required to install the app. When FALSE, indicates some other OS version is the minimum OS to install the app. Default value is FALSE.|
+|v10_8|Boolean|When TRUE, indicates OS X 10.8 or later is required to install the app. When FALSE, indicates some other OS version is the minimum OS to install the app. Default value is FALSE.|
+|v10_9|Boolean|When TRUE, indicates OS X 10.9 or later is required to install the app. When FALSE, indicates some other OS version is the minimum OS to install the app. Default value is FALSE.|
+|v10_10|Boolean|When TRUE, indicates OS X 10.10 or later is required to install the app. When FALSE, indicates some other OS version is the minimum OS to install the app. Default value is FALSE.|
+|v10_11|Boolean|When TRUE, indicates OS X 10.11 or later is required to install the app. When FALSE, indicates some other OS version is the minimum OS to install the app. Default value is FALSE.|
|v10_12|Boolean|When TRUE, indicates macOS 10.12 or later is required to install the app. When FALSE, indicates some other OS version is the minimum OS to install the app. Default value is FALSE.| |v10_13|Boolean|When TRUE, indicates macOS 10.13 or later is required to install the app. When FALSE, indicates some other OS version is the minimum OS to install the app. Default value is FALSE.| |v10_14|Boolean|When TRUE, indicates macOS 10.14 or later is required to install the app. When FALSE, indicates some other OS version is the minimum OS to install the app. Default value is FALSE.|
v1.0 Intune Apps Microsoftedgechannel https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-apps-microsoftedgechannel.md
The enum to specify the channels for Microsoft Edge apps.
## Members |Member|Value|Description| |:|:|:|
-|dev|0|Not yet documented|
-|beta|1|Not yet documented|
-|stable|2|Not yet documented|
+|dev|0|The Dev Channel is intended to help you plan and develop with the latest capabilities of Microsoft Edge.|
+|beta|1|The Beta Channel is intended for production deployment to a representative sample set of users. New features ship about every 4 weeks. Security and quality updates ship as needed.|
+|stable|2|The Stable Channel is intended for broad deployment within organizations, and it's the channel that most users should be on. New features ship about every 4 weeks. Security and quality updates ship as needed.|
+|unknownFutureValue|3|Evolvable enumeration sentinel value. Do not use.|
v1.0 Intune Apps Windowsmicrosoftedgeapp https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-apps-windowsmicrosoftedgeapp.md
Inherits from [mobileApp](../resources/intune-shared-mobileapp.md)
|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
-|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`.|
+|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`, `unknownFutureValue`.|
|displayLanguageLocale|String|The language locale to use when the Edge app displays text to the user.| ## Relationships
v1.0 Intune Apps Wingetapp https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-apps-wingetapp.md
Inherits from [mobileApp](../resources/intune-shared-mobileapp.md)
|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|manifestHash|String|Hash of package metadata properties used to validate that the application matches the metadata in the source repository.|
|packageIdentifier|String|The PackageIdentifier from the WinGet source repository REST API. This also maps to the Id when using the WinGet client command line application. Required at creation time, cannot be modified on existing objects.| |installExperience|[winGetAppInstallExperience](../resources/intune-apps-wingetappinstallexperience.md)|The install experience settings associated with this application, which are used to ensure the desired install experiences on the target device are taken into account. This includes the account type (System or User) that actions should be run as on target devices. Required at creation time.|
Here is a JSON representation of the resource.
"dependentAppCount": 1024, "supersedingAppCount": 1024, "supersededAppCount": 1024,
+ "manifestHash": "String",
"packageIdentifier": "String", "installExperience": { "@odata.type": "microsoft.graph.winGetAppInstallExperience",
v1.0 Intune Deviceconfig Androiddeviceownergeneraldeviceconfiguration https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownergeneraldeviceconfiguration.md
Inherits from [deviceConfiguration](../resources/intune-shared-deviceconfigurati
|networkEscapeHatchAllowed|Boolean|Indicates whether or not the device will allow connecting to a temporary network connection at boot time.| |nfcBlockOutgoingBeam|Boolean|Indicates whether or not to block NFC outgoing beam.| |passwordBlockKeyguard|Boolean|Indicates whether or not the keyguard is disabled.|
-|passwordBlockKeyguardFeatures|[androidKeyguardFeature](../resources/intune-deviceconfig-androidkeyguardfeature.md) collection|List of device keyguard features to block. This collection can contain a maximum of 7 elements.|
+|passwordBlockKeyguardFeatures|[androidKeyguardFeature](../resources/intune-deviceconfig-androidkeyguardfeature.md) collection|List of device keyguard features to block. This collection can contain a maximum of 11 elements.|
|passwordExpirationDays|Int32|Indicates the amount of time that a password can be set for before it expires and a new password will be required. Valid values 1 to 365| |passwordMinimumLength|Int32|Indicates the minimum length of the password required on the device. Valid values 4 to 16| |passwordMinimumLetterCharacters|Int32|Indicates the minimum number of letter characters required for device password. Valid values 1 to 16|
v1.0 Intune Deviceconfigv2 Devicemanagementcompliancepolicy https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementcompliancepolicy.md
Device Management Compliance Policy
|name|String|Policy name| |description|String|Policy description| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this policy. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
|createdDateTime|DateTimeOffset|Policy creation date and time. This property is read-only.| |lastModifiedDateTime|DateTimeOffset|Policy last modification date and time. This property is read-only.| |settingCount|Int32|Number of settings. This property is read-only.|
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationcategory https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationcategory.md
Device Management Configuration Policy
|name|String|Name of the item| |displayName|String|Display name of the item| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms types, which settings in the category have. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies types, which settings in the category have. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies types, which settings in the category have. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicates that the category contains settings that are used for Compliance or Configuration. Possible values are: `none`, `configuration`, `compliance`.| |parentCategoryId|String|Parent id of the category.| |rootCategoryId|String|Root id of the category.|
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationexchangeonlinesettingapplicability https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationexchangeonlinesettingapplicability.md
Inherits from [deviceManagementConfigurationSettingApplicability](../resources/i
|description|String|description of the setting Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md)| |platform|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platform setting can be applied on Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.| |deviceMode|[deviceManagementConfigurationDeviceMode](../resources/intune-deviceconfigv2-devicemanagementconfigurationdevicemode.md)|Device Mode that setting can be applied on Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `kiosk`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Which technology channels this setting can be deployed through Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Which technology channels this setting can be deployed through Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
## Relationships None
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationpolicy.md
Device Management Configuration Policy
|[Update deviceManagementConfigurationPolicy](../api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-update.md)|[deviceManagementConfigurationPolicy](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicy.md)|Update the properties of a [deviceManagementConfigurationPolicy](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicy.md) object.| |[assign action](../api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-assign.md)|[deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) collection|Not yet documented| |[createCopy action](../api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-createcopy.md)|[deviceManagementConfigurationPolicy](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicy.md)|Not yet documented|
+|[reorder action](../api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-reorder.md)|None|Not yet documented|
## Properties |Property|Type|Description|
Device Management Configuration Policy
|name|String|Policy name| |description|String|Policy description| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this policy. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
|createdDateTime|DateTimeOffset|Policy creation date and time| |lastModifiedDateTime|DateTimeOffset|Policy last modification date and time| |settingCount|Int32|Number of settings|
Here is a JSON representation of the resource.
"templateDisplayVersion": "String" }, "priorityMetaData": {
- "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData"
+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
+ "priority": 1024
} } ```
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicytemplate https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationpolicytemplate.md
Device Management Configuration Policy Template
|displayVersion|String|Description of template version| |lifecycleState|[deviceManagementTemplateLifecycleState](../resources/intune-deviceconfigv2-devicemanagementtemplatelifecyclestate.md)|Indicate current lifecycle state of template. Possible values are: `invalid`, `draft`, `active`, `superseded`, `deprecated`, `retired`.| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this template. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this template. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
-|templateFamily|[deviceManagementConfigurationTemplateFamily](../resources/intune-deviceconfigv2-devicemanagementconfigurationtemplatefamily.md)|TemplateFamily for this template. Possible values are: `none`, `endpointSecurityAntivirus`, `endpointSecurityDiskEncryption`, `endpointSecurityFirewall`, `endpointSecurityEndpointDetectionAndResponse`, `endpointSecurityAttackSurfaceReduction`, `endpointSecurityAccountProtection`, `endpointSecurityApplicationControl`, `enrollmentConfiguration`, `baseline`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this template. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
+|templateFamily|[deviceManagementConfigurationTemplateFamily](../resources/intune-deviceconfigv2-devicemanagementconfigurationtemplatefamily.md)|TemplateFamily for this template. Possible values are: `none`, `endpointSecurityAntivirus`, `endpointSecurityDiskEncryption`, `endpointSecurityFirewall`, `endpointSecurityEndpointDetectionAndResponse`, `endpointSecurityAttackSurfaceReduction`, `endpointSecurityAccountProtection`, `endpointSecurityApplicationControl`, `endpointSecurityEndpointPrivilegeManagement`, `enrollmentConfiguration`, `appQuietTime`, `baseline`, `unknownFutureValue`.|
|allowUnmanagedSettings|Boolean|Allow unmanaged setting templates| |settingTemplateCount|Int32|Number of setting templates. Valid values 0 to 2147483647. This property is read-only.|
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicytemplatereference https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationpolicytemplatereference.md
Policy template reference information
|Property|Type|Description| |:|:|:| |templateId|String|Template id|
-|templateFamily|[deviceManagementConfigurationTemplateFamily](../resources/intune-deviceconfigv2-devicemanagementconfigurationtemplatefamily.md)|Template Family of the referenced Template. This property is read-only. Possible values are: `none`, `endpointSecurityAntivirus`, `endpointSecurityDiskEncryption`, `endpointSecurityFirewall`, `endpointSecurityEndpointDetectionAndResponse`, `endpointSecurityAttackSurfaceReduction`, `endpointSecurityAccountProtection`, `endpointSecurityApplicationControl`, `enrollmentConfiguration`, `baseline`.|
+|templateFamily|[deviceManagementConfigurationTemplateFamily](../resources/intune-deviceconfigv2-devicemanagementconfigurationtemplatefamily.md)|Template Family of the referenced Template. This property is read-only. Possible values are: `none`, `endpointSecurityAntivirus`, `endpointSecurityDiskEncryption`, `endpointSecurityFirewall`, `endpointSecurityEndpointDetectionAndResponse`, `endpointSecurityAttackSurfaceReduction`, `endpointSecurityAccountProtection`, `endpointSecurityApplicationControl`, `endpointSecurityEndpointPrivilegeManagement`, `enrollmentConfiguration`, `appQuietTime`, `baseline`, `unknownFutureValue`.|
|templateDisplayName|String|Template Display Name of the referenced template. This property is read-only.| |templateDisplayVersion|String|Template Display Version of the referenced Template. This property is read-only.|
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationsettingapplicability https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md
Not yet documented
|description|String|description of the setting| |platform|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platform setting can be applied on. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.| |deviceMode|[deviceManagementConfigurationDeviceMode](../resources/intune-deviceconfigv2-devicemanagementconfigurationdevicemode.md)|Device Mode that setting can be applied on. Possible values are: `none`, `kiosk`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Which technology channels this setting can be deployed through. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Which technology channels this setting can be deployed through. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
## Relationships None
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationtechnologies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md
Describes which technology this setting can be deployed with
|exchangeOnline|256|Setting can be deployed through the Exchange Online agent channel| |linuxMdm|1024|Setting can be deployed through the Linux Mdm channel| |enrollment|4096|Setting can be deployed through device enrollment.|
-|unknownFutureValue|1073741824|Sentinel member for cases where the client cannot handle the new enum values.|
+|endpointPrivilegeManagement|8192|Setting can be deployed using the Endpoint privilege management channel|
+|unknownFutureValue|16384|Evolvable enumeration sentinel value. Do not use.|
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationtemplatefamily https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationtemplatefamily.md
Describes the TemplateFamily for the Template entity
|endpointSecurityAttackSurfaceReduction|14|Template Family for EndpointSecurityAttackSurfaceReduction that help reduce your attack surfaces, by minimizing the places where your organization is vulnerable to cyberthreats and attacks| |endpointSecurityAccountProtection|15|Template Family for EndpointSecurityAccountProtection that facilitates protecting the identity and accounts of users| |endpointSecurityApplicationControl|16|Template Family for ApplicationControl that helps mitigate security threats by restricting the applications that users can run and the code that runs in the System Core (kernel)|
+|endpointSecurityEndpointPrivilegeManagement|17|Template Family for EPM Elevation Rules|
|enrollmentConfiguration|18|Template Family for EnrollmentConfiguration|
+|appQuietTime|19|Template Family for QuietTimeIndicates Template Family for all the Apps QuietTime policies and templates|
|baseline|20|Template Family for Baseline|
+|unknownFutureValue|21|Evolvable enumeration sentinel value. Do not use.|
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationwindowssettingapplicability https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationwindowssettingapplicability.md
Inherits from [deviceManagementConfigurationSettingApplicability](../resources/i
|description|String|description of the setting Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md)| |platform|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platform setting can be applied on Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.| |deviceMode|[deviceManagementConfigurationDeviceMode](../resources/intune-deviceconfigv2-devicemanagementconfigurationdevicemode.md)|Device Mode that setting can be applied on Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `kiosk`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Which technology channels this setting can be deployed through Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Which technology channels this setting can be deployed through Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
|configurationServiceProviderVersion|String|Version of CSP setting is a part of| |maximumSupportedVersion|String|Maximum supported version of Windows| |minimumSupportedVersion|String|Minimum supported version of Windows|
v1.0 Intune Deviceconfigv2 Devicemanagementprioritymetadata https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementprioritymetadata.md
Title: "deviceManagementPriorityMetaData resource type"
-description: "Not yet documented"
+description: "Priority metadata of the policy."
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+Priority metadata of the policy.
## Properties |Property|Type|Description| |:|:|:|
+|priority|Int32|Priority of the policy. Valid values 1 to 500|
## Relationships None
Here is a JSON representation of the resource.
--> ``` json {
- "@odata.type": "#microsoft.graph.deviceManagementPriorityMetaData"
+ "@odata.type": "#microsoft.graph.deviceManagementPriorityMetaData",
+ "priority": 1024
} ```
v1.0 Intune Devices Comanagementeligibledevice https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-comanagementeligibledevice.md
Device Co-Management eligibility state
|upn|String|UPN| |userEmail|String|UserEmail| |userName|String|UserName|
-|status|[comanagementEligibleType](../resources/intune-devices-comanagementeligibletype.md)|ComanagementEligibleStatus. Possible values are: `comanaged`, `eligible`, `eligibleButNotAzureAdJoined`, `needsOsUpdate`, `ineligible`, `scheduledForEnrollment`.|
+|status|[comanagementEligibleType](../resources/intune-devices-comanagementeligibletype.md)|ComanagementEligibleStatus. Possible values are: `comanaged`, `eligible`, `eligibleButNotAzureAdJoined`, `needsOsUpdate`, `ineligible`, `scheduledForEnrollment`, `unknownFutureValue`.|
## Relationships None
v1.0 Intune Devices Comanagementeligibledevicessummary https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-comanagementeligibledevicessummary.md
Not yet documented
|:|:|:| |comanagedCount|Int32|Count of devices already Co-Managed| |eligibleCount|Int32|Count of devices fully eligible for Co-Management|
+|scheduledForEnrollmentCount|Int32|Count of devices scheduled for Co-Management enrollment. Valid values 0 to 9999999|
|eligibleButNotAzureAdJoinedCount|Int32|Count of devices eligible for Co-Management but not yet joined to Azure Active Directory| |needsOsUpdateCount|Int32|Count of devices that will be eligible for Co-Management after an OS update| |ineligibleCount|Int32|Count of devices ineligible for Co-Management|
Here is a JSON representation of the resource.
"@odata.type": "#microsoft.graph.comanagementEligibleDevicesSummary", "comanagedCount": 1024, "eligibleCount": 1024,
+ "scheduledForEnrollmentCount": 1024,
"eligibleButNotAzureAdJoinedCount": 1024, "needsOsUpdateCount": 1024, "ineligibleCount": 1024
v1.0 Intune Devices Comanagementeligibletype https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-comanagementeligibletype.md
Not yet documented
|needsOsUpdate|4|Not yet documented| |ineligible|5|Not yet documented| |scheduledForEnrollment|6|Devices scheduled for Co-Management enrollment|
+|unknownFutureValue|7|Evolvable enumeration sentinel value. Do not use.|
v1.0 Intune Devices Detectedapp https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-detectedapp.md
A managed or unmanaged app that is installed on a managed device. Unmanaged apps
|sizeInByte|Int64|Discovered application size in bytes. Read-only| |deviceCount|Int32|The number of devices that have installed this application| |publisher|String|Indicates the publisher of the discovered application. For example: 'Microsoft'. The default value is an empty string.|
-|platform|[detectedAppPlatformType](../resources/intune-devices-detectedappplatformtype.md)|Indicates the operating system / platform of the discovered application. Some possible values are Windows, iOS, macOS. The default value is unknown (0). Possible values are: `unknown`, `windows`, `windowsMobile`, `windowsHolographic`, `ios`, `macOS`, `chromeOS`, `androidOSP`, `androidDeviceAdministrator`, `androidWorkProfile`, `androidDedicatedAndFullyManaged`.|
+|platform|[detectedAppPlatformType](../resources/intune-devices-detectedappplatformtype.md)|Indicates the operating system / platform of the discovered application. Some possible values are Windows, iOS, macOS. The default value is unknown (0). Possible values are: `unknown`, `windows`, `windowsMobile`, `windowsHolographic`, `ios`, `macOS`, `chromeOS`, `androidOSP`, `androidDeviceAdministrator`, `androidWorkProfile`, `androidDedicatedAndFullyManaged`, `unknownFutureValue`.|
## Relationships |Relationship|Type|Description|
v1.0 Intune Devices Detectedappplatformtype https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-detectedappplatformtype.md
Indicates the operating system / platform of the discovered application. Some p
|androidDeviceAdministrator|8|Indicates that the platform of the detected application is Android device administrator.| |androidWorkProfile|9|Indicates that the platform of the detected application is Android work profile.| |androidDedicatedAndFullyManaged|10|Indicates that the platform of the detected application is Android dedicated and fully managed.|
+|unknownFutureValue|11|Evolvable enumeration sentinel value. Do not use.|
v1.0 Intune Devices Devicelogcollectionresponse https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-devicelogcollectionresponse.md
Windows Log Collection request entity.
|initiatedByUserPrincipalName|String|The UPN for who initiated the request| |expirationDateTimeUTC|DateTimeOffset|The DateTime of the expiration of the logs| |size|Double|The size of the logs. Valid values -1.79769313486232E+308 to 1.79769313486232E+308|
+|enrolledByUser|String|The User Principal Name (UPN) of the user that enrolled the device|
## Relationships None
Here is a JSON representation of the resource.
"receivedDateTimeUTC": "String (timestamp)", "initiatedByUserPrincipalName": "String", "expirationDateTimeUTC": "String (timestamp)",
- "size": "4.2"
+ "size": "4.2",
+ "enrolledByUser": "String"
} ```
v1.0 Intune Devices Devicescopeaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-devicescopeaction.md
Trigger on the service to either START or STOP computing metrics data based on a
## Members |Member|Value|Description| |:|:|:|
-|stop|0|Stop computing metrics data|
+|stop|0|Stop computing metrics data|
|start|1|Start computing metrics data| -
v1.0 Intune Devices Manageddevice https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-manageddevice.md
Devices that are managed or pre-enrolled through Intune
|[reenable action](../api/intune-devices-manageddevice-reenable.md)|None|Not yet documented| |[moveDevicesToOU action](../api/intune-devices-manageddevice-movedevicestoou.md)|None|Not yet documented| |[removeDeviceFirmwareConfigurationInterfaceManagement action](../api/intune-devices-manageddevice-removedevicefirmwareconfigurationinterfacemanagement.md)|None|Remove device from Device Firmware Configuration Interface management|
+|[initiateMobileDeviceManagementKeyRecovery action](../api/intune-devices-manageddevice-initiatemobiledevicemanagementkeyrecovery.md)|None|Perform MDM key recovery and TPM attestation|
|[getOemWarranty function](../api/intune-devices-manageddevice-getoemwarranty.md)|[oemWarranty](../resources/intune-devices-oemwarranty.md)|Not yet documented| |[appDiagnostics function](../api/intune-devices-manageddevice-appdiagnostics.md)|[powerliftIncidentMetadata](../resources/intune-devices-powerliftincidentmetadata.md) collection|Not yet documented| |[downloadAppDiagnostics action](../api/intune-devices-manageddevice-downloadappdiagnostics.md)|Stream|Not yet documented|
Devices that are managed or pre-enrolled through Intune
|id|String|Unique Identifier for the device. This property is read-only.| |userId|String|Unique Identifier for the user associated with the device. This property is read-only.| |deviceName|String|Name of the device. This property is read-only.|
-|hardwareInformation|[hardwareInformation](../resources/intune-devices-hardwareinformation.md)|The hardward details for the device. Includes information such as storage space, manufacturer, serial number, etc. This property is read-only.|
+|hardwareInformation|[hardwareInformation](../resources/intune-devices-hardwareinformation.md)|The hardward details for the device. Includes information such as storage space, manufacturer, serial number, etc. Return default value in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only.|
|ownerType|[ownerType](../resources/intune-shared-ownertype.md)|Ownership of the device. Can be 'company' or 'personal'. Possible values are: `unknown`, `company`, `personal`.| |managedDeviceOwnerType|[managedDeviceOwnerType](../resources/intune-shared-manageddeviceownertype.md)|Ownership of the device. Can be 'company' or 'personal'. Possible values are: `unknown`, `company`, `personal`.| |deviceActionResults|[deviceActionResult](../resources/intune-devices-deviceactionresult.md) collection|List of ComplexType deviceActionResult objects. This property is read-only.|
Devices that are managed or pre-enrolled through Intune
|subscriberCarrier|String|Subscriber Carrier. This property is read-only.| |meid|String|MEID. This property is read-only.| |totalStorageSpaceInBytes|Int64|Total Storage in Bytes. This property is read-only.|
-|freeStorageSpaceInBytes|Int64|Free Storage in Bytes. This property is read-only.|
+|freeStorageSpaceInBytes|Int64|Free Storage in Bytes. Default value is 0. Read-only. This property is read-only.|
|managedDeviceName|String|Automatically generated name to identify a device. Can be overwritten to a user friendly name.| |partnerReportedThreatState|[managedDevicePartnerReportedHealthState](../resources/intune-devices-manageddevicepartnerreportedhealthstate.md)|Indicates the threat state of a device when a Mobile Threat Defense partner is in use by the account and device. Read Only. This property is read-only. Possible values are: `unknown`, `activated`, `deactivated`, `secured`, `lowSeverity`, `mediumSeverity`, `highSeverity`, `unresponsive`, `compromised`, `misconfigured`.| |retireAfterDateTime|DateTimeOffset|Indicates the time after when a device will be auto retired because of scheduled action. This property is read-only.|
Devices that are managed or pre-enrolled through Intune
|autopilotEnrolled|Boolean|Reports if the managed device is enrolled via auto-pilot. This property is read-only.| |requireUserEnrollmentApproval|Boolean|Reports if the managed iOS device is user approval enrollment. This property is read-only.| |managementCertificateExpirationDate|DateTimeOffset|Reports device management certificate expiration date. This property is read-only.|
-|iccid|String|Integrated Circuit Card Identifier, it is A SIM card's unique identification number. This property is read-only.|
-|udid|String|Unique Device Identifier for iOS and macOS devices. This property is read-only.|
+|iccid|String|Integrated Circuit Card Identifier, it is A SIM card's unique identification number. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only.|
+|udid|String|Unique Device Identifier for iOS and macOS devices. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only.|
|roleScopeTagIds|String collection|List of Scope Tag IDs for this Device instance.| |windowsActiveMalwareCount|Int32|Count of active malware for this windows device. This property is read-only.| |windowsRemediatedMalwareCount|Int32|Count of remediated malware for this windows device. This property is read-only.|
-|notes|String|Notes on the device created by IT Admin|
+|notes|String|Notes on the device created by IT Admin. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported.|
|configurationManagerClientHealthState|[configurationManagerClientHealthState](../resources/intune-devices-configurationmanagerclienthealthstate.md)|Configuration manager client health state, valid only for devices managed by MDM/ConfigMgr Agent| |configurationManagerClientInformation|[configurationManagerClientInformation](../resources/intune-devices-configurationmanagerclientinformation.md)|Configuration manager client information, valid only for devices managed, duel-managed or tri-managed by ConfigMgr Agent| |ethernetMacAddress|String|Ethernet MAC. This property is read-only.|
-|physicalMemoryInBytes|Int64|Total Memory in Bytes. This property is read-only.|
+|physicalMemoryInBytes|Int64|Total Memory in Bytes. Return default value 0 in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. Default value is 0. Read-only. This property is read-only.|
|processorArchitecture|[managedDeviceArchitecture](../resources/intune-devices-manageddevicearchitecture.md)|Processor architecture. This property is read-only. Possible values are: `unknown`, `x86`, `x64`, `arm`, `arM64`.| |specificationVersion|String|Specification version. This property is read-only.| |joinType|[joinType](../resources/intune-devices-jointype.md)|Device join type. Possible values are: `unknown`, `azureADJoined`, `azureADRegistered`, `hybridAzureADJoined`.| |skuFamily|String|Device sku family|
-|skuNumber|Int32|Device sku number, see also: https://docs.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only.|
+|skuNumber|Int32|Device sku number, see also: https://learn.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only.|
|managementFeatures|[managedDeviceManagementFeatures](../resources/intune-devices-manageddevicemanagementfeatures.md)|Device management features. Possible values are: `none`, `microsoftManagedDesktop`.| |chromeOSDeviceInfo|[chromeOSDeviceProperty](../resources/intune-devices-chromeosdeviceproperty.md) collection|List of properties of the ChromeOS Device.| |enrollmentProfileName|String|Name of the enrollment profile assigned to the device. Default value is empty string, indicating no enrollment profile was assgined. This property is read-only.|
Here is a JSON representation of the resource.
+
v1.0 Intune Devices Manageddeviceremoteaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-manageddeviceremoteaction.md
Not yet documented
|moveDeviceToOrganizationalUnit|13|Name of the moveDevicesToOU action.| |activateDeviceEsim|14|Name of action to Activate eSIM on the device.| |collectDiagnostics|15|Name of the collectDiagnostics action.|
+|initiateMobileDeviceManagementKeyRecovery|16|Name of action to initiate MDM key recovery|
v1.0 Intune Devices Remoteaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-remoteaction.md
Remote actions Intune supports.
|disable|25|Indicate user initiates an action to disable the device.| |reenable|26|Indicate user initiates an action to reenable the device.| |moveDeviceToOrganizationalUnit|27|Indicate user initiates an action to move the device to a new organizational unit.|
+|initiateMobileDeviceManagementKeyRecovery|28|Add device action of InitiateMobileDeviceManagementKeyRecovery|
v1.0 Intune Devices Remoteactionaudit https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-remoteactionaudit.md
Report of remote actions initiated on the devices belonging to a certain tenant.
|deviceDisplayName|String|Intune device name.| |userName|String|\[deprecated\] Please use InitiatedByUserPrincipalName instead.| |initiatedByUserPrincipalName|String|User who initiated the device action, format is UPN.|
-|action|[remoteAction](../resources/intune-devices-remoteaction.md)|The action name. Possible values are: `unknown`, `factoryReset`, `removeCompanyData`, `resetPasscode`, `remoteLock`, `enableLostMode`, `disableLostMode`, `locateDevice`, `rebootNow`, `recoverPasscode`, `cleanWindowsDevice`, `logoutSharedAppleDeviceActiveUser`, `quickScan`, `fullScan`, `windowsDefenderUpdateSignatures`, `factoryResetKeepEnrollmentData`, `updateDeviceAccount`, `automaticRedeployment`, `shutDown`, `rotateBitLockerKeys`, `rotateFileVaultKey`, `getFileVaultKey`, `setDeviceName`, `activateDeviceEsim`, `deprovision`, `disable`, `reenable`, `moveDeviceToOrganizationalUnit`.|
+|action|[remoteAction](../resources/intune-devices-remoteaction.md)|The action name. Possible values are: `unknown`, `factoryReset`, `removeCompanyData`, `resetPasscode`, `remoteLock`, `enableLostMode`, `disableLostMode`, `locateDevice`, `rebootNow`, `recoverPasscode`, `cleanWindowsDevice`, `logoutSharedAppleDeviceActiveUser`, `quickScan`, `fullScan`, `windowsDefenderUpdateSignatures`, `factoryResetKeepEnrollmentData`, `updateDeviceAccount`, `automaticRedeployment`, `shutDown`, `rotateBitLockerKeys`, `rotateFileVaultKey`, `getFileVaultKey`, `setDeviceName`, `activateDeviceEsim`, `deprovision`, `disable`, `reenable`, `moveDeviceToOrganizationalUnit`, `initiateMobileDeviceManagementKeyRecovery`.|
|requestDateTime|DateTimeOffset|Time when the action was issued, given in UTC.| |deviceOwnerUserPrincipalName|String|Upn of the device owner.| |deviceIMEI|String|IMEI of the device.|
v1.0 Intune Devices Userexperienceanalyticsanomalyseverityoverview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsanomalyseverityoverview.md
The user experience analytics anomaly severity overview entity contains the coun
|mediumSeverityAnomalyCount|Int32|The number of medium severity anomalies which have been detected. Valid values -2147483648 to 2147483647| |highSeverityAnomalyCount|Int32|The number of high severity anomalies which have been detected. Valid values -2147483648 to 2147483647| |informationalSeverityAnomalyCount|Int32|The number of informational severity anomalies which have been detected. Valid values -2147483648 to 2147483647|
-|otherSeverityAnomalyCount|Int32|The number of anomalies which have been detected with undefined severity. Valid values -2147483648 to 2147483647|
## Relationships None
Here is a JSON representation of the resource.
"lowSeverityAnomalyCount": 1024, "mediumSeverityAnomalyCount": 1024, "highSeverityAnomalyCount": 1024,
- "informationalSeverityAnomalyCount": 1024,
- "otherSeverityAnomalyCount": 1024
+ "informationalSeverityAnomalyCount": 1024
} ```
v1.0 Intune Devices Userexperienceanalyticsdevicescopesummary https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsdevicescopesummary.md
+
+ Title: "userExperienceAnalyticsDeviceScopeSummary resource type"
+description: "The user experience analytics tenant level information for all the device scope configurations"
+
+localization_priority: Normal
++
+# userExperienceAnalyticsDeviceScopeSummary resource type
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+The user experience analytics tenant level information for all the device scope configurations
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|totalDeviceScopes|Int32|The total number of user experience analytics device scopes. Valid values -2147483648 to 2147483647|
+|totalDeviceScopesEnabled|Int32|The total number of user experience analytics device scopes that are enabled. Valid values -2147483648 to 2147483647|
+|completedDeviceScopeIds|String collection|A collection of the user experience analytics device scope Unique Identifiers that are enabled and finished recalculating the report metric.|
+|insufficientDataDeviceScopeIds|String collection|A collection of user experience analytics device scope Unique Identitfiers that are enabled but there is insufficient data to calculate results.|
+
+## Relationships
+None
+
+## JSON Representation
+Here is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.userExperienceAnalyticsDeviceScopeSummary"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.userExperienceAnalyticsDeviceScopeSummary",
+ "totalDeviceScopes": 1024,
+ "totalDeviceScopesEnabled": 1024,
+ "completedDeviceScopeIds": [
+ "String"
+ ],
+ "insufficientDataDeviceScopeIds": [
+ "String"
+ ]
+}
+```
+++++
v1.0 Intune Devices Windowsmanageddevice https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-windowsmanageddevice.md
Inherits from [managedDevice](../resources/intune-devices-manageddevice.md)
|id|String|Unique Identifier for the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |userId|String|Unique Identifier for the user associated with the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |deviceName|String|Name of the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|hardwareInformation|[hardwareInformation](../resources/intune-devices-hardwareinformation.md)|The hardward details for the device. Includes information such as storage space, manufacturer, serial number, etc. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|hardwareInformation|[hardwareInformation](../resources/intune-devices-hardwareinformation.md)|The hardward details for the device. Includes information such as storage space, manufacturer, serial number, etc. Return default value in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|ownerType|[ownerType](../resources/intune-shared-ownertype.md)|Ownership of the device. Can be 'company' or 'personal' Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `company`, `personal`.| |managedDeviceOwnerType|[managedDeviceOwnerType](../resources/intune-shared-manageddeviceownertype.md)|Ownership of the device. Can be 'company' or 'personal' Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `company`, `personal`.| |deviceActionResults|[deviceActionResult](../resources/intune-devices-deviceactionresult.md) collection|List of ComplexType deviceActionResult objects. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
Inherits from [managedDevice](../resources/intune-devices-manageddevice.md)
|subscriberCarrier|String|Subscriber Carrier. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |meid|String|MEID. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |totalStorageSpaceInBytes|Int64|Total Storage in Bytes. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|freeStorageSpaceInBytes|Int64|Free Storage in Bytes. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|freeStorageSpaceInBytes|Int64|Free Storage in Bytes. Default value is 0. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|managedDeviceName|String|Automatically generated name to identify a device. Can be overwritten to a user friendly name. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |partnerReportedThreatState|[managedDevicePartnerReportedHealthState](../resources/intune-devices-manageddevicepartnerreportedhealthstate.md)|Indicates the threat state of a device when a Mobile Threat Defense partner is in use by the account and device. Read Only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `activated`, `deactivated`, `secured`, `lowSeverity`, `mediumSeverity`, `highSeverity`, `unresponsive`, `compromised`, `misconfigured`.| |retireAfterDateTime|DateTimeOffset|Indicates the time after when a device will be auto retired because of scheduled action. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
Inherits from [managedDevice](../resources/intune-devices-manageddevice.md)
|autopilotEnrolled|Boolean|Reports if the managed device is enrolled via auto-pilot. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |requireUserEnrollmentApproval|Boolean|Reports if the managed iOS device is user approval enrollment. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |managementCertificateExpirationDate|DateTimeOffset|Reports device management certificate expiration date. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|iccid|String|Integrated Circuit Card Identifier, it is A SIM card's unique identification number. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|udid|String|Unique Device Identifier for iOS and macOS devices. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|iccid|String|Integrated Circuit Card Identifier, it is A SIM card's unique identification number. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|udid|String|Unique Device Identifier for iOS and macOS devices. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|roleScopeTagIds|String collection|List of Scope Tag IDs for this Device instance. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |windowsActiveMalwareCount|Int32|Count of active malware for this windows device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |windowsRemediatedMalwareCount|Int32|Count of remediated malware for this windows device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|notes|String|Notes on the device created by IT Admin Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|notes|String|Notes on the device created by IT Admin. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|configurationManagerClientHealthState|[configurationManagerClientHealthState](../resources/intune-devices-configurationmanagerclienthealthstate.md)|Configuration manager client health state, valid only for devices managed by MDM/ConfigMgr Agent Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |configurationManagerClientInformation|[configurationManagerClientInformation](../resources/intune-devices-configurationmanagerclientinformation.md)|Configuration manager client information, valid only for devices managed, duel-managed or tri-managed by ConfigMgr Agent Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |ethernetMacAddress|String|Ethernet MAC. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|physicalMemoryInBytes|Int64|Total Memory in Bytes. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|physicalMemoryInBytes|Int64|Total Memory in Bytes. Return default value 0 in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. Default value is 0. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|processorArchitecture|[managedDeviceArchitecture](../resources/intune-devices-manageddevicearchitecture.md)|Processor architecture. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `x86`, `x64`, `arm`, `arM64`.| |specificationVersion|String|Specification version. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |joinType|[joinType](../resources/intune-devices-jointype.md)|Device join type Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `azureADJoined`, `azureADRegistered`, `hybridAzureADJoined`.| |skuFamily|String|Device sku family Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|skuNumber|Int32|Device sku number, see also: https://docs.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|skuNumber|Int32|Device sku number, see also: https://learn.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|managementFeatures|[managedDeviceManagementFeatures](../resources/intune-devices-manageddevicemanagementfeatures.md)|Device management features Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `none`, `microsoftManagedDesktop`.| |chromeOSDeviceInfo|[chromeOSDeviceProperty](../resources/intune-devices-chromeosdeviceproperty.md) collection|List of properties of the ChromeOS Device. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |enrollmentProfileName|String|Name of the enrollment profile assigned to the device. Default value is empty string, indicating no enrollment profile was assgined. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
Here is a JSON representation of the resource.
+
v1.0 Intune Enrollment Depenrollmentbaseprofile https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-enrollment-depenrollmentbaseprofile.md
Inherits from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofi
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information.|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information.|
|supportDepartment|String|Support department information| |isMandatory|Boolean|Indicates if the profile is mandatory| |locationDisabled|Boolean|Indicates if Location service setup pane is disabled|
Here is a JSON representation of the resource.
+
v1.0 Intune Enrollment Depenrollmentprofile https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-enrollment-depenrollmentprofile.md
Inherits from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofi
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information.|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information.|
|supportDepartment|String|Support department information| |passCodeDisabled|Boolean|Indicates if Passcode setup pane is disabled| |isMandatory|Boolean|Indicates if the profile is mandatory|
Here is a JSON representation of the resource.
+
v1.0 Intune Enrollment Depiosenrollmentprofile https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-enrollment-depiosenrollmentprofile.md
Inherits from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrol
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise