+ 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

+```

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+| 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. |

+ "reviewHistoryPeriodStartDateTime": "2021-01-01T00:00:00Z",

+ "reviewHistoryPeriodEndDateTime": "2021-04-30T23:59:59Z",

+# [C#](#tab/csharp)

+# [PHP](#tab/php)

+ "reviewHistoryPeriodStartDateTime": "2021-01-01T00:00:00Z",

+ "reviewHistoryPeriodEndDateTime": "2021-04-30T23:59:59Z",

+|Application | AdministrativeUnit.Read.All, Directory.Read.All, AdministrativeUnit.ReadWrite.All, Directory.ReadWrite.All |

+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

+- 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.

+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.

+<!-- {

+ "isCollection": true

+} -->

+This method supports the `$select` and `$filter` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).

+|Delegated (work or school account) | Application.ReadWrite.All |

+|Application | Application.ReadWrite.OwnedBy, Application.ReadWrite.All|

+|Delegated (work or school account) | Application.ReadWrite.All |

+|Application | Application.ReadWrite.OwnedBy, Application.ReadWrite.All |

+> Assigning the `presenter` or `coorganizer` role to users who are not registered in Azure Active Directory is not currently supported.

+|Delegated (work or school account) | Application.ReadWrite.All |

+|Application | Application.ReadWrite.OwnedBy, Application.ReadWrite.All |

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [JavaScript](#tab/javascript)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+} -->

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+|Permission type|Permissions (from least to most privileged)|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|Not supported.|

+For delegated permissions to allow apps to get **bitLockerRecoveryKey** resources on behalf of the signed-in user, the user must be the registered owner of the device that the BitLocker recovery key was originally backed up from, or the calling user must be in one of the following directory roles:

+To get a list of BitLocker keys within the tenant filtered by the **deviceId**:

+This method supports the `$filter` OData query parameter to filter results by the **deviceId** the key was most recently backed up to. This method does not support the `$top` filter. For details, see [Example 2](#example-2-retrieve-a-list-of-bitlocker-keys-filtered-by-deviceid). For general information, see [OData query parameters](/graph/query-parameters).

+### Example 1: Retrieve a list of BitLocker keys in the tenant

+### Example 2: Retrieve a list of BitLocker keys filtered by **deviceId**

+|Permission type|Permissions (from least to most privileged)|

+|Delegated (personal Microsoft account)|Not supported.|

+|Application|Not supported.|

+>**Note:** For delegated permissions to allow apps to get **bitLockerRecoveryKey** resources on behalf of the signed-in user, the tenant administrator must have assigned the user one of the following roles, or the user must be the **registered owner** of the device that the BitLocker key was originally backed up from:

+This method supports the `$select` OData query parameter to return the **key** property. For details, see [Example 2](#example-2-get-the-bitlocker-key-with-the-key-property-by-specifying-the-key-id). For general information, see [OData query parameters](/graph/query-parameters).

+### Example 1: Get the BitLocker key by specifying the key **id**

+The following is an example of the request. This example does not return the **key** property.

+>**Note:** The response object shown here might be shortened for readability.

+### Example 2: Get the BitLocker key with the **key** property by specifying the key **id**

+>**Note:** The response object shown here might be shortened for readability.

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+ 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.

+# [HTTP](#tab/http)

+<!-- {

+ "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

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+### 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

+ }

+ }

+ ]

+}

+```

+ 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.

+# [HTTP](#tab/http)

+<!-- {

+ "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."

+}

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+### Response

+The following is an example of the response.

+<!-- {

+ "blockType": "response",

+ "truncated": true

+}

+-->

+``` http

+HTTP/1.1 204 No Content

+```

+ 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.

+# [HTTP](#tab/http)

+<!-- {

+ "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

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+### 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

+ }

+ }

+ ]

+}

+```

+ 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.

+# [HTTP](#tab/http)

+<!-- {

+ "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."

+}

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+### Response

+The following is an example of the response.

+<!-- {

+ "blockType": "response",

+ "truncated": true

+}

+-->

+``` http

+HTTP/1.1 204 No Content

+```

+ 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.

+# [HTTP](#tab/http)

+<!-- {

+ "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

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+#### 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.

+# [HTTP](#tab/http)

+<!-- {

+ "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

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+#### 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": []

+}

+```

