Updates from: 12/02/2022 03:19:06
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Accesspackage Movetocatalog https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackage-movetocatalog.md
+
+ Title: "accessPackage: moveToCatalog"
+description: "Allows callers to move an access package from one catalog to the another."
+
+ms.localizationpriority: medium
++
+# accessPackage: moveToCatalog
+Namespace: microsoft.graph
++
+In [Azure AD entitlement management](../resources/entitlementmanagement-overview.md), this action moves the [accessPackage](../resources/accesspackage.md) to a specified target [accessPackageCatalog](../resources/accesspackagecatalog.md). The resources in the access package must be present in the target catalog.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)| EntitlementManagement.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|EntitlementManagement.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /identityGovernance/entitlementManagement/accessPackages/{accessPackageId}/moveToCatalog
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply a JSON representation of the parameters.
+
+The following table shows the parameters that can be used with this action.
+
+|Parameter|Type|Description|
+|:|:|:|
+|catalogId|String|ID of the catalog to which the access package will be moved.|
+++
+## Response
+
+If successful, this action returns a `200 OK` response code.
+
+## Examples
+
+### Request
+The following is an example of a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "accesspackagethis.movetocatalog"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackages/3089f957-4bfe-405d-96c0-9a7ef30c01d6/moveToCatalog
+Content-Type: application/json
+
+{
+ "catalogId": "3301434b-99bd-46be-923b-d762c30c8e8b"
+}
+```
+
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
+++++
+### Response
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 200 OK
+```
+
v1.0 Accesspackage Post Incompatiblegroup https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackage-post-incompatiblegroup.md
If successful, this method returns a `204 No Content` response code. It does not
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "add_incompatiblegroup_to_accesspackage"
Content-type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response.
v1.0 Accessreviewset Post Historydefinitions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewset-post-historydefinitions.md
The following table shows the required properties used to create an [accessRevie
|reviewHistoryPeriodStartDateTime | DateTimeOffset | A timestamp. Reviews starting on or after this date will be included in the fetched history data. Only required if **scheduleSettings** is not defined. | |reviewHistoryPeriodEndDateTime | DateTimeOffset | A timestamp. Reviews starting on or before this date will be included in the fetched history data. Only required if **scheduleSettings** is not defined. | |scopes|[accessReviewQueryScope](../resources/accessreviewqueryscope.md) collection| Used to filter which reviews are included in the fetched history data. Fetches reviews whose scope matches with this provided scope. Required. <br> For more, see [Supported scope queries for accessReviewHistoryDefinition](#supported-scope-queries-for-accessreviewhistorydefinition). |
-| scheduleSettings |[accessReviewHistoryScheduleSettings](../resources/accessReviewHistoryScheduleSettings.md)| The settings for a recurring access review history definition series. Only required if **reviewHistoryPeriodStartDateTime** or **reviewHistoryPeriodEndDateTime** are not defined. Not supported yet.|
+| scheduleSettings |[accessReviewHistoryScheduleSettings](../resources/accessReviewHistoryScheduleSettings.md)| **Not supported yet.** The settings for a recurring access review history definition series. Only required if **reviewHistoryPeriodStartDateTime** or **reviewHistoryPeriodEndDateTime** are not defined. |
### Supported scope queries for accessReviewHistoryDefinition
Content-Type: application/json
"notReviewed", "notNotified" ],
- "scheduleSettings": {
- "reportRange": "P1M",
- "recurrence": {
- "pattern": {
- "type": "monthly",
- "interval": 1
- },
- "range": {
- "type": "noEnd",
- "startDate": "2018-08-03T21:02:30.667Z",
- "count": 0
- }
- }
- },
+ "reviewHistoryPeriodStartDateTime": "2021-01-01T00:00:00Z",
+ "reviewHistoryPeriodEndDateTime": "2021-04-30T23:59:59Z",
"scopes": [ { "@odata.type": "#microsoft.graph.accessReviewQueryScope",
Content-Type: application/json
} ```
+# [C#](#tab/csharp)
+ # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/create-accessreviewhistorydefinition-from--javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-accessreviewhistorydefinition-from--powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PHP](#tab/php)
+ ### Response
Content-Type: application/json
"@odata.type": "#microsoft.graph.accessReviewHistoryDefinition", "id": "b2cb022f-b7e1-40f3-9854-c65a40861c38", "displayName": "Last quarter's group reviews April 2021",
- "scheduleSettings": {
- "reportRange": "P1M",
- "recurrence": {
- "pattern": {
- "type": "monthly",
- "interval": 1
- },
- "range": {
- "type": "noEnd",
- "startDate": "2018-08-03T21:02:30.667Z",
- "count": 0
- }
- }
- },
+ "reviewHistoryPeriodStartDateTime": "2021-01-01T00:00:00Z",
+ "reviewHistoryPeriodEndDateTime": "2021-04-30T23:59:59Z",
"decisions": [ "approve", "deny",
v1.0 Administrativeunit Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/administrativeunit-delta.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) | AdministrativeUnit.Read.All, Directory.Read.All, AdministrativeUnit.ReadWrite.All, Directory.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |
-|administrativeunit | AdministrativeUnit.Read.All, Directory.Read.All, AdministrativeUnit.ReadWrite.All, Directory.ReadWrite.All |
+|Application | AdministrativeUnit.Read.All, Directory.Read.All, AdministrativeUnit.ReadWrite.All, Directory.ReadWrite.All |
## HTTP request
GET /administrativeUnits/delta
## Query parameters
-Tracking changes incurs a round of one or more **delta** function calls. If you use any query parameter
-(other than `$deltatoken` and `$skiptoken`), you must specify
-it in the initial **delta** request. Microsoft Graph automatically encodes any specified parameters
-into the token portion of the `@odata.nextLink` or `@odata.deltaLink` URL provided in the response.
-You only need to specify any query parameters once up front.
-In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL from the previous response. That URL already
+Tracking changes incurs a round of one or more **delta** function calls. If you use any query parameter
+(other than `$deltatoken` and `$skiptoken`), you must specify
+it in the initial **delta** request. Microsoft Graph automatically encodes any specified parameters
+into the token portion of the `@odata.nextLink` or `@odata.deltaLink` URL provided in the response.
+You only need to specify any query parameters once up front.
+In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL from the previous response. That URL already
includes the encoded parameters. | Query parameter | Type |Description|
includes the encoded parameters.
This method supports the following OData query parameters to help customize the response: -- You can use a `$select` query parameter as in any GET request to specify only the properties your need for best performance. The
-**id** property is always returned.
+- You can use a `$select` query parameter as in any GET request to specify only the properties your need for best performance. The
+**id** property is always returned.
- There is limited support for `$filter`: * The only supported `$filter` expression is for tracking changes for specific resources, by their ID: `$filter=id+eq+{value}` or `$filter=id+eq+{value1}+or+id+eq+{value2}`. The number of IDs you can specify is limited by the maximum URL length.
Do not supply a request body for this method.
## Response
-If successful, this method returns `200 OK` response code and an [administrativeUnit](../resources/administrativeunit.md) collection object in the response body. The response also includes a `@odata.nextLink` URL or a `@odata.deltaLink` URL.
+If successful, this method returns `200 OK` response code and an [administrativeUnit](../resources/administrativeunit.md) collection object in the response body. The response also includes a `@odata.nextLink` URL or a `@odata.deltaLink` URL.
- If a `@odata.nextLink` URL is returned, there are additional pages of data to be retrieved in the session. The **administrativeUnit** continues making requests using the `@odata.nextLink` URL until a `@odata.deltaLink` URL is included in the response.
GET https://graph.microsoft.com/beta/administrativeUnits/delta
### Response >**Note:** The response object shown here might be shortened for readability.
-<!-- {
+<!-- {
"blockType": "response", "truncated": true, "@odata.type": "microsoft.graph.administrativeUnit",
- "isCollection": true
-} -->
+ "isCollection": true
+} -->
```http HTTP/1.1 200 OK Content-type: application/json
v1.0 Agreement List Acceptances https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/agreement-list-acceptances.md
GET /identityGovernance/termsOfUse/agreements/{agreementsId}/acceptances
``` ## Optional query parameters
-This method the `$select` and `$filter` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+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).
## Request headers |Name|Description|
v1.0 Appcatalogs List Teamsapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/appcatalogs-list-teamsapps.md
GET https://graph.microsoft.com/beta/appCatalogs/teamsApps?$expand=appDefinitio
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php)
v1.0 Appconsentrequest Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/appconsentrequest-filterByCurrentUser.md
GET https://graph.microsoft.com/beta/identityGovernance/appConsent/appConsentReq
[!INCLUDE [sample-code](../includes/snippets/go/appconsentrequest-filterbycurrentuser-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
- # [PHP](#tab/php) [!INCLUDE [sample-code](../includes/snippets/php/appconsentrequest-filterbycurrentuser-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Application Addkey https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-addkey.md
Applications that donΓÇÖt have any existing valid certificates (no certificates
## HTTP request
+You can address the application using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal.
<!-- { "blockType": "ignored" } -->- ```http POST /applications/{id}/addKey
+POST /applications(appId='{appId}')/addKey
``` ## Request headers
v1.0 Application Addpassword https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-addpassword.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request
+You can address the application using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal.
<!-- { "blockType": "ignored" } -->- ```http POST /applications/{id}/addPassword
+POST /applications(appId='{appId}')/addPassword
``` ## Request headers
v1.0 Application Delete Owners https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-delete-owners.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Remove an owner from an [application](../resources/application.md).
+Remove an owner from an [application](../resources/application.md). As a recommended best practice, apps should have at least two owners.
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
One of the following permissions is required to call this API. To learn more, in
|Application | Application.ReadWrite.OwnedBy, Application.ReadWrite.All, Directory.ReadWrite.All | ## HTTP request+
+You can address the application using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal.
<!-- { "blockType": "ignored" } --> ```http DELETE /applications/{id}/owners/{id}/$ref
+DELETE /applications(appId='{appId}')/owners/{id}/$ref
```+ > [!CAUTION] > If `/$ref` is not appended to the request and the calling app has permissions to manage the user who is the app owner, the user will also be deleted from Azure Active Directory (Azure AD); otherwise, a `403 Forbidden` error is returned. You can restore deleted users through the [Restore deleted items API](directory-deleteditems-restore.md).
v1.0 Application Delete Tokenlifetimepolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-delete-tokenlifetimepolicies.md
One of the following sets of permissions is required to call this API. To learn
## HTTP request
-<!-- { "blockType": "ignored" } -->
+Token lifetime policies can be assigned to both applications and service principals.
+
+You can address the application using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal.
+<!-- { "blockType": "ignored" } -->
```http
-DELETE /applications/{id}/tokenLifetimePolicies/{id}/$ref
-DELETE /servicePrincipals/{id}/tokenLifetimePolicies/{id}$ref
+DELETE /applications/{id}/tokenLifetimePolicies/$ref
+
+DELETE /applications(appId='{appId}')/tokenLifetimePolicies/$ref
+
+DELETE /servicePrincipals/{id}/tokenLifetimePolicies/$ref
+
+DELETE /servicePrincipals(appId='{appId}')/tokenLifetimePolicies/$ref
``` ## Request headers
v1.0 Application Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-delete.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | Application.ReadWrite.All, Directory.ReadWrite.All |
+|Delegated (work or school account) | Application.ReadWrite.All |
|Delegated (personal Microsoft account) | Application.ReadWrite.All |
-|Application | Application.ReadWrite.OwnedBy, Application.ReadWrite.All, Directory.ReadWrite.All |
+|Application | Application.ReadWrite.OwnedBy, Application.ReadWrite.All|
## HTTP request
-Replace `{applicationObjectId}` with the **id** for the application object, also referred to as the **Object ID** in the Azure portal.
+
+You can address the application using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal. Replace `{applicationObjectId}` with the **id** for the application object.
+ <!-- { "blockType": "ignored" } --> ```http DELETE /applications/{applicationObjectId}
+DELETE /applications(appId='{appId}')
``` ## Request headers
v1.0 Application Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-delta.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Application.Read.All, Directory.Read.All, Application.ReadWrite.OwnedBy, Application.ReadWrite.All, Directory.ReadWrite.All | + ## HTTP request To begin tracking changes, you make a request including the delta function on the application resource.
v1.0 Application Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-get.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Application.Read.All, Application.ReadWrite.All | |Application | Application.Read.All, Directory.Read.All, Application.ReadWrite.OwnedBy, Application.ReadWrite.All, Directory.ReadWrite.All | + ## HTTP request
-Replace `{applicationObjectId}` with the **id** for the application object, also referred to as the **Object ID** in the Azure portal.
+
+You can address the application using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal. Replace `{applicationObjectId}` with the **id** for the application object.
+ <!-- { "blockType": "ignored" } --> ```http GET /applications/{applicationObjectId}
+GET /applications(appId='{appId}')
```+ ## Optional query parameters This method supports the `$select` [OData query parameter](/graph/query-parameters) to retrieve specific application properties.
v1.0 Application List Extensionproperty https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-list-extensionproperty.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) | Application.Read.All, Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All| |Delegated (personal Microsoft account) | Application.Read.All, Application.ReadWrite.All |
-|Application | Application.Read.All, Application.ReadWrite.OwnedBy, Application.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
+|Application | Application.Read.All, Application.ReadWrite.OwnedBy, Application.ReadWrite.All, Directory.ReadWrite.All |
+ ## HTTP request
v1.0 Application List Federatedidentitycredentials https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-list-federatedidentitycredentials.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Application.ReadWrite.All | |Application | Application.Read.All, Application.ReadWrite.OwnedBy, Application.ReadWrite.All | ## HTTP request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
+You can address the application using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal.
+<!-- { "blockType": "ignored" } -->
+```http
GET /applications/{id}/federatedIdentityCredentials
+GET /applications(appId='{appId}')/federatedIdentityCredentials
``` ## Optional query parameters
v1.0 Application List Owners https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-list-owners.md
One of the following permissions is required to call this API. To learn more, in
[!INCLUDE [limited-info](../../includes/limited-info.md)] + ## HTTP request+
+You can address the application using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal.
<!-- { "blockType": "ignored" } --> ```http GET /applications/{id}/owners
+GET /applications(appId='{appId}')/owners
```+ ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
v1.0 Application List Tokenissuancepolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-list-tokenissuancepolicies.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request
+You can address the application using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal.
<!-- { "blockType": "ignored" } -->- ```http GET /applications/{id}/tokenIssuancePolicies
+GET /applications(appId='{appId}')/tokenIssuancePolicies
``` ## Request headers
v1.0 Application List Tokenlifetimepolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-list-tokenlifetimepolicies.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request
-<!-- { "blockType": "ignored" } -->
+Token lifetime policies can be assigned to both applications and service principals.
+
+You can address the application using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal.
+<!-- { "blockType": "ignored" } -->
```http GET /applications/{id}/tokenLifetimePolicies+
+GET /applications(appId='{appId}')/tokenLifetimePolicies
+ GET /servicePrincipals/{id}/tokenLifetimePolicies+
+GET /servicePrincipals(appId='{appId}')/tokenLifetimePolicies
``` ## Request headers
v1.0 Application List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-list.md
Namespace: microsoft.graph
Get the list of [applications](../resources/application.md) in this organization. > [!NOTE]
-> When calling this API using tokens issued for a personal Microsoft account, it will return the apps owned by the personal Microsoft account. The notion of organizations doesn't exist for personal Microsoft accounts. In order to list applications owned by specific personal Microsoft accounts, this API requires User.Read permission in addition to Application.Read.All or Application.ReadWrite.All.
+> When calling this API using tokens issued for a personal Microsoft account, it will return the apps owned by the personal Microsoft account. The notion of organizations doesn't exist for personal Microsoft accounts. To list applications owned by a specific personal Microsoft account, this API requires the *User.Read* permission in addition to *Application.Read.All* or *Application.ReadWrite.All*.
## Permissions
One of the following permissions is required to call this API. To learn more, in
| Delegated (personal Microsoft account) | Application.Read.All and User.Read, Application.ReadWrite.All and User.Read | | Application | Application.Read.All, Application.ReadWrite.OwnedBy, Application.ReadWrite.All, Directory.Read.All | + ## HTTP request <!-- { "blockType": "ignored" } -->
Content-type: application/json
] } ```+
+### Example 5: Get applications with less than two owners
+
+#### Request
+
+Here is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$count` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
+
+>**Note:** The `$count` and `$search` query parameters are currently not available in Azure AD B2C tenants.
+
+<!-- {
+ "blockType": "request",
+ "name": "list_application_lessthan2owners"
+}-->
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/applications?$filter=owners/$count eq 0 or owners/$count eq 1&$count=true&$select=id,displayName
+ConsistencyLevel: eventual
+```
+
+#### Response
+
+Here 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.application",
+ "isCollection": true
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#applications(id,displayName)",
+ "@odata.count": 3,
+ "value": [
+ {
+ "id": "89e9e6c6-a7de-4ac0-8eed-12bd867d8f27",
+ "displayName": "Box"
+ },
+ {
+ "id": "c6cb7240-c684-4e24-93f5-eb29d0d9f43b",
+ "displayName": "LinkedIn"
+ },
+ {
+ "id": "d7151835-284e-4416-adc6-96fef8a77690",
+ "displayName": "BrowserStack"
+ }
+ ]
+}
+```
+ <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!--
v1.0 Application Post Applications https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-post-applications.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | Application.ReadWrite.All, Directory.ReadWrite.All |
+|Delegated (work or school account) | Application.ReadWrite.All |
|Delegated (personal Microsoft account) | Application.ReadWrite.All |
-|Application | Application.ReadWrite.OwnedBy, Application.ReadWrite.All, Directory.ReadWrite.All |
+|Application | Application.ReadWrite.OwnedBy, Application.ReadWrite.All |
## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Application Post Federatedidentitycredentials https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-post-federatedidentitycredentials.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
+You can address the application using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal.
+<!-- { "blockType": "ignored" } -->
+```http
POST /applications/{id}/federatedIdentityCredentials
+POST /applications(appId='{appId}')/federatedIdentityCredentials
``` ## Request headers
v1.0 Application Post Onlinemeetings https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-post-onlinemeetings.md
In the request body, supply a JSON representation of an [onlineMeeting](../resou
> [!CAUTION] >
-> Assigning the `presenter` or `coorganizer` role to users who are not registered in Azure Active Directory is not currently supported. For details, see [Known issues](/graph/known-issues#presenter-role-cannot-be-assigned-to-non-azure-ad-participants) for more details.
+> Assigning the `presenter` or `coorganizer` role to users who are not registered in Azure Active Directory is not currently supported.
## Response If successful, this method returns a `201 Created` response code and an [onlineMeeting](../resources/onlinemeeting.md) object in the response body.
v1.0 Application Post Owners https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-post-owners.md
One of the following permissions is required to call this API. To learn more, in
|Application | Application.ReadWrite.OwnedBy and Directory.Read.All, Application.ReadWrite.All and Directory.Read.All, Directory.ReadWrite.All | ## HTTP request+
+You can address the application using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal.
<!-- { "blockType": "ignored" } --> ```http POST /applications/{id}/owners/$ref-
+POST /applications(appId='{appId}')/owners/$ref
```+ ## Request headers | Name | Description| |:- |:- |
v1.0 Application Post Tokenissuancepolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-post-tokenissuancepolicies.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request
+You can address the application using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal.
<!-- { "blockType": "ignored" } -->- ```http POST /applications/{id}/tokenIssuancePolicies/$ref
+POST /applications(appId='{appId}')/tokenIssuancePolicies/$ref
``` ## Request headers
v1.0 Application Post Tokenlifetimepolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-post-tokenlifetimepolicies.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request
-<!-- { "blockType": "ignored" } -->
+Token lifetime policies can be assigned to both applications and service principals.
+
+You can address the application using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal.
+<!-- { "blockType": "ignored" } -->
```http POST /applications/{id}/tokenLifetimePolicies/$ref+
+POST /applications(appId='{appId}')/tokenLifetimePolicies/$ref
+ POST /servicePrincipals/{id}/tokenLifetimePolicies/$ref+
+POST /servicePrincipals(appId='{appId}')/tokenLifetimePolicies/$ref
``` ## Request headers
v1.0 Application Removekey https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-removekey.md
As part of the request validation for this method, a proof of possession of an e
## HTTP request
+You can address the application using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal.
<!-- { "blockType": "ignored" } -->- ```http POST /applications/{id}/removeKey
+POST /applications(appId='{appId}')/removeKey
``` ## Request headers
v1.0 Application Removepassword https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-removepassword.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request
+You can address the application using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal.
<!-- { "blockType": "ignored" } -->- ```http POST /applications/{id}/removePassword
+POST /applications(appId='{appId}')/removePassword
``` ## Request headers
v1.0 Application Setverifiedpublisher https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-setverifiedpublisher.md
Set the the [verifiedPublisher](../resources/verifiedPublisher.md) on an [applic
## HTTP request
+You can address the application using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal.
<!-- { "blockType": "ignored" } -->- ```http POST /applications/{id}/setVerifiedPublisher
+POST /applications(appId='{appId}')/setVerifiedPublisher
``` ## Request headers
v1.0 Application Unsetverifiedpublisher https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-unsetverifiedpublisher.md
Unset the the [verifiedPublisher](../resources/verifiedPublisher.md) previously
## HTTP request
+You can address the application using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal.
<!-- { "blockType": "ignored" } -->- ```http POST /applications/{id}/unsetVerifiedPublisher
+POST /applications(appId='{appId}')/unsetVerifiedPublisher
``` ## Request headers
v1.0 Application Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-update.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | Application.ReadWrite.All, Directory.ReadWrite.All |
+|Delegated (work or school account) | Application.ReadWrite.All |
|Delegated (personal Microsoft account) | Application.ReadWrite.All |
-|Application | Application.ReadWrite.OwnedBy, Application.ReadWrite.All, Directory.ReadWrite.All |
+|Application | Application.ReadWrite.OwnedBy, Application.ReadWrite.All |
## HTTP request
-Replace `{applicationObjectId}` with the **id** for the application object, also referred to as the **Object ID** in the Azure portal.
+
+You can address the application using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal. Replace `{applicationObjectId}` with the **id** for the application object.
+ <!-- { "blockType": "ignored" } --> ```http PATCH /applications/{applicationObjectId}
+PATCH /applications(appId='{appId}')
```+
+To update the logo, use the PUT method as follows.
+<!-- { "blockType": "ignored" } -->
+```http
+PUT /applications/{applicationObjectId}/logo
+PUT /applications(appId='{appId}')/logo
+```
+ ## Request headers | Name | Description| |:--|:-|
In the request body, supply the values for relevant fields that should be update
| info | [informationalUrl](../resources/informationalurl.md) | Basic profile information of the application such as app's marketing, support, terms of service, and privacy statement URLs. The terms of service and privacy statement are surfaced to users through the user consent experience. For more information, see [Add Terms of service and privacy statement for registered Azure AD apps](/azure/active-directory/develop/howto-add-terms-of-service-privacy-statement). | | isFallbackPublicClient | Boolean | Specifies the fallback application type as public client, such as an installed application running on a mobile device. The default value is `false`, which means the fallback application type is confidential client such as web app. There are certain scenarios where Azure AD cannot determine the client application type (for example, [ROPC](https://tools.ietf.org/html/rfc6749#section-4.3) flow where it is configured without specifying a redirect URI). In those cases, Azure AD will interpret the application type based on the value of this property. | | keyCredentials | [keyCredential](../resources/keycredential.md) collection | The collection of key credentials associated with the application. Not nullable. |
-| logo | Stream | The main logo for the application. Not nullable. |
+| logo | Stream | The main logo for the application. Not nullable. Use the PUT method to update the logo. |
| onPremisesPublishing | [onPremisesPublishing](../resources/onpremisespublishing.md) | Represents the set of properties for configuring [Azure AD Application Proxy](/azure/active-directory/app-proxy/what-is-application-proxy) for an on-premises application. This property can only be set after the application has been created and cannot be updated in the same request as other application properties. | | optionalClaims | optionalClaims | Application developers can configure optional claims in their Azure AD apps to specify which claims they want in tokens sent to their application by the Microsoft security token service. See [optional claims](/azure/active-directory/develop/active-directory-optional-claims) for more information. | | parentalControlSettings | [parentalControlSettings](../resources/parentalcontrolsettings.md) | Specifies parental control settings for an application. | | publicClient | [publicClientApplication](../resources/publicclientapplication.md) | Specifies settings for installed clients such as desktop or mobile devices. | | requiredResourceAccess | [requiredResourceAccess](../resources/requiredresourceaccess.md) collection | Specifies the resources that the application needs to access. This property also specifies the set of delegated permissions and application roles that it needs for each of those resources. This configuration of access to the required resources drives the consent experience. No more than 50 resource services (APIs) can be configured. Beginning mid-October 2021, the total number of required permissions must not exceed 400. Not nullable. | | samlMetadataUrl | String | The URL where the service exposes SAML metadata for federation. This property is valid only for single-tenant applications. |
-| signInAudience | String | Specifies what Microsoft accounts are supported for the current application. Supported values are:<ul><li>`AzureADMyOrg`: Users with a Microsoft work or school account in my organizationΓÇÖs Azure AD tenant (i.e. single tenant)</li><li>`AzureADMultipleOrgs`: Users with a Microsoft work or school account in any organizationΓÇÖs Azure AD tenant (i.e. multi-tenant)</li> <li>`AzureADandPersonalMicrosoftAccount`: Users with a personal Microsoft account, or a work or school account in any organizationΓÇÖs Azure AD tenant</li></ul> |
+| signInAudience | String | Specifies what Microsoft accounts are supported for the current application. Supported values are:<ul><li>`AzureADMyOrg`: Users with a Microsoft work or school account in my organizationΓÇÖs Azure AD tenant (i.e. single tenant)</li><li>`AzureADMultipleOrgs`: Users with a Microsoft work or school account in any organizationΓÇÖs Azure AD tenant (i.e. multi-tenant)</li> <li>`AzureADandPersonalMicrosoftAccount`: Users with a personal Microsoft account, or a work or school account in any organizationΓÇÖs Azure AD tenant</li></ul> <br/>The value for this property has implications on other app object properties. As a result, if you change this property, you may need to change other properties first. For more information, see [Validation differences for signInAudience](/azure/active-directory/develop/supported-accounts-validation?context=graph/context). |
| spa | [spaApplication](../resources/spaapplication.md) | Specifies settings for a single-page application, including sign out URLs and redirect URIs for authorization codes and access tokens. | | tags | String collection | Custom strings that can be used to categorize and identify the application. Not nullable. | | tokenEncryptionKeyId | String | Specifies the keyId of a public key from the keyCredentials collection. When configured, Azure AD encrypts all the tokens it emits by using the key this property points to. The application code that receives the encrypted token must use the matching private key to decrypt the token before it can be used for the signed-in user. |
v1.0 Authenticationcombinationconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationcombinationconfiguration-get.md
If successful, this method returns a `200 OK` response code and an [authenticati
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_authenticationcombinationconfiguration"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identity/conditionalAccess/authenticationStrengths/policies/0e371351-6419-4c8a-8047-61eef0212ffb/combinationConfigurations/133b68c4-503b-4e87-839a-6c286a27381b ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationcombinationconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationcombinationconfiguration-update.md
If successful, this method returns a `204 NO CONTENT` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_authenticationcombinationconfiguration"
Content-length: 130
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationmethodmodedetail Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationmethodmodedetail-get.md
If successful, this method returns a `200 OK` response code and an [authenticati
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_authenticationmethodmodedetail"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identity/conditionalAccess/authenticationStrengths/authenticationMethodModes/windowsHelloForBusiness ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthpolicy Delete Combinationconfigurations https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-delete-combinationconfigurations.md
If successful, this method returns a `204 No Content` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_authenticationcombinationconfiguration"
The following is an example of a request.
DELETE https://graph.microsoft.com/beta/identity/conditionalAccess/authenticationStrengths/policies/0e371351-6419-4c8a-8047-61eef0212ffb/combinationConfigurations/6cbbcfd0-5054-4a59-a10e-2d21fe09305d ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthpolicy Findbymethodmode https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-findbymethodmode.md
If successful, this function returns a `200 OK` response code and a [authenticat
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "authenticationstrengthpolicythis.findbymethodmode"
The following is an example of a request.
GET https://graph.microsoft.com/beta/policies/authenticationStrengthPolicies/findByMethodMode(authenticationMethodModes=["sms"]) ```
+# [JavaScript](#tab/javascript)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
v1.0 Authenticationstrengthpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-get.md
If successful, this method returns a `200 OK` response code and an [authenticati
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_authenticationstrengthpolicy"
The following is an example of a request.
GET https://graph.microsoft.com/beta/policies/authenticationStrengthPolicies/00000000-0000-0000-0000-000000000004 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthpolicy List Combinationconfigurations https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-list-combinationconfigurations.md
If successful, this method returns a `200 OK` response code and a collection of
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_authenticationcombinationconfiguration"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identity/conditionalAccess/authenticationStrengths/policies/0e371351-6419-4c8a-8047-61eef0212ffb/combinationConfigurations ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthpolicy Post Combinationconfigurations https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-post-combinationconfigurations.md
If successful, this method returns a `201 Created` response code and a [fido2Com
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_authenticationcombinationconfiguration_from_"
Content-length: 130
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-update.md
If successful, this method returns a `204 NO CONTENT` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_authenticationstrengthpolicy"
Content-length: 239
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthpolicy Updateallowedcombinations https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-updateallowedcombinations.md
If successful, this action returns a `200 OK` response code and a [updateAllowed
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "authenticationstrengthpolicythis.updateallowedcombinations"
Content-length: 51
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthpolicy Usage https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-usage.md
If successful, this function returns a `200 OK` response code and an [authentica
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "authenticationstrengthpolicythis.usage"
The following is an example of a request.
GET https://graph.microsoft.com/beta/policies/authenticationStrengthPolicies/{authenticationStrengthPolicyId}/usage ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthroot Delete Policies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthroot-delete-policies.md
If successful, this method returns a `204 No Content` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_authenticationstrengthpolicy"
The following is an example of a request.
DELETE https://graph.microsoft.com/beta/policies/authenticationStrengthPolicies/6e7d7469-07c5-4bb2-a801-5eaef8fb7c1e/$ref ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthroot List Authenticationmethodmodes https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthroot-list-authenticationmethodmodes.md
If successful, this method returns a `200 OK` response code and a collection of
#### Request The following is an example of a request to retrieve the collection of **authenticationMethodModes** objects and their descriptions. .+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_authenticationmethodmodedetail"
The following is an example of a request to retrieve the collection of **authent
GET https://graph.microsoft.com/beta/identity/conditionalAccess/authenticationStrengths/authenticationMethodModes ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
Content-Type: application/json
#### Request The following is an example of a request to retrieve the flat collection of authenticationCombinations objects, representing all the possible allowed combinations (allowedCombinations) that may be used in an authenticationStrengthPolicy object. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_authenticationcombinations"
The following is an example of a request to retrieve the flat collection of auth
GET https://graph.microsoft.com/beta/identity/conditionalAccess/authenticationStrengths/authenticationCombinations ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
Content-Type: application/json
"Error: list_authenticationcombinations: Unable to locate a definition for resource type: microsoft.graph.authenticationMethodModes" ]
-} -->
+} -->
v1.0 Authenticationstrengthroot List Policies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthroot-list-policies.md
If successful, this method returns a `200 OK` response code and a collection of
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_authenticationstrengthpolicy"
The following is an example of a request.
GET https://graph.microsoft.com/beta/policies/authenticationStrengthPolicies ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthroot Post Policies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthroot-post-policies.md
If successful, this method returns a `201 Created` response code and an [authent
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_authenticationstrengthpolicy_from_"
Content-length: 239
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Basetask Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/basetask-delta.md
GET https://graph.microsoft.com/beta/me/tasks/lists/AAMkAGVjMzJmMWZjLTgyYjgtNGIy
[!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Go](#tab/go)
-
-# [PowerShell](#tab/powershell)
-
-# [PHP](#tab/php)
-
v1.0 Basetask Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/basetask-get.md
GET https://graph.microsoft.com/beta/me/tasks/lists/AAMkAGVjMzJmMWZjLTgyYjgtNGIy
[!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Go](#tab/go)
-
-# [PHP](#tab/php)
-
v1.0 Basetask List Checklistitems https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/basetask-list-checklistitems.md
GET https://graph.microsoft.com/beta/me/tasks/lists/AAMkADliMmU5YjJlLTVmMmQtNGQz
[!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Go](#tab/go)
-
-# [PHP](#tab/php)
-
v1.0 Basetask List Linkedresources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/basetask-list-linkedresources.md
GET https://graph.microsoft.com/beta/me/tasks/lists/AAMkADliMmU5YjJlLTVmMmQtNGQz
[!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Go](#tab/go)
-
-# [PHP](#tab/php)
-
v1.0 Basetask Move https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/basetask-move.md
Content-length: 41
} ```
-# [C#](#tab/csharp)
- # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/basetask-move-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Java](#tab/java)
-
-# [Go](#tab/go)
-
-# [PowerShell](#tab/powershell)
-
-# [PHP](#tab/php)
-
v1.0 Basetask Post Checklistitems https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/basetask-post-checklistitems.md
Content-Type: application/json
} ```
-# [C#](#tab/csharp)
- # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/create-checklistitem-task-for-me-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Java](#tab/java)
-
-# [Go](#tab/go)
-
-# [PHP](#tab/php)
-
v1.0 Basetask Post Linkedresources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/basetask-post-linkedresources.md
Content-Type: application/json
} ```
-# [C#](#tab/csharp)
- # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/create-linkedresource-v2-from--javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Java](#tab/java)
-
-# [Go](#tab/go)
-
-# [PHP](#tab/php)
-
v1.0 Basetask Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/basetask-update.md
Content-length: 634
} ```
-# [C#](#tab/csharp)
- # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/update-basetask-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Java](#tab/java)
-
-# [Go](#tab/go)
-
-# [PHP](#tab/php)
-
v1.0 Basetasklist Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/basetasklist-delta.md
GET https://graph.microsoft.com/beta/me/tasks/lists/delta
[!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Go](#tab/go)
-
-# [PowerShell](#tab/powershell)
-
-# [PHP](#tab/php)
-
v1.0 Basetasklist Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/basetasklist-get.md
GET https://graph.microsoft.com/beta/me/tasks/lists/AQMkAGVjMzJmMWZjLTgyYjgtNGIy
[!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Go](#tab/go)
-
-# [PHP](#tab/php)
-
v1.0 Basetasklist List Tasks https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/basetasklist-list-tasks.md
GET https://graph.microsoft.com/beta/me/tasks/lists/AQMkAGVjMzJmMWZjLTgyYjgtNGIy
[!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Go](#tab/go)
-
-# [PHP](#tab/php)
-
v1.0 Basetasklist Post Tasks https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/basetasklist-post-tasks.md
Content-length: 634
} ```
-# [C#](#tab/csharp)
- # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/create-basetask-from--javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Java](#tab/java)
-
-# [Go](#tab/go)
-
-# [PHP](#tab/php)
-
v1.0 Bitlocker List Recoverykeys https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bitlocker-list-recoverykeys.md
This operation does not return the **key** property. For information about how t
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-|Permission type|Permissions (from most to least privileged)|
+|Permission type|Permissions (from least to most privileged)|
|:|:| |Delegated (work or school account)|BitLockerKey.ReadBasic.All, BitLockerKey.Read.All|
-|Delegated (personal Microsoft account)|Not supported|
-|Application|Not supported|
+|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:
+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:
* Global administrator * Cloud device administrator
To get a list of BitLocker keys within the tenant:
GET /informationProtection/bitlocker/recoveryKeys ```
-To get a list of BitLocker keys within the tenant filtered by the **device id**:
+To get a list of BitLocker keys within the tenant filtered by the **deviceId**:
<!-- { "blockType": "ignored"
GET /informationProtection/bitlocker/recoveryKeys?$filter=deviceId eq '{deviceId
``` ## Optional query parameters
-This method supports the `$filter` OData query parameter to filter results by the **device id** the key was most recently backed up to. This method does not support the `$top` filter. For details, see [Example 2](#example-2). For general information, see [OData query parameters](/graph/query-parameters).
+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).
The response might also contain an `odata.nextLink`, which you can use to page through the result set. For details, see [Paging Microsoft Graph data](/graph/paging).
If successful, this method returns a `200 OK` response code and a collection of
## Examples
-### Example 1
-Retrieve a list of BitLocker keys in the tenant.
+### Example 1: Retrieve a list of BitLocker keys in the tenant
#### Request The following is an example of the request.
Content-Type: application/json
] } ```
-### Example 2
-Retrieve a list of BitLocker keys filtered by **device id**.
+### Example 2: Retrieve a list of BitLocker keys filtered by **deviceId**
#### Request The following is an example of the request.
v1.0 Bitlockerrecoverykey Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bitlockerrecoverykey-get.md
By default, this operation does not return the **key** property that represents
## Permissions 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 most to least privileged)|
+|Permission type|Permissions (from least to most privileged)|
|:|:| |Delegated (work or school account)|BitLockerKey.ReadBasic.All, BitLockerKey.Read.All|
-|Delegated (personal Microsoft account)|Not supported|
-|Application|Not supported|
+|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:
+>**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:
* Global administrator * Cloud device administrator * Helpdesk administrator
GET /informationProtection/bitlocker/recoveryKeys/{bitlockeryRecoveryKeyId}?$sel
``` ## Optional query parameters
-This method supports the `$select` OData query parameter to return the **key** property. For details, see [Example 2](#example-2). For general information, see [OData query parameters](/graph/query-parameters).
+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).
## Request headers |Name|Description|
If successful, this method returns a `200 OK` response code and a [bitlockerReco
## Examples
-### Example 1
-Get the BitLocker key by specifying the **key id**. This example does not return the **key** property.
+### Example 1: Get the BitLocker key by specifying the key **id**
#### Request
-The following is an example of the request.
+The following is an example of the request. This example does not return the **key** property.
<!-- { "blockType": "request",
ocp-client-version: "1.2"
#### Response The following is an example of the response.
-**Note:** The response object shown here might be shortened for readability.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
Content-type: application/json
} ```
-### Example 2
-Get the BitLocker key with the **key** property by specifying the **key id**.
+### Example 2: Get the BitLocker key with the **key** property by specifying the key **id**
#### Request The following is an example of the request.
ocp-client-version: "1.2"
#### Response The following is an example of the response.
-**Note:** The response object shown here might be shortened for readability.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
v1.0 Bookingbusiness Getstaffavailability https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingbusiness-getstaffavailability.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
+
v1.0 Browsersharedcookie Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersharedcookie-get.md
+
+ Title: "Get browserSharedCookie"
+description: "Get a session cookie that can be shared between a Microsoft Edge process and an Internet Explorer process, while using Internet Explorer mode."
+
+ms.localizationpriority: medium
++
+# Get browserSharedCookie
+Namespace: microsoft.graph
++
+Get a [session cookie](../resources/browsersharedcookie.md) that can be shared between a Microsoft Edge process and an Internet Explorer process, while using [Internet Explorer mode](/deployedge/edge-ie-mode).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sharedCookies/{browserSharedCookieId}
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [browserSharedCookie](../resources/browsersharedcookie.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+
+# [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
+ }
+ }
+ ]
+}
+```
+
v1.0 Browsersharedcookie Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersharedcookie-update.md
+
+ Title: "Update browserSharedCookie"
+description: "Update the properties of a browserSharedCookie object."
+
+ms.localizationpriority: medium
++
+# Update browserSharedCookie
+Namespace: microsoft.graph
++
+Update the properties of a [browserSharedCookie](../resources/browsersharedcookie.md) object.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sharedCookies/{browserSharedCookieId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+++
+|Property|Type|Description|
+|:|:|:|
+|comment|String|The comment of the cookie.|
+|displayName|String|The name of the cookie.|
+|hostOnly|Boolean|Determines whether a cookie is a host-only or domain cookie.|
+|hostOrDomain|String|The URL of the cookie.|
+|path|String|The path of the cookie.|
+|sourceEnvironment|browserSharedCookieSourceEnvironment|Specifies how the cookies are shared between Microsoft Edge and Internet Explorer. The possible values are: `microsoftEdge`, `internetExplorer11`, `both`, `unknownFutureValue`.|
++
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+The following is an example of a request.
+
+# [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
+```
+
v1.0 Browsersite Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersite-get.md
+
+ Title: "Get browserSite"
+description: "Get a browserSite that resides on a site list."
+
+ms.localizationpriority: medium
++
+# Get browserSite
+Namespace: microsoft.graph
++
+Get a [browserSite](../resources/browsersite.md) that resides on a [browserSiteList](../resources/browsersitelist.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sites/{browserSiteId}
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [browserSite](../resources/browsersite.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+
+# [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
+ }
+ }
+ ]
+}
+```
+
v1.0 Browsersite Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersite-update.md
+
+ Title: "Update browserSite"
+description: "Update the properties of a browserSite object."
+
+ms.localizationpriority: medium
++
+# Update browserSite
+Namespace: microsoft.graph
++
+Update the properties of a [browserSite](../resources/browsersite.md) object.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sites/{browserSiteId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
++
+|Property|Type|Description|
+|:|:|:|
+|allowRedirect|Boolean|Controls the behavior of redirected sites. If `true`, indicates that the site will open in Internet Explorer 11 or Microsoft Edge even if the site is navigated to as part of a HTTP or meta refresh redirection chain.|
+|comment|String|The comment for the site.|
+|compatibilityMode|browserSiteCompatibilityMode|Controls what compatibility setting is used for specific sites or domains. The possible values are: `default`, `internetExplorer8Enterprise`, `internetExplorer7Enterprise`, `internetExplorer11`, `internetExplorer10`, `internetExplorer9`, `internetExplorer8`, `internetExplorer7`, `internetExplorer5`, `unknownFutureValue`.|
+|mergeType|browserSiteMergeType|The merge type of the site. The possible values are: `noMerge`, `default`, `unknownFutureValue`.|
+|targetEnvironment|browserSiteTargetEnvironment|The target environment that the site should open in. The possible values are: `internetExplorerMode`, `internetExplorer11`, `microsoftEdge`, `configurable`, `none`, `unknownFutureValue`.<br /><br />Prior to June 15, 2022, the `internetExplorer11` option would allow opening a site in the Internet Explorer 11 (IE11) desktop application. Following the retirement of IE11 on June 15, 2022, the `internetExplorer11` option will no longer open an IE11 window and will instead behave the same as the `internetExplorerMode` option.|
+|webUrl|String|The URL of the site.|
+
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+The following is an example of a request.
+
+# [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
+```
+
v1.0 Browsersitelist Delete Sharedcookies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-delete-sharedcookies.md
+
+ Title: "Delete browserSharedCookie"
+description: "Delete a browserSharedCookie from a browserSiteList."
+
+ms.localizationpriority: medium
++
+# Delete browserSharedCookie
+Namespace: microsoft.graph
++
+Delete a [browserSharedCookie](../resources/browsersharedcookie.md) from a [browserSiteList](../resources/browsersitelist.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sharedCookies/{browserSharedCookieId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If the shared cookie was not previously published, then this method returns a `204 No Content` response code on a successful delete. If the shared cookie was previously published, then this method returns a `200 OK` response code and a [browserSiteList](../resources/browsersitelist.md) object in the response body with the status as `pendingDelete`. You must publish (for example, via the [browserSiteList: publish](../api/browsersitelist-publish.md) API) the shared cookie to fully remove it from the site list.
+
+## Examples
+
+### Example 1: Delete a shared cookie that was not previously published
+
+#### Request
+The following is an example of a request.
+
+# [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": []
+}
+```
v1.0 Browsersitelist Delete Sites https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-delete-sites.md
+
+ Title: "Delete browserSite"
+description: "Delete a browserSite from a browserSiteList."
+
+ms.localizationpriority: medium
++
+# Delete browserSite
+Namespace: microsoft.graph
++
+Delete a [browserSite](../resources/browsersite.md) from a [browserSiteList](../resources/browsersitelist.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sites/{browserSiteId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If the site was not previously published, then this method returns a `204 No Content` response code on a successful delete. If the site was previously published, then this method returns a `200 OK` response code and a [browserSiteList](../resources/browsersitelist.md) object in the response body with the status as `pendingDelete`. You must publish (for example, via the [browserSiteList: publish](../api/browsersitelist-publish.md) API) the site to fully remove it from the site list.
+
+## Examples
+
+### Example 1: Delete a site that was not previously published
+
+#### Request
+The following is an example of a request.
+
+# [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": []
+}
+```
v1.0 Browsersitelist Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-get.md
+
+ Title: "Get browserSiteList"
+description: "Get a browserSiteList that contains browserSite and browserSharedCookie resources."
+
+ms.localizationpriority: medium
++
+# Get browserSiteList
+Namespace: microsoft.graph
++
+Get a [browserSiteList](../resources/browsersitelist.md) that contains [browserSite](../resources/browsersite.md) and [browserSharedCookie](../resources/browsersharedcookie.md) resources.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [browserSiteList](../resources/browsersitelist.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+
+# [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"
+}
+```
+
v1.0 Browsersitelist List Sharedcookies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-list-sharedcookies.md
+
+ Title: "List browserSharedCookies"
+description: "Get a list of the browserSharedCookie objects and their properties."
+
+ms.localizationpriority: medium
++
+# List browserSharedCookies
+Namespace: microsoft.graph
++
+Get a list of the [browserSharedCookie](../resources/browsersharedcookie.md) objects and their properties.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sharedCookies
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [browserSharedCookie](../resources/browsersharedcookie.md) objects in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+
+# [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": []
+ }
+ ]
+}
+```
+
v1.0 Browsersitelist List Sites https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-list-sites.md
+
+ Title: "List browserSites"
+description: "Get a list of the browserSite objects and their properties."
+
+ms.localizationpriority: medium
++
+# List browserSites
+Namespace: microsoft.graph
++
+Get a list of the [browserSite](../resources/browsersite.md) objects and their properties.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sites
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [browserSite](../resources/browsersite.md) objects in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+
+# [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
+ }
+ }
+ ]
+ }
+ ]
+}
+```
+
v1.0 Browsersitelist Post Sharedcookies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-post-sharedcookies.md
+
+ Title: "Create browserSharedCookie"
+description: "Create a new browserSharedCookie object in a browserSiteList."
+
+ms.localizationpriority: medium
++
+# Create browserSharedCookie
+Namespace: microsoft.graph
++
+Create a new [browserSharedCookie](../resources/browsersharedcookie.md) object in a [browserSiteList](../resources/browsersitelist.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sharedCookies
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply a JSON representation of the [browserSharedCookie](../resources/browsersharedcookie.md) object.
+
+You can specify the following properties when you create a **browserSharedCookie**.
+
+|Property|Type|Description|
+|:|:|:|
+|comment|String|The comment of the cookie. Required.|
+|displayName|String|The name of the cookie. Required.|
+|hostOnly|Boolean|Determines whether a cookie is a host-only or domain cookie. Required.|
+|hostOrDomain|String|The URL of the cookie. Required.|
+|path|String|The path of the cookie. Required.|
+|sourceEnvironment|browserSharedCookieSourceEnvironment|Specifies how the cookies are shared between Microsoft Edge and Internet Explorer. The possible values are: `microsoftEdge`, `internetExplorer11`, `both`, `unknownFutureValue`. Required.|
+
+## Response
+
+If successful, this method returns a `201 Created` response code and a [browserSharedCookie](../resources/browsersharedcookie.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+
+# [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": []
+}
+```
+
v1.0 Browsersitelist Post Sites https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-post-sites.md
+
+ Title: "Create browserSite"
+description: "Create a new browserSite object in a browserSiteList."
+
+ms.localizationpriority: medium
++
+# Create browserSite
+Namespace: microsoft.graph
++
+Create a new [browserSite](../resources/browsersite.md) object in a [browserSiteList](../resources/browsersitelist.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sites
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply a JSON representation of the [browserSite](../resources/browsersite.md) object.
+
+You can specify the following properties when you create a **browserSite**.
+
+|Property|Type|Description|
+|:|:|:|
+|allowRedirect|Boolean|Controls the behavior of redirected sites. If `true`, indicates that the site will open in Internet Explorer 11 or Microsoft Edge even if the site is navigated to as part of a HTTP or meta refresh redirection chain. Required.|
+|comment|String|The comment for the site. Required|
+|compatibilityMode|browserSiteCompatibilityMode|Controls what compatibility setting is used for specific sites or domains. The possible values are: `default`, `internetExplorer8Enterprise`, `internetExplorer7Enterprise`, `internetExplorer11`, `internetExplorer10`, `internetExplorer9`, `internetExplorer8`, `internetExplorer7`, `internetExplorer5`, `unknownFutureValue`. Required.|
+|mergeType|browserSiteMergeType|The merge type of the site. The possible values are: `noMerge`, `default`, `unknownFutureValue`. Required.|
+|targetEnvironment|browserSiteTargetEnvironment|The target environment that the site should open in. The possible values are: `internetExplorerMode`, `internetExplorer11`, `microsoftEdge`, `configurable`, `none`, `unknownFutureValue`. Required.<br /><br />Prior to June 15, 2022, the `internetExplorer11` option would allow opening a site in the Internet Explorer 11 (IE11) desktop application. Following the retirement of IE11 on June 15, 2022, the `internetExplorer11` option will no longer open an IE11 window and will instead behave the same as the `internetExplorerMode` option.|
+|webUrl|String|The URL of the site. Required.|
++
+## Response
+
+If successful, this method returns a `201 Created` response code and a [browserSite](../resources/browsersite.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+
+# [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": []
+}
+```
+
v1.0 Browsersitelist Publish https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-publish.md
+
+ Title: "browserSiteList: publish"
+description: "Publish the specified browserSiteList for devices to download."
+
+ms.localizationpriority: medium
++
+# browserSiteList: publish
+Namespace: microsoft.graph
++
+Publish the specified [browserSiteList](../resources/browsersitelist.md) for devices to download.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/publish
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
++
+## Request body
+
+In the request body, omit both sites and share cookies to publish the entire site list. Optionally, you can publish specific sites and shared cookies by specifying a collection of IDs.
++
+|Property|Type|Description|
+|:|:|:|
+|revision|String|The revision of the site list to publish. Required.|
+|sharedCookies|[browserSharedCookie](../resources/browsersharedcookie.md) collection|The collection of shared cookies to publish. Optional. Only requires the shared cookie ID. All other fields are ignored.|
+|sites|[browserSite](../resources/browsersite.md) collection|The collection of sites to publish. Optional. Only requires the site ID. All other fields are ignored.|
++
+## Response
+
+If successful, this action returns a `200 OK` response code and a [browserSiteList](../resources/browsersitelist.md) in the response body.
+
+## Examples
+
+### Example 1: Publish all sites and shared cookies
+
+#### Request
+
+The following is an example of a request.
+
+# [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
+ }
+}
+```
v1.0 Browsersitelist Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-update.md
+
+ Title: "Update browserSiteList"
+description: "Update the properties of a browserSiteList object."
+
+ms.localizationpriority: medium
++
+# Update browserSiteList
+Namespace: microsoft.graph
++
+Update the properties of a [browserSiteList](../resources/browsersitelist.md) object.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
++
+|Property|Type|Description|
+|:|:|:|
+|description|String|Description for the site list.|
+|displayName|String|Display name of this site list.|
+++
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+The following is an example of a request.
+
+# [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
+```
+
v1.0 Call Addlargegalleryview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/call-addlargegalleryview.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Add the large gallery view to a call.
+Add the large gallery view to a call.
+
+For details about how to identify a large gallery view participant in a roster so that you can retrieve the relevant data to subscribe to the video feed, see [Identify large gallery view participants in a roster](https://learn.microsoft.com/en-us/graph/cloud-communications-identifylargegalleryview).
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Channel Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-get.md
GET https://graph.microsoft.com/beta/teams/893075dd-2487-4122-925f-022c42e20265/
[!INCLUDE [sample-code](../includes/snippets/go/get-channel-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [PHP](#tab/php) [!INCLUDE [sample-code](../includes/snippets/php/get-channel-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Channel List Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-list-messages.md
Content-type: application/json
} } ],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
}, { "id": "1616963377068",
Content-type: application/json
"onBehalfOf": null, "attachments": [], "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
}, { "id": "1616883610266",
Content-type: application/json
} }, "reactions": [],
+ "messageHistory": [],
"eventDetail": { "@odata.type": "#microsoft.graph.teamDescriptionUpdatedEventMessageDetail", "teamId": "fbe2bf47-16c8-47cf-b4a5-4b9b187c508b",
Content-type: application/json
} } ],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
}, { "id": "1616963377068",
Content-type: application/json
}, "attachments": [], "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
}, { "id": "1616883610266",
Content-type: application/json
"attachments": [], "mentions": [], "reactions": [],
+ "messageHistory": [],
"eventDetail": { "@odata.type": "#microsoft.graph.teamDescriptionUpdatedEventMessageDetail", "teamId": "fbe2bf47-16c8-47cf-b4a5-4b9b187c508b",
Content-type: application/json
"attachments": [], "mentions": [], "reactions": [],
+ "messageHistory": [],
"replies@odata.count": 3, "replies@odata.nextLink": "https://graph.microsoft.com/beta/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/channels/19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2/messages/1616963377068/replies?$skiptoken=MSwwLDE2NDQ0MzkzODAxNDU", "replies": [
Content-type: application/json
}, "attachments": [], "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
}, { "id": "1616989750004",
Content-type: application/json
}, "attachments": [], "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
}, { "id": "1616989747416",
Content-type: application/json
}, "attachments": [], "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
} ] }
v1.0 Channel List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-list.md
GET https://graph.microsoft.com/beta/teams/893075dd-2487-4122-925f-022c42e20265/
[!INCLUDE [sample-code](../includes/snippets/go/list-channels-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [PHP](#tab/php) [!INCLUDE [sample-code](../includes/snippets/php/list-channels-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
GET https://graph.microsoft.com/beta/teams/64c323f2-226a-4e64-8ba4-3e6e3f7b9330/
[!INCLUDE [sample-code](../includes/snippets/go/list-private-channels-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [PHP](#tab/php) [!INCLUDE [sample-code](../includes/snippets/php/list-private-channels-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
GET https://graph.microsoft.com/beta/teams/6a720ba5-7373-463b-bc9f-4cd04b5c6742/
[!INCLUDE [sample-code](../includes/snippets/go/list-shared-channels-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [PHP](#tab/php) [!INCLUDE [sample-code](../includes/snippets/php/list-shared-channels-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Chat Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-get.md
Content-type: application/json
#### Request The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_meeting_chat", "sampleKeys": ["19:meeting_ZDZlYTYxOWUtYzdlMi00ZmMxLWIxMTAtN2YzODZlZjAxYzI4@thread.v2"] }-->
-```http
+```msgraph-interactive
GET https://graph.microsoft.com/beta/chats/19:ebe3857aa388434bab0cad9d2e09f4de@thread.v2?$expand=lastMessagePreview ```+
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
+++
Content-type: application/json
} } }
-```
+```
v1.0 Chat Hideforuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-hideforuser.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/javascript/chat-hideforuser-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Java](#tab/java)
- # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/chat-hideforuser-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Chat List Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-list-messages.md
Content-type: application/json
}, "attachments": [], "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
}, { "id": "1615971548136",
Content-type: application/json
}, "attachments": [], "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
} ] }
The following is an example of a request that lists the top two messages (`$top=
The following example shows the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_chat_messages_2",
The following example shows the request.
GET https://graph.microsoft.com/beta/chats/19:2da4c29f6d7041eca70b638b43d45437@thread.v2/messages?$top=2&$orderBy=lastModifiedDateTime desc&$filter=lastModifiedDateTime ge 2022-09-22T00:00:00.000Z and lastModifiedDateTime le 2022-09-24T00:00:00.000Z ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following example shows the response.
Content-type: application/json
}, "attachments": [], "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
}, { "id": "1615971548136",
Content-type: application/json
}, "attachments": [], "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
} ] }
v1.0 Chat Markchatreadforuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-markchatreadforuser.md
Content-length: 106
[!INCLUDE [sample-code](../includes/snippets/javascript/chat-markchatreadforuser-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Java](#tab/java)
- # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/chat-markchatreadforuser-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Chat Markchatunreadforuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-markchatunreadforuser.md
Content-length: 158
[!INCLUDE [sample-code](../includes/snippets/javascript/chat-markchatunreadforuser-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Java](#tab/java)
- # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/chat-markchatunreadforuser-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Chat Post Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-post-messages.md
Content-type: application/json
}, "attachments": [], "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
} ```
v1.0 Chat Sendactivitynotification https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-sendactivitynotification.md
The following table shows the parameters that can be used with this action.
|chainId|Int64|Optional. Used to override a previous notification. Use the same `chainId` in subsequent requests to override the previous notification.| |previewText|[itemBody](../resources/itembody.md)|Preview text for the notification. Microsoft Teams will only show first 150 characters.| |templateParameters|[keyValuePair](../resources/keyvaluepair.md) collection|Values for template variables defined in the activity feed entry corresponding to `activityType` in [Teams app manifest](/microsoftteams/platform/overview).|
-|recipient|[teamworkNotificationRecipient](../resources/teamworknotificationrecipient.md)|Recipient of the notification. See also [aadUserNotificationRecipient](../resources/aadusernotificationrecipient.md) and [chatMembersNotificationRecipient](../resources/chatmembersnotificationrecipient.md). |
+|recipient|[teamworkNotificationRecipient](../resources/teamworknotificationrecipient.md)|Recipient of the notification. For more details, see [aadUserNotificationRecipient](../resources/aadusernotificationrecipient.md) and [chatMembersNotificationRecipient](../resources/chatmembersnotificationrecipient.md). |
The following resources are supported when setting the `source` value of the **topic** property to `entityURL`:
HTTP/1.1 204 No Content
### Example 5: Notify the chat members about a task created in a chat
-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.
+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.
#### Request
The following example shows the request.
# [HTTP](#tab/http) <!-- { "blockType": "request",
- "name": "chat_sendactivitynotification_4",
+ "name": "chat_sendactivitynotification_5",
"sampleKeys": ["19:1c3af46e9e0f4a5293343c8813c47619@thread.v2"] } -->
Content-Type: application/json
``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Chat Unhideforuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-unhideforuser.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/javascript/chat-unhideforuser-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Java](#tab/java)
- # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/chat-unhideforuser-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Chatmessage Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-delta.md
Content-type: application/json
"onBehalfOf": null, "attachments": [], "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
}, { "@odata.type": "#microsoft.graph.chatMessage",
Content-type: application/json
"onBehalfOf": null, "attachments": [], "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
} ] }
Content-type: application/json
"onBehalfOf": null, "attachments": [], "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
} ] }
Content-type: application/json
"onBehalfOf": null, "attachments": [], "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
} ] }
Content-type: application/json
"onBehalfOf": null, "attachments": [], "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
} ] }
v1.0 Chatmessage Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-get.md
Content-type: application/json
}, "attachments": [], "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
} ```
Content-type: application/json
"onBehalfOf": null, "attachments": [], "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
} ```
Content-type: application/json
"onBehalfOf": null, "attachments": [], "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
} ```
v1.0 Chatmessage List Replies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-list-replies.md
Content-type: application/json
"onBehalfOf": null, "attachments": [], "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
}, { "id": "1616989750004",
Content-type: application/json
"onBehalfOf": null, "attachments": [], "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
}, { "id": "1616989747416",
Content-type: application/json
"onBehalfOf": null, "attachments": [], "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
} ] }
v1.0 Chatmessage Post Replies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-post-replies.md
Content-type: application/json
"onBehalfOf": null, "attachments": [], "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
} ```
HTTP/1.1 200 OK
"contentType":"html", "content":"Hello World" },
- "attachments":[ ],
- "mentions":[ ],
- "reactions":[ ]
+ "attachments":[],
+ "mentions":[],
+ "reactions":[],
+ "messageHistory": []
} ```
v1.0 Chatmessage Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-post.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | ChannelMessage.Send, Group.ReadWrite.All** | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Teamwork.Migrate.All, ChannelMessage.ReadWrite.All |
+| Application | Teamwork.Migrate.All |
> **Note**: Permissions marked with ** are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward.
Content-type: application/json
"onBehalfOf": null, "attachments": [], "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
} ```
Content-type: application/json
} } ],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
} ```
Content-type: application/json
#### Request The following is an example of the request.
-> **Note:** The attachment's ID must be unique and can be a new randomly generated GUID. However, the attachment's ID must be the same in the _body_ and _attachments_ elements.
+> **Note:** The attachment ID must be unique and can be a new randomly generated GUID. However, the attachment ID must be the same in the _body_ and _attachments_ elements.
# [HTTP](#tab/http)
Content-type: application/json
], "onBehalfOf": null, "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
} ```
Content-type: application/json
], "onBehalfOf": null, "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
} ```
Content-type: application/json
#### Request The following is an example of the request.
-> **Note:** The **temporaryId** in the **hostedContents** collection is a random ID, but must be same across the **body** and **hostedContents** elements. (Notice the **temporaryId** set to **1** and the reference in body as `../hostedContents/1/$value`.)
+> **Note:** The **temporaryId** in the **hostedContents** collection is a random ID, but must be same across the **body** and **hostedContents** elements. (Notice the **temporaryId** set to `1` and the reference in body as `../hostedContents/1/$value`.).
-**contentBytes** must be set to binary string Base64-encoded bytes. You can do this in C# by using `Convert.ToBase64String(File.ReadAllBytes("image.png"));`
+**contentBytes** must be set to binary string Base64-encoded bytes. You can do this in C# by using `Convert.ToBase64String(File.ReadAllBytes("image.png"));`.
# [HTTP](#tab/http)
Content-type: application/json
}, "attachments": [], "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
} ```
Content-type: application/json
#### Request The following is an example of the request.
-> **Note:** The **temporaryId** in the **hostedContents** collection is a random ID, but must be same across the **content** (in **attachments**) and **hostedContents** elements. (Notice the **temporaryId** set to **1** and the reference in content as `../hostedContents/1/$value`.)
+> **Notes:**
+> * 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`.).
+> * The maximum possible size of hosted content is 4 MB.
-**contentBytes** must be set to binary string Base64-encoded bytes. You can do this in C# by using `Convert.ToBase64String(File.ReadAllBytes("image.png"));`
+**contentBytes** must be set to binary string Base64-encoded bytes. You can do this in C# by using `Convert.ToBase64String(File.ReadAllBytes("image.png"));`.
# [HTTP](#tab/http)
Content-type: application/json
#### Response
+The following is an example of the response.
+ <!-- { "blockType": "response", "truncated": true,
Content-type: application/json
], "onBehalfOf": null, "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
} ```
Content-type: application/json
} } ],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
} ```
-### Example 8 : @mention a team in a channel message
+### Example 8: @mention a team in a channel message
#### Request The following is an example of the request.
Content-type: application/json
} } ],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
} ```
Content-type: application/json
} } ],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
} ```
Content-type: application/json
} } ],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
} ```
Content-type: application/json
], "onBehalfOf": null, "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
} ```
v1.0 Chatmessage Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-update.md
ms.prod: "microsoft-teams"
Update a [chatMessage](../resources/chatMessage.md) object.
-With the exception of the **policyViolation** property, all properties of a **chatMessage** can be updated in delegated permissions scenarios.
+
+All properties of a **chatMessage** can be updated in delegated permissions scenarios,
+except for read-only properties and the **policyViolation** property.
Only the **policyViolation** property of a **chatMessage** can be updated in application permissions scenarios. The update only works for chats where members are Microsoft Teams users. If one of the participants is using Skype, the operation will fail.
Content-Type: application/json
}, "attachments": [], "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
} ```
Content-Type: application/json
} } ],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
} ```
Content-Type: application/json
} ], "mentions": [],
- "reactions": []
+ "reactions": [],
+ "messageHistory": []
} ```
Content-Type: application/json
} } }
+ ],
+ "messageHistory": [
+ {
+ "modifiedDateTime": "2018-10-21T08:10:30.489Z",
+ "actions": "reactionAdded",
+ "reaction": {
+ "reactionType": "angry",
+ "user": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "f1b66449-b46d-49b0-9c3c-53c10a5c818e",
+ "displayName": null,
+ "userIdentityType": "aadUser"
+ }
+ }
+ }
+ },
+ {
+ "modifiedDateTime": "2018-10-21T08:10:32.489Z",
+ "actions": "reactionAdded",
+ "reaction": {
+ "reactionType": "laugh",
+ "user": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "03a02232-d8f5-4970-a77e-6e8c76ce7a4e",
+ "displayName": null,
+ "userIdentityType": "aadUser"
+ }
+ }
+ }
+ },
+ {
+ "modifiedDateTime": "2018-10-21T02:17:14.67Z",
+ "actions": "reactionAdded",
+ "reaction": {
+ "reactionType": "like",
+ "user": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "f1b66449-b46d-49b0-9c3c-53c10a5c818e",
+ "displayName": null,
+ "userIdentityType": "aadUser"
+ }
+ }
+ }
+ },
+ {
+ "modifiedDateTime": "2018-10-21T02:34:40.3Z",
+ "actions": "reactionAdded",
+ "reaction": {
+ "reactionType": "like",
+ "user": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "4c9041b7-449a-40f7-8855-56da239b9fd1",
+ "displayName": null,
+ "userIdentityType": "aadUser"
+ }
+ }
+ }
+ },
+ {
+ "modifiedDateTime": "2018-10-21T08:10:25.489Z",
+ "actions": "reactionAdded",
+ "reaction": {
+ "reactionType": "like",
+ "user": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "03a02232-d8f5-4970-a77e-6e8c76ce7a4e",
+ "displayName": null,
+ "userIdentityType": "aadUser"
+ }
+ }
+ }
+ },
+ {
+ "modifiedDateTime": "2018-10-21T08:10:31.489Z",
+ "actions": "reactionAdded",
+ "reaction": {
+ "reactionType": "heart",
+ "user": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "03a02232-d8f5-4970-a77e-6e8c76ce7a4e",
+ "displayName": null,
+ "userIdentityType": "aadUser"
+ }
+ }
+ }
+ },
+ {
+ "modifiedDateTime": "2018-10-21T08:10:33.489Z",
+ "actions": "reactionAdded",
+ "reaction": {
+ "reactionType": "sad",
+ "user": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "03a02232-d8f5-4970-a77e-6e8c76ce7a4e",
+ "displayName": null,
+ "userIdentityType": "aadUser"
+ }
+ }
+ }
+ },
+ {
+ "modifiedDateTime": "2018-10-21T08:10:34.489Z",
+ "actions": "surprised",
+ "reaction": {
+ "reactionType": "sad",
+ "user": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "03a02232-d8f5-4970-a77e-6e8c76ce7a4e",
+ "displayName": null,
+ "userIdentityType": "aadUser"
+ }
+ }
+ }
+ }
] } ```
v1.0 Checklistitem Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/checklistitem-delete.md
DELETE https://graph.microsoft.com/beta/me/tasks/lists/AAMkADliMmU5YjJlLTVmMmQtN
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell)
DELETE https://graph.microsoft.com/beta/me/tasks/lists/AAMkADliMmU5YjJlLTVmMmQtN
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Checklistitem Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/checklistitem-get.md
GET https://graph.microsoft.com/beta/me/tasks/lists/AAMkADliMmU5YjJlLTVmMmQtNGQz
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell)
GET https://graph.microsoft.com/beta/me/tasks/lists/AAMkADliMmU5YjJlLTVmMmQtNGQz
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Checklistitem Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/checklistitem-update.md
Content-Type: application/json
``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript)
Content-Type: application/json
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell)
Content-Type: application/json
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Cloudpccrosscloudgovernmentorganizationmapping Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpccrosscloudgovernmentorganizationmapping-get.md
If successful, this method returns a `200 OK` response code and a [cloudPcCrossC
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_cloudpccrosscloudgovernmentorganizationmapping"
GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/crossCloud
X-MS-CloudPC-USGovCloudTenantAADToken: {token} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response <!-- {
v1.0 Cloudpcexportjob Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcexportjob-get.md
If successful, this method returns a `200 OK` response code and a [cloudPcExport
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_cloudpcexportjob"
The following is an example of a request.
GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/reports/exportJobs/TotalAggregatedRemoteConnectionReports__d39979c9-a0a2-4916-a158-1b984742ffff ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Cloudpconpremisesconnection Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpconpremisesconnection-delete.md
Delete a specific [cloudPcOnPremisesConnection](../resources/cloudpconpremisesco
When you delete an Azure network connection, permissions to the service are removed from the specified Azure resources.
-You cannot delete an Azure network connection when it's in use, as indicated by the `inUse` property.
+You cannot delete an Azure network connection when it's in use, as indicated by the **inUse** property.
## Permissions
If successful, this method returns a `204 No Content` response code.
### Request
+The following is an example of a request.
# [HTTP](#tab/http) <!-- {
DELETE https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/onPremi
### Response
+The following is an example of the response.
+ <!-- { "blockType": "response", "truncated": true
v1.0 Cloudpcreports Getdailyaggregatedremoteconnectionreports https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcreports-getdailyaggregatedremoteconnectionreports.md
If successful, this action returns a `200 OK` response code and a Stream in the
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "cloudpcreportsthis.getdailyaggregatedremoteconnectionreports"
Content-length: 199
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Cloudpcreports Getrealtimeremoteconnectionlatency https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcreports-getrealtimeremoteconnectionlatency.md
If successful, this function returns a `200 OK` response code and a Stream in th
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "cloudpcreportsthis.getrealtimeremoteconnectionlatency"
The following is an example of a request.
GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/reports/getRealTimeRemoteConnectionLatency(cloudPcId='f5ff445f-7488-40f8-8ab9-ee784a9fffff') ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
++++ ### Response The following is an example of the response
v1.0 Cloudpcreports Getrealtimeremoteconnectionstatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcreports-getrealtimeremoteconnectionstatus.md
If successful, this function returns a `200 OK` response code and a Stream in th
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "cloudpcreportsthis.getrealtimeremoteconnectionstatus"
The following is an example of a request.
GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/reports/getRealTimeRemoteConnectionStatus(cloudPcId='f5ff445f-7488-40f8-8ab9-ee784a9fffff') ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
++++ ### Response The following is an example of the response
v1.0 Cloudpcreports Getremoteconnectionhistoricalreports https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcreports-getremoteconnectionhistoricalreports.md
If successful, this action returns a `200 OK` response code and a Stream in the
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "cloudpcreportsthis.getremoteconnectionhistoricalreports"
Content-length: 199
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Cloudpcreports Gettotalaggregatedremoteconnectionreports https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcreports-gettotalaggregatedremoteconnectionreports.md
If successful, this action returns a `200 OK` response code and a Stream in the
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "cloudpcreportsthis.gettotalaggregatedremoteconnectionreports"
Content-length: 199
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Cloudpcreports Post Exportjobs https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcreports-post-exportjobs.md
If successful, this method returns a `201 Created` response code and a [cloudPcE
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_cloudpcexportjob_from_"
Content-length: 315
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Conditionalaccessroot List Templates https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/conditionalaccessroot-list-templates.md
If successful, this method returns a `200 OK` response code and a collection of
#### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_conditionalaccesstemplate"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identity/conditionalAccess/templates ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
Content-Type: application/json
#### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_conditionalaccesstemplate_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identity/conditionalAccess/templates?$select=name,description,id,scenarios&$filter=scenarios has 'secureFoundation' ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
Content-Type: application/json
} ] }
-```
+```
v1.0 Conditionalaccesstemplate Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/conditionalaccesstemplate-get.md
If successful, this method returns a `200 OK` response code and a [conditionalAc
#### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_conditionalaccesstemplate"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identity/conditionalAccess/templates/c7503427-338e-4c5e-902d-abe252abfb43 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
Content-Type: application/json
#### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_conditionalaccesstemplate_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identity/conditionalAccess/templates/c7503427-338e-4c5e-902d-abe252abfb43?$select=details ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
Content-Type: application/json
} } }
-```
+```
v1.0 Device Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/device-delete.md
The calling user must also be in one of the following [Azure AD roles](/azure/ac
## HTTP request
-The `{id}` in the request is the value of the **id** property of the device, not the **deviceId** property.
+You can address the device using either its **id** or **deviceId**.
<!-- { "blockType": "ignored" } --> ```http DELETE /devices/{id}-
+DELETE /devices(deviceId='{deviceId}')
```
v1.0 Device Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/device-get.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request
-The `{id}` in the request is the value of the **id** property of the device, not the **deviceId** property.
+You can address the device using either its **id** or **deviceId**.
<!-- { "blockType": "ignored" } --> ```http GET /devices/{id}
+GET /devices(deviceId='{deviceId}')
```+ ## Optional query parameters This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response. ## Request headers
v1.0 Device List Memberof https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/device-list-memberof.md
One of the following permissions is required to call this API. To learn more, in
[!INCLUDE [limited-info](../../includes/limited-info.md)] ## HTTP request+
+You can address the device using either its **id** or **deviceId**.
<!-- { "blockType": "ignored" } --> ```http GET /devices/{id}/memberOf
+GET /devices(deviceId='{deviceId}')/memberOf
``` ## Optional query parameters
v1.0 Device List Registeredowners https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/device-list-registeredowners.md
One of the following permissions is required to call this API. To learn more, in
[!INCLUDE [limited-info](../../includes/limited-info.md)] ## HTTP request+
+You can address the device using either its **id** or **deviceId**.
<!-- { "blockType": "ignored" } --> ```http GET /devices/{id}/registeredOwners
+GET /devices(deviceId='{deviceId}')/registeredOwners
``` > Note: The "id" in the request is the "id" property of the device, not the "deviceId" property.
v1.0 Device List Registeredusers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/device-list-registeredusers.md
One of the following permissions is required to call this API. To learn more, in
[!INCLUDE [limited-info](../../includes/limited-info.md)] ## HTTP request+
+You can address the device using either its **id** or **deviceId**.
<!-- { "blockType": "ignored" } --> ```http GET /devices/{id}/registeredUsers
+GET /devices(deviceId='{deviceId}')/registeredUsers
``` > Note: The "id" in the request is the "id" property of the device, not the "deviceId" property.
v1.0 Device List Transitivememberof https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/device-list-transitivememberof.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request
-<!-- { "blockType": "ignored" } -->
+You can address the device using either its **id** or **deviceId**.
+<!-- { "blockType": "ignored" } -->
```http GET /devices/{id}/transitiveMemberOf
+GET /devices(deviceId='{deviceId}')/transitiveMemberOf
``` ## Optional query parameters
v1.0 Device List Usagerights https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/device-list-usagerights.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request
+You can address the device using either its **id** or **deviceId**.
<!-- { "blockType": "ignored" } --> ``` http GET /devices/{objectId}/usageRights
+GET /devices(deviceId='{deviceId}')/usageRights
``` ## Optional query parameters
v1.0 Device Post Registeredowners https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/device-post-registeredowners.md
One of the following permissions is required to call this API. To learn more, in
|Application | Not supported. | ## HTTP request+
+You can address the device using either its **id** or **deviceId**.
<!-- { "blockType": "ignored" } --> ```http POST /devices/{id}/registeredOwners/$ref
+POST /devices(deviceId='{deviceId}')/registeredOwners/$ref
``` ## Request headers
v1.0 Device Post Registeredusers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/device-post-registeredusers.md
One of the following permissions is required to call this API. To learn more, in
|Application | Not supported. | ## HTTP request+
+You can address the device using either its **id** or **deviceId**.
<!-- { "blockType": "ignored" } --> ```http POST /devices/{id}/registeredUsers/$ref-
+POST /devices(deviceId='{deviceId}')/registeredUsers/$ref
``` ## Request headers | Name | Description|
v1.0 Device Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/device-update.md
The calling user must also be in one of the following [Azure AD roles](/azure/ac
## HTTP request
-The `{id}` in the request is the value of the **id** property of the device, not the **deviceId** property.
-
+You can address the device using either its **id** or **deviceId**.
<!-- { "blockType": "ignored" } --> ```http PATCH /devices/{id}
+PATCH /devices(deviceId='{deviceId}')
``` ## Request headers
v1.0 Devicemanagement Alertrecord Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrecord-get.md
If successful, this method returns a `200 OK` response code and an [microsoft.gr
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_alertrecord"
The following is an example of a request.
GET https://graph.microsoft.com/beta/deviceManagement/monitoring/alertRecords/6c46a7ba-e78a-45e5-a81c-179ab8fd3e8e ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response.
v1.0 Devicemanagement Alertrecord Getportalnotifications https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrecord-getportalnotifications.md
If successful, this function returns a `200 OK` response code and a collection o
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "alertrecordthis.getportalnotifications"
The following is an example of a request.
GET https://graph.microsoft.com/beta/deviceManagement/monitoring/alertRecords/getPortalNotifications ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response.
v1.0 Devicemanagement Alertrecord List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrecord-list.md
If successful, this method returns a `200 OK` response code and a collection of
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_alertrecord"
The following is an example of a request.
GET https://graph.microsoft.com/beta/deviceManagement/monitoring/alertRecords ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response.
v1.0 Devicemanagement Alertrecord Setportalnotificationassent https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrecord-setportalnotificationassent.md
If successful, this action returns a `204 No Content` response code.
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "alertrecordthis.setportalnotificationassent"
The following is an example of a request.
POST https://graph.microsoft.com/beta/deviceManagement/monitoring/alertRecords/6c46a7ba-e78a-45e5-a81c-179ab8fd3e8e/setPortalNotificationAsSent ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response.
v1.0 Devicemanagement Alertrule Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrule-get.md
If successful, this method returns a `200 OK` response code and an [microsoft.gr
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_alertrule"
The following is an example of a request.
GET https://graph.microsoft.com/beta/deviceManagement/monitoring/alertRules/30070507-6514-443b-8fa5-06979cedacdf ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response.
v1.0 Devicemanagement Alertrule List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrule-list.md
If successful, this method returns a `200 OK` response code and a collection of
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_alertrule"
The following is an example of a request.
GET https://graph.microsoft.com/beta/deviceManagement/monitoring/alertRules ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response.
v1.0 Devicemanagement Alertrule Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrule-post.md
If successful, this method returns a `201 Created` response code and an [microso
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "post_alertrule"
Content-Type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response.
v1.0 Devicemanagement Alertrule Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrule-update.md
If successful, this method returns a `200 OK` response code and an updated [micr
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_alertrule"
Content-Type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response.
v1.0 Directory Deleteditems Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/directory-deleteditems-delete.md
Namespace: microsoft.graph
Permanently delete a recently deleted [application](../resources/application.md), [group](../resources/group.md), [servicePrincipal](../resources/serviceprincipal.md), or [user](../resources/user.md) object from [deleted items](../resources/directory.md). After an item is permanently deleted, it **cannot** be restored.
+Administrative units **cannot** be permanently deleted by using the **deletedItems** API. Soft-deleted administrative units will be permanently deleted 30 days after initial deletion unless they are restored.
+ ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Directory Deleteditems Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/directory-deleteditems-get.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve the properties of a recently deleted [application](../resources/application.md), [group](../resources/group.md), [servicePrincipal](../resources/serviceprincipal.md), or [user](../resources/user.md) object from [deleted items](../resources/directory.md).
+Retrieve the properties of a recently deleted [application](../resources/application.md), [group](../resources/group.md), [servicePrincipal](../resources/serviceprincipal.md), [administrative unit](../resources/administrativeunit.md), or [user](../resources/user.md) object from [deleted items](../resources/directory.md).
>**Note:** Deleted security groups are deleted permanently and can't be retrieved through this API.
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
+### For administrative units:
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | AdministrativeUnit.Read.All, AdministrativeUnit.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | AdministrativeUnit.Read.All, AdministrativeUnit.ReadWrite.All |
+ ## HTTP request <!-- { "blockType": "ignored" } --> ```http
v1.0 Directory Deleteditems List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/directory-deleteditems-list.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve a list of recently deleted directory objects. Currently, deleted items functionality is only supported for the [application](../resources/application.md), [servicePrincipal](../resources/serviceprincipal.md), [group](../resources/group.md), and [user](../resources/user.md) resources.
+Retrieve a list of recently deleted directory objects. Currently, deleted items functionality is only supported for the [application](../resources/application.md), [servicePrincipal](../resources/serviceprincipal.md), [group](../resources/group.md), [administrative unit](../resources/administrativeunit.md), and [user](../resources/user.md) resources.
>**Note:** Deleted security groups are deleted permanently and can't be retrieved through this API.
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Group.Read.All, Group.ReadWrite.All, Directory.Read.All |
+### For administrative units:
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | AdministrativeUnit.Read.All, AdministrativeUnit.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | AdministrativeUnit.Read.All, AdministrativeUnit.ReadWrite.All |
+ ## HTTP request <!-- { "blockType": "ignored" } --> ```http
GET /directory/deleteditems/microsoft.graph.application
GET /directory/deleteditems/microsoft.graph.servicePrincipal GET /directory/deleteditems/microsoft.graph.group GET /directory/deletedItems/microsoft.graph.user
+GET /directory/deletedItems/microsoft.graph.administrativeUnit
```
-This API currently supports retrieving object types of applications (`microsoft.graph.application`), servicePrincipals (`microsoft.graph.serviceprincipal`), groups (`microsoft.graph.group`), or users (`microsoft.graph.user`) from deleted items. The OData cast type is a required part of the URI and calling `GET /directory/deleteditems` without a type is **not** supported.
+The OData cast type is a required part of the URI and calling `GET /directory/deleteditems` without a type is **not** supported.
## Optional query parameters
v1.0 Directory Deleteditems Restore https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/directory-deleteditems-restore.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Restore a recently deleted [application](../resources/application.md), [group](../resources/group.md), [servicePrincipal](../resources/serviceprincipal.md), or [user](../resources/user.md) object from [deleted items](../resources/directory.md). If an item was accidentally deleted, you can fully restore the item. This is not applicable to security groups, which are deleted permanently.
+Restore a recently deleted [application](../resources/application.md), [group](../resources/group.md), [servicePrincipal](../resources/serviceprincipal.md), [administrative unit](../resources/administrativeunit.md), or [user](../resources/user.md) object from [deleted items](../resources/directory.md). If an item was accidentally deleted, you can fully restore the item. This is not applicable to security groups, which are deleted permanently.
A recently deleted item will remain available for up to 30 days. After 30 days, the item is permanently deleted.
The calling app must be assigned one of the following [Azure AD roles](/azure/ac
|Delegated (personal Microsoft account) | Not supported. | |Application | Group.ReadWrite.All |
+### For administrative units:
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | AdministrativeUnit.ReadWrite.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | AdministrativeUnit.ReadWrite.All |
+ ## HTTP request <!-- { "blockType": "ignored" } --> ```http
v1.0 Directoryaudit List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/directoryaudit-list.md
Title: "List directoryAudits"
-description: "Describes the list method of the directoryAudit resource (entity) from the Microsoft Graph API (beta version)."
+description: "Get the list of audit logs generated by Azure Active Directory (Azure AD)."
ms.localizationpriority: medium ms.prod: "identity-and-access-reports"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get the list of audit logs generated by Azure Active Directory. This includes audit logs generated by various services within Azure AD, including user, app, device and group Management, privileged identity management (PIM), access reviews, terms of use, identity protection, password management (SSPR and admin password resets), and self service group management.
+Get the list of audit logs generated by Azure Active Directory (Azure AD). This includes audit logs generated by various services within Azure AD, including user, app, device and group Management, privileged identity management (PIM), access reviews, terms of use, identity protection, password management (SSPR and admin password resets), and self service group management.
## Permissions
Do not supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and collection of [directoryAudit](../resources/directoryaudit.md) objects in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [directoryAudit](../resources/directoryaudit.md) objects in the response body.
## Example ### Request
-Here is an example of the request.
+The following is an example of the request.
# [HTTP](#tab/http) <!-- {
GET https://graph.microsoft.com/beta/auditLogs/directoryAudits
### Response
-Here is an example of the response.
+The following is an example of the response.
>**Note:** The response object shown here might be shortened for readability. <!-- {
v1.0 Directoryrole Delete Member https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/directoryrole-delete-member.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request
+You can address the directory role using either its **id** or **roleTemplateId**.
<!-- { "blockType": "ignored" } -->- ```http DELETE /directoryRoles/{role-id}/members/{id}/$ref
-DELETE /directoryRoles/roleTemplateId={roleTemplateId}/members/{id}/$ref
+DELETE /directoryRoles(roleTemplateId='{roleTemplateId}')/members/{id}/$ref
``` > [!CAUTION] > If `/$ref` is not appended to the request and the calling app has permissions to manage the member object, the object will also be deleted from Azure Active Directory (Azure AD); otherwise, a `403 Forbidden` error is returned. You can restore specific objects through the [Restore deleted items API](directory-deleteditems-restore.md).
HTTP/1.1 204 No Content
The following is an example of the request. Replace `9f06204d-73c1-4d4c-880a-6edb90606fd8` with the value of your roleTemplateId and `bb165b45-151c-4cf6-9911-cd7188912848` with the **id** value of your user of directory object.
-<!-- disabling snippet generation because of an SDK limitation. For more information, see https://github.com/microsoftgraph/msgraph-sdk-dotnet/issues/1041-->
- <!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "delete_directoryobject_from_directoryrole_templateId" }--> ```http
-DELETE https://graph.microsoft.com/v1.0/directoryRoles/roleTemplateId=9f06204d-73c1-4d4c-880a-6edb90606fd8/members/bb165b45-151c-4cf6-9911-cd7188912848/$ref
+DELETE https://graph.microsoft.com/beta/directoryRoles(roleTemplateId='9f06204d-73c1-4d4c-880a-6edb90606fd85')/members/bb165b45-151c-4cf6-9911-cd7188912848/$ref
```
v1.0 Directoryrole Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/directoryrole-get.md
One of the following permissions is required to call this API. To learn more, in
|Application | RoleManagement.Read.Directory, Directory.Read.All, RoleManagement.ReadWrite.Directory, Directory.ReadWrite.All | ## HTTP request+
+You can address the directory role using either its **id** or **roleTemplateId**.
<!-- { "blockType": "ignored" } --> ```http GET /directoryRoles/{role-id}
-GET /directoryRoles/roleTemplateId={roleTemplateId}
+GET /directoryRoles(roleTemplateId='{roleTemplateId}')
```+ ## Optional query parameters This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response.
Content-type: application/json
#### Request The following is an example of the request.
-<!-- disabling snippet generation because of an SDK limitation. For more information, see https://github.com/microsoftgraph/msgraph-sdk-dotnet/issues/1041-->
- <!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_directoryrole_templateId" }-->
-```msgraph-interactive
-GET https://graph.microsoft.com/beta/directoryRoles/roleTemplateId=88d8e3e3-8f55-4a1e-953a-9b9898b8876b
+```http
+GET https://graph.microsoft.com/beta/directoryRoles(roleTemplateId='88d8e3e3-8f55-4a1e-953a-9b9898b8876b')
```
v1.0 Directoryrole List Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/directoryrole-list-members.md
One of the following permissions is required to call this API. To learn more, in
[!INCLUDE [limited-info](../../includes/limited-info.md)] ## HTTP request+
+You can address the directory role using either its **id** or **roleTemplateId**.
<!-- { "blockType": "ignored" } --> ```http GET /directoryRoles/{role-id}/members
-GET /directoryRoles/roleTemplateId={roleTemplateId}/members
+GET /directoryRoles(roleTemplateId='{roleTemplateId}')/members
```+ ## Optional query parameters This method supports the [OData query parameters](/graph/query-parameters) to help customize the response. ## Request headers
Content-type: application/json
#### Request The following is an example of the request.
-<!-- disabling snippet generation because of an SDK limitation. For more information, see https://github.com/microsoftgraph/msgraph-sdk-dotnet/issues/1041-->
- <!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_directoryrole_members_templateId" }-->
-```msgraph-interactive
-GET https://graph.microsoft.com/beta/directoryRoles/roleTemplateId=4a5d8f65-41da-4de4-8968-e035b65339cf/members
+```http
+GET https://graph.microsoft.com/beta/directoryRoles(roleTemplateId='4a5d8f65-41da-4de4-8968-e035b65339cf')/members
```
v1.0 Directoryrole List Scopedmembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/directoryrole-list-scopedmembers.md
One of the following permissions is required to call this API. To learn more, in
|Application | RoleManagement.Read.Directory, Directory.Read.All, RoleManagement.ReadWrite.Directory, Directory.ReadWrite.All | ## HTTP request+
+You can address the directory role using either its **id** or **roleTemplateId**.
<!-- { "blockType": "ignored" } --> ```http GET /directoryroles/{role-id}/scopedMembers
-GET /directoryroles/roleTemplateId={roleTemplateId}/scopedMembers
+GET /directoryRoles(roleTemplateId='{roleTemplateId}')/scopedMembers
```+ ## Optional query parameters This method supports the [OData query parameters](/graph/query-parameters) to help customize the response.
Content-type: application/json
#### Request The following is an example of a request for a directory role with **roleTemplateId** `fdd7a751-b60b-444a-984c-02652fe8fa1c`. -
-<!-- disabling snippet generation because of an SDK limitation. For more information, see https://github.com/microsoftgraph/msgraph-sdk-dotnet/issues/1041-->
--
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_scopedmembers_directoryrole_templateId" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/directoryRoles/roleTemplateId=fdd7a751-b60b-444a-984c-02652fe8fa1c/scopedMembers
+GET https://graph.microsoft.com/beta/directoryRoles(roleTemplateId='fdd7a751-b60b-444a-984c-02652fe8fa1c')/scopedMembers
```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Java](#tab/java)
-
-# [Go](#tab/go)
-
-# [PowerShell](#tab/powershell)
-
-# [PHP](#tab/php)
--- #### Response The following example shows the response.
v1.0 Driveitem Createlink https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/driveitem-createlink.md
The request should be a JSON object with the following properties.
| Property | Type | Description | | :-| :-- | :| |type|String|Optional.The type of sharing link to create. |
-|scope|String|Optional. The scope of link to create. Either anonymous, organization or users.|
+|scope|String|Optional. The scope of link to create. Either `anonymous`, `organization`, or `users`|
|expirationDateTime|DateTimeOffset|Optional. A String with format of yyyy-MM-ddTHH:mm:ssZ of DateTime indicates the expiration time of the permission.| |password|String|Optional.The password of the sharing link that is set by the creator.| |recipients|[driveRecipient](../resources/driverecipient.md) collection|Optional. A collection of recipients who will receive access to the sharing link.|
The following values are allowed for the **scope** parameter.
|:|: | anonymous | Anyone with the link has access, without needing to sign in. This may include people outside of your organization. Anonymous link support may be disabled by an administrator. | organization | Anyone signed into your organization (tenant) can use the link to get access. Only available in OneDrive for Business and SharePoint.
-| users | Specific people in the recipients collection can use the link to get access. Only available in OneDrive for Business and SharePoint.
+| users | Specific people in the recipient's collection can use the link to get access. Only available in OneDrive for Business and SharePoint.
## Response
v1.0 Driveitem Createuploadsession https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/driveitem-createuploadsession.md
Alternatively, you can defer final creation of the file in the destination until
POST /drives/{driveId}/items/{itemId}/createUploadSession POST /groups/{groupId}/drive/items/{itemId}/createUploadSession POST /me/drive/items/{itemId}/createUploadSession
+POST /me/drive/items/{itemId}:/{fileName}:/createUploadSession
POST /sites/{siteId}/drive/items/{itemId}/createUploadSession POST /users/{userId}/drive/items/{itemId}/createUploadSession ```
v1.0 Ediscovery Legalhold Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/ediscovery-legalhold-update.md
In the request body, supply the values for relevant fields that should be update
|Property|Type|Description| |:|:|:|
-|contentQuery|String|KQL query that specifies content to be held in the specified locations. For more information about KQL in eDiscovery, see [Keyword queries and search conditions for Content Search and eDiscovery](/microsoft-365/compliance/keyword-queries-and-search-conditions). To hold all content in the specified locations, leave **contentQuery** blank. |
|description|String| The legal hold description. | |displayName|String| The display name of the legal hold. | |isEnabled|Boolean|Indicates whether the hold is enabled and actively holding content. |
v1.0 Educationassignment List Submissions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignment-list-submissions.md
The following is an example of the request.
# [HTTP](#tab/http) <!-- { "blockType": "request",
- "sampleKeys": ["f4a941ff-9da6-4707-ba5b-0eae93cad0b4","3c77de7f-539b-49e1-9c96-1274f2f0ee3b"],
+ "sampleKeys": ["2003c52e-807a-4186-9b49-60c573095461","2be08d97-b140-4eec-8cbd-88238d571060"],
"name": "get_submissions" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/education/classes/f4a941ff-9da6-4707-ba5b-0eae93cad0b4/assignments/3c77de7f-539b-49e1-9c96-1274f2f0ee3b/submissions
+GET https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions
``` # [C#](#tab/csharp)
Content-type: application/json
Content-length: 873 {
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions",
"value": [ {
- "status": "working",
+ "status": "returned",
"submittedDateTime": null, "unsubmittedDateTime": null,
- "returnedDateTime": null,
- "resourcesFolderUrl": "https://graph.microsoft.com/beta/drives/b!DPA6q59Tw0mtgmyXRUmrQRqBZTesG-lMkl1cBmvvMeUEWrOk89nKRpUEr4ZhNYBc/items/016XPCQEDJCE5LX4OXABF37QSORAK5WKQD",
- "id": "4af73d2b-6b9c-493f-0688-979087bed39b",
+ "returnedDateTime": "2022-04-13T05:11:50.756165Z",
+ "reassignedDateTime": null,
+ "resourcesFolderUrl": null,
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226"
+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a",
"displayName": null } },
Content-length: 873
} }, "returnedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ },
+ "reassignedBy": {
"application": null, "device": null, "user": {
The following is an example of the request.
"name": "get_submissions_expand" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/efcdf80b-a5de-42ac-8579-e40b0223d48b/submissions?$expand=outcomes
+GET https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions?$expand=outcomes
``` # [C#](#tab/csharp)
Content-type: application/json
Content-length: 4492 {
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('72a7baec-c3e9-4213-a850-f62de0adad5f')/assignments('efcdf80b-a5de-42ac-8579-e40b0223d48b')/submissions(outcomes())",
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions(outcomes())",
"value": [ { "status": "returned", "submittedDateTime": null, "unsubmittedDateTime": null,
- "returnedDateTime": "2021-10-13T15:57:00.0349869Z",
+ "returnedDateTime": "2022-04-13T05:11:50.756165Z",
"reassignedDateTime": null, "resourcesFolderUrl": null,
- "id": "9bc724ee-d314-1ec5-725d-5f81228e85a6",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226"
+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a",
"displayName": null } },
Content-length: 4492
"application": null, "device": null, "user": {
- "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
Content-length: 4492
"displayName": null } },
+ "outcomes@odata.context": "https://canary.graph.microsoft.com/testprodbetaeduasg_local_submissions-deeplink/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions('d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a')/outcomes",
"outcomes": [ { "@odata.type": "#microsoft.graph.educationFeedbackOutcome",
Content-length: 4492
"lastModifiedBy": null, "points": null, "publishedPoints": null
- },
- {
- "@odata.type": "#microsoft.graph.educationRubricOutcome",
- "lastModifiedDateTime": "2021-10-13T15:57:00.0076092Z",
- "id": "65a46d78-1a2b-4a7e-bcf8-78a22ac2611b",
- "lastModifiedBy": {
- "application": null,
- "device": null,
- "user": {
- "id": null,
- "displayName": null
- }
- },
- "rubricQualityFeedback": [
- {
- "qualityId": "f4c7b781-4c0c-4113-a5fb-c0885b7ab510",
- "feedback": null
- }
- ],
- "rubricQualitySelectedLevels": [
- {
- "qualityId": "f4c7b781-4c0c-4113-a5fb-c0885b7ab510",
- "columnId": "ef99fe68-b6f8-4f67-a13b-9a81c1724788"
- }
- ],
- "publishedRubricQualityFeedback": [
- {
- "qualityId": "f4c7b781-4c0c-4113-a5fb-c0885b7ab510",
- "feedback": null
- }
- ],
- "publishedRubricQualitySelectedLevels": [
- {
- "qualityId": "f4c7b781-4c0c-4113-a5fb-c0885b7ab510",
- "columnId": "ef99fe68-b6f8-4f67-a13b-9a81c1724788"
- }
- ]
} ] }
The following is an example of the request.
"name": "get_submissions_prefer" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/education/classes/59069eb2-2a09-4d90-bb19-2089cc69d613/assignments/80da1069-a635-4913-813f-d775a5470a8f/submissions
+GET https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions
Prefer: include-unknown-enum-members ```
Content-type: application/json
Content-length: 4492 {
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('59069eb2-2a09-4d90-bb19-2089cc69d613')/assignments('80da1069-a635-4913-813f-d775a5470a8f')/submissions",
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions",
"value": [ {
- "status": "working",
+ "status": "returned",
"submittedDateTime": null, "unsubmittedDateTime": null,
- "returnedDateTime": null,
+ "returnedDateTime": "2022-04-13T05:11:50.756165Z",
"reassignedDateTime": null, "resourcesFolderUrl": null,
- "id": "f51a6687-a4a3-a8d9-ac4a-6ff81c5a8da7",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "0ca0dd79-57eb-4903-97dc-88c769dd2a3d"
+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "0ca0dd79-57eb-4903-97dc-88c769dd2a3d",
+ "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a",
"displayName": null } },
Content-length: 4492
"application": null, "device": null, "user": {
- "id": null,
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
Content-length: 4492
}, { "status": "reassigned",
- "submittedDateTime": "2021-11-10T00:57:17.0495233Z",
+ "submittedDateTime": "2022-04-13T05:10:00.4660243Z",
"unsubmittedDateTime": null,
- "returnedDateTime": null,
- "reassignedDateTime": "2021-11-10T01:03:25.7812455Z",
+ "returnedDateTime": "2022-04-13T05:12:14.6531582Z",
+ "reassignedDateTime": null,
"resourcesFolderUrl": null,
- "id": "869369de-3e5a-89eb-6f2d-83cd88f860b5",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22efbecaf4-6956-4a76-6e10-b901e4de91c5%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "efbecaf4-6956-4a76-6e10-b901e4de91c5",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "723e2402-f503-4825-a4d5-5143fbe6f53d"
+ "userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "723e2402-f503-4825-a4d5-5143fbe6f53d",
+ "id": "51cf5a99-d234-4e43-96de-cd65df14bfa1",
"displayName": null } },
Content-length: 4492
"application": null, "device": null, "user": {
- "id": null,
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
Content-length: 4492
"application": null, "device": null, "user": {
- "id": "afc58f1f-7c9e-4770-a448-e53ba43463a5",
+ "id": null,
"displayName": null } }
v1.0 Educationassignment Setupfeedbackresourcesfolder https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignment-setupfeedbackresourcesfolder.md
Content-type: application/json
### Response+ The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
+ <!-- { "blockType": "response", "truncated": true,
v1.0 Educationfeedbackresourceoutcome Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationfeedbackresourceoutcome-delete.md
Title: "Delete educationFeedbackResourceOutcome"
-description: "Delete a feedback resource from a submission. This can only be done by a teacher."
+description: "Delete a feedback resource from a submission."
ms.localizationpriority: medium ms.prod: "education"
DELETE /education/classes/{classId}/assignments/{assignmentId}/submissions/{subm
| Authorization | Bearer {token}. Required. | ## Request body
-Don't supply a request body for this method.
+Do not supply a request body for this method.
## Response If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
v1.0 Educationfeedbackresourceoutcome Post Outcomes https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationfeedbackresourceoutcome-post-outcomes.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Create a new [feedback resource](../resources/educationfeedbackresourceoutcome.md) for a submission.
-
-Only a teacher can perform this operation.
+Create a new [feedback resource](../resources/educationfeedbackresourceoutcome.md) for a submission. Only a teacher can perform this operation.
To create a new file-based resource, upload the file to the feedback resources folder associated with the assignment. If the file doesn't exist or is not in that folder, the `POST` request will fail.
Content-type: application/json
} } }- ```
+## See also
+
+To upload an existing file, see [Upload feedback files for education submissions](/graph/education-upload-feedback-resource-overview).
+ <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2022-05-06 14:57:30 UTC --> <!--
v1.0 Educationrubric Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationrubric-get.md
The following is an example of the request.
GET https://graph.microsoft.com/beta/education/me/rubrics/bf040af7-a5ff-4abe-a8c8-1bdc532344c2 ```
-## Optional query parameters
-
-This method supports the `$select` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
- # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-educationrubric-csharp-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Educationsubmission Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-get.md
The following is an example of the request.
"name": "get_educationsubmission" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/education/classes/59069eb2-2a09-4d90-bb19-2089cc69d613/assignments/80da1069-a635-4913-813f-d775a5470a8f/submissions/869369de-3e5a-89eb-6f2d-83cd88f860b5
+GET https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions/d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a
``` # [C#](#tab/csharp)
Content-type: application/json
Content-length: 712 {
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('59069eb2-2a09-4d90-bb19-2089cc69d613')/assignments('80da1069-a635-4913-813f-d775a5470a8f')/submissions/$entity",
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions/$entity",
"status": "returned",
- "submittedDateTime": "2021-11-10T00:57:17.0495233Z",
+ "submittedDateTime": null,
"unsubmittedDateTime": null,
- "returnedDateTime": "2021-11-10T01:03:25.7812455Z",
- "reassignedDateTime": "2021-11-10T01:03:25.7812455Z",
+ "returnedDateTime": "2022-04-13T05:11:50.756165Z",
+ "reassignedDateTime": null,
"resourcesFolderUrl": null,
- "id": "869369de-3e5a-89eb-6f2d-83cd88f860b5",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "723e2402-f503-4825-a4d5-5143fbe6f53d"
+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "723e2402-f503-4825-a4d5-5143fbe6f53d",
+ "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a",
"displayName": null } },
Content-length: 712
"application": null, "device": null, "user": {
- "id": "afc58f1f-7c9e-4770-a448-e53ba43463a5",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
Content-length: 712
"application": null, "device": null, "user": {
- "id": "afc58f1f-7c9e-4770-a448-e53ba43463a5",
+ "id": null,
"displayName": null } }
The following is an example of the request.
"name": "get_educationsubmission_prefer" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/education/classes/59069eb2-2a09-4d90-bb19-2089cc69d613/assignments/80da1069-a635-4913-813f-d775a5470a8f/submissions/869369de-3e5a-89eb-6f2d-83cd88f860b5
+GET https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions/efbecaf4-6956-4a76-6e10-b901e4de91c5
Prefer: include-unknown-enum-members ```
Content-type: application/json
Content-length: 712 {
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('59069eb2-2a09-4d90-bb19-2089cc69d613')/assignments('80da1069-a635-4913-813f-d775a5470a8f')/submissions/$entity",
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions/$entity",
"status": "reassigned",
- "submittedDateTime": "2021-11-10T00:57:17.0495233Z",
+ "submittedDateTime": "2022-04-13T05:10:00.4660243Z",
"unsubmittedDateTime": null,
- "returnedDateTime": null,
- "reassignedDateTime": "2021-11-10T01:03:25.7812455Z",
+ "returnedDateTime": "2022-04-13T05:12:14.6531582Z",
+ "reassignedDateTime": "2022-04-13T05:12:14.6531582Z",
"resourcesFolderUrl": null,
- "id": "869369de-3e5a-89eb-6f2d-83cd88f860b5",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22efbecaf4-6956-4a76-6e10-b901e4de91c5%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "efbecaf4-6956-4a76-6e10-b901e4de91c5",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "723e2402-f503-4825-a4d5-5143fbe6f53d"
+ "userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "723e2402-f503-4825-a4d5-5143fbe6f53d",
+ "id": "51cf5a99-d234-4e43-96de-cd65df14bfa1",
"displayName": null } },
Content-length: 712
"application": null, "device": null, "user": {
- "id": null,
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
Content-length: 712
"application": null, "device": null, "user": {
- "id": "afc58f1f-7c9e-4770-a448-e53ba43463a5",
+ "id": null,
"displayName": null } }
The following is an example of the request.
"name": "get_submission_expand" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/education/classes/59069eb2-2a09-4d90-bb19-2089cc69d613/assignments/80da1069-a635-4913-813f-d775a5470a8f/submissions/869369de-3e5a-89eb-6f2d-83cd88f860b5?$expand=*
+GET https://graph.microsoft.com/beta/education/classes/a86a5c30-0437-49d6-9c6b-b1ce0d8d5574/assignments/95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f/submissions/e1a0240e-f3af-f039-63e7-09c3cbf8d176?$expand=*
``` # [C#](#tab/csharp)
Content-type: application/json
Content-length: 4492 {
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('59069eb2-2a09-4d90-bb19-2089cc69d613')/assignments('80da1069-a635-4913-813f-d775a5470a8f')/submissions(outcomes(),resources(),submittedResources())/$entity",
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('a86a5c30-0437-49d6-9c6b-b1ce0d8d5574')/assignments('95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f')/submissions(outcomes(),resources(),submittedResources())/$entity",
"status": "returned",
- "submittedDateTime": "2021-11-10T00:57:17.0495233Z",
+ "submittedDateTime": "2022-10-24T21:03:53.3664034Z",
"unsubmittedDateTime": null,
- "returnedDateTime": "2021-11-10T01:03:25.7812455Z",
- "reassignedDateTime": "2021-11-10T01:03:25.7812455Z",
+ "returnedDateTime": "2022-10-24T21:04:42.7101616Z",
+ "reassignedDateTime": null,
"resourcesFolderUrl": null,
- "id": "869369de-3e5a-89eb-6f2d-83cd88f860b5",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%22a86a5c30-0437-49d6-9c6b-b1ce0d8d5574%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%2295da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22e1a0240e-f3af-f039-63e7-09c3cbf8d176%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "e1a0240e-f3af-f039-63e7-09c3cbf8d176",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "723e2402-f503-4825-a4d5-5143fbe6f53d"
+ "userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "723e2402-f503-4825-a4d5-5143fbe6f53d",
+ "id": "51cf5a99-d234-4e43-96de-cd65df14bfa1",
"displayName": null } },
Content-length: 4492
"application": null, "device": null, "user": {
- "id": "afc58f1f-7c9e-4770-a448-e53ba43463a5",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
Content-length: 4492
"application": null, "device": null, "user": {
- "id": "afc58f1f-7c9e-4770-a448-e53ba43463a5",
+ "id": null,
"displayName": null } },
+ "outcomes@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('a86a5c30-0437-49d6-9c6b-b1ce0d8d5574')/assignments('95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f')/submissions('e1a0240e-f3af-f039-63e7-09c3cbf8d176')/outcomes",
"outcomes": [ { "@odata.type": "#microsoft.graph.educationFeedbackOutcome",
- "lastModifiedDateTime": null,
+ "lastModifiedDateTime": "2022-10-24T21:04:42.3073523Z",
"id": "ca05367a-b292-42d5-aff7-5d279feeace8",
- "lastModifiedBy": null,
- "feedback": null,
- "publishedFeedback": null
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ },
+ "feedback": {
+ "feedbackDateTime": "2022-10-24T21:04:42.3073523Z",
+ "text": {
+ "content": "New feedback!",
+ "contentType": "text"
+ },
+ "feedbackBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ }
+ },
+ "publishedFeedback": {
+ "feedbackDateTime": "2022-10-24T21:04:25.2783852Z",
+ "text": {
+ "content": "Feedback",
+ "contentType": "text"
+ },
+ "feedbackBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ }
+ }
}, { "@odata.type": "#microsoft.graph.educationPointsOutcome",
- "lastModifiedDateTime": null,
+ "lastModifiedDateTime": "2022-10-24T21:04:42.7101541Z",
"id": "ea1351f6-ba33-4940-b2cb-6a7254af2dc8",
- "lastModifiedBy": null,
- "points": null,
- "publishedPoints": null
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ },
+ "points": {
+ "gradedDateTime": "2022-10-24T21:04:42.7101541Z",
+ "points": 456,
+ "gradedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ }
+ },
+ "publishedPoints": {
+ "gradedDateTime": "2022-10-24T21:04:25.6308301Z",
+ "points": 123,
+ "gradedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ }
+ }
}, { "@odata.type": "#microsoft.graph.educationRubricOutcome",
- "lastModifiedDateTime": "2021-11-10T01:03:25.7712076Z",
+ "lastModifiedDateTime": "2022-10-24T21:04:26.5833776Z",
"id": "65a46d78-1a2b-4a7e-bcf8-78a22ac2611b", "lastModifiedBy": { "application": null,
Content-length: 4492
}, "rubricQualityFeedback": [ {
- "qualityId": "a660004a-608d-4cd2-a6dc-4f43812444ee",
+ "qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c",
"feedback": null }, {
- "qualityId": "2c5ae75d-d347-426b-be2c-cfc81a6f0b32",
- "feedback": null
+ "qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b",
+ "feedback": {
+ "content": "Needs improvement",
+ "contentType": "text"
+ }
}, {
- "qualityId": "32fdea06-5cbb-4881-9093-96e59f59b8b8",
- "feedback": null
- },
- {
- "qualityId": "66137bd8-b9c2-40e1-a360-40b7ee75eaef",
+ "qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de",
"feedback": null } ], "rubricQualitySelectedLevels": [ {
- "qualityId": "a660004a-608d-4cd2-a6dc-4f43812444ee",
+ "qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c",
"columnId": null }, {
- "qualityId": "2c5ae75d-d347-426b-be2c-cfc81a6f0b32",
- "columnId": null
+ "qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b",
+ "columnId": "0f9823a2-174c-4ce0-8f12-e298c291f29b"
}, {
- "qualityId": "32fdea06-5cbb-4881-9093-96e59f59b8b8",
- "columnId": null
- },
- {
- "qualityId": "66137bd8-b9c2-40e1-a360-40b7ee75eaef",
+ "qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de",
"columnId": null } ], "publishedRubricQualityFeedback": [ {
- "qualityId": "a660004a-608d-4cd2-a6dc-4f43812444ee",
- "feedback": null
- },
- {
- "qualityId": "2c5ae75d-d347-426b-be2c-cfc81a6f0b32",
+ "qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c",
"feedback": null }, {
- "qualityId": "32fdea06-5cbb-4881-9093-96e59f59b8b8",
- "feedback": null
+ "qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b",
+ "feedback": {
+ "content": "Needs improvement",
+ "contentType": "text"
+ }
}, {
- "qualityId": "66137bd8-b9c2-40e1-a360-40b7ee75eaef",
+ "qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de",
"feedback": null } ], "publishedRubricQualitySelectedLevels": [ {
- "qualityId": "a660004a-608d-4cd2-a6dc-4f43812444ee",
+ "qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c",
"columnId": null }, {
- "qualityId": "2c5ae75d-d347-426b-be2c-cfc81a6f0b32",
- "columnId": null
- },
- {
- "qualityId": "32fdea06-5cbb-4881-9093-96e59f59b8b8",
- "columnId": null
+ "qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b",
+ "columnId": "0f9823a2-174c-4ce0-8f12-e298c291f29b"
}, {
- "qualityId": "66137bd8-b9c2-40e1-a360-40b7ee75eaef",
+ "qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de",
"columnId": null } ] } ],
+ "resources@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('a86a5c30-0437-49d6-9c6b-b1ce0d8d5574')/assignments('95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f')/submissions('e1a0240e-f3af-f039-63e7-09c3cbf8d176')/resources",
"resources": [],
+ "submittedResources@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('a86a5c30-0437-49d6-9c6b-b1ce0d8d5574')/assignments('95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f')/submissions('e1a0240e-f3af-f039-63e7-09c3cbf8d176')/submittedResources",
"submittedResources": [] } ```
v1.0 Educationsubmission List Outcomes https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-list-outcomes.md
Title: "List outcomes"
-description: "Retrieve a list of educationoutcome objects."
+description: "Retrieve a list of educationOutcome objects."
ms.localizationpriority: medium ms.prod: "education"
A submission for a points assignment (one that has a point value assigned) will
A submission for an assignment with an attached rubric, if the rubric is a credit rubric (no points), will have an [educationFeedbackOutcome](../resources/educationpointsoutcome.md) and an [educationRubricOutcome](../resources/educationrubricoutcome.md). (It might also return an [educationPointsOutcome](../resources/educationpointsoutcome.md), but that outcome is ignored.)
-A submission for an assignment with an attached rubric, if the rubric is a points rubric, will have an [educationFeedbackOutcome](../resources/educationpointsoutcome.md), an [educationPointsOutcome](../resources/educationpointsoutcome.md, and an [educationRubricOutcome](../resources/educationrubricoutcome.md).
+A submission for an assignment with an attached rubric, if the rubric is a points rubric, will have an [educationFeedbackOutcome](../resources/educationpointsoutcome.md), an [educationPointsOutcome](../resources/educationpointsoutcome.md), and an [educationRubricOutcome](../resources/educationrubricoutcome.md).
A submission for a feedback resource will have an [educationFeedbackResourceOutcome](../resources/educationfeedbackresourceoutcome.md).
-All outcome types have a regular and a published property appropriate to that type of outcome; for example, **points** and **publishedPoints**, **feedback** and **publishedFeedback**. The regular property is the most recent value updated by the teacher; the published property is the most recent value returned to the student.
+All outcome types have a regular and a published property appropriate to that type of outcome; for example, **points** and **publishedPoints**, **feedback** and **publishedFeedback**. The regular property is the most recent value updated by the teacher; the published property is the most recent value returned to the student.
## Permissions
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-GET /education/classes/{id}/assignments/{id}/submissions/{id}/outcomes
+GET /education/classes/{classId}/assignments/{assignmentId}/submissions/{submissionId}/outcomes
``` ## Optional query parameters
v1.0 Educationsubmission Reassign https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-reassign.md
The following is an example of the request.
}--> ```http
-POST /education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/7192332b-e904-4891-81e2-356242ab1858/submissions/02bb5de1-7205-2a25-fe33-f99cf53de1c4/reassign
+POST https://graph.microsoft.com/beta/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/assignments/db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a/submissions/4bca096a-7de3-8675-5e86-2fa149923860/reassign
``` # [C#](#tab/csharp)
HTTP/1.1 200 OK
"@odata.context": "https://graph.microsoft.com/beta/$metadata#educationSubmission", "@odata.type": "#microsoft.graph.educationSubmission", "status": "returned",
- "submittedDateTime": "2021-09-07T14:54:46.1606962Z",
- "unsubmittedDateTime": "2021-09-07T14:41:18.9512645Z",
- "returnedDateTime": "2021-09-07T21:38:40.5254847Z",
- "reassignedDateTime": "2021-09-07T21:38:40.5254847Z",
+ "submittedDateTime": "2022-10-19T23:32:49.3314767Z",
+ "unsubmittedDateTime": null,
+ "returnedDateTime": "2022-10-19T23:32:58.1079737Z",
+ "reassignedDateTime": "2022-10-19T23:32:58.1079737Z",
"resourcesFolderUrl": null,
- "id": "02bb5de1-7205-2a25-fe33-f99cf53de1c4",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%22bf1f1963-05f6-4cba-903c-5892b4ce3bd7%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%22db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%224bca096a-7de3-8675-5e86-2fa149923860%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "4bca096a-7de3-8675-5e86-2fa149923860",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226"
+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
HTTP/1.1 200 OK
"application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": null,
"displayName": null } },
HTTP/1.1 200 OK
"application": null, "device": null, "user": {
- "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
HTTP/1.1 200 OK
"application": null, "device": null, "user": {
- "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } }
The following is an example of the request.
}--> ```http
-POST /education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/7192332b-e904-4891-81e2-356242ab1858/submissions/02bb5de1-7205-2a25-fe33-f99cf53de1c4/reassign
+POST https://graph.microsoft.com/beta/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/assignments/db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a/submissions/b9dab587-5fcc-30ae-f7fa-41a47fb89972/reassign
Prefer: include-unknown-enum-members ```
HTTP/1.1 200 OK
"@odata.context": "https://graph.microsoft.com/beta/$metadata#educationSubmission", "@odata.type": "#microsoft.graph.educationSubmission", "status": "reassigned",
- "submittedDateTime": "2021-09-07T21:44:41.8377109Z",
- "unsubmittedDateTime": "2021-09-07T14:41:18.9512645Z",
+ "submittedDateTime": "2022-10-19T23:34:34.5246354Z",
+ "unsubmittedDateTime": null,
"returnedDateTime": null,
- "reassignedDateTime": "2021-09-07T21:45:42.9027726Z",
+ "reassignedDateTime": "2022-10-19T23:35:07.2786612Z",
"resourcesFolderUrl": null,
- "id": "02bb5de1-7205-2a25-fe33-f99cf53de1c4",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%22bf1f1963-05f6-4cba-903c-5892b4ce3bd7%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%22db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22b9dab587-5fcc-30ae-f7fa-41a47fb89972%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "b9dab587-5fcc-30ae-f7fa-41a47fb89972",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226"
+ "userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
HTTP/1.1 200 OK
"application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": null,
"displayName": null } },
HTTP/1.1 200 OK
"application": null, "device": null, "user": {
- "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } }
v1.0 Educationsubmission Return https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-return.md
The following is an example of the request.
}--> ```http
-POST https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/7192332b-e904-4891-81e2-356242ab1858/submissions/022fb52d-1278-d21f-e827-2221a6a3e516/return
+POST https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions/d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a/return
``` # [C#](#tab/csharp)
HTTP/1.1 200 Ok
"@odata.context": "https://graph.microsoft.com/beta/$metadata#educationSubmission", "@odata.type": "#microsoft.graph.educationSubmission", "status": "returned",
- "submittedDateTime": "2021-09-03T18:20:11.2167718Z",
+ "submittedDateTime": null,
"unsubmittedDateTime": null,
- "returnedDateTime": "2021-09-03T19:01:45.6526389Z",
- "resourcesFolderUrl": "https://graph.microsoft.com/beta/drives/b!OPmUsPgnBUiMIXMxWcj3neC1xck6I5NIsnFxfrLdmXodJYOAkI7rTLhw7ME_e42J/items/01QTY63RKYRQDN3FDQWNA24OCLHBD5C2SH",
- "id": "022fb52d-1278-d21f-e827-2221a6a3e516",
+ "returnedDateTime": "2022-10-19T23:00:30.9243194Z",
+ "reassignedDateTime": null,
+ "resourcesFolderUrl": null,
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226"
+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a",
"displayName": null } },
HTTP/1.1 200 Ok
"application": null, "device": null, "user": {
- "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ },
+ "reassignedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": null,
"displayName": null } }
v1.0 Educationsubmission Submit https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-submit.md
The following is an example of the request.
}--> ```http
-POST https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/7192332b-e904-4891-81e2-356242ab1858/submissions/02bb5de1-7205-2a25-fe33-f99cf53de1c4/submit
+POST https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions/efbecaf4-6956-4a76-6e10-b901e4de91c5/submit
``` # [C#](#tab/csharp)
HTTP/1.1 200 Ok
"@odata.context": "https://graph.microsoft.com/beta/$metadata#educationSubmission", "@odata.type": "#microsoft.graph.educationSubmission", "status": "submitted",
- "submittedDateTime": "2021-09-07T14:54:46.1606962Z",
- "unsubmittedDateTime": "2021-09-07T14:41:18.9512645Z",
- "returnedDateTime": null,
+ "submittedDateTime": "2022-10-19T23:02:20.4995757Z",
+ "unsubmittedDateTime": null,
+ "returnedDateTime": "2022-04-13T05:12:14.6531582Z",
+ "reassignedDateTime": null,
"resourcesFolderUrl": null,
- "id": "02bb5de1-7205-2a25-fe33-f99cf53de1c4",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22efbecaf4-6956-4a76-6e10-b901e4de91c5%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "efbecaf4-6956-4a76-6e10-b901e4de91c5",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226"
+ "userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
HTTP/1.1 200 Ok
"application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": null,
"displayName": null } }, "returnedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ },
+ "reassignedBy": {
"application": null, "device": null, "user": {
v1.0 Educationsubmission Unsubmit https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-unsubmit.md
The following is an example of the request.
}--> ```http
-POST https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/7192332b-e904-4891-81e2-356242ab1858/submissions/02bb5de1-7205-2a25-fe33-f99cf53de1c4/unsubmit
+POST https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/7242e03e-048c-437b-8810-3e89b285a362/submissions/3cea5cf6-55dc-d6c7-2f5b-3b5cd2e79c3a/unsubmit
``` # [C#](#tab/csharp)
HTTP/1.1 200 Ok
"@odata.type": "#microsoft.graph.educationSubmission", "status": "returned", "submittedDateTime": null,
- "unsubmittedDateTime": "2021-09-07T14:41:18.9512645Z",
- "returnedDateTime": null,
+ "unsubmittedDateTime": "2022-10-19T23:14:41.2934772Z",
+ "returnedDateTime": "2022-04-13T02:09:15.7223872Z",
+ "reassignedDateTime": null,
"resourcesFolderUrl": null,
- "id": "02bb5de1-7205-2a25-fe33-f99cf53de1c4",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%227242e03e-048c-437b-8810-3e89b285a362%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%223cea5cf6-55dc-d6c7-2f5b-3b5cd2e79c3a%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "3cea5cf6-55dc-d6c7-2f5b-3b5cd2e79c3a",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226"
+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a",
"displayName": null } },
HTTP/1.1 200 Ok
"application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } }, "returnedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ },
+ "reassignedBy": {
"application": null, "device": null, "user": {
v1.0 Educationsynchronizationprofile Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsynchronizationprofile-post.md
Title: "Create an educationSynchronizationProfile"
-description: "Create a request for a new school data synchronization profile in the tenant. Query the status to get the status of the profile. "
+description: "Create a request for a new school data synchronization profile in the tenant."
ms.localizationpriority: medium ms.prod: "education"
POST /education/synchronizationProfiles
In the request body, supply a JSON representation of the [educationSynchronizationProfile](../resources/educationsynchronizationprofile.md) object. ## Response
-If successful, this method returns a `202, Accepted` response code and an [educationSynchronizationProfile](../resources/educationsynchronizationprofile.md) object in the response body.
+If successful, this method returns a `202 Accepted` response code and an [educationSynchronizationProfile](../resources/educationsynchronizationprofile.md) object in the response body.
## Example
-##### Request
+### Request
The following is an example of the request. <!-- { "blockType": "ignored",
Content-type: application/json
{ "displayName": "Test Profile", "dataProvider": {
- "@odata.type": "#Microsoft.Education.DataSync.educationCsvDataProvider",
+ "@odata.type": "#microsoft.graph.educationCsvDataProvider",
"customizations": { "student": { "optionalPropertiesToSync": [
Content-type: application/json
} }, "identitySynchronizationConfiguration": {
- "@odata.type": "#Microsoft.Education.DataSync.educationIdentityCreationConfiguration",
+ "@odata.type": "#microsoft.graph.educationIdentityCreationConfiguration",
"userDomains": [ { "appliesTo": "student",
Content-type: application/json
} ```
-##### Response
+### Response
The following is an example of the response. >**Note:** The response object shown here might be shortened for readability.
v1.0 Emailauthenticationmethodconfiguration Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/emailauthenticationmethodconfiguration-delete.md
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account)|Policy.ReadWrite.AuthenticationMethod| |Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
+|Application|Policy.ReadWrite.AuthenticationMethod|
For delegated scenarios, the administrator needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles):
v1.0 Emailauthenticationmethodconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/emailauthenticationmethodconfiguration-get.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|Policy.ReadWrite.AuthenticationMethod|
+|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.AuthenticationMethod|
|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
+|Application|Policy.Read.All, Policy.ReadWrite.AuthenticationMethod|
For delegated scenarios, the administrator needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles):
v1.0 Emailauthenticationmethodconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/emailauthenticationmethodconfiguration-update.md
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account)|Policy.ReadWrite.AuthenticationMethod| |Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
+|Application|Policy.ReadWrite.AuthenticationMethod|
For delegated scenarios, the administrator needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles):
v1.0 Federatedidentitycredential Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/federatedidentitycredential-delete.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Application.ReadWrite.All | |Application | Application.ReadWrite.OwnedBy, Application.ReadWrite.All | - ## HTTP request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
+You can address the application using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal.
+
+You can also address the federated identity credential with either its **id** or **name**.
+<!-- { "blockType": "ignored" } -->
+```http
DELETE /applications/{id}/federatedIdentityCredentials/{federatedIdentityCredentialId} DELETE /applications/{id}/federatedIdentityCredentials/{federatedIdentityCredentialName}+
+DELETE /applications(appId='{appId}')/federatedIdentityCredentials/{federatedIdentityCredentialId}
+
+DELETE /applications(appId='{appId}')/federatedIdentityCredentials/{federatedIdentityCredentialName}
``` ## Request headers
v1.0 Federatedidentitycredential Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/federatedidentitycredential-get.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
+You can address the application using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal.
+
+You can also address the federated identity credential with either its **id** or **name**.
+<!-- { "blockType": "ignored" } -->
+```http
GET /applications/{id}/federatedIdentityCredentials/{federatedIdentityCredentialId} GET /applications/{id}/federatedIdentityCredentials/{federatedIdentityCredentialName}+
+GET /applications(appId='{appId}')/federatedIdentityCredentials/{federatedIdentityCredentialId}
+
+GET /applications(appId='{appId}')/federatedIdentityCredentials/{federatedIdentityCredentialName}
``` ## Optional query parameters
v1.0 Federatedidentitycredential Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/federatedidentitycredential-update.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
+You can address the application using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal.
+
+You can also address the federated identity credential with either its **id** or **name**.
+<!-- { "blockType": "ignored" } -->
+```http
PATCH /applications/{id}/federatedIdentityCredentials/{federatedIdentityCredentialId} PATCH /applications/{id}/federatedIdentityCredentials/{federatedIdentityCredentialName}+
+PATCH /applications(appId='{appId}')/federatedIdentityCredentials/{federatedIdentityCredentialId}
+
+PATCH /applications(appId='{appId}')/federatedIdentityCredentials/{federatedIdentityCredentialName}
``` ## Request headers
v1.0 Fido2authenticationmethodconfiguration Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/fido2authenticationmethodconfiguration-delete.md
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account)|Policy.ReadWrite.AuthenticationMethod| |Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
+|Application|Policy.ReadWrite.AuthenticationMethod|
For delegated scenarios, the administrator needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles):
v1.0 Fido2authenticationmethodconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/fido2authenticationmethodconfiguration-get.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|Policy.ReadWrite.AuthenticationMethod|
+|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.AuthenticationMethod|
|Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
+|Application|Policy.Read.All, Policy.ReadWrite.AuthenticationMethod|
For delegated scenarios, the administrator needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles):
v1.0 Fido2authenticationmethodconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/fido2authenticationmethodconfiguration-update.md
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account)|Policy.ReadWrite.AuthenticationMethod| |Delegated (personal Microsoft account)|Not supported.|
-|Application|Not supported.|
+|Application|Policy.ReadWrite.AuthenticationMethod|
For delegated scenarios, the administrator needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles):
v1.0 Group List Transitivememberof https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/group-list-transitivememberof.md
One of the following permissions is required to call this API. To learn more, in
| Permission type | Permissions (from least to most privileged) | | :- | : |
-| Delegated (work or school account) | Directory.Read.All, Directory.ReadWrite.All |
+| Delegated (work or school account) | GroupMember.Read.All, Group.Read.All, Directory.Read.All, Directory.ReadWrite.All |
| Delegated (personal Microsoft account) | Not supported. | | Application | Directory.Read.All, Directory.ReadWrite.All |
v1.0 Group List Transitivemembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/group-list-transitivemembers.md
GET /groups/{id}/transitiveMembers
This method supports the [OData query parameters](/graph/query-parameters) to help customize the response, including `$search`, `$count`, and `$filter`. You can use `$search` on the **displayName** and **description** properties. When items are added or updated for this resource, they are specially indexed for use with the `$count` and `$search` query parameters. There can be a slight delay between when an item is added or updated and when it is available in the index.
+This API returns up to 100 member objects by default. The maximum page size that you can request through the `$top` query parameter is 999 objects.
+ To filter the results on the OData type, such as `microsoft.graph.user` or `microsoft.graph.group`, you must use the [advanced query parameters](/graph/aad-advanced-queries). That is, the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string. ## Request headers
v1.0 Group List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/group-list.md
GET /groups
## Optional query parameters
-This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$search`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. The default and maximum page sizes are 100 and 999 group objects respectively. Some queries are supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
+This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$search`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. `$skip` isn't supported. The default and maximum page sizes are 100 and 999 group objects respectively. Some queries are supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
To list only Microsoft 365 groups (aka unified groups), apply a filter on **groupTypes**:
v1.0 Group Post Approleassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/group-post-approleassignments.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Use this API to assign an app role to a group. All direct members of the group will be considered assigned. To grant an app role assignment to a group, you need three identifiers:
+Use this API to assign an app role to a security group. All direct members of the group will be considered assigned. Security groups with dynamic memberships are supported. To grant an app role assignment to a group, you need three identifiers:
- **principalId**: The ID of the **group** to which you are assigning the app role. - **resourceId**: The ID of the resource **servicePrincipal** that has defined the app role.
v1.0 Identitygovernance Deleteditemcontainer Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-deleteditemcontainer-get.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_get_deleteditemcontainer_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/deletedItems/workflows/952b23c5-cc25-48c9-8848-95da4dd9dc6d?$select=id,category,displayName,description,version,executionConditions ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
Content-Type: application/json
"tasks@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/deletedItems/workflows('952b23c5-cc25-48c9-8848-95da4dd9dc6d')/tasks", "tasks": [] }
-```
+```
v1.0 Identitygovernance Lifecycleworkflowscontainer List Deleteditems https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-lifecycleworkflowscontainer-list-deleteditems.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_list_deleteditemcontainer_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/deletedItems/workflows?$select=id,category,displayName,description,version&$filter=category eq 'leaver' ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
Content-Type: application/json
} ] }
-```
+```
v1.0 Identitygovernance Lifecycleworkflowscontainer List Taskdefinitions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-lifecycleworkflowscontainer-list-taskdefinitions.md
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/taskD
``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go)
v1.0 Identitygovernance Run Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-run-get.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_get_workflow_run"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/runs/e65e08a0-d68d-41dc-915b-8c4019af5cc2?$select=id,failedTasksCount,failedUsersCount,processingStatus,totalTasksCount,totalUnprocessedTasksCount,totalUsersCount ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response
Content-Type: application/json
"totalUsersCount": 1, "totalUnprocessedTasksCount": 0 }
-```
+```
v1.0 Identitygovernance Run List Taskprocessingresults https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-run-list-taskprocessingresults.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_list_run_taskprocessingresult_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/runs/e65e08a0-d68d-41dc-915b-8c4019af5cc2/userProcessingResults/40efc576-840f-47d0-ab95-5abca800f8a2//taskProcessingResults?$select=id,failureReason,processingStatus,subject,task ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
Content-Type: application/json
} ] }
-```
+```
v1.0 Identitygovernance Run List Userprocessingresults https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-run-list-userprocessingresults.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_get_run_taskprocessingresult_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/runs/e65e08a0-d68d-41dc-915b-8c4019af5cc2/userProcessingResults?$select=id,failedTasksCount,processingStatus,totalTasksCount,totalUnprocessedTasksCount,subject ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
Content-Type: application/json
} ] }
-```
+```
v1.0 Identitygovernance Taskreport List Taskprocessingresults https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-taskreport-list-taskprocessingresults.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_list_taskreport_taskprocessingresult_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/taskReports/443c7611-45df-48c0-bf5e-dc6068c402f0/taskProcessingResults?$select=id,failureReason,processingStatus,subject,task ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
Content-Type: application/json
} ] }
-```
+```
v1.0 Identitygovernance Userprocessingresult Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-userprocessingresult-get.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_get_run_userprocessingresult"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/runs/e65e08a0-d68d-41dc-915b-8c4019af5cc2/userProcessingResults/40efc576-840f-47d0-ab95-5abca800f8a2?$select=id,failedTasksCount,processingStatus,totalTasksCount,totalUnprocessedTasksCount,subject ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
v1.0 Identitygovernance Userprocessingresult List Taskprocessingresults https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-userprocessingresult-list-taskprocessingresults.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_list_workflow_userprocessingresult_taskprocessingresult_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/userProcessingResults/40efc576-840f-47d0-ab95-5abca800f8a2/taskProcessingResults?$select=id,processingStatus,failureReason,subject,task ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response
Content-Type: application/json
} ] }
-```
+```
v1.0 Identitygovernance Userprocessingresult Summary https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-userprocessingresult-summary.md
The following is an example of the response
<!-- { "blockType": "response", "truncated": true,
- "@odata.type": "microsoft.graph.identityGovernance.usersProcessingSummary"
+ "@odata.type": "microsoft.graph.identityGovernance.userSummary"
} --> ``` http
v1.0 Identitygovernance Workflow List Runs https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-workflow-list-runs.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_list_run_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/runs?$select=id,failedTasksCount,failedUsersCount,processingStatus,totalTasksCount,totalUnprocessedTasksCount,totalUsersCount,id ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
Content-Type: application/json
} ] }
-```
+```
v1.0 Identitygovernance Workflow List Taskreports https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-workflow-list-taskreports.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_list_taskreport_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/taskReports?$select=id,failedUsersCount,processingStatus,successfulUsersCount,totalUsersCount,unprocessedUsersCount,taskDefinition,taskProcessingResults ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
Content-Type: application/json
} ] }
-```
+```
v1.0 Identitygovernance Workflow List Userprocessingresults https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-workflow-list-userprocessingresults.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_list_userprocessingresult_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/156ce798-1eb6-4e0a-8515-e79f54d04390/userProcessingResults?$select=id,failedTasksCount,processingStatus,totalTasksCount,totalUnprocessedTasksCount,workflowExecutionType,subject ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
Content-Type: application/json
} ] }
-```
+```
v1.0 Identitygovernance Workflow List Versions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-workflow-list-versions.md
Content-Type: application/json
} ```
-### Example 12: Retrieve specific properties of all versions of a workflow
+### Example 2: Retrieve specific properties of all versions of a workflow
#### Request The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_list_workflowversion_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/versions?$select=category,displayName,versionNumber ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response <!-- {
Content-Type: application/json
} ] }
-```
+```
v1.0 Identitygovernance Workflowversion Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-workflowversion-get.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_get_workflowversion_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/versions/2?$select=category,displayName,versionNumber,executionConditions&$expand=tasks ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response <!-- { "blockType": "response",
Content-Type: application/json
} ] }
-```
+```
v1.0 Internetexplorermode Delete Sitelists https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/internetexplorermode-delete-sitelists.md
+
+ Title: "Delete browserSiteList"
+description: "Delete a browserSiteList object."
+
+ms.localizationpriority: medium
++
+# Delete browserSiteList
+Namespace: microsoft.graph
++
+Delete a [browserSiteList](../resources/browsersitelist.md) object.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+The following is an example of a request.
+
+# [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
+```
+
v1.0 Internetexplorermode List Sitelists https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/internetexplorermode-list-sitelists.md
+
+ Title: "List browserSiteLists"
+description: "Get a list of the browserSiteList objects and their properties."
+
+ms.localizationpriority: medium
++
+# List browserSiteLists
+Namespace: microsoft.graph
++
+Get a list of the [browserSiteList](../resources/browsersitelist.md) objects and their properties.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/edge/internetExplorerMode/siteLists
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [browserSiteList](../resources/browsersitelist.md) objects in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+
+# [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"
+ }
+ ]
+}
+```
+
v1.0 Internetexplorermode Post Sitelists https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/internetexplorermode-post-sitelists.md
+
+ Title: "Create browserSiteList"
+description: "Create a new browserSiteList object to support Internet Explorer mode."
+
+ms.localizationpriority: medium
++
+# Create browserSiteList
+Namespace: microsoft.graph
++
+Create a new [browserSiteList](../resources/browsersitelist.md) object to support [Internet Explorer mode](/deployedge/edge-ie-mode).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|BrowserSiteLists.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BrowserSiteLists.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /admin/edge/internetExplorerMode/siteLists
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply a JSON representation of the [browserSiteList](../resources/browsersitelist.md) object.
+
+You can specify the following properties when you create a **browserSiteList**.
+
+|Property|Type|Description|
+|:|:|:|
+|description|String|Description for the site list. Required.|
+|displayName|String|Display name of the site list. Required.|
++
+## Response
+
+If successful, this method returns a `201 Created` response code and a [browserSiteList](../resources/browsersitelist.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+
+# [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
+}
+```
+
v1.0 Intune Apps Ioslobapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-ioslobapp-create.md
The following table shows the properties that are required when you create the i
|expirationDateTime|DateTimeOffset|The expiration time.| |versionNumber|String|The version number of iOS Line of Business (LoB) app.| |buildNumber|String|The build number of iOS Line of Business (LoB) app.|
-|identityVersion|String|The identity version.|
+|identityVersion|String|The identity version. This property is being deprecated in 2211(November 2022)|
v1.0 Intune Apps Ioslobapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-ioslobapp-update.md
The following table shows the properties that are required when you create the [
|expirationDateTime|DateTimeOffset|The expiration time.| |versionNumber|String|The version number of iOS Line of Business (LoB) app.| |buildNumber|String|The build number of iOS Line of Business (LoB) app.|
-|identityVersion|String|The identity version.|
+|identityVersion|String|The identity version. This property is being deprecated in 2211(November 2022)|
v1.0 Intune Apps Macoslobapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macoslobapp-create.md
The following table shows the properties that are required when you create the m
|committedContentVersion|String|The internal committed content version. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |fileName|String|The name of the main Lob application file. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |size|Int64|The total size, including all uploaded files. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)|
-|bundleId|String|The bundle id.|
-|minimumSupportedOperatingSystem|[macOSMinimumOperatingSystem](../resources/intune-apps-macosminimumoperatingsystem.md)|The value for the minimum applicable operating system.|
-|buildNumber|String|The build number of MacOS Line of Business (LoB) app.|
-|versionNumber|String|The version number of MacOS Line of Business (LoB) app.|
-|childApps|[macOSLobChildApp](../resources/intune-apps-macoslobchildapp.md) collection|The app list in this bundle package|
-|identityVersion|String|The identity version.|
-|md5HashChunkSize|Int32|The chunk size for MD5 hash|
-|md5Hash|String collection|The MD5 hash codes|
-|ignoreVersionDetection|Boolean|A boolean to control whether the app's version will be used to detect the app after it is installed on a device. Set this to true for macOS Line of Business (LoB) apps that use a self update feature.|
-|installAsManaged|Boolean|A boolean to control whether the app will be installed as managed (requires macOS 11.0 and other PKG restrictions).|
+|bundleId|String|The primary bundleId of the package.|
+|minimumSupportedOperatingSystem|[macOSMinimumOperatingSystem](../resources/intune-apps-macosminimumoperatingsystem.md)|ComplexType macOSMinimumOperatingSystem that indicates the minimum operating system applicable for the application.|
+|buildNumber|String|The build number of the package. This should match the package CFBundleShortVersionString of the .pkg file.|
+|versionNumber|String|The version number of the package. This should match the package CFBundleVersion in the packageinfo file.|
+|childApps|[macOSLobChildApp](../resources/intune-apps-macoslobchildapp.md) collection|List of ComplexType macOSLobChildApp objects. Represents the apps expected to be installed by the package.|
+|identityVersion|String|The identity version. This property is being deprecated in 2211(November 2022).|
+|md5HashChunkSize|Int32|The chunk size for MD5 hash. This is '0' or empty if the package was uploaded directly. If the Intune App Wrapping Tool is used to create a .intunemac, this value can be found inside the Detection.xml file.|
+|md5Hash|String collection|The MD5 hash codes. This is empty if the package was uploaded directly. If the Intune App Wrapping Tool is used to create a .intunemac, this value can be found inside the Detection.xml file.|
+|ignoreVersionDetection|Boolean|When TRUE, indicates that the app's version will NOT be used to detect if the app is installed on a device. When FALSE, indicates that the app's version will be used to detect if the app is installed on a device. Set this to true for apps that use a self update feature.|
+|installAsManaged|Boolean|When TRUE, indicates that the app will be installed as managed (requires macOS 11.0 and other managed package restrictions). When FALSE, indicates that the app will be installed as unmanaged.|
v1.0 Intune Apps Macoslobapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macoslobapp-update.md
The following table shows the properties that are required when you create the [
|committedContentVersion|String|The internal committed content version. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |fileName|String|The name of the main Lob application file. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |size|Int64|The total size, including all uploaded files. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)|
-|bundleId|String|The bundle id.|
-|minimumSupportedOperatingSystem|[macOSMinimumOperatingSystem](../resources/intune-apps-macosminimumoperatingsystem.md)|The value for the minimum applicable operating system.|
-|buildNumber|String|The build number of MacOS Line of Business (LoB) app.|
-|versionNumber|String|The version number of MacOS Line of Business (LoB) app.|
-|childApps|[macOSLobChildApp](../resources/intune-apps-macoslobchildapp.md) collection|The app list in this bundle package|
-|identityVersion|String|The identity version.|
-|md5HashChunkSize|Int32|The chunk size for MD5 hash|
-|md5Hash|String collection|The MD5 hash codes|
-|ignoreVersionDetection|Boolean|A boolean to control whether the app's version will be used to detect the app after it is installed on a device. Set this to true for macOS Line of Business (LoB) apps that use a self update feature.|
-|installAsManaged|Boolean|A boolean to control whether the app will be installed as managed (requires macOS 11.0 and other PKG restrictions).|
+|bundleId|String|The primary bundleId of the package.|
+|minimumSupportedOperatingSystem|[macOSMinimumOperatingSystem](../resources/intune-apps-macosminimumoperatingsystem.md)|ComplexType macOSMinimumOperatingSystem that indicates the minimum operating system applicable for the application.|
+|buildNumber|String|The build number of the package. This should match the package CFBundleShortVersionString of the .pkg file.|
+|versionNumber|String|The version number of the package. This should match the package CFBundleVersion in the packageinfo file.|
+|childApps|[macOSLobChildApp](../resources/intune-apps-macoslobchildapp.md) collection|List of ComplexType macOSLobChildApp objects. Represents the apps expected to be installed by the package.|
+|identityVersion|String|The identity version. This property is being deprecated in 2211(November 2022).|
+|md5HashChunkSize|Int32|The chunk size for MD5 hash. This is '0' or empty if the package was uploaded directly. If the Intune App Wrapping Tool is used to create a .intunemac, this value can be found inside the Detection.xml file.|
+|md5Hash|String collection|The MD5 hash codes. This is empty if the package was uploaded directly. If the Intune App Wrapping Tool is used to create a .intunemac, this value can be found inside the Detection.xml file.|
+|ignoreVersionDetection|Boolean|When TRUE, indicates that the app's version will NOT be used to detect if the app is installed on a device. When FALSE, indicates that the app's version will be used to detect if the app is installed on a device. Set this to true for apps that use a self update feature.|
+|installAsManaged|Boolean|When TRUE, indicates that the app will be installed as managed (requires macOS 11.0 and other managed package restrictions). When FALSE, indicates that the app will be installed as unmanaged.|
v1.0 Intune Apps Macosmicrosoftdefenderapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmicrosoftdefenderapp-create.md
+
+ Title: "Create macOSMicrosoftDefenderApp"
+description: "Create a new macOSMicrosoftDefenderApp object."
+
+localization_priority: Normal
++
+# Create macOSMicrosoftDefenderApp
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Create a new [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object.
+
+## Prerequisites
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementApps.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementApps.ReadWrite.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceAppManagement/mobileApps
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+In the request body, supply a JSON representation for the macOSMicrosoftDefenderApp object.
+
+The following table shows the properties that are required when you create the macOSMicrosoftDefenderApp.
+
+|Property|Type|Description|
+|:|:|:|
+|id|String|Key of the entity. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|displayName|String|The admin provided or imported title of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|description|String|The description of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|publisher|String|The publisher of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|largeIcon|[mimeContent](../resources/intune-shared-mimecontent.md)|The large icon, to be displayed in the app details and used for upload of the icon. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|createdDateTime|DateTimeOffset|The date and time the app was created. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|lastModifiedDateTime|DateTimeOffset|The date and time the app was last modified. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|isFeatured|Boolean|The value indicating whether the app is marked as featured by the admin. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|privacyInformationUrl|String|The privacy statement Url. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|informationUrl|String|The more information Url. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|owner|String|The owner of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|developer|String|The developer of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|notes|String|Notes for the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|uploadState|Int32|The upload state. Possible values are: 0 - `Not Ready`, 1 - `Ready`, 2 - `Processing`. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|publishingState|[mobileAppPublishingState](../resources/intune-apps-mobileapppublishingstate.md)|The publishing state for the app. The app cannot be assigned unless the app is published. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md). Possible values are: `notPublished`, `processing`, `published`.|
+|isAssigned|Boolean|The value indicating whether the app is assigned to at least one group. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|roleScopeTagIds|String collection|List of scope tag ids for this mobile app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+++
+## Response
+If successful, this method returns a `201 Created` response code and a [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps
+Content-type: application/json
+Content-length: 781
+
+{
+ "@odata.type": "#microsoft.graph.macOSMicrosoftDefenderApp",
+ "displayName": "Display Name value",
+ "description": "Description value",
+ "publisher": "Publisher value",
+ "largeIcon": {
+ "@odata.type": "microsoft.graph.mimeContent",
+ "type": "Type value",
+ "value": "dmFsdWU="
+ },
+ "isFeatured": true,
+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
+ "informationUrl": "https://example.com/informationUrl/",
+ "owner": "Owner value",
+ "developer": "Developer value",
+ "notes": "Notes value",
+ "uploadState": 11,
+ "publishingState": "processing",
+ "isAssigned": true,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ],
+ "dependentAppCount": 1,
+ "supersedingAppCount": 3,
+ "supersededAppCount": 2
+}
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+Content-Length: 953
+
+{
+ "@odata.type": "#microsoft.graph.macOSMicrosoftDefenderApp",
+ "id": "ca25fa0c-fa0c-ca25-0cfa-25ca0cfa25ca",
+ "displayName": "Display Name value",
+ "description": "Description value",
+ "publisher": "Publisher value",
+ "largeIcon": {
+ "@odata.type": "microsoft.graph.mimeContent",
+ "type": "Type value",
+ "value": "dmFsdWU="
+ },
+ "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
+ "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
+ "isFeatured": true,
+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
+ "informationUrl": "https://example.com/informationUrl/",
+ "owner": "Owner value",
+ "developer": "Developer value",
+ "notes": "Notes value",
+ "uploadState": 11,
+ "publishingState": "processing",
+ "isAssigned": true,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ],
+ "dependentAppCount": 1,
+ "supersedingAppCount": 3,
+ "supersededAppCount": 2
+}
+```
+++++
v1.0 Intune Apps Macosmicrosoftdefenderapp Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmicrosoftdefenderapp-delete.md
+
+ Title: "Delete macOSMicrosoftDefenderApp"
+description: "Deletes a macOSMicrosoftDefenderApp."
+
+localization_priority: Normal
++
+# Delete macOSMicrosoftDefenderApp
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Deletes a [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md).
+
+## Prerequisites
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementApps.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementApps.ReadWrite.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /deviceAppManagement/mobileApps/{mobileAppId}
+DELETE /deviceAppManagement/mobileApps/{mobileAppId}/userStatuses/{userAppInstallStatusId}/app
+DELETE /deviceAppManagement/mobileApps/{mobileAppId}/deviceStatuses/{mobileAppInstallStatusId}/app
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns a `204 No Content` response code.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 204 No Content
+```
+++++
v1.0 Intune Apps Macosmicrosoftdefenderapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmicrosoftdefenderapp-get.md
+
+ Title: "Get macOSMicrosoftDefenderApp"
+description: "Read properties and relationships of the macOSMicrosoftDefenderApp object."
+
+localization_priority: Normal
++
+# Get macOSMicrosoftDefenderApp
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Read properties and relationships of the [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object.
+
+## Prerequisites
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /deviceAppManagement/mobileApps/{mobileAppId}
+GET /deviceAppManagement/mobileApps/{mobileAppId}/userStatuses/{userAppInstallStatusId}/app
+GET /deviceAppManagement/mobileApps/{mobileAppId}/deviceStatuses/{mobileAppInstallStatusId}/app
+```
+
+## Optional query parameters
+This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns a `200 OK` response code and [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+GET https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 1026
+
+{
+ "value": {
+ "@odata.type": "#microsoft.graph.macOSMicrosoftDefenderApp",
+ "id": "ca25fa0c-fa0c-ca25-0cfa-25ca0cfa25ca",
+ "displayName": "Display Name value",
+ "description": "Description value",
+ "publisher": "Publisher value",
+ "largeIcon": {
+ "@odata.type": "microsoft.graph.mimeContent",
+ "type": "Type value",
+ "value": "dmFsdWU="
+ },
+ "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
+ "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
+ "isFeatured": true,
+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
+ "informationUrl": "https://example.com/informationUrl/",
+ "owner": "Owner value",
+ "developer": "Developer value",
+ "notes": "Notes value",
+ "uploadState": 11,
+ "publishingState": "processing",
+ "isAssigned": true,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ],
+ "dependentAppCount": 1,
+ "supersedingAppCount": 3,
+ "supersededAppCount": 2
+ }
+}
+```
+++++
v1.0 Intune Apps Macosmicrosoftdefenderapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmicrosoftdefenderapp-list.md
+
+ Title: "List macOSMicrosoftDefenderApps"
+description: "List properties and relationships of the macOSMicrosoftDefenderApp objects."
+
+localization_priority: Normal
++
+# List macOSMicrosoftDefenderApps
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+List properties and relationships of the [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) objects.
+
+## Prerequisites
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /deviceAppManagement/mobileApps
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns a `200 OK` response code and a collection of [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) objects in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+GET https://graph.microsoft.com/beta/deviceAppManagement/mobileApps
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 1094
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.macOSMicrosoftDefenderApp",
+ "id": "ca25fa0c-fa0c-ca25-0cfa-25ca0cfa25ca",
+ "displayName": "Display Name value",
+ "description": "Description value",
+ "publisher": "Publisher value",
+ "largeIcon": {
+ "@odata.type": "microsoft.graph.mimeContent",
+ "type": "Type value",
+ "value": "dmFsdWU="
+ },
+ "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
+ "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
+ "isFeatured": true,
+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
+ "informationUrl": "https://example.com/informationUrl/",
+ "owner": "Owner value",
+ "developer": "Developer value",
+ "notes": "Notes value",
+ "uploadState": 11,
+ "publishingState": "processing",
+ "isAssigned": true,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ],
+ "dependentAppCount": 1,
+ "supersedingAppCount": 3,
+ "supersededAppCount": 2
+ }
+ ]
+}
+```
+++++
v1.0 Intune Apps Macosmicrosoftdefenderapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmicrosoftdefenderapp-update.md
+
+ Title: "Update macOSMicrosoftDefenderApp"
+description: "Update the properties of a macOSMicrosoftDefenderApp object."
+
+localization_priority: Normal
++
+# Update macOSMicrosoftDefenderApp
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Update the properties of a [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object.
+
+## Prerequisites
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementApps.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementApps.ReadWrite.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /deviceAppManagement/mobileApps/{mobileAppId}
+PATCH /deviceAppManagement/mobileApps/{mobileAppId}/userStatuses/{userAppInstallStatusId}/app
+PATCH /deviceAppManagement/mobileApps/{mobileAppId}/deviceStatuses/{mobileAppInstallStatusId}/app
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+In the request body, supply a JSON representation for the [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object.
+
+The following table shows the properties that are required when you create the [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md).
+
+|Property|Type|Description|
+|:|:|:|
+|id|String|Key of the entity. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|displayName|String|The admin provided or imported title of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|description|String|The description of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|publisher|String|The publisher of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|largeIcon|[mimeContent](../resources/intune-shared-mimecontent.md)|The large icon, to be displayed in the app details and used for upload of the icon. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|createdDateTime|DateTimeOffset|The date and time the app was created. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|lastModifiedDateTime|DateTimeOffset|The date and time the app was last modified. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|isFeatured|Boolean|The value indicating whether the app is marked as featured by the admin. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|privacyInformationUrl|String|The privacy statement Url. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|informationUrl|String|The more information Url. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|owner|String|The owner of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|developer|String|The developer of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|notes|String|Notes for the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|uploadState|Int32|The upload state. Possible values are: 0 - `Not Ready`, 1 - `Ready`, 2 - `Processing`. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|publishingState|[mobileAppPublishingState](../resources/intune-apps-mobileapppublishingstate.md)|The publishing state for the app. The app cannot be assigned unless the app is published. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md). Possible values are: `notPublished`, `processing`, `published`.|
+|isAssigned|Boolean|The value indicating whether the app is assigned to at least one group. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|roleScopeTagIds|String collection|List of scope tag ids for this mobile app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+++
+## Response
+If successful, this method returns a `200 OK` response code and an updated [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}
+Content-type: application/json
+Content-length: 781
+
+{
+ "@odata.type": "#microsoft.graph.macOSMicrosoftDefenderApp",
+ "displayName": "Display Name value",
+ "description": "Description value",
+ "publisher": "Publisher value",
+ "largeIcon": {
+ "@odata.type": "microsoft.graph.mimeContent",
+ "type": "Type value",
+ "value": "dmFsdWU="
+ },
+ "isFeatured": true,
+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
+ "informationUrl": "https://example.com/informationUrl/",
+ "owner": "Owner value",
+ "developer": "Developer value",
+ "notes": "Notes value",
+ "uploadState": 11,
+ "publishingState": "processing",
+ "isAssigned": true,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ],
+ "dependentAppCount": 1,
+ "supersedingAppCount": 3,
+ "supersededAppCount": 2
+}
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 953
+
+{
+ "@odata.type": "#microsoft.graph.macOSMicrosoftDefenderApp",
+ "id": "ca25fa0c-fa0c-ca25-0cfa-25ca0cfa25ca",
+ "displayName": "Display Name value",
+ "description": "Description value",
+ "publisher": "Publisher value",
+ "largeIcon": {
+ "@odata.type": "microsoft.graph.mimeContent",
+ "type": "Type value",
+ "value": "dmFsdWU="
+ },
+ "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
+ "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
+ "isFeatured": true,
+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
+ "informationUrl": "https://example.com/informationUrl/",
+ "owner": "Owner value",
+ "developer": "Developer value",
+ "notes": "Notes value",
+ "uploadState": 11,
+ "publishingState": "processing",
+ "isAssigned": true,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ],
+ "dependentAppCount": 1,
+ "supersedingAppCount": 3,
+ "supersededAppCount": 2
+}
+```
+++++
v1.0 Intune Apps Macosmicrosoftedgeapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmicrosoftedgeapp-create.md
The following table shows the properties that are required when you create the m
|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
-|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`.|
+|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`, `unknownFutureValue`.|
v1.0 Intune Apps Macosmicrosoftedgeapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmicrosoftedgeapp-update.md
The following table shows the properties that are required when you create the [
|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
-|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`.|
+|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`, `unknownFutureValue`.|
v1.0 Intune Apps Windowsmicrosoftedgeapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-windowsmicrosoftedgeapp-create.md
The following table shows the properties that are required when you create the w
|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
-|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`.|
+|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`, `unknownFutureValue`.|
|displayLanguageLocale|String|The language locale to use when the Edge app displays text to the user.|
v1.0 Intune Apps Windowsmicrosoftedgeapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-windowsmicrosoftedgeapp-update.md
The following table shows the properties that are required when you create the [
|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
-|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`.|
+|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`, `unknownFutureValue`.|
|displayLanguageLocale|String|The language locale to use when the Edge app displays text to the user.|
v1.0 Intune Apps Wingetapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-wingetapp-create.md
The following table shows the properties that are required when you create the w
|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|manifestHash|String|Hash of package metadata properties used to validate that the application matches the metadata in the source repository.|
|packageIdentifier|String|The PackageIdentifier from the WinGet source repository REST API. This also maps to the Id when using the WinGet client command line application. Required at creation time, cannot be modified on existing objects.| |installExperience|[winGetAppInstallExperience](../resources/intune-apps-wingetappinstallexperience.md)|The install experience settings associated with this application, which are used to ensure the desired install experiences on the target device are taken into account. This includes the account type (System or User) that actions should be run as on target devices. Required at creation time.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps Content-type: application/json
-Content-length: 943
+Content-length: 985
{ "@odata.type": "#microsoft.graph.winGetApp",
Content-length: 943
"dependentAppCount": 1, "supersedingAppCount": 3, "supersededAppCount": 2,
+ "manifestHash": "Manifest Hash value",
"packageIdentifier": "Package Identifier value", "installExperience": { "@odata.type": "microsoft.graph.winGetAppInstallExperience",
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 1115
+Content-Length: 1157
{ "@odata.type": "#microsoft.graph.winGetApp",
Content-Length: 1115
"dependentAppCount": 1, "supersedingAppCount": 3, "supersededAppCount": 2,
+ "manifestHash": "Manifest Hash value",
"packageIdentifier": "Package Identifier value", "installExperience": { "@odata.type": "microsoft.graph.winGetAppInstallExperience",
v1.0 Intune Apps Wingetapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-wingetapp-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1198
+Content-Length: 1242
{ "value": {
Content-Length: 1198
"dependentAppCount": 1, "supersedingAppCount": 3, "supersededAppCount": 2,
+ "manifestHash": "Manifest Hash value",
"packageIdentifier": "Package Identifier value", "installExperience": { "@odata.type": "microsoft.graph.winGetAppInstallExperience",
v1.0 Intune Apps Wingetapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-wingetapp-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1276
+Content-Length: 1322
{ "value": [
Content-Length: 1276
"dependentAppCount": 1, "supersedingAppCount": 3, "supersededAppCount": 2,
+ "manifestHash": "Manifest Hash value",
"packageIdentifier": "Package Identifier value", "installExperience": { "@odata.type": "microsoft.graph.winGetAppInstallExperience",
v1.0 Intune Apps Wingetapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-wingetapp-update.md
The following table shows the properties that are required when you create the [
|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|manifestHash|String|Hash of package metadata properties used to validate that the application matches the metadata in the source repository.|
|packageIdentifier|String|The PackageIdentifier from the WinGet source repository REST API. This also maps to the Id when using the WinGet client command line application. Required at creation time, cannot be modified on existing objects.| |installExperience|[winGetAppInstallExperience](../resources/intune-apps-wingetappinstallexperience.md)|The install experience settings associated with this application, which are used to ensure the desired install experiences on the target device are taken into account. This includes the account type (System or User) that actions should be run as on target devices. Required at creation time.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId} Content-type: application/json
-Content-length: 943
+Content-length: 985
{ "@odata.type": "#microsoft.graph.winGetApp",
Content-length: 943
"dependentAppCount": 1, "supersedingAppCount": 3, "supersededAppCount": 2,
+ "manifestHash": "Manifest Hash value",
"packageIdentifier": "Package Identifier value", "installExperience": { "@odata.type": "microsoft.graph.winGetAppInstallExperience",
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1115
+Content-Length: 1157
{ "@odata.type": "#microsoft.graph.winGetApp",
Content-Length: 1115
"dependentAppCount": 1, "supersedingAppCount": 3, "supersededAppCount": 2,
+ "manifestHash": "Manifest Hash value",
"packageIdentifier": "Package Identifier value", "installExperience": { "@odata.type": "microsoft.graph.winGetAppInstallExperience",
v1.0 Intune Deviceconfig Androiddeviceownergeneraldeviceconfiguration Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownergeneraldeviceconfiguration-create.md
The following table shows the properties that are required when you create the a
|networkEscapeHatchAllowed|Boolean|Indicates whether or not the device will allow connecting to a temporary network connection at boot time.| |nfcBlockOutgoingBeam|Boolean|Indicates whether or not to block NFC outgoing beam.| |passwordBlockKeyguard|Boolean|Indicates whether or not the keyguard is disabled.|
-|passwordBlockKeyguardFeatures|[androidKeyguardFeature](../resources/intune-deviceconfig-androidkeyguardfeature.md) collection|List of device keyguard features to block. This collection can contain a maximum of 7 elements. Possible values are: `notConfigured`, `camera`, `notifications`, `unredactedNotifications`, `trustAgents`, `fingerprint`, `remoteInput`, `allFeatures`, `face`, `iris`, `biometrics`.|
+|passwordBlockKeyguardFeatures|[androidKeyguardFeature](../resources/intune-deviceconfig-androidkeyguardfeature.md) collection|List of device keyguard features to block. This collection can contain a maximum of 11 elements. Possible values are: `notConfigured`, `camera`, `notifications`, `unredactedNotifications`, `trustAgents`, `fingerprint`, `remoteInput`, `allFeatures`, `face`, `iris`, `biometrics`.|
|passwordExpirationDays|Int32|Indicates the amount of time that a password can be set for before it expires and a new password will be required. Valid values 1 to 365| |passwordMinimumLength|Int32|Indicates the minimum length of the password required on the device. Valid values 4 to 16| |passwordMinimumLetterCharacters|Int32|Indicates the minimum number of letter characters required for device password. Valid values 1 to 16|
v1.0 Intune Deviceconfig Androiddeviceownergeneraldeviceconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownergeneraldeviceconfiguration-update.md
The following table shows the properties that are required when you create the [
|networkEscapeHatchAllowed|Boolean|Indicates whether or not the device will allow connecting to a temporary network connection at boot time.| |nfcBlockOutgoingBeam|Boolean|Indicates whether or not to block NFC outgoing beam.| |passwordBlockKeyguard|Boolean|Indicates whether or not the keyguard is disabled.|
-|passwordBlockKeyguardFeatures|[androidKeyguardFeature](../resources/intune-deviceconfig-androidkeyguardfeature.md) collection|List of device keyguard features to block. This collection can contain a maximum of 7 elements. Possible values are: `notConfigured`, `camera`, `notifications`, `unredactedNotifications`, `trustAgents`, `fingerprint`, `remoteInput`, `allFeatures`, `face`, `iris`, `biometrics`.|
+|passwordBlockKeyguardFeatures|[androidKeyguardFeature](../resources/intune-deviceconfig-androidkeyguardfeature.md) collection|List of device keyguard features to block. This collection can contain a maximum of 11 elements. Possible values are: `notConfigured`, `camera`, `notifications`, `unredactedNotifications`, `trustAgents`, `fingerprint`, `remoteInput`, `allFeatures`, `face`, `iris`, `biometrics`.|
|passwordExpirationDays|Int32|Indicates the amount of time that a password can be set for before it expires and a new password will be required. Valid values 1 to 365| |passwordMinimumLength|Int32|Indicates the minimum length of the password required on the device. Valid values 4 to 16| |passwordMinimumLetterCharacters|Int32|Indicates the minimum number of letter characters required for device password. Valid values 1 to 16|
v1.0 Intune Deviceconfig Devicecompliancepolicy Setscheduledretirestate https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfig-devicecompliancepolicy-setscheduledretirestate.md
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
+|scopedToAllDevices|Boolean|Not yet documented|
|state|[scheduledRetireState](../resources/intune-deviceconfig-scheduledretirestate.md)|Not yet documented| |managedDeviceIds|String collection|Not yet documented|
Here is an example of the request.
POST https://graph.microsoft.com/beta/deviceManagement/deviceCompliancePolicies/setScheduledRetireState Content-type: application/json
-Content-length: 95
+Content-length: 126
{
+ "scopedToAllDevices": true,
"state": "confirmRetire", "managedDeviceIds": [ "Managed Device Ids value"
v1.0 Intune Deviceconfigv2 Devicemanagementcompliancepolicy Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementcompliancepolicy-create.md
The following table shows the properties that are required when you create the d
|name|String|Policy name| |description|String|Policy description| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this policy. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
|createdDateTime|DateTimeOffset|Policy creation date and time. This property is read-only.| |lastModifiedDateTime|DateTimeOffset|Policy last modification date and time. This property is read-only.| |settingCount|Int32|Number of settings. This property is read-only.|
v1.0 Intune Deviceconfigv2 Devicemanagementcompliancepolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementcompliancepolicy-update.md
The following table shows the properties that are required when you create the [
|name|String|Policy name| |description|String|Policy description| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this policy. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
|createdDateTime|DateTimeOffset|Policy creation date and time. This property is read-only.| |lastModifiedDateTime|DateTimeOffset|Policy last modification date and time. This property is read-only.| |settingCount|Int32|Number of settings. This property is read-only.|
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationcategory Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationcategory-create.md
The following table shows the properties that are required when you create the d
|name|String|Name of the item| |displayName|String|Display name of the item| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms types, which settings in the category have. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies types, which settings in the category have. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies types, which settings in the category have. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicates that the category contains settings that are used for Compliance or Configuration. Possible values are: `none`, `configuration`, `compliance`.| |parentCategoryId|String|Parent id of the category.| |rootCategoryId|String|Root id of the category.|
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationcategory Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationcategory-update.md
The following table shows the properties that are required when you create the [
|name|String|Name of the item| |displayName|String|Display name of the item| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms types, which settings in the category have. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies types, which settings in the category have. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies types, which settings in the category have. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicates that the category contains settings that are used for Compliance or Configuration. Possible values are: `none`, `configuration`, `compliance`.| |parentCategoryId|String|Parent id of the category.| |rootCategoryId|String|Root id of the category.|
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Assign https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-assign.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-POST /deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}/assign
POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assign POST /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId}/assign ```
If successful, this action returns a `200 OK` response code and a [deviceManagem
### Request Here is an example of the request. ``` http
-POST https://graph.microsoft.com/beta/deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}/assign
+POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assign
Content-type: application/json Content-length: 593
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-create.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-POST /deviceManagementConfigurationPolicy
POST /deviceManagement/configurationPolicies POST /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies ```
The following table shows the properties that are required when you create the d
|name|String|Policy name| |description|String|Policy description| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this policy. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
|createdDateTime|DateTimeOffset|Policy creation date and time| |lastModifiedDateTime|DateTimeOffset|Policy last modification date and time| |settingCount|Int32|Number of settings|
If successful, this method returns a `201 Created` response code and a [deviceMa
### Request Here is an example of the request. ``` http
-POST https://graph.microsoft.com/beta/deviceManagementConfigurationPolicy
+POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies
Content-type: application/json
-Content-length: 789
+Content-length: 809
{ "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicy",
Content-length: 789
"templateDisplayVersion": "Template Display Version value" }, "priorityMetaData": {
- "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData"
+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
+ "priority": 8
} } ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 961
+Content-Length: 981
{ "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicy",
Content-Length: 961
"templateDisplayVersion": "Template Display Version value" }, "priorityMetaData": {
- "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData"
+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
+ "priority": 8
} } ```
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Createcopy https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-createcopy.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-POST /deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}/createCopy
POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/createCopy POST /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId}/createCopy ```
If successful, this action returns a `200 OK` response code and a [deviceManagem
### Request Here is an example of the request. ``` http
-POST https://graph.microsoft.com/beta/deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}/createCopy
+POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/createCopy
Content-type: application/json Content-length: 82
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1028
+Content-Length: 1050
{ "value": {
Content-Length: 1028
"templateDisplayVersion": "Template Display Version value" }, "priorityMetaData": {
- "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData"
+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
+ "priority": 8
} } }
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-delete.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-DELETE /deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}
DELETE /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId} DELETE /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId} ```
If successful, this method returns a `204 No Content` response code.
### Request Here is an example of the request. ``` http
-DELETE https://graph.microsoft.com/beta/deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}
+DELETE https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}
``` ### Response
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-get.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-GET /deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}
GET /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId} GET /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId} ```
If successful, this method returns a `200 OK` response code and [deviceManagemen
### Request Here is an example of the request. ``` http
-GET https://graph.microsoft.com/beta/deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}
+GET https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}
``` ### Response
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1028
+Content-Length: 1050
{ "value": {
Content-Length: 1028
"templateDisplayVersion": "Template Display Version value" }, "priorityMetaData": {
- "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData"
+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
+ "priority": 8
} } }
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-list.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-GET /deviceManagementConfigurationPolicy
GET /deviceManagement/configurationPolicies GET /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies ```
If successful, this method returns a `200 OK` response code and a collection of
### Request Here is an example of the request. ``` http
-GET https://graph.microsoft.com/beta/deviceManagementConfigurationPolicy
+GET https://graph.microsoft.com/beta/deviceManagement/configurationPolicies
``` ### Response
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1090
+Content-Length: 1114
{ "value": [
Content-Length: 1090
"templateDisplayVersion": "Template Display Version value" }, "priorityMetaData": {
- "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData"
+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
+ "priority": 8
} } ]
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Reorder https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-reorder.md
+
+ Title: "reorder action"
+description: "Not yet documented"
+
+localization_priority: Normal
++
+# reorder action
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Not yet documented
+
+## Prerequisites
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementConfiguration.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementConfiguration.Read.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/reorder
+POST /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId}/reorder
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+In the request body, supply JSON representation of the parameters.
+
+The following table shows the parameters that can be used with this action.
+
+|Property|Type|Description|
+|:|:|:|
+|priority|Int32|Not yet documented|
+++
+## Response
+If successful, this action returns a `204 No Content` response code.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/reorder
+
+Content-type: application/json
+Content-length: 21
+
+{
+ "priority": 8
+}
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 204 No Content
+```
+++++
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-update.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-PATCH /deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}
PATCH /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId} PATCH /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId} ```
The following table shows the properties that are required when you create the [
|name|String|Policy name| |description|String|Policy description| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this policy. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
|createdDateTime|DateTimeOffset|Policy creation date and time| |lastModifiedDateTime|DateTimeOffset|Policy last modification date and time| |settingCount|Int32|Number of settings|
If successful, this method returns a `200 OK` response code and an updated [devi
### Request Here is an example of the request. ``` http
-PATCH https://graph.microsoft.com/beta/deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}
+PATCH https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}
Content-type: application/json
-Content-length: 789
+Content-length: 809
{ "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicy",
Content-length: 789
"templateDisplayVersion": "Template Display Version value" }, "priorityMetaData": {
- "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData"
+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
+ "priority": 8
} } ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 961
+Content-Length: 981
{ "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicy",
Content-Length: 961
"templateDisplayVersion": "Template Display Version value" }, "priorityMetaData": {
- "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData"
+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
+ "priority": 8
} } ```
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicytemplate Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicytemplate-create.md
The following table shows the properties that are required when you create the d
|displayVersion|String|Description of template version| |lifecycleState|[deviceManagementTemplateLifecycleState](../resources/intune-deviceconfigv2-devicemanagementtemplatelifecyclestate.md)|Indicate current lifecycle state of template. Possible values are: `invalid`, `draft`, `active`, `superseded`, `deprecated`, `retired`.| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this template. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this template. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
-|templateFamily|[deviceManagementConfigurationTemplateFamily](../resources/intune-deviceconfigv2-devicemanagementconfigurationtemplatefamily.md)|TemplateFamily for this template. Possible values are: `none`, `endpointSecurityAntivirus`, `endpointSecurityDiskEncryption`, `endpointSecurityFirewall`, `endpointSecurityEndpointDetectionAndResponse`, `endpointSecurityAttackSurfaceReduction`, `endpointSecurityAccountProtection`, `endpointSecurityApplicationControl`, `enrollmentConfiguration`, `baseline`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this template. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
+|templateFamily|[deviceManagementConfigurationTemplateFamily](../resources/intune-deviceconfigv2-devicemanagementconfigurationtemplatefamily.md)|TemplateFamily for this template. Possible values are: `none`, `endpointSecurityAntivirus`, `endpointSecurityDiskEncryption`, `endpointSecurityFirewall`, `endpointSecurityEndpointDetectionAndResponse`, `endpointSecurityAttackSurfaceReduction`, `endpointSecurityAccountProtection`, `endpointSecurityApplicationControl`, `endpointSecurityEndpointPrivilegeManagement`, `enrollmentConfiguration`, `appQuietTime`, `baseline`, `unknownFutureValue`.|
|allowUnmanagedSettings|Boolean|Allow unmanaged setting templates| |settingTemplateCount|Int32|Number of setting templates. Valid values 0 to 2147483647. This property is read-only.|
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicytemplate Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicytemplate-update.md
The following table shows the properties that are required when you create the [
|displayVersion|String|Description of template version| |lifecycleState|[deviceManagementTemplateLifecycleState](../resources/intune-deviceconfigv2-devicemanagementtemplatelifecyclestate.md)|Indicate current lifecycle state of template. Possible values are: `invalid`, `draft`, `active`, `superseded`, `deprecated`, `retired`.| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this template. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this template. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
-|templateFamily|[deviceManagementConfigurationTemplateFamily](../resources/intune-deviceconfigv2-devicemanagementconfigurationtemplatefamily.md)|TemplateFamily for this template. Possible values are: `none`, `endpointSecurityAntivirus`, `endpointSecurityDiskEncryption`, `endpointSecurityFirewall`, `endpointSecurityEndpointDetectionAndResponse`, `endpointSecurityAttackSurfaceReduction`, `endpointSecurityAccountProtection`, `endpointSecurityApplicationControl`, `enrollmentConfiguration`, `baseline`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this template. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
+|templateFamily|[deviceManagementConfigurationTemplateFamily](../resources/intune-deviceconfigv2-devicemanagementconfigurationtemplatefamily.md)|TemplateFamily for this template. Possible values are: `none`, `endpointSecurityAntivirus`, `endpointSecurityDiskEncryption`, `endpointSecurityFirewall`, `endpointSecurityEndpointDetectionAndResponse`, `endpointSecurityAttackSurfaceReduction`, `endpointSecurityAccountProtection`, `endpointSecurityApplicationControl`, `endpointSecurityEndpointPrivilegeManagement`, `enrollmentConfiguration`, `appQuietTime`, `baseline`, `unknownFutureValue`.|
|allowUnmanagedSettings|Boolean|Allow unmanaged setting templates| |settingTemplateCount|Int32|Number of setting templates. Valid values 0 to 2147483647. This property is read-only.|
v1.0 Intune Devices Comanagementeligibledevice Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-comanagementeligibledevice-create.md
The following table shows the properties that are required when you create the c
|upn|String|UPN| |userEmail|String|UserEmail| |userName|String|UserName|
-|status|[comanagementEligibleType](../resources/intune-devices-comanagementeligibletype.md)|ComanagementEligibleStatus. Possible values are: `comanaged`, `eligible`, `eligibleButNotAzureAdJoined`, `needsOsUpdate`, `ineligible`, `scheduledForEnrollment`.|
+|status|[comanagementEligibleType](../resources/intune-devices-comanagementeligibletype.md)|ComanagementEligibleStatus. Possible values are: `comanaged`, `eligible`, `eligibleButNotAzureAdJoined`, `needsOsUpdate`, `ineligible`, `scheduledForEnrollment`, `unknownFutureValue`.|
v1.0 Intune Devices Comanagementeligibledevice Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-comanagementeligibledevice-update.md
The following table shows the properties that are required when you create the [
|upn|String|UPN| |userEmail|String|UserEmail| |userName|String|UserName|
-|status|[comanagementEligibleType](../resources/intune-devices-comanagementeligibletype.md)|ComanagementEligibleStatus. Possible values are: `comanaged`, `eligible`, `eligibleButNotAzureAdJoined`, `needsOsUpdate`, `ineligible`, `scheduledForEnrollment`.|
+|status|[comanagementEligibleType](../resources/intune-devices-comanagementeligibletype.md)|ComanagementEligibleStatus. Possible values are: `comanaged`, `eligible`, `eligibleButNotAzureAdJoined`, `needsOsUpdate`, `ineligible`, `scheduledForEnrollment`, `unknownFutureValue`.|
v1.0 Intune Devices Detectedapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-detectedapp-create.md
The following table shows the properties that are required when you create the d
|sizeInByte|Int64|Discovered application size in bytes. Read-only| |deviceCount|Int32|The number of devices that have installed this application| |publisher|String|Indicates the publisher of the discovered application. For example: 'Microsoft'. The default value is an empty string.|
-|platform|[detectedAppPlatformType](../resources/intune-devices-detectedappplatformtype.md)|Indicates the operating system / platform of the discovered application. Some possible values are Windows, iOS, macOS. The default value is unknown (0). Possible values are: `unknown`, `windows`, `windowsMobile`, `windowsHolographic`, `ios`, `macOS`, `chromeOS`, `androidOSP`, `androidDeviceAdministrator`, `androidWorkProfile`, `androidDedicatedAndFullyManaged`.|
+|platform|[detectedAppPlatformType](../resources/intune-devices-detectedappplatformtype.md)|Indicates the operating system / platform of the discovered application. Some possible values are Windows, iOS, macOS. The default value is unknown (0). Possible values are: `unknown`, `windows`, `windowsMobile`, `windowsHolographic`, `ios`, `macOS`, `chromeOS`, `androidOSP`, `androidDeviceAdministrator`, `androidWorkProfile`, `androidDedicatedAndFullyManaged`, `unknownFutureValue`.|
v1.0 Intune Devices Detectedapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-detectedapp-update.md
The following table shows the properties that are required when you create the [
|sizeInByte|Int64|Discovered application size in bytes. Read-only| |deviceCount|Int32|The number of devices that have installed this application| |publisher|String|Indicates the publisher of the discovered application. For example: 'Microsoft'. The default value is an empty string.|
-|platform|[detectedAppPlatformType](../resources/intune-devices-detectedappplatformtype.md)|Indicates the operating system / platform of the discovered application. Some possible values are Windows, iOS, macOS. The default value is unknown (0). Possible values are: `unknown`, `windows`, `windowsMobile`, `windowsHolographic`, `ios`, `macOS`, `chromeOS`, `androidOSP`, `androidDeviceAdministrator`, `androidWorkProfile`, `androidDedicatedAndFullyManaged`.|
+|platform|[detectedAppPlatformType](../resources/intune-devices-detectedappplatformtype.md)|Indicates the operating system / platform of the discovered application. Some possible values are Windows, iOS, macOS. The default value is unknown (0). Possible values are: `unknown`, `windows`, `windowsMobile`, `windowsHolographic`, `ios`, `macOS`, `chromeOS`, `androidOSP`, `androidDeviceAdministrator`, `androidWorkProfile`, `androidDedicatedAndFullyManaged`, `unknownFutureValue`.|
v1.0 Intune Devices Devicelogcollectionresponse Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-devicelogcollectionresponse-create.md
The following table shows the properties that are required when you create the d
|initiatedByUserPrincipalName|String|The UPN for who initiated the request| |expirationDateTimeUTC|DateTimeOffset|The DateTime of the expiration of the logs| |size|Double|The size of the logs. Valid values -1.79769313486232E+308 to 1.79769313486232E+308|
+|enrolledByUser|String|The User Principal Name (UPN) of the user that enrolled the device|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/logCollectionRequests Content-type: application/json
-Content-length: 479
+Content-length: 526
{ "@odata.type": "#microsoft.graph.deviceLogCollectionResponse",
Content-length: 479
"receivedDateTimeUTC": "2016-12-31T23:59:48.6545758-08:00", "initiatedByUserPrincipalName": "Initiated By User Principal Name value", "expirationDateTimeUTC": "2017-01-01T00:02:49.2157996-08:00",
- "size": 1.3333333333333333
+ "size": 1.3333333333333333,
+ "enrolledByUser": "Enrolled By User value"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 528
+Content-Length: 575
{ "@odata.type": "#microsoft.graph.deviceLogCollectionResponse",
Content-Length: 528
"receivedDateTimeUTC": "2016-12-31T23:59:48.6545758-08:00", "initiatedByUserPrincipalName": "Initiated By User Principal Name value", "expirationDateTimeUTC": "2017-01-01T00:02:49.2157996-08:00",
- "size": 1.3333333333333333
+ "size": 1.3333333333333333,
+ "enrolledByUser": "Enrolled By User value"
} ```
v1.0 Intune Devices Devicelogcollectionresponse Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-devicelogcollectionresponse-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 567
+Content-Length: 616
{ "value": {
Content-Length: 567
"receivedDateTimeUTC": "2016-12-31T23:59:48.6545758-08:00", "initiatedByUserPrincipalName": "Initiated By User Principal Name value", "expirationDateTimeUTC": "2017-01-01T00:02:49.2157996-08:00",
- "size": 1.3333333333333333
+ "size": 1.3333333333333333,
+ "enrolledByUser": "Enrolled By User value"
} } ```
v1.0 Intune Devices Devicelogcollectionresponse List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-devicelogcollectionresponse-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 601
+Content-Length: 652
{ "value": [
Content-Length: 601
"receivedDateTimeUTC": "2016-12-31T23:59:48.6545758-08:00", "initiatedByUserPrincipalName": "Initiated By User Principal Name value", "expirationDateTimeUTC": "2017-01-01T00:02:49.2157996-08:00",
- "size": 1.3333333333333333
+ "size": 1.3333333333333333,
+ "enrolledByUser": "Enrolled By User value"
} ] }
v1.0 Intune Devices Devicelogcollectionresponse Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-devicelogcollectionresponse-update.md
The following table shows the properties that are required when you create the [
|initiatedByUserPrincipalName|String|The UPN for who initiated the request| |expirationDateTimeUTC|DateTimeOffset|The DateTime of the expiration of the logs| |size|Double|The size of the logs. Valid values -1.79769313486232E+308 to 1.79769313486232E+308|
+|enrolledByUser|String|The User Principal Name (UPN) of the user that enrolled the device|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/logCollectionRequests/{deviceLogCollectionResponseId} Content-type: application/json
-Content-length: 479
+Content-length: 526
{ "@odata.type": "#microsoft.graph.deviceLogCollectionResponse",
Content-length: 479
"receivedDateTimeUTC": "2016-12-31T23:59:48.6545758-08:00", "initiatedByUserPrincipalName": "Initiated By User Principal Name value", "expirationDateTimeUTC": "2017-01-01T00:02:49.2157996-08:00",
- "size": 1.3333333333333333
+ "size": 1.3333333333333333,
+ "enrolledByUser": "Enrolled By User value"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 528
+Content-Length: 575
{ "@odata.type": "#microsoft.graph.deviceLogCollectionResponse",
Content-Length: 528
"receivedDateTimeUTC": "2016-12-31T23:59:48.6545758-08:00", "initiatedByUserPrincipalName": "Initiated By User Principal Name value", "expirationDateTimeUTC": "2017-01-01T00:02:49.2157996-08:00",
- "size": 1.3333333333333333
+ "size": 1.3333333333333333,
+ "enrolledByUser": "Enrolled By User value"
} ```
v1.0 Intune Devices Devicemanagement Getcomanagementeligibledevicessummary https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-devicemanagement-getcomanagementeligibledevicessummary.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 251
+Content-Length: 291
{ "value": { "@odata.type": "microsoft.graph.comanagementEligibleDevicesSummary", "comanagedCount": 14, "eligibleCount": 13,
+ "scheduledForEnrollmentCount": 11,
"eligibleButNotAzureAdJoinedCount": 0, "needsOsUpdateCount": 2, "ineligibleCount": 15
v1.0 Intune Devices Devicemanagement Userexperienceanalyticssummarizeddevicescopes https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-devicemanagement-userexperienceanalyticssummarizeddevicescopes.md
+
+ Title: "userExperienceAnalyticsSummarizedDeviceScopes function"
+description: "Not yet documented"
+
+localization_priority: Normal
++
+# userExperienceAnalyticsSummarizedDeviceScopes function
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Not yet documented
+
+## Prerequisites
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementManagedDevices.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementConfiguration.Read.All, DeviceManagementManagedDevices.Read.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /deviceManagement/userExperienceAnalyticsSummarizedDeviceScopes
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this function returns a `200 OK` response code and a [userExperienceAnalyticsDeviceScopeSummary](../resources/intune-devices-userexperienceanalyticsdevicescopesummary.md) in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+GET https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsSummarizedDeviceScopes
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 351
+
+{
+ "value": {
+ "@odata.type": "microsoft.graph.userExperienceAnalyticsDeviceScopeSummary",
+ "totalDeviceScopes": 1,
+ "totalDeviceScopesEnabled": 8,
+ "completedDeviceScopeIds": [
+ "Completed Device Scope Ids value"
+ ],
+ "insufficientDataDeviceScopeIds": [
+ "Insufficient Data Device Scope Ids value"
+ ]
+ }
+}
+```
+++++
v1.0 Intune Devices Manageddevice Createdevicelogcollectionrequest https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-manageddevice-createdevicelogcollectionrequest.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 567
+Content-Length: 616
{ "value": {
Content-Length: 567
"receivedDateTimeUTC": "2016-12-31T23:59:48.6545758-08:00", "initiatedByUserPrincipalName": "Initiated By User Principal Name value", "expirationDateTimeUTC": "2017-01-01T00:02:49.2157996-08:00",
- "size": 1.3333333333333333
+ "size": 1.3333333333333333,
+ "enrolledByUser": "Enrolled By User value"
} } ```
v1.0 Intune Devices Manageddevice Initiatemobiledevicemanagementkeyrecovery https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-manageddevice-initiatemobiledevicemanagementkeyrecovery.md
+
+ Title: "initiateMobileDeviceManagementKeyRecovery action"
+description: "Perform MDM key recovery and TPM attestation"
+
+localization_priority: Normal
++
+# initiateMobileDeviceManagementKeyRecovery action
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Perform MDM key recovery and TPM attestation
+
+## Prerequisites
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementManagedDevices.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementConfiguration.Read.All, DeviceManagementManagedDevices.Read.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceManagement/managedDevices/{managedDeviceId}/initiateMobileDeviceManagementKeyRecovery
+POST /deviceManagement/comanagedDevices/{managedDeviceId}/initiateMobileDeviceManagementKeyRecovery
+POST /deviceManagement/deviceHealthScripts/{deviceHealthScriptId}/deviceRunStates/{deviceHealthScriptDeviceStateId}/managedDevice/initiateMobileDeviceManagementKeyRecovery
+POST /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/initiateMobileDeviceManagementKeyRecovery
+POST /deviceManagement/deviceComplianceScripts/{deviceComplianceScriptId}/deviceRunStates/{deviceComplianceScriptDeviceStateId}/managedDevice/initiateMobileDeviceManagementKeyRecovery
+POST /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/users/{userId}/managedDevices/{managedDeviceId}/initiateMobileDeviceManagementKeyRecovery
+POST /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/detectedApps/{detectedAppId}/managedDevices/{managedDeviceId}/initiateMobileDeviceManagementKeyRecovery
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this action returns a `204 No Content` response code.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/managedDevices/{managedDeviceId}/initiateMobileDeviceManagementKeyRecovery
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 204 No Content
+```
+++++
v1.0 Intune Devices Manageddevice Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-manageddevice-update.md
The following table shows the properties that are required when you create the [
|id|String|Unique Identifier for the device. This property is read-only.| |userId|String|Unique Identifier for the user associated with the device. This property is read-only.| |deviceName|String|Name of the device. This property is read-only.|
-|hardwareInformation|[hardwareInformation](../resources/intune-devices-hardwareinformation.md)|The hardward details for the device. Includes information such as storage space, manufacturer, serial number, etc. This property is read-only.|
+|hardwareInformation|[hardwareInformation](../resources/intune-devices-hardwareinformation.md)|The hardward details for the device. Includes information such as storage space, manufacturer, serial number, etc. Return default value in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only.|
|ownerType|[ownerType](../resources/intune-shared-ownertype.md)|Ownership of the device. Can be 'company' or 'personal'. Possible values are: `unknown`, `company`, `personal`.| |managedDeviceOwnerType|[managedDeviceOwnerType](../resources/intune-shared-manageddeviceownertype.md)|Ownership of the device. Can be 'company' or 'personal'. Possible values are: `unknown`, `company`, `personal`.| |deviceActionResults|[deviceActionResult](../resources/intune-devices-deviceactionresult.md) collection|List of ComplexType deviceActionResult objects. This property is read-only.|
The following table shows the properties that are required when you create the [
|subscriberCarrier|String|Subscriber Carrier. This property is read-only.| |meid|String|MEID. This property is read-only.| |totalStorageSpaceInBytes|Int64|Total Storage in Bytes. This property is read-only.|
-|freeStorageSpaceInBytes|Int64|Free Storage in Bytes. This property is read-only.|
+|freeStorageSpaceInBytes|Int64|Free Storage in Bytes. Default value is 0. Read-only. This property is read-only.|
|managedDeviceName|String|Automatically generated name to identify a device. Can be overwritten to a user friendly name.| |partnerReportedThreatState|[managedDevicePartnerReportedHealthState](../resources/intune-devices-manageddevicepartnerreportedhealthstate.md)|Indicates the threat state of a device when a Mobile Threat Defense partner is in use by the account and device. Read Only. This property is read-only. Possible values are: `unknown`, `activated`, `deactivated`, `secured`, `lowSeverity`, `mediumSeverity`, `highSeverity`, `unresponsive`, `compromised`, `misconfigured`.| |retireAfterDateTime|DateTimeOffset|Indicates the time after when a device will be auto retired because of scheduled action. This property is read-only.|
The following table shows the properties that are required when you create the [
|autopilotEnrolled|Boolean|Reports if the managed device is enrolled via auto-pilot. This property is read-only.| |requireUserEnrollmentApproval|Boolean|Reports if the managed iOS device is user approval enrollment. This property is read-only.| |managementCertificateExpirationDate|DateTimeOffset|Reports device management certificate expiration date. This property is read-only.|
-|iccid|String|Integrated Circuit Card Identifier, it is A SIM card's unique identification number. This property is read-only.|
-|udid|String|Unique Device Identifier for iOS and macOS devices. This property is read-only.|
+|iccid|String|Integrated Circuit Card Identifier, it is A SIM card's unique identification number. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only.|
+|udid|String|Unique Device Identifier for iOS and macOS devices. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only.|
|roleScopeTagIds|String collection|List of Scope Tag IDs for this Device instance.| |windowsActiveMalwareCount|Int32|Count of active malware for this windows device. This property is read-only.| |windowsRemediatedMalwareCount|Int32|Count of remediated malware for this windows device. This property is read-only.|
-|notes|String|Notes on the device created by IT Admin|
+|notes|String|Notes on the device created by IT Admin. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported.|
|configurationManagerClientHealthState|[configurationManagerClientHealthState](../resources/intune-devices-configurationmanagerclienthealthstate.md)|Configuration manager client health state, valid only for devices managed by MDM/ConfigMgr Agent| |configurationManagerClientInformation|[configurationManagerClientInformation](../resources/intune-devices-configurationmanagerclientinformation.md)|Configuration manager client information, valid only for devices managed, duel-managed or tri-managed by ConfigMgr Agent| |ethernetMacAddress|String|Ethernet MAC. This property is read-only.|
-|physicalMemoryInBytes|Int64|Total Memory in Bytes. This property is read-only.|
+|physicalMemoryInBytes|Int64|Total Memory in Bytes. Return default value 0 in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. Default value is 0. Read-only. This property is read-only.|
|processorArchitecture|[managedDeviceArchitecture](../resources/intune-devices-manageddevicearchitecture.md)|Processor architecture. This property is read-only. Possible values are: `unknown`, `x86`, `x64`, `arm`, `arM64`.| |specificationVersion|String|Specification version. This property is read-only.| |joinType|[joinType](../resources/intune-devices-jointype.md)|Device join type. Possible values are: `unknown`, `azureADJoined`, `azureADRegistered`, `hybridAzureADJoined`.| |skuFamily|String|Device sku family|
-|skuNumber|Int32|Device sku number, see also: https://docs.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only.|
+|skuNumber|Int32|Device sku number, see also: https://learn.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only.|
|managementFeatures|[managedDeviceManagementFeatures](../resources/intune-devices-manageddevicemanagementfeatures.md)|Device management features. Possible values are: `none`, `microsoftManagedDesktop`.| |chromeOSDeviceInfo|[chromeOSDeviceProperty](../resources/intune-devices-chromeosdeviceproperty.md) collection|List of properties of the ChromeOS Device.| |enrollmentProfileName|String|Name of the enrollment profile assigned to the device. Default value is empty string, indicating no enrollment profile was assgined. This property is read-only.|
Content-Length: 9187
+
v1.0 Intune Devices Remoteactionaudit Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-remoteactionaudit-create.md
The following table shows the properties that are required when you create the r
|deviceDisplayName|String|Intune device name.| |userName|String|\[deprecated\] Please use InitiatedByUserPrincipalName instead.| |initiatedByUserPrincipalName|String|User who initiated the device action, format is UPN.|
-|action|[remoteAction](../resources/intune-devices-remoteaction.md)|The action name. Possible values are: `unknown`, `factoryReset`, `removeCompanyData`, `resetPasscode`, `remoteLock`, `enableLostMode`, `disableLostMode`, `locateDevice`, `rebootNow`, `recoverPasscode`, `cleanWindowsDevice`, `logoutSharedAppleDeviceActiveUser`, `quickScan`, `fullScan`, `windowsDefenderUpdateSignatures`, `factoryResetKeepEnrollmentData`, `updateDeviceAccount`, `automaticRedeployment`, `shutDown`, `rotateBitLockerKeys`, `rotateFileVaultKey`, `getFileVaultKey`, `setDeviceName`, `activateDeviceEsim`, `deprovision`, `disable`, `reenable`, `moveDeviceToOrganizationalUnit`.|
+|action|[remoteAction](../resources/intune-devices-remoteaction.md)|The action name. Possible values are: `unknown`, `factoryReset`, `removeCompanyData`, `resetPasscode`, `remoteLock`, `enableLostMode`, `disableLostMode`, `locateDevice`, `rebootNow`, `recoverPasscode`, `cleanWindowsDevice`, `logoutSharedAppleDeviceActiveUser`, `quickScan`, `fullScan`, `windowsDefenderUpdateSignatures`, `factoryResetKeepEnrollmentData`, `updateDeviceAccount`, `automaticRedeployment`, `shutDown`, `rotateBitLockerKeys`, `rotateFileVaultKey`, `getFileVaultKey`, `setDeviceName`, `activateDeviceEsim`, `deprovision`, `disable`, `reenable`, `moveDeviceToOrganizationalUnit`, `initiateMobileDeviceManagementKeyRecovery`.|
|requestDateTime|DateTimeOffset|Time when the action was issued, given in UTC.| |deviceOwnerUserPrincipalName|String|Upn of the device owner.| |deviceIMEI|String|IMEI of the device.|
v1.0 Intune Devices Remoteactionaudit Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-remoteactionaudit-update.md
The following table shows the properties that are required when you create the [
|deviceDisplayName|String|Intune device name.| |userName|String|\[deprecated\] Please use InitiatedByUserPrincipalName instead.| |initiatedByUserPrincipalName|String|User who initiated the device action, format is UPN.|
-|action|[remoteAction](../resources/intune-devices-remoteaction.md)|The action name. Possible values are: `unknown`, `factoryReset`, `removeCompanyData`, `resetPasscode`, `remoteLock`, `enableLostMode`, `disableLostMode`, `locateDevice`, `rebootNow`, `recoverPasscode`, `cleanWindowsDevice`, `logoutSharedAppleDeviceActiveUser`, `quickScan`, `fullScan`, `windowsDefenderUpdateSignatures`, `factoryResetKeepEnrollmentData`, `updateDeviceAccount`, `automaticRedeployment`, `shutDown`, `rotateBitLockerKeys`, `rotateFileVaultKey`, `getFileVaultKey`, `setDeviceName`, `activateDeviceEsim`, `deprovision`, `disable`, `reenable`, `moveDeviceToOrganizationalUnit`.|
+|action|[remoteAction](../resources/intune-devices-remoteaction.md)|The action name. Possible values are: `unknown`, `factoryReset`, `removeCompanyData`, `resetPasscode`, `remoteLock`, `enableLostMode`, `disableLostMode`, `locateDevice`, `rebootNow`, `recoverPasscode`, `cleanWindowsDevice`, `logoutSharedAppleDeviceActiveUser`, `quickScan`, `fullScan`, `windowsDefenderUpdateSignatures`, `factoryResetKeepEnrollmentData`, `updateDeviceAccount`, `automaticRedeployment`, `shutDown`, `rotateBitLockerKeys`, `rotateFileVaultKey`, `getFileVaultKey`, `setDeviceName`, `activateDeviceEsim`, `deprovision`, `disable`, `reenable`, `moveDeviceToOrganizationalUnit`, `initiateMobileDeviceManagementKeyRecovery`.|
|requestDateTime|DateTimeOffset|Time when the action was issued, given in UTC.| |deviceOwnerUserPrincipalName|String|Upn of the device owner.| |deviceIMEI|String|IMEI of the device.|
v1.0 Intune Devices Userexperienceanalyticsmetric Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-userexperienceanalyticsmetric-create.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-POST /deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression
-POST /deviceManagement/userExperienceAnalyticsRegressionSummary/manufacturerRegression
-POST /deviceManagement/userExperienceAnalyticsRegressionSummary/operatingSystemRegression
POST /deviceManagement/userExperienceAnalyticsBaselines/{userExperienceAnalyticsBaselineId}/deviceBootPerformanceMetrics/metricValues ```
If successful, this method returns a `201 Created` response code and a [userExpe
### Request Here is an example of the request. ``` http
-POST https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression
+POST https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsBaselines/{userExperienceAnalyticsBaselineId}/deviceBootPerformanceMetrics/metricValues
Content-type: application/json Content-length: 128
v1.0 Intune Devices Userexperienceanalyticsmetric Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-userexperienceanalyticsmetric-delete.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-DELETE /deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression/{userExperienceAnalyticsMetricId}
-DELETE /deviceManagement/userExperienceAnalyticsRegressionSummary/manufacturerRegression/{userExperienceAnalyticsMetricId}
-DELETE /deviceManagement/userExperienceAnalyticsRegressionSummary/operatingSystemRegression/{userExperienceAnalyticsMetricId}
DELETE /deviceManagement/userExperienceAnalyticsMetricHistory/{userExperienceAnalyticsMetricHistoryId}/userExperienceAnalyticsMetric DELETE /deviceManagement/userExperienceAnalyticsBaselines/{userExperienceAnalyticsBaselineId}/deviceBootPerformanceMetrics/metricValues/{userExperienceAnalyticsMetricId} ```
If successful, this method returns a `204 No Content` response code.
### Request Here is an example of the request. ``` http
-DELETE https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression/{userExperienceAnalyticsMetricId}
+DELETE https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsMetricHistory/{userExperienceAnalyticsMetricHistoryId}/userExperienceAnalyticsMetric
``` ### Response
v1.0 Intune Devices Userexperienceanalyticsmetric Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-userexperienceanalyticsmetric-get.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-GET /deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression/{userExperienceAnalyticsMetricId}
-GET /deviceManagement/userExperienceAnalyticsRegressionSummary/manufacturerRegression/{userExperienceAnalyticsMetricId}
-GET /deviceManagement/userExperienceAnalyticsRegressionSummary/operatingSystemRegression/{userExperienceAnalyticsMetricId}
GET /deviceManagement/userExperienceAnalyticsMetricHistory/{userExperienceAnalyticsMetricHistoryId}/userExperienceAnalyticsMetric GET /deviceManagement/userExperienceAnalyticsBaselines/{userExperienceAnalyticsBaselineId}/deviceBootPerformanceMetrics/metricValues/{userExperienceAnalyticsMetricId} ```
If successful, this method returns a `200 OK` response code and [userExperienceA
### Request Here is an example of the request. ``` http
-GET https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression/{userExperienceAnalyticsMetricId}
+GET https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsMetricHistory/{userExperienceAnalyticsMetricHistoryId}/userExperienceAnalyticsMetric
``` ### Response
v1.0 Intune Devices Userexperienceanalyticsmetric List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-userexperienceanalyticsmetric-list.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-GET /deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression
-GET /deviceManagement/userExperienceAnalyticsRegressionSummary/manufacturerRegression
-GET /deviceManagement/userExperienceAnalyticsRegressionSummary/operatingSystemRegression
GET /deviceManagement/userExperienceAnalyticsBaselines/{userExperienceAnalyticsBaselineId}/deviceBootPerformanceMetrics/metricValues ```
If successful, this method returns a `200 OK` response code and a collection of
### Request Here is an example of the request. ``` http
-GET https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression
+GET https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsBaselines/{userExperienceAnalyticsBaselineId}/deviceBootPerformanceMetrics/metricValues
``` ### Response
v1.0 Intune Devices Userexperienceanalyticsmetric Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-userexperienceanalyticsmetric-update.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-PATCH /deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression/{userExperienceAnalyticsMetricId}
-PATCH /deviceManagement/userExperienceAnalyticsRegressionSummary/manufacturerRegression/{userExperienceAnalyticsMetricId}
-PATCH /deviceManagement/userExperienceAnalyticsRegressionSummary/operatingSystemRegression/{userExperienceAnalyticsMetricId}
PATCH /deviceManagement/userExperienceAnalyticsMetricHistory/{userExperienceAnalyticsMetricHistoryId}/userExperienceAnalyticsMetric PATCH /deviceManagement/userExperienceAnalyticsBaselines/{userExperienceAnalyticsBaselineId}/deviceBootPerformanceMetrics/metricValues/{userExperienceAnalyticsMetricId} ```
If successful, this method returns a `200 OK` response code and an updated [user
### Request Here is an example of the request. ``` http
-PATCH https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression/{userExperienceAnalyticsMetricId}
+PATCH https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsMetricHistory/{userExperienceAnalyticsMetricHistoryId}/userExperienceAnalyticsMetric
Content-type: application/json Content-length: 128
v1.0 Intune Devices Windowsmanageddevice Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-windowsmanageddevice-create.md
The following table shows the properties that are required when you create the w
|id|String|Unique Identifier for the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |userId|String|Unique Identifier for the user associated with the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |deviceName|String|Name of the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|hardwareInformation|[hardwareInformation](../resources/intune-devices-hardwareinformation.md)|The hardward details for the device. Includes information such as storage space, manufacturer, serial number, etc. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|hardwareInformation|[hardwareInformation](../resources/intune-devices-hardwareinformation.md)|The hardward details for the device. Includes information such as storage space, manufacturer, serial number, etc. Return default value in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|ownerType|[ownerType](../resources/intune-shared-ownertype.md)|Ownership of the device. Can be 'company' or 'personal' Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `company`, `personal`.| |managedDeviceOwnerType|[managedDeviceOwnerType](../resources/intune-shared-manageddeviceownertype.md)|Ownership of the device. Can be 'company' or 'personal' Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `company`, `personal`.| |deviceActionResults|[deviceActionResult](../resources/intune-devices-deviceactionresult.md) collection|List of ComplexType deviceActionResult objects. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
The following table shows the properties that are required when you create the w
|subscriberCarrier|String|Subscriber Carrier. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |meid|String|MEID. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |totalStorageSpaceInBytes|Int64|Total Storage in Bytes. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|freeStorageSpaceInBytes|Int64|Free Storage in Bytes. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|freeStorageSpaceInBytes|Int64|Free Storage in Bytes. Default value is 0. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|managedDeviceName|String|Automatically generated name to identify a device. Can be overwritten to a user friendly name. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |partnerReportedThreatState|[managedDevicePartnerReportedHealthState](../resources/intune-devices-manageddevicepartnerreportedhealthstate.md)|Indicates the threat state of a device when a Mobile Threat Defense partner is in use by the account and device. Read Only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `activated`, `deactivated`, `secured`, `lowSeverity`, `mediumSeverity`, `highSeverity`, `unresponsive`, `compromised`, `misconfigured`.| |retireAfterDateTime|DateTimeOffset|Indicates the time after when a device will be auto retired because of scheduled action. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
The following table shows the properties that are required when you create the w
|autopilotEnrolled|Boolean|Reports if the managed device is enrolled via auto-pilot. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |requireUserEnrollmentApproval|Boolean|Reports if the managed iOS device is user approval enrollment. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |managementCertificateExpirationDate|DateTimeOffset|Reports device management certificate expiration date. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|iccid|String|Integrated Circuit Card Identifier, it is A SIM card's unique identification number. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|udid|String|Unique Device Identifier for iOS and macOS devices. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|iccid|String|Integrated Circuit Card Identifier, it is A SIM card's unique identification number. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|udid|String|Unique Device Identifier for iOS and macOS devices. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|roleScopeTagIds|String collection|List of Scope Tag IDs for this Device instance. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |windowsActiveMalwareCount|Int32|Count of active malware for this windows device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |windowsRemediatedMalwareCount|Int32|Count of remediated malware for this windows device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|notes|String|Notes on the device created by IT Admin Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|notes|String|Notes on the device created by IT Admin. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|configurationManagerClientHealthState|[configurationManagerClientHealthState](../resources/intune-devices-configurationmanagerclienthealthstate.md)|Configuration manager client health state, valid only for devices managed by MDM/ConfigMgr Agent Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |configurationManagerClientInformation|[configurationManagerClientInformation](../resources/intune-devices-configurationmanagerclientinformation.md)|Configuration manager client information, valid only for devices managed, duel-managed or tri-managed by ConfigMgr Agent Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |ethernetMacAddress|String|Ethernet MAC. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|physicalMemoryInBytes|Int64|Total Memory in Bytes. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|physicalMemoryInBytes|Int64|Total Memory in Bytes. Return default value 0 in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. Default value is 0. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|processorArchitecture|[managedDeviceArchitecture](../resources/intune-devices-manageddevicearchitecture.md)|Processor architecture. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `x86`, `x64`, `arm`, `arM64`.| |specificationVersion|String|Specification version. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |joinType|[joinType](../resources/intune-devices-jointype.md)|Device join type Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `azureADJoined`, `azureADRegistered`, `hybridAzureADJoined`.| |skuFamily|String|Device sku family Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|skuNumber|Int32|Device sku number, see also: https://docs.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|skuNumber|Int32|Device sku number, see also: https://learn.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|managementFeatures|[managedDeviceManagementFeatures](../resources/intune-devices-manageddevicemanagementfeatures.md)|Device management features Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `none`, `microsoftManagedDesktop`.| |chromeOSDeviceInfo|[chromeOSDeviceProperty](../resources/intune-devices-chromeosdeviceproperty.md) collection|List of properties of the ChromeOS Device. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |enrollmentProfileName|String|Name of the enrollment profile assigned to the device. Default value is empty string, indicating no enrollment profile was assgined. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
Content-Length: 9194
+
v1.0 Intune Devices Windowsmanageddevice Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-windowsmanageddevice-update.md
The following table shows the properties that are required when you create the [
|id|String|Unique Identifier for the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |userId|String|Unique Identifier for the user associated with the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |deviceName|String|Name of the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|hardwareInformation|[hardwareInformation](../resources/intune-devices-hardwareinformation.md)|The hardward details for the device. Includes information such as storage space, manufacturer, serial number, etc. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|hardwareInformation|[hardwareInformation](../resources/intune-devices-hardwareinformation.md)|The hardward details for the device. Includes information such as storage space, manufacturer, serial number, etc. Return default value in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|ownerType|[ownerType](../resources/intune-shared-ownertype.md)|Ownership of the device. Can be 'company' or 'personal' Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `company`, `personal`.| |managedDeviceOwnerType|[managedDeviceOwnerType](../resources/intune-shared-manageddeviceownertype.md)|Ownership of the device. Can be 'company' or 'personal' Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `company`, `personal`.| |deviceActionResults|[deviceActionResult](../resources/intune-devices-deviceactionresult.md) collection|List of ComplexType deviceActionResult objects. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
The following table shows the properties that are required when you create the [
|subscriberCarrier|String|Subscriber Carrier. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |meid|String|MEID. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |totalStorageSpaceInBytes|Int64|Total Storage in Bytes. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|freeStorageSpaceInBytes|Int64|Free Storage in Bytes. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|freeStorageSpaceInBytes|Int64|Free Storage in Bytes. Default value is 0. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|managedDeviceName|String|Automatically generated name to identify a device. Can be overwritten to a user friendly name. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |partnerReportedThreatState|[managedDevicePartnerReportedHealthState](../resources/intune-devices-manageddevicepartnerreportedhealthstate.md)|Indicates the threat state of a device when a Mobile Threat Defense partner is in use by the account and device. Read Only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `activated`, `deactivated`, `secured`, `lowSeverity`, `mediumSeverity`, `highSeverity`, `unresponsive`, `compromised`, `misconfigured`.| |retireAfterDateTime|DateTimeOffset|Indicates the time after when a device will be auto retired because of scheduled action. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
The following table shows the properties that are required when you create the [
|autopilotEnrolled|Boolean|Reports if the managed device is enrolled via auto-pilot. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |requireUserEnrollmentApproval|Boolean|Reports if the managed iOS device is user approval enrollment. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |managementCertificateExpirationDate|DateTimeOffset|Reports device management certificate expiration date. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|iccid|String|Integrated Circuit Card Identifier, it is A SIM card's unique identification number. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|udid|String|Unique Device Identifier for iOS and macOS devices. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|iccid|String|Integrated Circuit Card Identifier, it is A SIM card's unique identification number. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|udid|String|Unique Device Identifier for iOS and macOS devices. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|roleScopeTagIds|String collection|List of Scope Tag IDs for this Device instance. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |windowsActiveMalwareCount|Int32|Count of active malware for this windows device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |windowsRemediatedMalwareCount|Int32|Count of remediated malware for this windows device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|notes|String|Notes on the device created by IT Admin Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|notes|String|Notes on the device created by IT Admin. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|configurationManagerClientHealthState|[configurationManagerClientHealthState](../resources/intune-devices-configurationmanagerclienthealthstate.md)|Configuration manager client health state, valid only for devices managed by MDM/ConfigMgr Agent Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |configurationManagerClientInformation|[configurationManagerClientInformation](../resources/intune-devices-configurationmanagerclientinformation.md)|Configuration manager client information, valid only for devices managed, duel-managed or tri-managed by ConfigMgr Agent Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |ethernetMacAddress|String|Ethernet MAC. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|physicalMemoryInBytes|Int64|Total Memory in Bytes. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|physicalMemoryInBytes|Int64|Total Memory in Bytes. Return default value 0 in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. Default value is 0. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|processorArchitecture|[managedDeviceArchitecture](../resources/intune-devices-manageddevicearchitecture.md)|Processor architecture. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `x86`, `x64`, `arm`, `arM64`.| |specificationVersion|String|Specification version. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |joinType|[joinType](../resources/intune-devices-jointype.md)|Device join type Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `azureADJoined`, `azureADRegistered`, `hybridAzureADJoined`.| |skuFamily|String|Device sku family Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|skuNumber|Int32|Device sku number, see also: https://docs.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|skuNumber|Int32|Device sku number, see also: https://learn.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|managementFeatures|[managedDeviceManagementFeatures](../resources/intune-devices-manageddevicemanagementfeatures.md)|Device management features Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `none`, `microsoftManagedDesktop`.| |chromeOSDeviceInfo|[chromeOSDeviceProperty](../resources/intune-devices-chromeosdeviceproperty.md) collection|List of properties of the ChromeOS Device. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |enrollmentProfileName|String|Name of the enrollment profile assigned to the device. Default value is empty string, indicating no enrollment profile was assgined. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
Content-Length: 9194
+
v1.0 Intune Enrollment Depenrollmentprofile Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-enrollment-depenrollmentprofile-create.md
The following table shows the properties that are required when you create the d
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information.|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information.|
|supportDepartment|String|Support department information| |passCodeDisabled|Boolean|Indicates if Passcode setup pane is disabled| |isMandatory|Boolean|Indicates if the profile is mandatory|
Content-Length: 1403
+
v1.0 Intune Enrollment Depenrollmentprofile Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-enrollment-depenrollmentprofile-update.md
The following table shows the properties that are required when you create the [
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information.|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information.|
|supportDepartment|String|Support department information| |passCodeDisabled|Boolean|Indicates if Passcode setup pane is disabled| |isMandatory|Boolean|Indicates if the profile is mandatory|
Content-Length: 1403
+
v1.0 Intune Enrollment Depiosenrollmentprofile Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-enrollment-depiosenrollmentprofile-create.md
The following table shows the properties that are required when you create the d
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
|supportDepartment|String|Support department information Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |isMandatory|Boolean|Indicates if the profile is mandatory Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |locationDisabled|Boolean|Indicates if Location service setup pane is disabled Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
The following table shows the properties that are required when you create the d
|userSessionTimeoutInSeconds|Int32|Indicates timeout of temporary session| |passcodeLockGracePeriodInSeconds|Int32|Indicates timeout before locked screen requires the user to enter the device passocde to unlock it| |carrierActivationUrl|String|Carrier URL for activating device eSIM.|
-|userlessSharedAadModeEnabled|Boolean|Indicates that this apple device is designated to support 'shared device mode' scenarios. This is distinct from the 'shared iPad' scenario. See https://docs.microsoft.com/mem/intune/enrollment/device-enrollment-shared-ios|
+|userlessSharedAadModeEnabled|Boolean|Indicates that this apple device is designated to support 'shared device mode' scenarios. This is distinct from the 'shared iPad' scenario. See https://learn.microsoft.com/mem/intune/enrollment/device-enrollment-shared-ios|
Content-Length: 2426
+
v1.0 Intune Enrollment Depiosenrollmentprofile Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-enrollment-depiosenrollmentprofile-update.md
The following table shows the properties that are required when you create the [
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
|supportDepartment|String|Support department information Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |isMandatory|Boolean|Indicates if the profile is mandatory Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |locationDisabled|Boolean|Indicates if Location service setup pane is disabled Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
The following table shows the properties that are required when you create the [
|userSessionTimeoutInSeconds|Int32|Indicates timeout of temporary session| |passcodeLockGracePeriodInSeconds|Int32|Indicates timeout before locked screen requires the user to enter the device passocde to unlock it| |carrierActivationUrl|String|Carrier URL for activating device eSIM.|
-|userlessSharedAadModeEnabled|Boolean|Indicates that this apple device is designated to support 'shared device mode' scenarios. This is distinct from the 'shared iPad' scenario. See https://docs.microsoft.com/mem/intune/enrollment/device-enrollment-shared-ios|
+|userlessSharedAadModeEnabled|Boolean|Indicates that this apple device is designated to support 'shared device mode' scenarios. This is distinct from the 'shared iPad' scenario. See https://learn.microsoft.com/mem/intune/enrollment/device-enrollment-shared-ios|
Content-Length: 2426
+
v1.0 Intune Enrollment Depmacosenrollmentprofile Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-enrollment-depmacosenrollmentprofile-create.md
The following table shows the properties that are required when you create the d
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
|supportDepartment|String|Support department information Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |isMandatory|Boolean|Indicates if the profile is mandatory Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |locationDisabled|Boolean|Indicates if Location service setup pane is disabled Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
Content-Length: 1993
+
v1.0 Intune Enrollment Depmacosenrollmentprofile Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-enrollment-depmacosenrollmentprofile-update.md
The following table shows the properties that are required when you create the [
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
|supportDepartment|String|Support department information Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |isMandatory|Boolean|Indicates if the profile is mandatory Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |locationDisabled|Boolean|Indicates if Location service setup pane is disabled Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
Content-Length: 1993
+
v1.0 Intune Gpanalyticsservice Grouppolicymigrationreport Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-gpanalyticsservice-grouppolicymigrationreport-create.md
The following table shows the properties that are required when you create the g
|totalSettingsCount|Int32|The total number of Group Policy Settings from GPO file.| |supportedSettingsCount|Int32|The number of Group Policy Settings supported by Intune.| |supportedSettingsPercent|Int32|The Percentage of Group Policy Settings supported by Intune.|
+|roleScopeTagIds|String collection|The list of scope tags for the configuration.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/groupPolicyMigrationReports Content-type: application/json
-Content-length: 544
+Content-length: 606
{ "@odata.type": "#microsoft.graph.groupPolicyMigrationReport",
Content-length: 544
"targetedInActiveDirectory": true, "totalSettingsCount": 2, "supportedSettingsCount": 6,
- "supportedSettingsPercent": 8
+ "supportedSettingsPercent": 8,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 716
+Content-Length: 778
{ "@odata.type": "#microsoft.graph.groupPolicyMigrationReport",
Content-Length: 716
"targetedInActiveDirectory": true, "totalSettingsCount": 2, "supportedSettingsCount": 6,
- "supportedSettingsPercent": 8
+ "supportedSettingsPercent": 8,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ```
v1.0 Intune Gpanalyticsservice Grouppolicymigrationreport Createmigrationreport https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-gpanalyticsservice-grouppolicymigrationreport-createmigrationreport.md
Here is an example of the request.
POST https://graph.microsoft.com/beta/deviceManagement/groupPolicyMigrationReports/createMigrationReport Content-type: application/json
-Content-length: 438
+Content-length: 506
{ "groupPolicyObjectFile": {
Content-length: 438
"ouDistinguishedName": "Ou Distinguished Name value", "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "content": "Content value"
+ "content": "Content value",
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} } ```
v1.0 Intune Gpanalyticsservice Grouppolicymigrationreport Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-gpanalyticsservice-grouppolicymigrationreport-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 763
+Content-Length: 831
{ "value": {
Content-Length: 763
"targetedInActiveDirectory": true, "totalSettingsCount": 2, "supportedSettingsCount": 6,
- "supportedSettingsPercent": 8
+ "supportedSettingsPercent": 8,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} } ```
v1.0 Intune Gpanalyticsservice Grouppolicymigrationreport List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-gpanalyticsservice-grouppolicymigrationreport-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 805
+Content-Length: 879
{ "value": [
Content-Length: 805
"targetedInActiveDirectory": true, "totalSettingsCount": 2, "supportedSettingsCount": 6,
- "supportedSettingsPercent": 8
+ "supportedSettingsPercent": 8,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ] }
v1.0 Intune Gpanalyticsservice Grouppolicymigrationreport Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-gpanalyticsservice-grouppolicymigrationreport-update.md
The following table shows the properties that are required when you create the [
|totalSettingsCount|Int32|The total number of Group Policy Settings from GPO file.| |supportedSettingsCount|Int32|The number of Group Policy Settings supported by Intune.| |supportedSettingsPercent|Int32|The Percentage of Group Policy Settings supported by Intune.|
+|roleScopeTagIds|String collection|The list of scope tags for the configuration.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/groupPolicyMigrationReports/{groupPolicyMigrationReportId} Content-type: application/json
-Content-length: 544
+Content-length: 606
{ "@odata.type": "#microsoft.graph.groupPolicyMigrationReport",
Content-length: 544
"targetedInActiveDirectory": true, "totalSettingsCount": 2, "supportedSettingsCount": 6,
- "supportedSettingsPercent": 8
+ "supportedSettingsPercent": 8,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 716
+Content-Length: 778
{ "@odata.type": "#microsoft.graph.groupPolicyMigrationReport",
Content-Length: 716
"targetedInActiveDirectory": true, "totalSettingsCount": 2, "supportedSettingsCount": 6,
- "supportedSettingsPercent": 8
+ "supportedSettingsPercent": 8,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ```
v1.0 Intune Gpanalyticsservice Grouppolicyobjectfile Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-gpanalyticsservice-grouppolicyobjectfile-create.md
The following table shows the properties that are required when you create the g
|createdDateTime|DateTimeOffset|The date and time at which the GroupPolicy was first uploaded.| |lastModifiedDateTime|DateTimeOffset|The date and time at which the GroupPolicyObjectFile was last modified.| |content|String|The Group Policy Object file content.|
+|roleScopeTagIds|String collection|The list of scope tags for the configuration.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/groupPolicyObjectFiles Content-type: application/json
-Content-length: 217
+Content-length: 279
{ "@odata.type": "#microsoft.graph.groupPolicyObjectFile", "groupPolicyObjectId": "ca1c97af-97af-ca1c-af97-1ccaaf971cca", "ouDistinguishedName": "Ou Distinguished Name value",
- "content": "Content value"
+ "content": "Content value",
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 389
+Content-Length: 451
{ "@odata.type": "#microsoft.graph.groupPolicyObjectFile",
Content-Length: 389
"ouDistinguishedName": "Ou Distinguished Name value", "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "content": "Content value"
+ "content": "Content value",
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ```
v1.0 Intune Gpanalyticsservice Grouppolicyobjectfile Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-gpanalyticsservice-grouppolicyobjectfile-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 422
+Content-Length: 490
{ "value": {
Content-Length: 422
"ouDistinguishedName": "Ou Distinguished Name value", "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "content": "Content value"
+ "content": "Content value",
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} } ```
v1.0 Intune Gpanalyticsservice Grouppolicyobjectfile List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-gpanalyticsservice-grouppolicyobjectfile-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 450
+Content-Length: 524
{ "value": [
Content-Length: 450
"ouDistinguishedName": "Ou Distinguished Name value", "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "content": "Content value"
+ "content": "Content value",
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ] }
v1.0 Intune Gpanalyticsservice Grouppolicyobjectfile Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-gpanalyticsservice-grouppolicyobjectfile-update.md
The following table shows the properties that are required when you create the [
|createdDateTime|DateTimeOffset|The date and time at which the GroupPolicy was first uploaded.| |lastModifiedDateTime|DateTimeOffset|The date and time at which the GroupPolicyObjectFile was last modified.| |content|String|The Group Policy Object file content.|
+|roleScopeTagIds|String collection|The list of scope tags for the configuration.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/groupPolicyObjectFiles/{groupPolicyObjectFileId} Content-type: application/json
-Content-length: 217
+Content-length: 279
{ "@odata.type": "#microsoft.graph.groupPolicyObjectFile", "groupPolicyObjectId": "ca1c97af-97af-ca1c-af97-1ccaaf971cca", "ouDistinguishedName": "Ou Distinguished Name value",
- "content": "Content value"
+ "content": "Content value",
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 389
+Content-Length: 451
{ "@odata.type": "#microsoft.graph.groupPolicyObjectFile",
Content-Length: 389
"ouDistinguishedName": "Ou Distinguished Name value", "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "content": "Content value"
+ "content": "Content value",
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ```
v1.0 Intune Mam Defaultmanagedappprotection Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-mam-defaultmanagedappprotection-create.md
The following table shows the properties that are required when you create the d
|requireClass3Biometrics|Boolean|Require user to apply Class 3 Biometrics on their Android device.| |requirePinAfterBiometricChange|Boolean|A PIN prompt will override biometric prompts if class 3 biometrics are updated on the device.| |fingerprintAndBiometricEnabled|Boolean|Indicate to the client to enable both biometrics and fingerprints for the app.|
+|minimumWarningSdkVersion|String|Versions less than the specified version will result in warning message on the managed app from accessing company data. (iOS only)|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceAppManagement/defaultManagedAppProtections Content-type: application/json
-Content-length: 5790
+Content-length: 5858
{ "@odata.type": "#microsoft.graph.defaultManagedAppProtection",
Content-length: 5790
"appActionIfDevicePasscodeComplexityLessThanHigh": "wipe", "requireClass3Biometrics": true, "requirePinAfterBiometricChange": true,
- "fingerprintAndBiometricEnabled": true
+ "fingerprintAndBiometricEnabled": true,
+ "minimumWarningSdkVersion": "Minimum Warning Sdk Version value"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 5962
+Content-Length: 6030
{ "@odata.type": "#microsoft.graph.defaultManagedAppProtection",
Content-Length: 5962
"appActionIfDevicePasscodeComplexityLessThanHigh": "wipe", "requireClass3Biometrics": true, "requirePinAfterBiometricChange": true,
- "fingerprintAndBiometricEnabled": true
+ "fingerprintAndBiometricEnabled": true,
+ "minimumWarningSdkVersion": "Minimum Warning Sdk Version value"
} ```
v1.0 Intune Mam Defaultmanagedappprotection Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-mam-defaultmanagedappprotection-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 6243
+Content-Length: 6313
{ "value": {
Content-Length: 6243
"appActionIfDevicePasscodeComplexityLessThanHigh": "wipe", "requireClass3Biometrics": true, "requirePinAfterBiometricChange": true,
- "fingerprintAndBiometricEnabled": true
+ "fingerprintAndBiometricEnabled": true,
+ "minimumWarningSdkVersion": "Minimum Warning Sdk Version value"
} } ```
v1.0 Intune Mam Defaultmanagedappprotection List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-mam-defaultmanagedappprotection-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 6519
+Content-Length: 6591
{ "value": [
Content-Length: 6519
"appActionIfDevicePasscodeComplexityLessThanHigh": "wipe", "requireClass3Biometrics": true, "requirePinAfterBiometricChange": true,
- "fingerprintAndBiometricEnabled": true
+ "fingerprintAndBiometricEnabled": true,
+ "minimumWarningSdkVersion": "Minimum Warning Sdk Version value"
} ] }
v1.0 Intune Mam Defaultmanagedappprotection Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-mam-defaultmanagedappprotection-update.md
The following table shows the properties that are required when you create the [
|requireClass3Biometrics|Boolean|Require user to apply Class 3 Biometrics on their Android device.| |requirePinAfterBiometricChange|Boolean|A PIN prompt will override biometric prompts if class 3 biometrics are updated on the device.| |fingerprintAndBiometricEnabled|Boolean|Indicate to the client to enable both biometrics and fingerprints for the app.|
+|minimumWarningSdkVersion|String|Versions less than the specified version will result in warning message on the managed app from accessing company data. (iOS only)|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceAppManagement/defaultManagedAppProtections/{defaultManagedAppProtectionId} Content-type: application/json
-Content-length: 5790
+Content-length: 5858
{ "@odata.type": "#microsoft.graph.defaultManagedAppProtection",
Content-length: 5790
"appActionIfDevicePasscodeComplexityLessThanHigh": "wipe", "requireClass3Biometrics": true, "requirePinAfterBiometricChange": true,
- "fingerprintAndBiometricEnabled": true
+ "fingerprintAndBiometricEnabled": true,
+ "minimumWarningSdkVersion": "Minimum Warning Sdk Version value"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 5962
+Content-Length: 6030
{ "@odata.type": "#microsoft.graph.defaultManagedAppProtection",
Content-Length: 5962
"appActionIfDevicePasscodeComplexityLessThanHigh": "wipe", "requireClass3Biometrics": true, "requirePinAfterBiometricChange": true,
- "fingerprintAndBiometricEnabled": true
+ "fingerprintAndBiometricEnabled": true,
+ "minimumWarningSdkVersion": "Minimum Warning Sdk Version value"
} ```
v1.0 Intune Mam Devicemanagementreports Getmobileapplicationmanagementappconfigurationreport https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-mam-devicemanagementreports-getmobileapplicationmanagementappconfigurationreport.md
+
+ Title: "getMobileApplicationManagementAppConfigurationReport action"
+description: "Not yet documented"
+
+localization_priority: Normal
++
+# getMobileApplicationManagementAppConfigurationReport action
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Not yet documented
+
+## Prerequisites
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceManagement/reports/getMobileApplicationManagementAppConfigurationReport
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+In the request body, supply JSON representation of the parameters.
+
+The following table shows the parameters that can be used with this action.
+
+|Property|Type|Description|
+|:|:|:|
+|name|String|Not yet documented|
+|select|String collection|Not yet documented|
+|search|String|Not yet documented|
+|groupBy|String collection|Not yet documented|
+|orderBy|String collection|Not yet documented|
+|skip|Int32|Not yet documented|
+|top|Int32|Not yet documented|
+|sessionId|String|Not yet documented|
+|filter|String|Not yet documented|
+++
+## Response
+If successful, this action returns a `200 OK` response code and a Stream in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/reports/getMobileApplicationManagementAppConfigurationReport
+
+Content-type: application/json
+Content-length: 278
+
+{
+ "name": "Name value",
+ "select": [
+ "Select value"
+ ],
+ "search": "Search value",
+ "groupBy": [
+ "Group By value"
+ ],
+ "orderBy": [
+ "Order By value"
+ ],
+ "skip": 4,
+ "top": 3,
+ "sessionId": "Session Id value",
+ "filter": "Filter value"
+}
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 127
+
+{
+ "value": "Z2V0TW9iaWxlQXBwbGljYXRpb25NYW5hZ2VtZW50QXBwQ29uZmlndXJhdGlvblJlcG9ydCBJbnR1bmUgRG9jIFNhbXBsZSA1NTA5OTkwMDg="
+}
+```
+++++
v1.0 Intune Onboarding Devicemanagementpartner Terminate https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-onboarding-devicemanagementpartner-terminate.md
+
+ Title: "terminate action"
+description: "Not yet documented"
+
+localization_priority: Normal
++
+# terminate action
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Not yet documented
+
+## Prerequisites
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementServiceConfig.Read.All, DeviceManagementConfiguration.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementServiceConfig.Read.All, DeviceManagementConfiguration.Read.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceManagement/deviceManagementPartners/{deviceManagementPartnerId}/terminate
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this action returns a `204 No Content` response code.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/deviceManagementPartners/{deviceManagementPartnerId}/terminate
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 204 No Content
+```
+++++
v1.0 Intune Onboarding Windows10enrollmentcompletionpageconfiguration Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-onboarding-windows10enrollmentcompletionpageconfiguration-create.md
The following table shows the properties that are required when you create the w
|allowDeviceUseOnInstallFailure|Boolean|Allow the user to continue using the device on installation failure| |selectedMobileAppIds|String collection|Selected applications to track the installation status| |allowNonBlockingAppInstallation|Boolean|Install all required apps as non blocking apps during white glove|
+|installQualityUpdates|Boolean|Allows quality updates installation during OOBE|
|trackInstallProgressForAutopilotOnly|Boolean|Only show installation progress for Autopilot enrollment scenarios| |disableUserStatusTrackingAfterFirstUser|Boolean|Only show installation progress for first user post enrollment|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/deviceEnrollmentConfigurations Content-type: application/json
-Content-length: 839
+Content-length: 873
{ "@odata.type": "#microsoft.graph.windows10EnrollmentCompletionPageConfiguration",
Content-length: 839
"Selected Mobile App Ids value" ], "allowNonBlockingAppInstallation": true,
+ "installQualityUpdates": true,
"trackInstallProgressForAutopilotOnly": true, "disableUserStatusTrackingAfterFirstUser": true }
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 1011
+Content-Length: 1045
{ "@odata.type": "#microsoft.graph.windows10EnrollmentCompletionPageConfiguration",
Content-Length: 1011
"Selected Mobile App Ids value" ], "allowNonBlockingAppInstallation": true,
+ "installQualityUpdates": true,
"trackInstallProgressForAutopilotOnly": true, "disableUserStatusTrackingAfterFirstUser": true }
v1.0 Intune Onboarding Windows10enrollmentcompletionpageconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-onboarding-windows10enrollmentcompletionpageconfiguration-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1080
+Content-Length: 1116
{ "value": {
Content-Length: 1080
"Selected Mobile App Ids value" ], "allowNonBlockingAppInstallation": true,
+ "installQualityUpdates": true,
"trackInstallProgressForAutopilotOnly": true, "disableUserStatusTrackingAfterFirstUser": true }
v1.0 Intune Onboarding Windows10enrollmentcompletionpageconfiguration List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-onboarding-windows10enrollmentcompletionpageconfiguration-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1144
+Content-Length: 1182
{ "value": [
Content-Length: 1144
"Selected Mobile App Ids value" ], "allowNonBlockingAppInstallation": true,
+ "installQualityUpdates": true,
"trackInstallProgressForAutopilotOnly": true, "disableUserStatusTrackingAfterFirstUser": true }
v1.0 Intune Onboarding Windows10enrollmentcompletionpageconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-onboarding-windows10enrollmentcompletionpageconfiguration-update.md
The following table shows the properties that are required when you create the [
|allowDeviceUseOnInstallFailure|Boolean|Allow the user to continue using the device on installation failure| |selectedMobileAppIds|String collection|Selected applications to track the installation status| |allowNonBlockingAppInstallation|Boolean|Install all required apps as non blocking apps during white glove|
+|installQualityUpdates|Boolean|Allows quality updates installation during OOBE|
|trackInstallProgressForAutopilotOnly|Boolean|Only show installation progress for Autopilot enrollment scenarios| |disableUserStatusTrackingAfterFirstUser|Boolean|Only show installation progress for first user post enrollment|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/deviceEnrollmentConfigurations/{deviceEnrollmentConfigurationId} Content-type: application/json
-Content-length: 839
+Content-length: 873
{ "@odata.type": "#microsoft.graph.windows10EnrollmentCompletionPageConfiguration",
Content-length: 839
"Selected Mobile App Ids value" ], "allowNonBlockingAppInstallation": true,
+ "installQualityUpdates": true,
"trackInstallProgressForAutopilotOnly": true, "disableUserStatusTrackingAfterFirstUser": true }
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1011
+Content-Length: 1045
{ "@odata.type": "#microsoft.graph.windows10EnrollmentCompletionPageConfiguration",
Content-Length: 1011
"Selected Mobile App Ids value" ], "allowNonBlockingAppInstallation": true,
+ "installQualityUpdates": true,
"trackInstallProgressForAutopilotOnly": true, "disableUserStatusTrackingAfterFirstUser": true }
v1.0 Intune Partnerintegration Organizationalmessagedetail Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-partnerintegration-organizationalmessagedetail-create.md
- Title: "Create organizationalMessageDetail"
-description: "Create a new organizationalMessageDetail object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Create organizationalMessageDetail
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Create a new [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object.
-
-## Prerequisites
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
-
-## HTTP Request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-POST /deviceManagement/organizationalMessageDetails
-```
-
-## Request headers
-|Header|Value|
-|:|:|
-|Authorization|Bearer &lt;token&gt; Required.|
-|Accept|application/json|
-
-## Request body
-In the request body, supply a JSON representation for the organizationalMessageDetail object.
-
-The following table shows the properties that are required when you create the organizationalMessageDetail.
-
-|Property|Type|Description|
-|:|:|:|
-|id|String|A unique identifier for the organizational message|
-|scenario|[organizationalMessageScenario](../resources/intune-partnerintegration-organizationalmessagescenario.md)|Indicates the scenario for the message. Possible values are: `onboarding`, `lifecycle`, `unknownFutureValue`.|
-|surface|[organizationalMessageSurface](../resources/intune-partnerintegration-organizationalmessagesurface.md)|Indicates the area where content will be displayed to customers. Possible values are: `actionCenter`, `getStarted`, `softLanding`, `unknownFutureValue`.|
-|status|[organizationalMessageStatus](../resources/intune-partnerintegration-organizationalmessagestatus.md)|Indicates the deployment status of the message. Possible values are: `scheduled`, `active`, `completed`, `cancelled`, `unknownFutureValue`.|
-|startDateTime|DateTimeOffset|The date and time of when the message will start being displayed to clients|
-|endDateTime|DateTimeOffset|The date and time of when the message will stop being displayed to clients|
-|createdDateTime|DateTimeOffset|The date and time of when the message was created|
-|lastModifiedDateTime|DateTimeOffset|The date and time of when the message was last modified|
-|userEngagementStatistics|[organizationalMessageInsights](../resources/intune-partnerintegration-organizationalmessageinsights.md)|The statistics containing how the message was interacted with by clients. This includes the number of impressions, clicks, and dismisses from targeted clients.|
-|frequency|[organizationalMessageFrequency](../resources/intune-partnerintegration-organizationalmessagefrequency.md)|The frequency at which a client will see the message. Possible values are: `weeklyOnce`, `monthlyOnce`, `monthlyTwice`, `unknownFutureValue`.|
-|targeting|[organizationalMessageTargeting](../resources/intune-partnerintegration-organizationalmessagetargeting.md)|The groups of devices that will receive the message. This also contains a list of excluded groups that will not receive the message regardless of the device being part of an included group|
-|content|[organizationalMessageContent](../resources/intune-partnerintegration-organizationalmessagecontent.md)|The content that will be displayed to clients for the message. This includes the text portion of the message and the displayed logo|
-|theme|[organizationalMessageTheme](../resources/intune-partnerintegration-organizationalmessagetheme.md)|Indicates the theme for the experience. Possible values are: `update`, `training`, `welcomeToWindows`, `explore`, `unknownFutureValue`.|
-|variant|String|Indicates the corresponding variant for the experience|
---
-## Response
-If successful, this method returns a `201 Created` response code and a [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object in the response body.
-
-## Example
-
-### Request
-Here is an example of the request.
-``` http
-POST https://graph.microsoft.com/beta/deviceManagement/organizationalMessageDetails
-Content-type: application/json
-Content-length: 2049
-
-{
- "@odata.type": "#microsoft.graph.organizationalMessageDetail",
- "scenario": "lifecycle",
- "surface": "getStarted",
- "status": "active",
- "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
- "endDateTime": "2017-01-01T00:03:30.9241974-08:00",
- "userEngagementStatistics": {
- "@odata.type": "microsoft.graph.organizationalMessageInsights",
- "impressions": 11,
- "clicks": 6,
- "dismisses": 9
- },
- "frequency": "monthlyOnce",
- "targeting": {
- "@odata.type": "microsoft.graph.organizationalMessageTargeting",
- "targetingType": "unknownFutureValue",
- "includeIds": [
- "Include Ids value"
- ],
- "excludeIds": [
- "Exclude Ids value"
- ]
- },
- "content": {
- "@odata.type": "microsoft.graph.organizationalMessageContent",
- "guidedContentId": "Guided Content Id value",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logoInfo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogo",
- "logo": "bG9nbw==",
- "contentType": "unknownFutureValue",
- "logoCdnUrl": "https://example.com/logoCdnUrl/"
- }
- },
- "theme": "training",
- "variant": "Variant value"
-}
-```
-
-### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
-``` http
-HTTP/1.1 201 Created
-Content-Type: application/json
-Content-Length: 2221
-
-{
- "@odata.type": "#microsoft.graph.organizationalMessageDetail",
- "id": "affbf3ad-f3ad-affb-adf3-fbafadf3fbaf",
- "scenario": "lifecycle",
- "surface": "getStarted",
- "status": "active",
- "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
- "endDateTime": "2017-01-01T00:03:30.9241974-08:00",
- "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
- "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "userEngagementStatistics": {
- "@odata.type": "microsoft.graph.organizationalMessageInsights",
- "impressions": 11,
- "clicks": 6,
- "dismisses": 9
- },
- "frequency": "monthlyOnce",
- "targeting": {
- "@odata.type": "microsoft.graph.organizationalMessageTargeting",
- "targetingType": "unknownFutureValue",
- "includeIds": [
- "Include Ids value"
- ],
- "excludeIds": [
- "Exclude Ids value"
- ]
- },
- "content": {
- "@odata.type": "microsoft.graph.organizationalMessageContent",
- "guidedContentId": "Guided Content Id value",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logoInfo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogo",
- "logo": "bG9nbw==",
- "contentType": "unknownFutureValue",
- "logoCdnUrl": "https://example.com/logoCdnUrl/"
- }
- },
- "theme": "training",
- "variant": "Variant value"
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessagedetail Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-partnerintegration-organizationalmessagedetail-get.md
- Title: "Get organizationalMessageDetail"
-description: "Read properties and relationships of the organizationalMessageDetail object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Get organizationalMessageDetail
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Read properties and relationships of the [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object.
-
-## Prerequisites
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
-
-## HTTP Request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-GET /deviceManagement/organizationalMessageDetails/{organizationalMessageDetailId}
-```
-
-## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
-
-## Request headers
-|Header|Value|
-|:|:|
-|Authorization|Bearer &lt;token&gt; Required.|
-|Accept|application/json|
-
-## Request body
-Do not supply a request body for this method.
-
-## Response
-If successful, this method returns a `200 OK` response code and [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object in the response body.
-
-## Example
-
-### Request
-Here is an example of the request.
-``` http
-GET https://graph.microsoft.com/beta/deviceManagement/organizationalMessageDetails/{organizationalMessageDetailId}
-```
-
-### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-Content-Length: 2368
-
-{
- "value": {
- "@odata.type": "#microsoft.graph.organizationalMessageDetail",
- "id": "affbf3ad-f3ad-affb-adf3-fbafadf3fbaf",
- "scenario": "lifecycle",
- "surface": "getStarted",
- "status": "active",
- "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
- "endDateTime": "2017-01-01T00:03:30.9241974-08:00",
- "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
- "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "userEngagementStatistics": {
- "@odata.type": "microsoft.graph.organizationalMessageInsights",
- "impressions": 11,
- "clicks": 6,
- "dismisses": 9
- },
- "frequency": "monthlyOnce",
- "targeting": {
- "@odata.type": "microsoft.graph.organizationalMessageTargeting",
- "targetingType": "unknownFutureValue",
- "includeIds": [
- "Include Ids value"
- ],
- "excludeIds": [
- "Exclude Ids value"
- ]
- },
- "content": {
- "@odata.type": "microsoft.graph.organizationalMessageContent",
- "guidedContentId": "Guided Content Id value",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logoInfo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogo",
- "logo": "bG9nbw==",
- "contentType": "unknownFutureValue",
- "logoCdnUrl": "https://example.com/logoCdnUrl/"
- }
- },
- "theme": "training",
- "variant": "Variant value"
- }
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessagedetail List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-partnerintegration-organizationalmessagedetail-list.md
- Title: "List organizationalMessageDetails"
-description: "List properties and relationships of the organizationalMessageDetail objects."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# List organizationalMessageDetails
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-List properties and relationships of the [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) objects.
-
-## Prerequisites
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
-
-## HTTP Request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-GET /deviceManagement/organizationalMessageDetails
-```
-
-## Request headers
-|Header|Value|
-|:|:|
-|Authorization|Bearer &lt;token&gt; Required.|
-|Accept|application/json|
-
-## Request body
-Do not supply a request body for this method.
-
-## Response
-If successful, this method returns a `200 OK` response code and a collection of [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) objects in the response body.
-
-## Example
-
-### Request
-Here is an example of the request.
-``` http
-GET https://graph.microsoft.com/beta/deviceManagement/organizationalMessageDetails
-```
-
-### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-Content-Length: 2510
-
-{
- "value": [
- {
- "@odata.type": "#microsoft.graph.organizationalMessageDetail",
- "id": "affbf3ad-f3ad-affb-adf3-fbafadf3fbaf",
- "scenario": "lifecycle",
- "surface": "getStarted",
- "status": "active",
- "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
- "endDateTime": "2017-01-01T00:03:30.9241974-08:00",
- "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
- "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "userEngagementStatistics": {
- "@odata.type": "microsoft.graph.organizationalMessageInsights",
- "impressions": 11,
- "clicks": 6,
- "dismisses": 9
- },
- "frequency": "monthlyOnce",
- "targeting": {
- "@odata.type": "microsoft.graph.organizationalMessageTargeting",
- "targetingType": "unknownFutureValue",
- "includeIds": [
- "Include Ids value"
- ],
- "excludeIds": [
- "Exclude Ids value"
- ]
- },
- "content": {
- "@odata.type": "microsoft.graph.organizationalMessageContent",
- "guidedContentId": "Guided Content Id value",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logoInfo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogo",
- "logo": "bG9nbw==",
- "contentType": "unknownFutureValue",
- "logoCdnUrl": "https://example.com/logoCdnUrl/"
- }
- },
- "theme": "training",
- "variant": "Variant value"
- }
- ]
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessagedetail Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-partnerintegration-organizationalmessagedetail-update.md
- Title: "Update organizationalMessageDetail"
-description: "Update the properties of a organizationalMessageDetail object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Update organizationalMessageDetail
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Update the properties of a [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object.
-
-## Prerequisites
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
-
-## HTTP Request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-PATCH /deviceManagement/organizationalMessageDetails/{organizationalMessageDetailId}
-```
-
-## Request headers
-|Header|Value|
-|:|:|
-|Authorization|Bearer &lt;token&gt; Required.|
-|Accept|application/json|
-
-## Request body
-In the request body, supply a JSON representation for the [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object.
-
-The following table shows the properties that are required when you create the [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md).
-
-|Property|Type|Description|
-|:|:|:|
-|id|String|A unique identifier for the organizational message|
-|scenario|[organizationalMessageScenario](../resources/intune-partnerintegration-organizationalmessagescenario.md)|Indicates the scenario for the message. Possible values are: `onboarding`, `lifecycle`, `unknownFutureValue`.|
-|surface|[organizationalMessageSurface](../resources/intune-partnerintegration-organizationalmessagesurface.md)|Indicates the area where content will be displayed to customers. Possible values are: `actionCenter`, `getStarted`, `softLanding`, `unknownFutureValue`.|
-|status|[organizationalMessageStatus](../resources/intune-partnerintegration-organizationalmessagestatus.md)|Indicates the deployment status of the message. Possible values are: `scheduled`, `active`, `completed`, `cancelled`, `unknownFutureValue`.|
-|startDateTime|DateTimeOffset|The date and time of when the message will start being displayed to clients|
-|endDateTime|DateTimeOffset|The date and time of when the message will stop being displayed to clients|
-|createdDateTime|DateTimeOffset|The date and time of when the message was created|
-|lastModifiedDateTime|DateTimeOffset|The date and time of when the message was last modified|
-|userEngagementStatistics|[organizationalMessageInsights](../resources/intune-partnerintegration-organizationalmessageinsights.md)|The statistics containing how the message was interacted with by clients. This includes the number of impressions, clicks, and dismisses from targeted clients.|
-|frequency|[organizationalMessageFrequency](../resources/intune-partnerintegration-organizationalmessagefrequency.md)|The frequency at which a client will see the message. Possible values are: `weeklyOnce`, `monthlyOnce`, `monthlyTwice`, `unknownFutureValue`.|
-|targeting|[organizationalMessageTargeting](../resources/intune-partnerintegration-organizationalmessagetargeting.md)|The groups of devices that will receive the message. This also contains a list of excluded groups that will not receive the message regardless of the device being part of an included group|
-|content|[organizationalMessageContent](../resources/intune-partnerintegration-organizationalmessagecontent.md)|The content that will be displayed to clients for the message. This includes the text portion of the message and the displayed logo|
-|theme|[organizationalMessageTheme](../resources/intune-partnerintegration-organizationalmessagetheme.md)|Indicates the theme for the experience. Possible values are: `update`, `training`, `welcomeToWindows`, `explore`, `unknownFutureValue`.|
-|variant|String|Indicates the corresponding variant for the experience|
---
-## Response
-If successful, this method returns a `200 OK` response code and an updated [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object in the response body.
-
-## Example
-
-### Request
-Here is an example of the request.
-``` http
-PATCH https://graph.microsoft.com/beta/deviceManagement/organizationalMessageDetails/{organizationalMessageDetailId}
-Content-type: application/json
-Content-length: 2049
-
-{
- "@odata.type": "#microsoft.graph.organizationalMessageDetail",
- "scenario": "lifecycle",
- "surface": "getStarted",
- "status": "active",
- "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
- "endDateTime": "2017-01-01T00:03:30.9241974-08:00",
- "userEngagementStatistics": {
- "@odata.type": "microsoft.graph.organizationalMessageInsights",
- "impressions": 11,
- "clicks": 6,
- "dismisses": 9
- },
- "frequency": "monthlyOnce",
- "targeting": {
- "@odata.type": "microsoft.graph.organizationalMessageTargeting",
- "targetingType": "unknownFutureValue",
- "includeIds": [
- "Include Ids value"
- ],
- "excludeIds": [
- "Exclude Ids value"
- ]
- },
- "content": {
- "@odata.type": "microsoft.graph.organizationalMessageContent",
- "guidedContentId": "Guided Content Id value",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logoInfo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogo",
- "logo": "bG9nbw==",
- "contentType": "unknownFutureValue",
- "logoCdnUrl": "https://example.com/logoCdnUrl/"
- }
- },
- "theme": "training",
- "variant": "Variant value"
-}
-```
-
-### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-Content-Length: 2221
-
-{
- "@odata.type": "#microsoft.graph.organizationalMessageDetail",
- "id": "affbf3ad-f3ad-affb-adf3-fbafadf3fbaf",
- "scenario": "lifecycle",
- "surface": "getStarted",
- "status": "active",
- "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
- "endDateTime": "2017-01-01T00:03:30.9241974-08:00",
- "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
- "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "userEngagementStatistics": {
- "@odata.type": "microsoft.graph.organizationalMessageInsights",
- "impressions": 11,
- "clicks": 6,
- "dismisses": 9
- },
- "frequency": "monthlyOnce",
- "targeting": {
- "@odata.type": "microsoft.graph.organizationalMessageTargeting",
- "targetingType": "unknownFutureValue",
- "includeIds": [
- "Include Ids value"
- ],
- "excludeIds": [
- "Exclude Ids value"
- ]
- },
- "content": {
- "@odata.type": "microsoft.graph.organizationalMessageContent",
- "guidedContentId": "Guided Content Id value",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logoInfo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogo",
- "logo": "bG9nbw==",
- "contentType": "unknownFutureValue",
- "logoCdnUrl": "https://example.com/logoCdnUrl/"
- }
- },
- "theme": "training",
- "variant": "Variant value"
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessageguidedcontent Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-partnerintegration-organizationalmessageguidedcontent-create.md
- Title: "Create organizationalMessageGuidedContent"
-description: "Create a new organizationalMessageGuidedContent object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Create organizationalMessageGuidedContent
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Create a new [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object.
-
-## Prerequisites
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
-
-## HTTP Request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-POST /deviceManagement/organizationalMessageGuidedContents
-```
-
-## Request headers
-|Header|Value|
-|:|:|
-|Authorization|Bearer &lt;token&gt; Required.|
-|Accept|application/json|
-
-## Request body
-In the request body, supply a JSON representation for the organizationalMessageGuidedContent object.
-
-The following table shows the properties that are required when you create the organizationalMessageGuidedContent.
-
-|Property|Type|Description|
-|:|:|:|
-|id|String|A unique identifier for the guided content|
-|scenario|[organizationalMessageScenario](../resources/intune-partnerintegration-organizationalmessagescenario.md)|Indicates the scenario for the guided content. Possible values are: `onboarding`, `lifecycle`, `unknownFutureValue`.|
-|theme|[organizationalMessageTheme](../resources/intune-partnerintegration-organizationalmessagetheme.md)|Indicates the theme for the guided content. Possible values are: `update`, `training`, `welcomeToWindows`, `explore`, `unknownFutureValue`.|
-|surface|[organizationalMessageSurface](../resources/intune-partnerintegration-organizationalmessagesurface.md)|Indicates the area where content will be displayed to customers. Possible values are: `actionCenter`, `getStarted`, `softLanding`, `unknownFutureValue`.|
-|placementDetails|[organizationalMessagePlacementDetail](../resources/intune-partnerintegration-organizationalmessageplacementdetail.md) collection|Contains the different types of text content that can be displayed to customers along with their localized values|
-|logo|[organizationalMessageLogoGuide](../resources/intune-partnerintegration-organizationalmessagelogoguide.md)|Example of the logo that will be displayed to customers and its size requirements|
---
-## Response
-If successful, this method returns a `201 Created` response code and a [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object in the response body.
-
-## Example
-
-### Request
-Here is an example of the request.
-``` http
-POST https://graph.microsoft.com/beta/deviceManagement/organizationalMessageGuidedContents
-Content-type: application/json
-Content-length: 1403
-
-{
- "@odata.type": "#microsoft.graph.organizationalMessageGuidedContent",
- "scenario": "lifecycle",
- "theme": "training",
- "surface": "getStarted",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide",
- "logoCdnUrl": "https://example.com/logoCdnUrl/",
- "assetName": "Asset Name value",
- "dimensions": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",
- "minWidth": 8,
- "maxWidth": 8,
- "minHeight": 9,
- "maxHeight": 9
- }
- }
-}
-```
-
-### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
-``` http
-HTTP/1.1 201 Created
-Content-Type: application/json
-Content-Length: 1452
-
-{
- "@odata.type": "#microsoft.graph.organizationalMessageGuidedContent",
- "id": "13e64843-4843-13e6-4348-e6134348e613",
- "scenario": "lifecycle",
- "theme": "training",
- "surface": "getStarted",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide",
- "logoCdnUrl": "https://example.com/logoCdnUrl/",
- "assetName": "Asset Name value",
- "dimensions": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",
- "minWidth": 8,
- "maxWidth": 8,
- "minHeight": 9,
- "maxHeight": 9
- }
- }
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessageguidedcontent Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-partnerintegration-organizationalmessageguidedcontent-get.md
- Title: "Get organizationalMessageGuidedContent"
-description: "Read properties and relationships of the organizationalMessageGuidedContent object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Get organizationalMessageGuidedContent
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Read properties and relationships of the [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object.
-
-## Prerequisites
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
-
-## HTTP Request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-GET /deviceManagement/organizationalMessageGuidedContents/{organizationalMessageGuidedContentId}
-```
-
-## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
-
-## Request headers
-|Header|Value|
-|:|:|
-|Authorization|Bearer &lt;token&gt; Required.|
-|Accept|application/json|
-
-## Request body
-Do not supply a request body for this method.
-
-## Response
-If successful, this method returns a `200 OK` response code and [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object in the response body.
-
-## Example
-
-### Request
-Here is an example of the request.
-``` http
-GET https://graph.microsoft.com/beta/deviceManagement/organizationalMessageGuidedContents/{organizationalMessageGuidedContentId}
-```
-
-### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-Content-Length: 1557
-
-{
- "value": {
- "@odata.type": "#microsoft.graph.organizationalMessageGuidedContent",
- "id": "13e64843-4843-13e6-4348-e6134348e613",
- "scenario": "lifecycle",
- "theme": "training",
- "surface": "getStarted",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide",
- "logoCdnUrl": "https://example.com/logoCdnUrl/",
- "assetName": "Asset Name value",
- "dimensions": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",
- "minWidth": 8,
- "maxWidth": 8,
- "minHeight": 9,
- "maxHeight": 9
- }
- }
- }
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessageguidedcontent List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-partnerintegration-organizationalmessageguidedcontent-list.md
- Title: "List organizationalMessageGuidedContents"
-description: "List properties and relationships of the organizationalMessageGuidedContent objects."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# List organizationalMessageGuidedContents
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-List properties and relationships of the [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) objects.
-
-## Prerequisites
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
-
-## HTTP Request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-GET /deviceManagement/organizationalMessageGuidedContents
-```
-
-## Request headers
-|Header|Value|
-|:|:|
-|Authorization|Bearer &lt;token&gt; Required.|
-|Accept|application/json|
-
-## Request body
-Do not supply a request body for this method.
-
-## Response
-If successful, this method returns a `200 OK` response code and a collection of [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) objects in the response body.
-
-## Example
-
-### Request
-Here is an example of the request.
-``` http
-GET https://graph.microsoft.com/beta/deviceManagement/organizationalMessageGuidedContents
-```
-
-### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-Content-Length: 1657
-
-{
- "value": [
- {
- "@odata.type": "#microsoft.graph.organizationalMessageGuidedContent",
- "id": "13e64843-4843-13e6-4348-e6134348e613",
- "scenario": "lifecycle",
- "theme": "training",
- "surface": "getStarted",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide",
- "logoCdnUrl": "https://example.com/logoCdnUrl/",
- "assetName": "Asset Name value",
- "dimensions": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",
- "minWidth": 8,
- "maxWidth": 8,
- "minHeight": 9,
- "maxHeight": 9
- }
- }
- }
- ]
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessageguidedcontent Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-partnerintegration-organizationalmessageguidedcontent-update.md
- Title: "Update organizationalMessageGuidedContent"
-description: "Update the properties of a organizationalMessageGuidedContent object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Update organizationalMessageGuidedContent
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Update the properties of a [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object.
-
-## Prerequisites
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
-
-## HTTP Request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-PATCH /deviceManagement/organizationalMessageGuidedContents/{organizationalMessageGuidedContentId}
-```
-
-## Request headers
-|Header|Value|
-|:|:|
-|Authorization|Bearer &lt;token&gt; Required.|
-|Accept|application/json|
-
-## Request body
-In the request body, supply a JSON representation for the [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object.
-
-The following table shows the properties that are required when you create the [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md).
-
-|Property|Type|Description|
-|:|:|:|
-|id|String|A unique identifier for the guided content|
-|scenario|[organizationalMessageScenario](../resources/intune-partnerintegration-organizationalmessagescenario.md)|Indicates the scenario for the guided content. Possible values are: `onboarding`, `lifecycle`, `unknownFutureValue`.|
-|theme|[organizationalMessageTheme](../resources/intune-partnerintegration-organizationalmessagetheme.md)|Indicates the theme for the guided content. Possible values are: `update`, `training`, `welcomeToWindows`, `explore`, `unknownFutureValue`.|
-|surface|[organizationalMessageSurface](../resources/intune-partnerintegration-organizationalmessagesurface.md)|Indicates the area where content will be displayed to customers. Possible values are: `actionCenter`, `getStarted`, `softLanding`, `unknownFutureValue`.|
-|placementDetails|[organizationalMessagePlacementDetail](../resources/intune-partnerintegration-organizationalmessageplacementdetail.md) collection|Contains the different types of text content that can be displayed to customers along with their localized values|
-|logo|[organizationalMessageLogoGuide](../resources/intune-partnerintegration-organizationalmessagelogoguide.md)|Example of the logo that will be displayed to customers and its size requirements|
---
-## Response
-If successful, this method returns a `200 OK` response code and an updated [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object in the response body.
-
-## Example
-
-### Request
-Here is an example of the request.
-``` http
-PATCH https://graph.microsoft.com/beta/deviceManagement/organizationalMessageGuidedContents/{organizationalMessageGuidedContentId}
-Content-type: application/json
-Content-length: 1403
-
-{
- "@odata.type": "#microsoft.graph.organizationalMessageGuidedContent",
- "scenario": "lifecycle",
- "theme": "training",
- "surface": "getStarted",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide",
- "logoCdnUrl": "https://example.com/logoCdnUrl/",
- "assetName": "Asset Name value",
- "dimensions": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",
- "minWidth": 8,
- "maxWidth": 8,
- "minHeight": 9,
- "maxHeight": 9
- }
- }
-}
-```
-
-### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-Content-Length: 1452
-
-{
- "@odata.type": "#microsoft.graph.organizationalMessageGuidedContent",
- "id": "13e64843-4843-13e6-4348-e6134348e613",
- "scenario": "lifecycle",
- "theme": "training",
- "surface": "getStarted",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide",
- "logoCdnUrl": "https://example.com/logoCdnUrl/",
- "assetName": "Asset Name value",
- "dimensions": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",
- "minWidth": 8,
- "maxWidth": 8,
- "minHeight": 9,
- "maxHeight": 9
- }
- }
-}
-```
-----
v1.0 Intune Shared Devicemanagementscript Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-shared-devicemanagementscript-create.md
The following table shows the properties that are required when you create the d
|id|String|Unique Identifier for the device management script.| |displayName|String|Name of the device management script.| |description|String|Optional description for the device management script.|
-|runSchedule|[runSchedule](../resources/intune-devices-runschedule.md)|The interval for script to run. If not defined the script will run once|
|scriptContent|Binary|The script content.| |createdDateTime|DateTimeOffset|The date and time the device management script was created. This property is read-only.| |lastModifiedDateTime|DateTimeOffset|The date and time the device management script was last modified. This property is read-only.|
Content-length: 443
"@odata.type": "#microsoft.graph.deviceManagementScript", "displayName": "Display Name value", "description": "Description value",
+ "runSchedule": {
+ "@odata.type": "microsoft.graph.runSchedule"
+ },
"scriptContent": "c2NyaXB0Q29udGVudA==", "runAsAccount": "user", "enforceSignatureCheck": true,
v1.0 Intune Shared Devicemanagementscript List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-shared-devicemanagementscript-list.md
Content-Length: 716
"id": "59ea4525-4525-59ea-2545-ea592545ea59", "displayName": "Display Name value", "description": "Description value",
+ "runSchedule": {
+ "@odata.type": "microsoft.graph.runSchedule"
+ },
"scriptContent": "c2NyaXB0Q29udGVudA==", "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
v1.0 Intune Shared Devicemanagementscript Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-shared-devicemanagementscript-update.md
The following table shows the properties that are required when you create the [
|id|String|Unique Identifier for the device management script.| |displayName|String|Name of the device management script.| |description|String|Optional description for the device management script.|
-|runSchedule|[runSchedule](../resources/intune-devices-runschedule.md)|The interval for script to run. If not defined the script will run once|
|scriptContent|Binary|The script content.| |createdDateTime|DateTimeOffset|The date and time the device management script was created. This property is read-only.| |lastModifiedDateTime|DateTimeOffset|The date and time the device management script was last modified. This property is read-only.|
Content-length: 443
"@odata.type": "#microsoft.graph.deviceManagementScript", "displayName": "Display Name value", "description": "Description value",
+ "runSchedule": {
+ "@odata.type": "microsoft.graph.runSchedule"
+ },
"scriptContent": "c2NyaXB0Q29udGVudA==", "runAsAccount": "user", "enforceSignatureCheck": true,
v1.0 Intune Wip Intunebrandingprofile Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-wip-intunebrandingprofile-create.md
The following table shows the properties that are required when you create the i
|companyPortalBlockedActions|[companyPortalBlockedAction](../resources/intune-shared-companyportalblockedaction.md) collection|Collection of blocked actions on the company portal as per platform and device ownership types.| |showAzureADEnterpriseApps|Boolean|Boolean that indicates if AzureAD Enterprise Apps will be shown in Company Portal| |showOfficeWebApps|Boolean|Boolean that indicates if Office WebApps will be shown in Company Portal|
+|showConfigurationManagerApps|Boolean|Boolean that indicates if Configuration Manager Apps will be shown in Company Portal|
|sendDeviceOwnershipChangePushNotification|Boolean|Boolean that indicates if a push notification is sent to users when their device ownership type changes from personal to corporate| |enrollmentAvailability|[enrollmentAvailabilityOptions](../resources/intune-shared-enrollmentavailabilityoptions.md)|Customized device enrollment flow displayed to the end user . Possible values are: `availableWithPrompts`, `availableWithoutPrompts`, `unavailable`.| |disableClientTelemetry|Boolean|Applies to telemetry sent from all clients to the Intune service. When disabled, all proactive troubleshooting and issue warnings within the client are turned off, and telemetry settings appear inactive or hidden to the device user.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/intuneBrandingProfiles Content-type: application/json
-Content-length: 1975
+Content-length: 2016
{ "@odata.type": "#microsoft.graph.intuneBrandingProfile",
Content-length: 1975
], "showAzureADEnterpriseApps": true, "showOfficeWebApps": true,
+ "showConfigurationManagerApps": true,
"sendDeviceOwnershipChangePushNotification": true, "enrollmentAvailability": "availableWithoutPrompts", "disableClientTelemetry": true,
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 2147
+Content-Length: 2188
{ "@odata.type": "#microsoft.graph.intuneBrandingProfile",
Content-Length: 2147
], "showAzureADEnterpriseApps": true, "showOfficeWebApps": true,
+ "showConfigurationManagerApps": true,
"sendDeviceOwnershipChangePushNotification": true, "enrollmentAvailability": "availableWithoutPrompts", "disableClientTelemetry": true,
v1.0 Intune Wip Intunebrandingprofile Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-wip-intunebrandingprofile-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 2284
+Content-Length: 2327
{ "value": {
Content-Length: 2284
], "showAzureADEnterpriseApps": true, "showOfficeWebApps": true,
+ "showConfigurationManagerApps": true,
"sendDeviceOwnershipChangePushNotification": true, "enrollmentAvailability": "availableWithoutPrompts", "disableClientTelemetry": true,
v1.0 Intune Wip Intunebrandingprofile List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-wip-intunebrandingprofile-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 2416
+Content-Length: 2461
{ "value": [
Content-Length: 2416
], "showAzureADEnterpriseApps": true, "showOfficeWebApps": true,
+ "showConfigurationManagerApps": true,
"sendDeviceOwnershipChangePushNotification": true, "enrollmentAvailability": "availableWithoutPrompts", "disableClientTelemetry": true,
v1.0 Intune Wip Intunebrandingprofile Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-wip-intunebrandingprofile-update.md
The following table shows the properties that are required when you create the [
|companyPortalBlockedActions|[companyPortalBlockedAction](../resources/intune-shared-companyportalblockedaction.md) collection|Collection of blocked actions on the company portal as per platform and device ownership types.| |showAzureADEnterpriseApps|Boolean|Boolean that indicates if AzureAD Enterprise Apps will be shown in Company Portal| |showOfficeWebApps|Boolean|Boolean that indicates if Office WebApps will be shown in Company Portal|
+|showConfigurationManagerApps|Boolean|Boolean that indicates if Configuration Manager Apps will be shown in Company Portal|
|sendDeviceOwnershipChangePushNotification|Boolean|Boolean that indicates if a push notification is sent to users when their device ownership type changes from personal to corporate| |enrollmentAvailability|[enrollmentAvailabilityOptions](../resources/intune-shared-enrollmentavailabilityoptions.md)|Customized device enrollment flow displayed to the end user . Possible values are: `availableWithPrompts`, `availableWithoutPrompts`, `unavailable`.| |disableClientTelemetry|Boolean|Applies to telemetry sent from all clients to the Intune service. When disabled, all proactive troubleshooting and issue warnings within the client are turned off, and telemetry settings appear inactive or hidden to the device user.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/intuneBrandingProfiles/{intuneBrandingProfileId} Content-type: application/json
-Content-length: 1975
+Content-length: 2016
{ "@odata.type": "#microsoft.graph.intuneBrandingProfile",
Content-length: 1975
], "showAzureADEnterpriseApps": true, "showOfficeWebApps": true,
+ "showConfigurationManagerApps": true,
"sendDeviceOwnershipChangePushNotification": true, "enrollmentAvailability": "availableWithoutPrompts", "disableClientTelemetry": true,
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 2147
+Content-Length: 2188
{ "@odata.type": "#microsoft.graph.intuneBrandingProfile",
Content-Length: 2147
], "showAzureADEnterpriseApps": true, "showOfficeWebApps": true,
+ "showConfigurationManagerApps": true,
"sendDeviceOwnershipChangePushNotification": true, "enrollmentAvailability": "availableWithoutPrompts", "disableClientTelemetry": true,
v1.0 Learningcontent Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/learningcontent-update.md
PATCH /employeeExperience/learningProviders/{learningProviderId}/learningContent
|contributors|String collection|The authors, creators, or contributors of the learning content. Optional.| |createdDateTime|DateTimeOffset|The date when the learning content was created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Optional.| |description|String|The description or summary for the learning content. Optional.|
-|duration|Duration|The duration of the learning content in seconds. Optional.|
+|duration|Duration|The duration of the learning content in seconds. The value is represented in ISO 8601 format for durations. Optional.|
|externalId|String|Unique external content ID for the learning content. Required.| |format|String|The format of the learning content. For example, `Course`, `Video`, `Book`, `Book Summary`, `Audiobook Summary`. Optional.| |isActive|Boolean|Indicates whether the content is active or not. Inactive content will not show up in the UI. The default value is `true`. Optional.|
Content-Type: application/json
"numberOfPages": 9, "duration": "PT20M", "format": "Book",
- "createdDateTime": "2018-01-01T00:00:00",
+ "createdDateTime": "2018-01-01T00:00:00Z",
"lastModifiedDateTime": "2021-04-01T04:26:06.1995367Z",
- "contributor": "Scott Simpson",
+ "contributors": ["Scott Simpson"],
"additionalTags": [ "Create private or public teams", "Add members to teams"
v1.0 Linkedresource_V2 Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/linkedresource_v2-delete.md
DELETE https://graph.microsoft.com/beta/me/tasks/lists/AAMkADliMmU5YjJlLTVmMmQtN
[!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Go](#tab/go)
-
-# [PHP](#tab/php)
-
v1.0 Linkedresource_V2 Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/linkedresource_v2-get.md
GET https://graph.microsoft.com/beta/me/tasks/lists/AAMkADliMmU5YjJlLTVmMmQtNGQz
[!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Go](#tab/go)
-
-# [PHP](#tab/php)
-
v1.0 Linkedresource_V2 Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/linkedresource_v2-update.md
Content-Type: application/json
} ```
-# [C#](#tab/csharp)
- # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/update-linkedresource-v2-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Java](#tab/java)
-
-# [Go](#tab/go)
-
-# [PHP](#tab/php)
-
v1.0 Managedtenants Auditevent Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-auditevent-get.md
Title: "Get auditEvent"
description: "Read the properties and relationships of an auditEvent object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Cloudpcconnection Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-cloudpcconnection-get.md
Title: "Get cloudPcConnection"
description: "Read the properties and relationships of a cloudPcConnection object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Cloudpcdevice Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-cloudpcdevice-get.md
Title: "Get cloudPcDevice"
description: "Read the properties and relationships of a cloudPcDevice object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Cloudpcoverview Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-cloudpcoverview-get.md
Title: "Get cloudPcOverview"
description: "Read the properties and relationships of a cloudPcOverview object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Conditionalaccesspolicycoverage Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-conditionalaccesspolicycoverage-get.md
Title: "Get conditionalAccessPolicyCoverage"
description: "Read the properties and relationships of a conditionalAccessPolicyCoverage object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Credentialuserregistrationssummary Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-credentialuserregistrationssummary-get.md
Title: "Get credentialUserRegistrationsSummary"
description: "Read the properties and relationships of a credentialUserRegistrationsSummary object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Devicecompliancepolicysettingstatesummary Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-devicecompliancepolicysettingstatesummary-get.md
Title: "Get deviceCompliancePolicySettingStateSummary"
description: "Read the properties and relationships of a deviceCompliancePolicySettingStateSummary object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Manageddevicecompliance Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-manageddevicecompliance-get.md
Title: "Get managedDeviceCompliance"
description: "Read the properties and relationships of a managedDeviceCompliance object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Manageddevicecompliancetrend Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-manageddevicecompliancetrend-get.md
Title: "Get managedDeviceComplianceTrend"
description: "Read the properties and relationships of a managedDeviceComplianceTrend object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Aggregatedpolicycompliances https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-aggregatedpolicycompliances.md
Title: "List aggregatedPolicyCompliances"
description: "Get a list of the aggregatedPolicyCompliance objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Auditevents https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-auditevents.md
Title: "List auditEvents"
description: "Get a list of the auditEvent objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Cloudpcconnections https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-cloudpcconnections.md
Title: "List cloudPcConnections"
description: "Get a list of the cloudPcConnection objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Cloudpcdevices https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-cloudpcdevices.md
Title: "List cloudPcDevices"
description: "Get a list of the cloudPcDevice objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Cloudpcsoverview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-cloudpcsoverview.md
Title: "List cloudPcOverviews"
description: "Get a list of the cloudPcOverview objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Conditionalaccesspolicycoverages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-conditionalaccesspolicycoverages.md
Title: "List conditionalAccessPolicyCoverages"
description: "Get a list of the conditionalAccessPolicyCoverage objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Credentialuserregistrationssummaries https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-credentialuserregistrationssummaries.md
Title: "List credentialUserRegistrationsSummaries"
description: "Get a list of the credentialUserRegistrationsSummary objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Devicecompliancepolicysettingstatesummary https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-devicecompliancepolicysettingstatesummary.md
Title: "List deviceCompliancePolicySettingStateSummary"
description: "Get a list of the deviceCompliancePolicySettingStateSummary objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Manageddevicecompliances https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-manageddevicecompliances.md
Title: "List managedDeviceCompliances"
description: "Get a list of the managedDeviceCompliance objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Manageddevicecompliancetrends https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-manageddevicecompliancetrends.md
Title: "List managedDeviceComplianceTrends"
description: "Get a list of the managedDeviceComplianceTrend objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Managementactions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-managementactions.md
Title: "List managementActions"
description: "Get a list of the managementAction objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Managementactiontenantdeploymentstatuses https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-managementactiontenantdeploymentstatuses.md
Title: "List managementActionTenantDeploymentStatus"
description: "Get a list of the managementActionTenantDeploymentStatus objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Managementintents https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-managementintents.md
Title: "List managementIntents"
description: "Get a list of the managementIntent objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Managementtemplates https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-managementtemplates.md
Title: "List managementTemplates"
description: "Get a list of the managementTemplate objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Myroles https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-myroles.md
Title: "List myRoles"
description: "Get the roles that a signed-in user has through a delegated relationship across managed tenants." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Tenantgroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-tenantgroups.md
Title: "List tenantGroups"
description: "Get a list of the tenantGroup objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Tenants https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-tenants.md
Title: "List tenants"
description: "Get a list of the tenant objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Tenantscustomizedinformation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-tenantscustomizedinformation.md
Title: "List tenantCustomizedInformation"
description: "Get a list of the tenantCustomizedInformation objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Tenantsdetailedinformation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-tenantsdetailedinformation.md
Title: "List tenantDetailedInformation"
description: "Get a list of the tenantDetailedInformation objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Tenanttags https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-tenanttags.md
Title: "List tenantTags"
description: "Get a list of the tenantTag objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Tenantusage https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-tenantusage.md
Title: "List tenantUsage"
description: "Get a list of the tenantUsage objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Windowsdevicemalwarestates https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-windowsdevicemalwarestates.md
Title: "List windowsDeviceMalwareStates"
description: "Get a list of the windowsDeviceMalwareState objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Windowsprotectionstates https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-windowsprotectionstates.md
Title: "List windowsProtectionStates"
description: "Get a list of the windowsProtectionState objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant Post Tenanttags https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-post-tenanttags.md
Title: "Create tenantTag"
description: "Create a new tenantTag object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managementaction Apply https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managementaction-apply.md
Title: "managementAction: apply"
description: "Applies a management action against a specific managed tenant. By performing this operation the appropriate configurations will be made and policies created. As example when applying the require multi-factor authentication for admins management action will create an Azure Active Directory conditional access policy that requires multi-factor authentication for all users that have been assigned an administrative directory role." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managementaction Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managementaction-get.md
Title: "Get managementAction"
description: "Read the properties and relationships of a managementAction object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managementactiontenantdeploymentstatus Changedeploymentstatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managementactiontenantdeploymentstatus-changedeploymentstatus.md
Title: "managementActionTenantDeploymentStatus: changeDeploymentStatus"
description: "Changes the tenant level deployment status for the management action. This information is used to provide insights into what management actions are in a specific state. As example there might be a plan to apply the require multi-factor authentication for admins, so it would be ideal to change the status to planned to reflect the appropriate status." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managementactiontenantdeploymentstatus Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managementactiontenantdeploymentstatus-get.md
Title: "Get managementActionTenantDeploymentStatus"
description: "Read the properties and relationships of a managementActionTenantDeploymentStatus object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managementintent Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managementintent-get.md
Title: "Get managementIntent"
description: "Read the properties and relationships of a managementIntent object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managementtemplate Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managementtemplate-get.md
Title: "Get managementTemplate"
description: "Read the properties and relationships of a managementTemplate object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenant Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenant-get.md
Title: "Get tenant"
description: "Read the properties and relationships of a tenant object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenant Offboardtenant https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenant-offboardtenant.md
Title: "tenant: offboardTenant"
description: "Carries out the appropriate procedures to remove a managed tenant from the multi-tenant management platform. No relationships, such as commerce and delegate administrative privileges, will be impacted. The only change made by invoking this action is the tenant will be deprovisioned from the multi-tenant management platform." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenant Resettenantonboardingstatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenant-resettenantonboardingstatus.md
Title: "tenant: resetTenantOnboardingStatus"
description: "Carries out the appropriate procedures to reset the onboarding status for the managed tenant that was removed from the multi-tenant management platform using the offboardTenant action. By invoking this action the platform will attempt to onboard the managed tenant for management." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenantcustomizedinformation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenantcustomizedinformation-get.md
Title: "Get tenantCustomizedInformation"
description: "Read the properties and relationships of a tenantCustomizedInformation object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenantcustomizedinformation Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenantcustomizedinformation-update.md
Title: "Update tenantCustomizedInformation"
description: "Update the properties of a tenantCustomizedInformation object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenantdetailedinformation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenantdetailedinformation-get.md
Title: "Get tenantDetailedInformation"
description: "Read the properties and relationships of a tenantDetailedInformation object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenantgroup Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenantgroup-get.md
Title: "Get tenantGroup"
description: "Read the properties and relationships of a tenantGroup object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenantgroup Tenantsearch https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenantgroup-tenantsearch.md
Title: "tenantGroup: tenantSearch"
description: "Searches for the specified managed tenants across tenant groups." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenanttag Assigntag https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenanttag-assigntag.md
Title: "tenantTag: assignTag"
description: "Assign the tenant tag to the specified managed tenants." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenanttag Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenanttag-delete.md
Title: "Delete tenantTag"
description: "Delete a tenantTag object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenanttag Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenanttag-get.md
Title: "Get tenantTag"
description: "Read the properties and relationships of a tenantTag object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenanttag Unassigntag https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenanttag-unassigntag.md
Title: "tenantTag: unassignTag"
description: "Un-assigns the tenant tag from the specified managed tenants." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenanttag Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenanttag-update.md
Title: "Update tenantTag"
description: "Update the properties of a tenantTag object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Windowsdevicemalwarestate Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-windowsdevicemalwarestate-get.md
Title: "Get windowsDeviceMalwareState"
description: "Read the properties and relationships of a windowsDeviceMalwareState object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Windowsprotectionstate Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-windowsprotectionstate-get.md
Title: "Get windowsProtectionState"
description: "Read the properties and relationships of a windowsProtectionState object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Microsoftauthenticatorauthenticationmethodconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/microsoftauthenticatorauthenticationmethodconfiguration-get.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:|
-|Delegated (work or school account)|Policy.ReadWrite.AuthenticationMethod|
+|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.AuthenticationMethod|
|Delegated (personal Microsoft account)|Not supported.|
-|Application|Policy.ReadWrite.AuthenticationMethod|
+|Application|Policy.Read.All, Policy.ReadWrite.AuthenticationMethod|
For delegated scenarios, the administrator needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles):
v1.0 Oauth2permissiongrant Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/oauth2permissiongrant-delta.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) | Directory.Read.All, Directory.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |
-|oauth2permissiongrant | Directory.Read.All, DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All |
+|Application | Directory.Read.All, DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All |
## HTTP request
GET /oauth2PermissionGrants/delta
## Query parameters
-Tracking changes incurs a round of one or more **delta** function calls. If you use any query parameter
-(other than `$deltatoken` and `$skiptoken`), you must specify
-it in the initial **delta** request. Microsoft Graph automatically encodes any specified parameters
-into the token portion of the `@odata.nextLink` or `@odata.deltaLink` URL provided in the response.
-You only need to specify any query parameters once up front.
-In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL from the previous response. That URL already
+Tracking changes incurs a round of one or more **delta** function calls. If you use any query parameter
+(other than `$deltatoken` and `$skiptoken`), you must specify
+it in the initial **delta** request. Microsoft Graph automatically encodes any specified parameters
+into the token portion of the `@odata.nextLink` or `@odata.deltaLink` URL provided in the response.
+You only need to specify any query parameters once up front.
+In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL from the previous response. That URL already
includes the encoded parameters. | Query parameter | Type |Description|
GET https://graph.microsoft.com/beta/oauth2PermissionGrants/delta
### Response >**Note:** The response object shown here might be shortened for readability.
-<!-- {
+<!-- {
"blockType": "response", "truncated": true, "@odata.type": "microsoft.graph.oAuth2PermissionGrant",
- "isCollection": true
-} -->
+ "isCollection": true
+} -->
```http HTTP/1.1 200 OK Content-type: application/json
v1.0 Onlinemeeting Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/onlinemeeting-delete.md
Delete an [onlineMeeting](../resources/onlinemeeting.md) object.
| Permission type | Permissions (from least to most privileged) | | :- | : | | Delegated (work or school account) | OnlineMeetings.ReadWrite |
-| Delegated (personal Microsoft account) | Not Supported. |
-| Application | OnlineMeetings.ReadWrite.All* |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | OnlineMeetings.ReadWrite.All* |
To use application permission for this API, tenant administrators must create an [application access policy](/graph/cloud-communication-online-meeting-application-access-policy) and grant it to a user to authorize the app configured in the policy to delete online meetings on behalf of that user (with user ID specified in the request path). ## HTTP request
-To delete an onlineMeeting using meeting ID with delegated (`/me`) and app (`/users/{userId}`) permission:
+To delete an **onlineMeeting** using the meeting ID with delegated (`/me`) and app (`/users/{userId}`) permission:
<!-- { "blockType": "ignored" } --> ```http DELETE https://graph.microsoft.com/beta/me/onlineMeetings/{meetingId}
DELETE https://graph.microsoft.com/beta/users/{userId}/onlineMeetings/{meetingId
``` > [!NOTE]
-> - `userId` is the object ID of a user in [Azure user management portal](https://portal.azure.com/#blade/Microsoft_AAD_IAM/UsersManagementMenuBlade). For more details, see [application access policy](/graph/cloud-communication-online-meeting-application-access-policy).
+> - `userId` is the object ID of a user in [Azure user management portal](https://portal.azure.com/#blade/Microsoft_AAD_IAM/UsersManagementMenuBlade). For more details, see [Configure application access to online meetings](/graph/cloud-communication-online-meeting-application-access-policy).
> - `meetingId` is the **id** of an [onlineMeeting](../resources/onlinemeeting.md) object. ## Request headers
DELETE https://graph.microsoft.com/beta/me/onlineMeetings/550fae72-d251-43ec-868
### Response
+The following example shows the response.
+ <!-- { "blockType": "response", "truncated": true
v1.0 Organization Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/organization-get.md
Content-type: application/json
"country": null, "countryLetterCode": "NL", "createdDateTime": "2021-08-02T10:30:06Z",
+ "defaultUsageLocation": "String",
"displayName": "Contoso", "isMultipleDataLocationsForServicesEnabled": null, "marketingNotificationEmails": [],
v1.0 Organization List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/organization-list.md
Content-type: application/json
"country": null, "countryLetterCode": "NL", "createdDateTime": "2021-08-02T10:30:06Z",
+ "defaultUsageLocation": "String",
"displayName": "Contoso", "isMultipleDataLocationsForServicesEnabled": null, "marketingNotificationEmails": [],
v1.0 Planner Post Buckets https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/planner-post-buckets.md
Title: "Create plannerBucket"
-description: "Use this API to create a new **plannerBucket**."
+description: "Create a new plannerBucket object."
ms.localizationpriority: medium ms.prod: "planner"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Use this API to create a new **plannerBucket**.
+Create a new [plannerBucket](../resources/plannerbucket.md) object.
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http POST /planner/buckets- ``` ## Request headers | Name | Description|
POST /planner/buckets
| Authorization | Bearer {token}. Required. | ## Request body
-In the request body, supply a JSON representation of [plannerBucket](../resources/plannerbucket.md) object.
+In the request body, supply a JSON representation of the [plannerBucket](../resources/plannerbucket.md) object.
## Response
-If successful, this method returns `201 Created` response code and [plannerBucket](../resources/plannerbucket.md) object in the response body.
+If successful, this method returns `201 Created` response code and a [plannerBucket](../resources/plannerbucket.md) object in the response body.
This method can return any of the [HTTP status codes](/graph/errors). The most common errors that apps should handle for this method are the 400, 403 and 404 responses. For more information about these errors, see [Common Planner error conditions](../resources/planner-overview.md#common-planner-error-conditions). ## Example
-##### Request
-Here is an example of the request.
+### Request
+The following is an example of the request.
# [HTTP](#tab/http) <!-- {
Content-type: application/json
-In the request body, supply a JSON representation of [plannerBucket](../resources/plannerbucket.md) object.
-##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+### Response
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
v1.0 Plannerbucket List Tasks https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/plannerbucket-list-tasks.md
Title: "List tasks"
-description: "Retrieve a list of **plannerTask** objects associated to a plannerBucket object."
+description: "Retrieve a list of plannerTask objects associated to a plannerBucket object."
ms.localizationpriority: medium ms.prod: "planner"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve a list of **plannerTask** objects associated to a [plannerBucket](../resources/plannerbucket.md) object.
+Retrieve a list of [plannerTask](../resources/plannertask.md) objects associated to a [plannerBucket](../resources/plannerbucket.md) object.
+ ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
Do not supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and collection of [plannerTask](../resources/plannertask.md) objects in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [plannerTask](../resources/plannertask.md) objects in the response body.
This method can return any of the [HTTP status codes](/graph/errors). The most common errors that apps should handle for this method are the 403 and 404 responses. For more information about these errors, see [Common Planner error conditions](../resources/planner-overview.md#common-planner-error-conditions). ## Example
-##### Request
-Here is an example of the request.
+### Request
+The following is an example of the request.
# [HTTP](#tab/http) <!-- {
GET https://graph.microsoft.com/beta/planner/buckets/gcrYAaAkgU2EQUvpkNNXLGQAGTt
-##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+### Response
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
v1.0 Plannerplan List Tasks https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/plannerplan-list-tasks.md
GET https://graph.microsoft.com/beta/planner/plans/xqQg5FS2LkCp935s-FIFm2QAFkHM/
[!INCLUDE [sample-code](../includes/snippets/go/plannerplan-get-tasks-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
- # [PHP](#tab/php) [!INCLUDE [sample-code](../includes/snippets/php/plannerplan-get-tasks-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Plannerroster Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/plannerroster-delete.md
If successful, this method returns a `204 No Content` response code.
### Request
+The following is an example of a request.
+ # [HTTP](#tab/http) <!-- { "blockType": "request",
DELETE https://graph.microsoft.com/beta/planner/rosters/5ba84f7a-aa11-4a51-a298-
### Response+
+The following is an example of the response.
+ <!-- { "blockType": "response", "truncated": true
v1.0 Plannertask Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/plannertask-get.md
Title: "Get plannerTask"
-description: "Retrieve the properties and relationships of **plannertask** object."
+description: "Retrieve the properties and relationships of plannerTask object."
ms.localizationpriority: medium ms.prod: "planner"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve the properties and relationships of **plannertask** object.
+Retrieve the properties and relationships of [plannerTask](../resources/plannertask.md) object.
+ ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
Do not supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and [plannerTask](../resources/plannertask.md) object in the response body.
+If successful, this method returns a `200 OK` response code and a [plannerTask](../resources/plannertask.md) object in the response body.
This method can return any of the [HTTP status codes](/graph/errors). The most common errors that apps should handle for this method are the 403 and 404 responses. For more information about these errors, see [Common Planner error conditions](../resources/planner-overview.md#common-planner-error-conditions). ## Example
-##### Request
-Here is an example of the request.
+### Request
+The following is an example of the request.
# [HTTP](#tab/http) <!-- {
GET https://graph.microsoft.com/beta/planner/tasks/01gzSlKkIUSUl6DF_EilrmQAKDhh
-##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+### Response
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
v1.0 Plannertaskdetails Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/plannertaskdetails-update.md
Title: "Update plannertaskdetails"
-description: "Update the properties of **plannertaskdetails** object."
+ Title: "Update plannerTaskDetails"
+description: "Update the properties of a **plannerTaskDetails** object."
ms.localizationpriority: medium ms.prod: "planner"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Update the properties of **plannertaskdetails** object.
+Update the properties of **plannerTaskDetails** 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).
One of the following permissions is required to call this API. To learn more, in
```http PATCH /planner/tasks/{id}/details ```+ ## Optional request headers | Name | Description| |:--|:--|
PATCH /planner/tasks/{id}/details
| If-Match | Last known ETag value for the **plannerTaskDetails** to be updated. Required.| ## Request body
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed.
+ | Property | Type |Description| |:|:--|:-| |checklist|[plannerChecklistItems](../resources/plannerchecklistitems.md)|The collection of checklist items on the task.|
-|description|String|Description of the task|
+|description|String|The description of the task.|
|notes|[itemBody](../resources/itembody.md)|Rich text description of the task. To be used by HTML-aware clients. For backwards compatibility, a plain-text version of the HTML description will be synced to the "description" field. If this field has not previously been set but "description" has been, the existing description will be synchronized to "notes" with minimal whitespace-preserving HTML markup. Setting both "description" and "notes" is an error and will result in an exception.| |previewType|string|This sets the type of preview that shows up on the task. Possible values are: `automatic`, `noPreview`, `checklist`, `description`, `reference`. When set to `automatic` the displayed preview is chosen by the app viewing the task.| |references|[plannerExternalReferences](../resources/plannerexternalreferences.md)|The collection of references on the task.| ## Response
-If successful, this method returns `204 No Content` response and empty content. If the request specifies `Prefer` header with `return=representation` preference, then this method returns a `200 OK` response code and updated [plannerTaskDetails](../resources/plannertaskdetails.md) object in the response body.
+If successful, this method returns a `204 No Content` response code and empty content. If the request specifies the `Prefer` header with `return=representation` preference, then this method returns a `200 OK` response code and an updated [plannerTaskDetails](../resources/plannertaskdetails.md) object in the response body.
This method can return any of the [HTTP status codes](/graph/errors). The most common errors that apps should handle for this method are the 400, 403, 404, 409, and 412 responses. For more information about these errors, see [Common Planner error conditions](../resources/planner-overview.md#common-planner-error-conditions). ## Example
-##### Request
-Here is an example of the request.
+### Request
+The following is an example of the request.
# [HTTP](#tab/http) <!-- {
If-Match: W/"JzEtVGFzayAgQEBAQEBAQEBAQEBAQEBAWCc="
-##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+### Response
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
Content-type: application/json
} --> -
v1.0 Presence Setpresence https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/presence-setpresence.md
Similarly, an application can have its own presence session for a user and be ab
The following is the precedence for how session states are aggregated, with "A > B" representing A having precedence over B: * User-preferred state > session-level states (user-preferred state overrides session-level states)
-* Among session-level states: DoNotDisturb (currently not supported for **setPresence**) > Busy > Available > Away
+* Among session-level states: DoNotDisturb > Busy > Available > Away
### Timeout, expiration, and keep alive A presence session may **time out** and **expire**, so the application needs to call this API before the **timeout**, to maintain the state for the session; or before the **expiration**, to keep the session alive.
In the request body, provide a JSON object with the following parameters.
Supported combinations of `availability` and `activity` are:
-| availability | activity | Description |
-| :-- | :- | :- |
-| Available | Available | Updates the presence session as Available. |
-| Busy | InACall | Updates the presence session as Busy, InACall. |
-| Busy | InAConferenceCall | Updates the presence session as Busy, InAConferenceCall. |
-| Away | Away | Updates the presence session as Away. |
+| availability | activity | Description |
+| :-- | :- | :-- |
+| Available | Available | Updates the presence session as Available. |
+| Busy | InACall | Updates the presence session as Busy, InACall. |
+| Busy | InAConferenceCall | Updates the presence session as Busy, InAConferenceCall. |
+| Away | Away | Updates the presence session as Away. |
+| DoNotDisturb | Presenting | Updates the presence session as DoNotDisturb, Presenting. |
## Response If successful, this method returns a `200 OK` response code.
v1.0 Print List Recentshares https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/print-list-recentshares.md
If successful, this method returns a `200 OK` response code and a collection of
### Request The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_recentprintershares"
The following is an example of the request.
GET https://graph.microsoft.com/beta/me/print/recentPrinterShares ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
++++ ### Response The following is an example of the response. >**Note:** The response object shown here might be shortened for readability.
v1.0 Rbacapplication List Roleassignmentschedulerequests https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/rbacapplication-list-roleassignmentschedulerequests.md
One of the following permissions is required to call this API. To learn more, in
| :- | : | | Delegated (work or school account) | RoleAssignmentSchedule.Read.Directory, RoleManagement.Read.Directory, RoleManagement.Read.All, RoleAssignmentSchedule.ReadWrite.Directory, RoleManagement.ReadWrite.Directory | | Delegated (personal Microsoft account) | Not supported |
-| Application | RoleManagement.Read.Directory, RoleManagement.ReadWrite.Directory |
+| Application | RoleManagement.ReadWrite.Directory |
## HTTP request
v1.0 Rbacapplication List Roleeligibilityschedulerequests https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/rbacapplication-list-roleeligibilityschedulerequests.md
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account)|RoleEligibilitySchedule.Read.Directory, RoleManagement.Read.Directory, RoleManagement.Read.All, RoleEligibilitySchedule.ReadWrite.Directory, RoleManagement.ReadWrite.Directory | |Delegated (personal Microsoft account)|Not supported|
-|Application|RoleManagement.Read.Directory, RoleManagement.ReadWrite.Directory |
+|Application|RoleManagement.ReadWrite.Directory |
## HTTP request
v1.0 Rbacapplication Post Roleassignmentschedulerequests https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/rbacapplication-post-roleassignmentschedulerequests.md
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account)|RoleAssignmentSchedule.ReadWrite.Directory| |Delegated (personal Microsoft account)|Not supported|
-|Application|Not supported|
+|Application|RoleManagement.ReadWrite.Directory|
## HTTP request
v1.0 Rbacapplication Post Roledefinitions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/rbacapplication-post-roledefinitions.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Create a new [unifiedRoleDefinition](../resources/unifiedroledefinition.md) object for an RBAC provider.
+Create a new [unifiedRoleDefinition](../resources/unifiedroledefinition.md) object for an RBAC provider. This feature requires an Azure AD Premium P1 or P2 license.
The following RBAC providers are currently supported: - Cloud PC
v1.0 Rbacapplication Post Roleeligibilityschedulerequests https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/rbacapplication-post-roleeligibilityschedulerequests.md
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account)|RoleEligibilitySchedule.ReadWrite.Directory| |Delegated (personal Microsoft account)|Not supported|
-|Application|Not supported|
+|Application|RoleManagement.ReadWrite.Directory|
## HTTP request
v1.0 Search Bookmark Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/search-bookmark-update.md
PATCH /search/bookmarks/{bookmarksId}
|Content-Type|application/json. Required.| ## Request body
-In the request body, supply a JSON representation of the [bookmark](../resources/search-bookmark.md) object. Supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed.
++ >**Note:** Updates to collection properties will update the entire collection. Any updates to a collection, such as keywords or categories, will replace the collection entirely. |Property|Type|Description| |:|:|:|
-|displayName|String|Bookmark name displayed in search results. Inherited from [searchAnswer](../resources/search-searchAnswer.md).|
-|description|String|Bookmark description shown on search results page. Inherited from [searchAnswer](../resources/search-searchAnswer.md).|
-|webUrl|String|Bookmark URL link. When users click this bookmark in search results, they will go to this URL. Inherited from [searchAnswer](../resources/search-searchAnswer.md).|
-|categories|String collection|Categories commonly used to describe this bookmark. For example, IT and HR.|
-|availabilityStartDateTime|DateTimeOffset|Timestamp of when the bookmark will start to appear as a search result. Set as `null` for always available.|
|availabilityEndDateTime|DateTimeOffset|Timestamp of when the bookmark will stop to appear as a search result. Set as `null` for always available.|
+|availabilityStartDateTime|DateTimeOffset|Timestamp of when the bookmark will start to appear as a search result. Set as `null` for always available.|
+|categories|String collection|Categories commonly used to describe this bookmark. For example, IT and HR.|
+|description|String|Bookmark description shown on search results page. Inherited from [searchAnswer](../resources/search-searchAnswer.md).|
+|displayName|String|Bookmark name displayed in search results. Inherited from [searchAnswer](../resources/search-searchAnswer.md).|
+|groupIds|String collection|List of security groups able to view this bookmark.|
+|keywords|[microsoft.graph.search.answerKeyword](../resources/search-answerKeyword.md)|Keywords that trigger this bookmark to appear in search results.|
|languageTags|String collection|List of countries or regions able to view this bookmark.| |platforms|microsoft.graph.devicePlatformType collection|List of devices and operating systems able to view this bookmark. Possible values are: `unknown`, `android`, `androidForWork`, `ios`, `macOS`, `windowsPhone81`, `windowsPhone81AndLater`, `windows10AndLater`, `androidWorkProfile`, `androidASOP`.|
-|targetedVariations|[microsoft.graph.search.answerVariant](../resources/search-answerVariant.md) collection|Variations of a bookmark for different countries or devices. Use when you need to show different content to users based on their device, country/region, or both. The date and group settings will apply to all variations.|
|powerAppIds|String collection|List of Power Apps associated with this bookmark. If users add existing Power Apps to a bookmark, they can complete tasks, such as to enter vacation time or to report expenses on the search results page.|
-|keywords|[microsoft.graph.search.answerKeyword](../resources/search-answerKeyword.md)|Keywords that trigger this bookmark to appear in search results.|
|state|microsoft.graph.search.answerState|State of the bookmark. Possible values are: `published`, `draft`, `excluded`, or `unknownFutureValue`.|
-|groupIds|String collection|List of security groups able to view this bookmark.|
--
+|targetedVariations|[microsoft.graph.search.answerVariant](../resources/search-answerVariant.md) collection|Variations of a bookmark for different countries or devices. Use when you need to show different content to users based on their device, country/region, or both. The date and group settings will apply to all variations.|
+|webUrl|String|Bookmark URL link. When users click this bookmark in search results, they will go to this URL. Inherited from [searchAnswer](../resources/search-searchAnswer.md).|
## Response
If successful, this method returns a `204 No Content` response code.
### Request
+The following is an example of a request.
+ # [HTTP](#tab/http) <!-- { "blockType": "request",
Content-Type: application/json
{ "description": "Book a fancy vacation in Tuscany or browse museums in Florence." }- ``` # [C#](#tab/csharp)
Content-Type: application/json
### Response+
+The following is an example of the response.
+ <!-- { "blockType": "response", "truncated": true
v1.0 Security Alert Post Comments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-alert-post-comments.md
If successful, this method returns a `200 OK` response code and an updated list
### Request The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "sampleKeys": ["da637865765418431569_-773071023"],
Content-Type: application/json
} ```
+# [JavaScript](#tab/javascript)
++++ ### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
v1.0 Security Ediscoverycase Post Legalholds https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycase-post-legalholds.md
You can specify the following properties when you create an **ediscoveryHoldPoli
|:|:|:| |displayName|String|The display name of the legal hold policy. Required.| |description|String|The description of the legal hold policy. Optional.|
-|contentQuery|String|The content query of the legal hold policy. Optional.|
## Response
Content-Type: application/json
{ "displayname": "My legalHold with sources", "description": "Created from Graph API",
- "contentQuery": "Bazooka",
"userSources@odata.bind": [ { "@odata.type": "microsoft.graph.security.userSource",
Content-Type: application/json
"@odata.context": "https://graph.microsoft.com/beta/$metadata#security/cases/ediscoveryCases('b0073e4e-4184-41c6-9eb7-8c8cc3e2288b')/legalHolds/$entity", "isEnabled": true, "errors": [],
- "contentQuery": "Bazooka",
"description": "Created from Graph API", "createdDateTime": "2022-05-23T03:54:11.1Z", "lastModifiedDateTime": "2022-05-23T03:54:11.1Z",
v1.0 Security Ediscoveryholdpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoveryholdpolicy-update.md
PATCH /security/cases/ediscoveryCases/{ediscoveryCaseId}/legalHolds/{ediscoveryH
|Property|Type|Description| |:|:|:| |description|String|The description of the legal hold policy. Optional.|
-|contentQuery|String|The content query of the legal hold policy. Optional.|
## Response
PATCH https://graph.microsoft.com/beta/security/cases/ediscoveryCases/b0073e4e-4
{ "description": "updated description",
- "contentQuery": "bazooka bazooka"
} ```
v1.0 Security Ediscoveryreviewset List Queries https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoveryreviewset-list-queries.md
GET https://graph.microsoft.com/beta/security/cases/ediscoveryCases/58399dff-ceb
[!INCLUDE [sample-code](../includes/snippets/go/list-ediscoveryreviewsetquery-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [PowerShell](#tab/powershell)
- # [PHP](#tab/php) [!INCLUDE [sample-code](../includes/snippets/php/list-ediscoveryreviewsetquery-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Security Ediscoverysearch Purgedata https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverysearch-purgedata.md
POST /security/cases/ediscoveryCases/{ediscoveryCaseId}/searches/{ediscoverySear
|Authorization|Bearer {token}. Required.| ## Request body
-Do not supply a request body for this method.
+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|
+|:|:|:|
+|purgeType|microsoft.graph.security.purgeType| Options that control whether the action is soft delete or hard delete. Possible values are `recoverable`, `permanentlydeleted`, `unknownFutureValue`. |
+|purgeAreas|microsoft.graph.security.purgeAreas| Options to define the locations to be in scope of the purge action. Possible values are: `mailboxes`, `teamsMessages`, `unknownFutureValue`. |
+ ## Response
v1.0 Security Incident Post Comments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-incident-post-comments.md
If successful, this method returns a `200 OK` response code and an updated list
### Request The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "sampleKeys": ["3962396"],
Content-Type: application/json
} ```
+# [JavaScript](#tab/javascript)
++++ ### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
v1.0 Security Retentionevent Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-retentionevent-delete.md
Title: "Delete retentionEvent"
description: "Deletes a retentionEvent object." ms.localizationpriority: medium doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account)|RecordsManagement.ReadWrite.All| |Delegated (personal Microsoft account)|Not supported.|
-|Application|RecordsManagement.ReadWrite.All|
+|Application|Not supported.|
## HTTP request
v1.0 Security Retentionevent Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-retentionevent-get.md
Title: "Get retentionEvent"
description: "Read the properties and relationships of a retentionEvent object." ms.localizationpriority: medium doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account)|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| |Delegated (personal Microsoft account)|Not Supported.|
-|Application|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All|
+|Application|Not Supported.|
## HTTP request
v1.0 Security Retentionevent List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-retentionevent-list.md
Title: "List retentionEvents"
description: "Get a list of the retentionEvent objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account)|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| |Delegated (personal Microsoft account)|Not Supported.|
-|Application|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All|
+|Application|Not Supported.|
## HTTP request
v1.0 Security Retentionevent Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-retentionevent-post.md
Title: "Create retentionEvent"
description: "Create a new retentionEvent object." ms.localizationpriority: medium doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account)|RecordsManagement.ReadWrite.All| |Delegated (personal Microsoft account)|Not supported.|
-|Application|RecordsManagement.ReadWrite.All|
+|Application|Not supported.|
## HTTP request
v1.0 Security Retentioneventtype Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-retentioneventtype-delete.md
Title: "Delete retentionEventType"
description: "Deletes a retentionEventType object." ms.localizationpriority: medium doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account)|RecordsManagement.ReadWrite.All| |Delegated (personal Microsoft account)|Not supported.|
-|Application|RecordsManagement.ReadWrite.All|
+|Application|Not supported.|
## HTTP request
v1.0 Security Retentioneventtype Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-retentioneventtype-get.md
Title: "Get retentionEventType"
description: "Read the properties and relationships of a retentionEventType object." ms.localizationpriority: medium doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account)|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| |Delegated (personal Microsoft account)|Not Supported.|
-|Application|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All|
+|Application|Not supported.|
## HTTP request
v1.0 Security Retentioneventtype List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-retentioneventtype-list.md
Title: "List retentionEventTypes"
description: "Get a list of the retentionEventType objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account)|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| |Delegated (personal Microsoft account)|Not Supported.|
-|Application|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All|
+|Application|Not supported.|
## HTTP request
v1.0 Security Retentioneventtype Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-retentioneventtype-post.md
Title: "Create retentionEventType"
description: "Create a new retentionEventType object." ms.localizationpriority: medium doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account)|RecordsManagement.ReadWrite.All| |Delegated (personal Microsoft account)|Not supported.|
-|Application|RecordsManagement.ReadWrite.All|
+|Application|Not supported.|
## HTTP request
v1.0 Security Retentioneventtype Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-retentioneventtype-update.md
Title: "Update retentionEventType"
description: "Update the properties of a retentionEventType object." ms.localizationpriority: medium doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account)|RecordsManagement.ReadWrite.All| |Delegated (personal Microsoft account)|Not supported.|
-|Application|RecordsManagement.ReadWrite.All|
+|Application|Not supported.|
## HTTP request
v1.0 Security Retentionlabel Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-retentionlabel-delete.md
Title: "Delete retentionLabel"
description: "Deletes a retentionLabel object." ms.localizationpriority: medium doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account)|RecordsManagement.ReadWrite.All| |Delegated (personal Microsoft account)|Not supported.|
-|Application|RecordsManagement.ReadWrite.All|
+|Application|Not supported.|
## HTTP request
v1.0 Security Retentionlabel Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-retentionlabel-get.md
Title: "Get retentionLabel"
description: "Read the properties and relationships of a retentionLabel object." ms.localizationpriority: medium doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account)|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| |Delegated (personal Microsoft account)|Not Supported.|
-|Application|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All|
+|Application|Not supported.|
## HTTP request
v1.0 Security Retentionlabel List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-retentionlabel-list.md
Title: "List retentionLabels"
description: "Get a list of the retentionLabel objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account)|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All| |Delegated (personal Microsoft account)|Not Supported.|
-|Application|RecordsManagement.Read.All, RecordsManagement.ReadWrite.All|
+|Application|Not supported.|
## HTTP request
v1.0 Security Retentionlabel Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-retentionlabel-post.md
Title: "Create retentionLabel"
description: "Create a new retentionLabel object." ms.localizationpriority: medium doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account)|RecordsManagement.ReadWrite.All| |Delegated (personal Microsoft account)|Not supported.|
-|Application|RecordsManagement.ReadWrite.All|
+|Application|Not supported.|
## HTTP request
v1.0 Security Retentionlabel Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-retentionlabel-update.md
Title: "Update retentionLabel"
description: "Update the properties of a retentionLabel object." ms.localizationpriority: medium doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account)|RecordsManagement.ReadWrite.All| |Delegated (personal Microsoft account)|Not supported.|
-|Application|RecordsManagement.ReadWrite.All|
+|Application|Not supported.|
## HTTP request
v1.0 Security Security Runhuntingquery https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-security-runhuntingquery.md
This example specifies a KQL query which does the following:
- Sorts the output by the `Timestamp` value. - Limits the output to 2 records (2 rows). +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "security_runhuntingquery"
This example specifies a KQL query which does the following:
POST https://graph.microsoft.com/beta/security/runHuntingQuery {
- "query":"DeviceProcessEvents | where InitiatingProcessFileName =~ \"powershell.exe\" | project Timestamp, FileName, InitiatingProcessFileName | order by Timestamp desc | limit 2"
+ "query": "DeviceProcessEvents | where InitiatingProcessFileName =~ \"powershell.exe\" | project Timestamp, FileName, InitiatingProcessFileName | order by Timestamp desc | limit 2"
} ```