+ 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.

+# [HTTP](#tab/http)

+<!-- {

+ "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

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+#### 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": []

+}

+```

+ 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.

+# [HTTP](#tab/http)

+<!-- {

+ "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

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+### 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"

+}

+```

+ 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.

+# [HTTP](#tab/http)

+<!-- {

+ "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

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+### 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": []

+ }

+ ]

+}

+```

+ 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.

+# [HTTP](#tab/http)

+<!-- {

+ "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

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+### 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

+ }

+ }

+ ]

+ }

+ ]

+}

+```

+ 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.

+# [HTTP](#tab/http)

+<!-- {

+ "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": "/"

+}

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+### 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": []

+}

+```

+ 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.

+# [HTTP](#tab/http)

+<!-- {

+ "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

+}

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+### 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": []

+}

+```

+ 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.

+# [HTTP](#tab/http)

+<!-- {

+ "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"

+}

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+#### 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

+ }

+}

+```

+ 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.

+# [HTTP](#tab/http)

+<!-- {

+ "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"

+}

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+### Response

+The following is an example of the response.

+<!-- {

+ "blockType": "response",

+ "truncated": true

+}

+-->

+``` http

+HTTP/1.1 204 No Content

+```

+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).

+# [PowerShell](#tab/powershell)

+# [PowerShell](#tab/powershell)

+# [PowerShell](#tab/powershell)

+# [PowerShell](#tab/powershell)

+# [HTTP](#tab/http)

+```msgraph-interactive

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+```

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+|recipient|[teamworkNotificationRecipient](../resources/teamworknotificationrecipient.md)|Recipient of the notification. For more details, see [aadUserNotificationRecipient](../resources/aadusernotificationrecipient.md) and [chatMembersNotificationRecipient](../resources/chatmembersnotificationrecipient.md). |

+The following example shows how you can send an activity feed notification to all chat members. This example is similar to previous examples. However, in this case, the **recipient** is a [chatMembersNotificationRecipient](../resources/chatmembersnotificationrecipient.md). Note that the **chatId** specified in the **recipient** must match the **chatId** specified in the request URL.

+ "name": "chat_sendactivitynotification_5",

+| Application | Teamwork.Migrate.All |

+> **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.

+> **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"));`.

+> **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"));`.

+The following is an example of the response.

+### Example 8: @mention a team in a channel message

+All properties of a **chatMessage** can be updated in delegated permissions scenarios,

+except for read-only properties and the **policyViolation** property.

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+You cannot delete an Azure network connection when it's in use, as indicated by the **inUse** property.

+The following is an example of a request.

+The following is an example of the response.

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+```

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+```

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+POST /me/drive/items/{itemId}:/{fileName}:/createUploadSession

+ "sampleKeys": ["2003c52e-807a-4186-9b49-60c573095461","2be08d97-b140-4eec-8cbd-88238d571060"],

+GET https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions

+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions",

+ "status": "returned",

+ "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",

+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"

+ "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a",

+ "application": null,

+ "device": null,

+ "user": {

+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",

+ "displayName": null

+ }

+ },

+ "reassignedBy": {

+GET https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions?$expand=outcomes

+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions(outcomes())",

+ "returnedDateTime": "2022-04-13T05:11:50.756165Z",

+ "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",

+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"

+ "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a",

+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",

+ "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",

+GET https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions

+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions",

+ "status": "returned",

+ "returnedDateTime": "2022-04-13T05:11:50.756165Z",

+ "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",

+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"

+ "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a",

+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",

+ "submittedDateTime": "2022-04-13T05:10:00.4660243Z",

+ "returnedDateTime": "2022-04-13T05:12:14.6531582Z",

+ "reassignedDateTime": 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%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",

+ "userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1"

+ "id": "51cf5a99-d234-4e43-96de-cd65df14bfa1",

+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",

+ "id": null,

+>**Note:** The response object shown here might be shortened for readability.

+description: "Delete a feedback resource from a submission."

+Do not supply a request body for this method.

+Create a new [feedback resource](../resources/educationfeedbackresourceoutcome.md) for a submission. Only a teacher can perform this operation.

+## See also

+To upload an existing file, see [Upload feedback files for education submissions](/graph/education-upload-feedback-resource-overview).

+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

+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions/$entity",

+ "submittedDateTime": null,

+ "returnedDateTime": "2022-04-13T05:11:50.756165Z",

+ "reassignedDateTime": 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",

+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"

+ "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a",

+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",

+ "id": null,

+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

+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions/$entity",

+ "submittedDateTime": "2022-04-13T05:10:00.4660243Z",

+ "returnedDateTime": "2022-04-13T05:12:14.6531582Z",

+ "reassignedDateTime": "2022-04-13T05:12:14.6531582Z",

+ "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",

+ "userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1"

+ "id": "51cf5a99-d234-4e43-96de-cd65df14bfa1",

+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",

+ "id": null,

+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=*

+ "@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",

+ "submittedDateTime": "2022-10-24T21:03:53.3664034Z",

+ "returnedDateTime": "2022-10-24T21:04:42.7101616Z",

+ "reassignedDateTime": 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%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",

+ "userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1"

+ "id": "51cf5a99-d234-4e43-96de-cd65df14bfa1",

+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",

+ "id": 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",

+ "lastModifiedDateTime": "2022-10-24T21:04:42.3073523Z",

+ "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

+ }

+ }

+ }

+ "lastModifiedDateTime": "2022-10-24T21:04:42.7101541Z",

+ "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

+ }

+ }

+ }

+ "lastModifiedDateTime": "2022-10-24T21:04:26.5833776Z",

+ "qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c",

+ "qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b",

+ "feedback": {

+ "content": "Needs improvement",

+ "contentType": "text"

+ }

+ "qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de",

+ "qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c",

+ "qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b",

+ "columnId": "0f9823a2-174c-4ce0-8f12-e298c291f29b"

+ "qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de",

+ "qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c",

+ "qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b",

+ "feedback": {

+ "content": "Needs improvement",

+ "contentType": "text"

+ }

+ "qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de",

+ "qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c",

+ "qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b",

+ "columnId": "0f9823a2-174c-4ce0-8f12-e298c291f29b"

+ "qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de",

+ "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",

+ "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",

+description: "Retrieve a list of educationOutcome objects."

+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).

+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.

+GET /education/classes/{classId}/assignments/{assignmentId}/submissions/{submissionId}/outcomes

+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

+ "submittedDateTime": "2022-10-19T23:32:49.3314767Z",

+ "unsubmittedDateTime": null,

+ "returnedDateTime": "2022-10-19T23:32:58.1079737Z",

+ "reassignedDateTime": "2022-10-19T23:32:58.1079737Z",

+ "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",

+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"

+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",

+ "id": null,

+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",

+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",

+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

+ "submittedDateTime": "2022-10-19T23:34:34.5246354Z",

+ "unsubmittedDateTime": null,

+ "reassignedDateTime": "2022-10-19T23:35:07.2786612Z",

+ "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",

+ "userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1"

+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",

+ "id": null,

+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",

+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

+ "submittedDateTime": null,

+ "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",

+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"

+ "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a",

+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",

+ "displayName": null

+ }

+ },

+ "reassignedBy": {

+ "application": null,

+ "device": null,

+ "user": {

+ "id": null,

+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

+ "submittedDateTime": "2022-10-19T23:02:20.4995757Z",

+ "unsubmittedDateTime": null,

+ "returnedDateTime": "2022-04-13T05:12:14.6531582Z",

+ "reassignedDateTime": 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%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",

+ "userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1"

+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",

+ "id": null,

+ "application": null,

+ "device": null,

+ "user": {

+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",

+ "displayName": null

+ }

+ },

+ "reassignedBy": {

+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

+ "unsubmittedDateTime": "2022-10-19T23:14:41.2934772Z",

+ "returnedDateTime": "2022-04-13T02:09:15.7223872Z",

+ "reassignedDateTime": 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%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",

+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"

+ "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a",

+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",

+ "application": null,

+ "device": null,

+ "user": {

+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",

+ "displayName": null

+ }

+ },

+ "reassignedBy": {

+description: "Create a request for a new school data synchronization profile in the tenant."

+If successful, this method returns a `202 Accepted` response code and an [educationSynchronizationProfile](../resources/educationsynchronizationprofile.md) object in the response body.

+### Request

+ "@odata.type": "#microsoft.graph.educationCsvDataProvider",

+ "@odata.type": "#microsoft.graph.educationIdentityCreationConfiguration",

+### Response

+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.

+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).

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+```

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+```

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+```

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+```

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+```

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+```

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+```

+ "@odata.type": "microsoft.graph.identityGovernance.userSummary"

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+```

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+```

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+```

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+```

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PowerShell](#tab/powershell)

+# [PHP](#tab/php)

+```

+ 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.

+# [HTTP](#tab/http)

+<!-- {

+ "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

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+### Response

+The following is an example of the response.

+<!-- {

+ "blockType": "response",

+ "truncated": true

+}

+-->

+``` http

+HTTP/1.1 204 No Content

+```

+ 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.

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "list_browsersitelist"

+}

+-->

+``` http

+GET https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+### 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"

+ }

+ ]

+}

+```

+ 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.

+# [HTTP](#tab/http)

+<!-- {

+ "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"

+}

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+### 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

+}

+```

+|identityVersion|String|The identity version. This property is being deprecated in 2211(November 2022)|

+|identityVersion|String|The identity version. This property is being deprecated in 2211(November 2022)|

+|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.|

+|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.|

+ 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

+}

+```

+ 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

+```

+ 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

+ }

+}

+```

+ 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

+ }

+ ]

+}

+```

+ 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

+}

+```

+|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`, `unknownFutureValue`.|

+|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`, `unknownFutureValue`.|

+|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`, `unknownFutureValue`.|

+|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`, `unknownFutureValue`.|

+|manifestHash|String|Hash of package metadata properties used to validate that the application matches the metadata in the source repository.|

+Content-length: 985

+ "manifestHash": "Manifest Hash value",

+Content-Length: 1157

+ "manifestHash": "Manifest Hash value",

+Content-Length: 1242

+ "manifestHash": "Manifest Hash value",

+Content-Length: 1322

+ "manifestHash": "Manifest Hash value",

+|manifestHash|String|Hash of package metadata properties used to validate that the application matches the metadata in the source repository.|

+Content-length: 985

+ "manifestHash": "Manifest Hash value",

+Content-Length: 1157

+ "manifestHash": "Manifest Hash value",

+|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`.|

+|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`.|

+|scopedToAllDevices|Boolean|Not yet documented|

+Content-length: 126

+ "scopedToAllDevices": true,

+|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`.|

+|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`.|

+|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`.|

+|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`.|

+POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assign

+|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`.|

+POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies

+Content-length: 809

+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",

+ "priority": 8

+Content-Length: 981

+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",

+ "priority": 8

+POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/createCopy

+Content-Length: 1050

+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",

+ "priority": 8

+DELETE https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}

+GET https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}

+Content-Length: 1050

+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",

+ "priority": 8

+GET https://graph.microsoft.com/beta/deviceManagement/configurationPolicies

+Content-Length: 1114

+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",

+ "priority": 8

+ 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

+```

+|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`.|

+PATCH https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}

+Content-length: 809

+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",

+ "priority": 8

+Content-Length: 981

+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",

+ "priority": 8

+|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`.|

+|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`.|

+|status|[comanagementEligibleType](../resources/intune-devices-comanagementeligibletype.md)|ComanagementEligibleStatus. Possible values are: `comanaged`, `eligible`, `eligibleButNotAzureAdJoined`, `needsOsUpdate`, `ineligible`, `scheduledForEnrollment`, `unknownFutureValue`.|

+|status|[comanagementEligibleType](../resources/intune-devices-comanagementeligibletype.md)|ComanagementEligibleStatus. Possible values are: `comanaged`, `eligible`, `eligibleButNotAzureAdJoined`, `needsOsUpdate`, `ineligible`, `scheduledForEnrollment`, `unknownFutureValue`.|

+|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`.|

+|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`.|

+|enrolledByUser|String|The User Principal Name (UPN) of the user that enrolled the device|

+Content-length: 526

+ "size": 1.3333333333333333,

+ "enrolledByUser": "Enrolled By User value"

+Content-Length: 575

+ "size": 1.3333333333333333,

+ "enrolledByUser": "Enrolled By User value"

+Content-Length: 616

+ "size": 1.3333333333333333,

+ "enrolledByUser": "Enrolled By User value"

+Content-Length: 652

+ "size": 1.3333333333333333,

+ "enrolledByUser": "Enrolled By User value"

+|enrolledByUser|String|The User Principal Name (UPN) of the user that enrolled the device|

+Content-length: 526

+ "size": 1.3333333333333333,

+ "enrolledByUser": "Enrolled By User value"

+Content-Length: 575

+ "size": 1.3333333333333333,

+ "enrolledByUser": "Enrolled By User value"

+Content-Length: 291

+ "scheduledForEnrollmentCount": 11,

+ 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"

+ ]

+ }

+}

+```

+Content-Length: 616

+ "size": 1.3333333333333333,

+ "enrolledByUser": "Enrolled By User value"

+ 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

+```

+|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.|

+|freeStorageSpaceInBytes|Int64|Free Storage in Bytes. Default value is 0. Read-only. 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.|

+|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.|

+|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.|

+|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.|

+|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`.|

+|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`.|

+POST https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsBaselines/{userExperienceAnalyticsBaselineId}/deviceBootPerformanceMetrics/metricValues

+DELETE https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsMetricHistory/{userExperienceAnalyticsMetricHistoryId}/userExperienceAnalyticsMetric

+GET https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsMetricHistory/{userExperienceAnalyticsMetricHistoryId}/userExperienceAnalyticsMetric

+GET https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsBaselines/{userExperienceAnalyticsBaselineId}/deviceBootPerformanceMetrics/metricValues

+PATCH https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsMetricHistory/{userExperienceAnalyticsMetricHistoryId}/userExperienceAnalyticsMetric

+|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)|

+|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)|

+|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)|

+|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)|

+|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)|

+|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)|

+|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)|

+|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)|

+|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)|

+|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)|

+|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)|

+|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)|

+|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.|

+|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.|

+|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)|

+|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|

+|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)|

+|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|

+|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)|

+|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)|

+|roleScopeTagIds|String collection|The list of scope tags for the configuration.|

+Content-length: 606

+ "supportedSettingsPercent": 8,

+ "roleScopeTagIds": [

+ "Role Scope Tag Ids value"

+ ]

+Content-Length: 778

+ "supportedSettingsPercent": 8,

+ "roleScopeTagIds": [

+ "Role Scope Tag Ids value"

+ ]

+Content-length: 506

+ "content": "Content value",

+ "roleScopeTagIds": [

+ "Role Scope Tag Ids value"

+ ]

+Content-Length: 831

+ "supportedSettingsPercent": 8,

+ "roleScopeTagIds": [

+ "Role Scope Tag Ids value"

+ ]

+Content-Length: 879

+ "supportedSettingsPercent": 8,

+ "roleScopeTagIds": [

+ "Role Scope Tag Ids value"

+ ]

+|roleScopeTagIds|String collection|The list of scope tags for the configuration.|

+Content-length: 606

+ "supportedSettingsPercent": 8,

+ "roleScopeTagIds": [

+ "Role Scope Tag Ids value"

+ ]

+Content-Length: 778

+ "supportedSettingsPercent": 8,

+ "roleScopeTagIds": [

+ "Role Scope Tag Ids value"

+ ]

+|roleScopeTagIds|String collection|The list of scope tags for the configuration.|

+Content-length: 279

+ "content": "Content value",

+ "roleScopeTagIds": [

+ "Role Scope Tag Ids value"

+ ]

+Content-Length: 451

+ "content": "Content value",

+ "roleScopeTagIds": [

+ "Role Scope Tag Ids value"

+ ]

+Content-Length: 490

+ "content": "Content value",

+ "roleScopeTagIds": [

+ "Role Scope Tag Ids value"

+ ]

+Content-Length: 524

+ "content": "Content value",

+ "roleScopeTagIds": [

+ "Role Scope Tag Ids value"

+ ]

+|roleScopeTagIds|String collection|The list of scope tags for the configuration.|

+Content-length: 279

+ "content": "Content value",

+ "roleScopeTagIds": [

+ "Role Scope Tag Ids value"

+ ]

+Content-Length: 451

+ "content": "Content value",

+ "roleScopeTagIds": [

+ "Role Scope Tag Ids value"

+ ]

+|minimumWarningSdkVersion|String|Versions less than the specified version will result in warning message on the managed app from accessing company data. (iOS only)|

+Content-length: 5858

+ "fingerprintAndBiometricEnabled": true,

+ "minimumWarningSdkVersion": "Minimum Warning Sdk Version value"

+Content-Length: 6030

+ "fingerprintAndBiometricEnabled": true,

+ "minimumWarningSdkVersion": "Minimum Warning Sdk Version value"

+Content-Length: 6313

+ "fingerprintAndBiometricEnabled": true,

+ "minimumWarningSdkVersion": "Minimum Warning Sdk Version value"

+Content-Length: 6591

+ "fingerprintAndBiometricEnabled": true,

+ "minimumWarningSdkVersion": "Minimum Warning Sdk Version value"

+|minimumWarningSdkVersion|String|Versions less than the specified version will result in warning message on the managed app from accessing company data. (iOS only)|

+Content-length: 5858

+ "fingerprintAndBiometricEnabled": true,

+ "minimumWarningSdkVersion": "Minimum Warning Sdk Version value"

+Content-Length: 6030

+ "fingerprintAndBiometricEnabled": true,

+ "minimumWarningSdkVersion": "Minimum Warning Sdk Version value"

+ 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="

+}

+```

+ 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

+```

+|installQualityUpdates|Boolean|Allows quality updates installation during OOBE|

+Content-length: 873

+ "installQualityUpdates": true,

+Content-Length: 1045

+ "installQualityUpdates": true,

+Content-Length: 1116

+ "installQualityUpdates": true,

+Content-Length: 1182

+ "installQualityUpdates": true,

+|installQualityUpdates|Boolean|Allows quality updates installation during OOBE|

+Content-length: 873

+ "installQualityUpdates": true,

+Content-Length: 1045

+ "installQualityUpdates": true,

+ "runSchedule": {

+ "@odata.type": "microsoft.graph.runSchedule"

+ },

+ "runSchedule": {

+ "@odata.type": "microsoft.graph.runSchedule"

+ },

+ "runSchedule": {

+ "@odata.type": "microsoft.graph.runSchedule"

+ },

+|showConfigurationManagerApps|Boolean|Boolean that indicates if Configuration Manager Apps will be shown in Company Portal|

+Content-length: 2016

+ "showConfigurationManagerApps": true,

+Content-Length: 2188

+ "showConfigurationManagerApps": true,

+Content-Length: 2327

+ "showConfigurationManagerApps": true,

+Content-Length: 2461

+ "showConfigurationManagerApps": true,

+|showConfigurationManagerApps|Boolean|Boolean that indicates if Configuration Manager Apps will be shown in Company Portal|

+Content-length: 2016

+ "showConfigurationManagerApps": true,

+Content-Length: 2188

+ "showConfigurationManagerApps": true,

+|duration|Duration|The duration of the learning content in seconds. The value is represented in ISO 8601 format for durations. Optional.|

+ "createdDateTime": "2018-01-01T00:00:00Z",

+ "contributors": ["Scott Simpson"],

+|Application | Directory.Read.All, DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All |

+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

+<!-- {

+ "isCollection": true

+} -->

+ "defaultUsageLocation": "String",

+ "defaultUsageLocation": "String",

+description: "Create a new plannerBucket object."

+Create a new [plannerBucket](../resources/plannerbucket.md) object.

+In the request body, supply a JSON representation of the [plannerBucket](../resources/plannerbucket.md) object.

+If successful, this method returns `201 Created` response code and a [plannerBucket](../resources/plannerbucket.md) object in the response body.

+### Request

+The following is an example of the request.

+### Response

+The following is an example of the response.

+>**Note:** The response object shown here might be shortened for readability.

+description: "Retrieve a list of plannerTask objects associated to a plannerBucket object."

+Retrieve a list of [plannerTask](../resources/plannertask.md) objects associated to a [plannerBucket](../resources/plannerbucket.md) object.

+If successful, this method returns a `200 OK` response code and a collection of [plannerTask](../resources/plannertask.md) objects in the response body.

+### Request

+The following is an example of the request.

+### Response

+The following is an example of the response.

+>**Note:** The response object shown here might be shortened for readability.

+description: "Retrieve the properties and relationships of plannerTask object."

+Retrieve the properties and relationships of [plannerTask](../resources/plannertask.md) object.

+If successful, this method returns a `200 OK` response code and a [plannerTask](../resources/plannertask.md) object in the response body.

+### Request

+The following is an example of the request.

+### Response

+The following is an example of the response.

+>**Note:** The response object shown here might be shortened for readability.

+* Among session-level states: DoNotDisturb > Busy > Available > 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. |

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [HTTP](#tab/http)

+# [JavaScript](#tab/javascript)

+# [HTTP](#tab/http)

+# [JavaScript](#tab/javascript)

+In the request body, provide a JSON object for the parameter, `Query`.

+|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).|

+# [HTTP](#tab/http)

+ "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)

+```

+>**Note:** This API has a [known issue](/graph/known-issues#sites-and-lists-sharepoint) and might return incorrect results.

+# [PowerShell](#tab/powershell)

+# [PowerShell](#tab/powershell)

+|recipient|[teamworkNotificationRecipient](../resources/teamworknotificationrecipient.md)|Recipient of the notification. For more details, see [aadUserNotificationRecipient](../resources/aadusernotificationrecipient.md), [channelMembersNotificationRecipient](../resources/channelmembersnotificationrecipient.md), and [teamMembersNotificationRecipient](../resources/teammembersnotificationrecipient.md). |

+The following example shows how you can send an activity feed notification to all team members. This example is similar to previous examples. However, in this case, the **recipient** is a [teamMembersNotificationRecipient](../resources/teammembersnotificationrecipient.md). Note that the **teamId** specified in the **recipient** must match the **teamId** specified in the request URL.

+The following example shows the request.

+The following example shows the response.

+The following example shows how you can send an activity feed notification to all channel members. This example is similar to the previous example. However, in this case, the **recipient** is a [channelMembersNotificationRecipient](../resources/channelmembersnotificationrecipient.md). Note that the **teamId** specified in the **recipient** must match the **teamId** specified in the request URL.

+The following example shows the request.

+ "name": "team_sendactivitynotification_6"

+The following example shows the response.

+ 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 |

+### 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:

+<!-- {

+ "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

+# [HTTP](#tab/http)

+<!-- {

+ "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')

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+#### 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

+# [HTTP](#tab/http)

+<!-- {

+ "blockType": "request",

+ "name": "unifiedroledefinition_assignedprincipals_allscopes"

+}

+-->

+``` http

+GET https://graph.microsoft.com/beta/roleManagement/directory/roleDefinitions/644ef478-e28f-4e28-b9dc-3fdde9aa0b1f/assignedPrincipals

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+#### 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

+# [HTTP](#tab/http)

+<!-- {

+ "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

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+#### 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

+# [HTTP](#tab/http)

+<!-- {

+ "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

+```

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+#### 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"

+ }

+ ]

+}

+```

+This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response.

+|$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).|

+>

+>This API doesn't revoke sign-in sessions for external users, because external users sign in through their home tenant.

+# [HTTP](#tab/http)

+# [C#](#tab/csharp)

+# [JavaScript](#tab/javascript)

+# [Java](#tab/java)

+# [Go](#tab/go)

+# [PHP](#tab/php)

+| [moveToCatalog](../api/accesspackage-movetocatalog.md) | None | Move an access package to a different catalog.|

+| edge | [edge](edge.md) | A container for Microsoft Edge resources. Read-only. |

+|deviceId|String|The unique identifier of the device used for accepting the agreement. Supports `$filter` (`eq`) and `eq` for `null` values.|

+|deviceOSVersion|String|The operating system version of the device used for accepting the agreement.|

+|expirationDateTime|DateTimeOffset|The expiration date time of the acceptance. 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`. Supports `$filter` (`eq`, `ge`, `le`) and `eq` for `null` values.|

+|id|String| The identifier of the agreement acceptance. Read-only. Supports `$filter` (`eq`).|

+|recordedDateTime|DateTimeOffset|The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Supports `$filter` (`eq`) and `eq` for `null` values.|

+|userId|String|ID of the user who accepted the agreement. Supports `$filter` (`eq`).|

+| servicePrincipalLockConfiguration | [servicePrincipalLockConfiguration](servicePrincipalLockConfiguration.md) | Specifies whether sensitive properties of a multi-tenant application should be locked for editing after the application is provisioned in a tenant. Nullable. `null` by default. |

+ "servicePrincipalLockConfiguration": {"@odata.type": "microsoft.graph.servicePrincipalLockConfiguration"},

+## See also

+ 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).

+ 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"