Updates from: 11/02/2022 02:22:08
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Accesspackage Movetocatalog https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackage-movetocatalog.md
+
+ Title: "accessPackage: moveToCatalog"
+description: "Allows callers to move an access package from one catalog to the another."
+
+ms.localizationpriority: medium
++
+# accessPackage: moveToCatalog
+Namespace: microsoft.graph
++
+In [Azure AD entitlement management](../resources/entitlementmanagement-overview.md), this action moves the [accessPackage](../resources/accesspackage.md) to a specified target [accessPackageCatalog](../resources/accesspackagecatalog.md). The resources in the access package must be present in the target catalog.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)| EntitlementManagement.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|EntitlementManagement.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /identityGovernance/entitlementManagement/accessPackages/{accessPackageId}/moveToCatalog
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply a JSON representation of the parameters.
+
+The following table shows the parameters that can be used with this action.
+
+|Parameter|Type|Description|
+|:|:|:|
+|catalogId|String|ID of the catalog to which the access package will be moved.|
+++
+## Response
+
+If successful, this action returns a `200 OK` response code.
+
+## Examples
+
+### Request
+The following is an example of a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "accesspackagethis.movetocatalog"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackages/3089f957-4bfe-405d-96c0-9a7ef30c01d6/moveToCatalog
+Content-Type: application/json
+
+{
+ "catalogId": "3301434b-99bd-46be-923b-d762c30c8e8b"
+}
+```
+
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
+++++
+### Response
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 200 OK
+```
+
v1.0 Accesspackage Post Incompatiblegroup https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackage-post-incompatiblegroup.md
If successful, this method returns a `204 No Content` response code. It does not
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "add_incompatiblegroup_to_accesspackage"
Content-type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response.
v1.0 Accessreviewset Post Historydefinitions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewset-post-historydefinitions.md
The following table shows the required properties used to create an [accessRevie
|reviewHistoryPeriodStartDateTime | DateTimeOffset | A timestamp. Reviews starting on or after this date will be included in the fetched history data. Only required if **scheduleSettings** is not defined. | |reviewHistoryPeriodEndDateTime | DateTimeOffset | A timestamp. Reviews starting on or before this date will be included in the fetched history data. Only required if **scheduleSettings** is not defined. | |scopes|[accessReviewQueryScope](../resources/accessreviewqueryscope.md) collection| Used to filter which reviews are included in the fetched history data. Fetches reviews whose scope matches with this provided scope. Required. <br> For more, see [Supported scope queries for accessReviewHistoryDefinition](#supported-scope-queries-for-accessreviewhistorydefinition). |
-| scheduleSettings |[accessReviewHistoryScheduleSettings](../resources/accessReviewHistoryScheduleSettings.md)| The settings for a recurring access review history definition series. Only required if **reviewHistoryPeriodStartDateTime** or **reviewHistoryPeriodEndDateTime** are not defined. Not supported yet.|
+| scheduleSettings |[accessReviewHistoryScheduleSettings](../resources/accessReviewHistoryScheduleSettings.md)| **Not supported yet.** The settings for a recurring access review history definition series. Only required if **reviewHistoryPeriodStartDateTime** or **reviewHistoryPeriodEndDateTime** are not defined. |
### Supported scope queries for accessReviewHistoryDefinition
Content-Type: application/json
"notReviewed", "notNotified" ],
- "scheduleSettings": {
- "reportRange": "P1M",
- "recurrence": {
- "pattern": {
- "type": "monthly",
- "interval": 1
- },
- "range": {
- "type": "noEnd",
- "startDate": "2018-08-03T21:02:30.667Z",
- "count": 0
- }
- }
- },
+ "reviewHistoryPeriodStartDateTime": "2021-01-01T00:00:00Z",
+ "reviewHistoryPeriodEndDateTime": "2021-04-30T23:59:59Z",
"scopes": [ { "@odata.type": "#microsoft.graph.accessReviewQueryScope",
Content-Type: application/json
} ```
+# [C#](#tab/csharp)
+ # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/create-accessreviewhistorydefinition-from--javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/powershell/create-accessreviewhistorydefinition-from--powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PHP](#tab/php)
+ ### Response
Content-Type: application/json
"@odata.type": "#microsoft.graph.accessReviewHistoryDefinition", "id": "b2cb022f-b7e1-40f3-9854-c65a40861c38", "displayName": "Last quarter's group reviews April 2021",
- "scheduleSettings": {
- "reportRange": "P1M",
- "recurrence": {
- "pattern": {
- "type": "monthly",
- "interval": 1
- },
- "range": {
- "type": "noEnd",
- "startDate": "2018-08-03T21:02:30.667Z",
- "count": 0
- }
- }
- },
+ "reviewHistoryPeriodStartDateTime": "2021-01-01T00:00:00Z",
+ "reviewHistoryPeriodEndDateTime": "2021-04-30T23:59:59Z",
"decisions": [ "approve", "deny",
v1.0 Administrativeunit Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/administrativeunit-delta.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) | AdministrativeUnit.Read.All, Directory.Read.All, AdministrativeUnit.ReadWrite.All, Directory.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |
-|administrativeunit | AdministrativeUnit.Read.All, Directory.Read.All, AdministrativeUnit.ReadWrite.All, Directory.ReadWrite.All |
+|Application | AdministrativeUnit.Read.All, Directory.Read.All, AdministrativeUnit.ReadWrite.All, Directory.ReadWrite.All |
## HTTP request
GET /administrativeUnits/delta
## Query parameters
-Tracking changes incurs a round of one or more **delta** function calls. If you use any query parameter
-(other than `$deltatoken` and `$skiptoken`), you must specify
-it in the initial **delta** request. Microsoft Graph automatically encodes any specified parameters
-into the token portion of the `@odata.nextLink` or `@odata.deltaLink` URL provided in the response.
-You only need to specify any query parameters once up front.
-In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL from the previous response. That URL already
+Tracking changes incurs a round of one or more **delta** function calls. If you use any query parameter
+(other than `$deltatoken` and `$skiptoken`), you must specify
+it in the initial **delta** request. Microsoft Graph automatically encodes any specified parameters
+into the token portion of the `@odata.nextLink` or `@odata.deltaLink` URL provided in the response.
+You only need to specify any query parameters once up front.
+In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL from the previous response. That URL already
includes the encoded parameters. | Query parameter | Type |Description|
includes the encoded parameters.
This method supports the following OData query parameters to help customize the response: -- You can use a `$select` query parameter as in any GET request to specify only the properties your need for best performance. The
-**id** property is always returned.
+- You can use a `$select` query parameter as in any GET request to specify only the properties your need for best performance. The
+**id** property is always returned.
- There is limited support for `$filter`: * The only supported `$filter` expression is for tracking changes for specific resources, by their ID: `$filter=id+eq+{value}` or `$filter=id+eq+{value1}+or+id+eq+{value2}`. The number of IDs you can specify is limited by the maximum URL length.
Do not supply a request body for this method.
## Response
-If successful, this method returns `200 OK` response code and an [administrativeUnit](../resources/administrativeunit.md) collection object in the response body. The response also includes a `@odata.nextLink` URL or a `@odata.deltaLink` URL.
+If successful, this method returns `200 OK` response code and an [administrativeUnit](../resources/administrativeunit.md) collection object in the response body. The response also includes a `@odata.nextLink` URL or a `@odata.deltaLink` URL.
- If a `@odata.nextLink` URL is returned, there are additional pages of data to be retrieved in the session. The **administrativeUnit** continues making requests using the `@odata.nextLink` URL until a `@odata.deltaLink` URL is included in the response.
GET https://graph.microsoft.com/beta/administrativeUnits/delta
### Response >**Note:** The response object shown here might be shortened for readability.
-<!-- {
+<!-- {
"blockType": "response", "truncated": true, "@odata.type": "microsoft.graph.administrativeUnit",
- "isCollection": true
-} -->
+ "isCollection": true
+} -->
```http HTTP/1.1 200 OK Content-type: application/json
v1.0 Authenticationcombinationconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationcombinationconfiguration-get.md
If successful, this method returns a `200 OK` response code and an [authenticati
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_authenticationcombinationconfiguration"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identity/conditionalAccess/authenticationStrengths/policies/0e371351-6419-4c8a-8047-61eef0212ffb/combinationConfigurations/133b68c4-503b-4e87-839a-6c286a27381b ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationcombinationconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationcombinationconfiguration-update.md
If successful, this method returns a `204 NO CONTENT` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_authenticationcombinationconfiguration"
Content-length: 130
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationmethodmodedetail Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationmethodmodedetail-get.md
If successful, this method returns a `200 OK` response code and an [authenticati
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_authenticationmethodmodedetail"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identity/conditionalAccess/authenticationStrengths/authenticationMethodModes/windowsHelloForBusiness ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthpolicy Delete Combinationconfigurations https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-delete-combinationconfigurations.md
If successful, this method returns a `204 No Content` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_authenticationcombinationconfiguration"
The following is an example of a request.
DELETE https://graph.microsoft.com/beta/identity/conditionalAccess/authenticationStrengths/policies/0e371351-6419-4c8a-8047-61eef0212ffb/combinationConfigurations/6cbbcfd0-5054-4a59-a10e-2d21fe09305d ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthpolicy Findbymethodmode https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-findbymethodmode.md
If successful, this function returns a `200 OK` response code and a [authenticat
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "authenticationstrengthpolicythis.findbymethodmode"
The following is an example of a request.
GET https://graph.microsoft.com/beta/policies/authenticationStrengthPolicies/findByMethodMode(authenticationMethodModes=["sms"]) ```
+# [JavaScript](#tab/javascript)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
v1.0 Authenticationstrengthpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-get.md
If successful, this method returns a `200 OK` response code and an [authenticati
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_authenticationstrengthpolicy"
The following is an example of a request.
GET https://graph.microsoft.com/beta/policies/authenticationStrengthPolicies/00000000-0000-0000-0000-000000000004 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthpolicy List Combinationconfigurations https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-list-combinationconfigurations.md
If successful, this method returns a `200 OK` response code and a collection of
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_authenticationcombinationconfiguration"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identity/conditionalAccess/authenticationStrengths/policies/0e371351-6419-4c8a-8047-61eef0212ffb/combinationConfigurations ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthpolicy Post Combinationconfigurations https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-post-combinationconfigurations.md
If successful, this method returns a `201 Created` response code and a [fido2Com
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_authenticationcombinationconfiguration_from_"
Content-length: 130
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-update.md
If successful, this method returns a `204 NO CONTENT` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_authenticationstrengthpolicy"
Content-length: 239
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthpolicy Updateallowedcombinations https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-updateallowedcombinations.md
If successful, this action returns a `200 OK` response code and a [updateAllowed
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "authenticationstrengthpolicythis.updateallowedcombinations"
Content-length: 51
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthpolicy Usage https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthpolicy-usage.md
If successful, this function returns a `200 OK` response code and an [authentica
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "authenticationstrengthpolicythis.usage"
The following is an example of a request.
GET https://graph.microsoft.com/beta/policies/authenticationStrengthPolicies/{authenticationStrengthPolicyId}/usage ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthroot Delete Policies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthroot-delete-policies.md
If successful, this method returns a `204 No Content` response code.
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_authenticationstrengthpolicy"
The following is an example of a request.
DELETE https://graph.microsoft.com/beta/policies/authenticationStrengthPolicies/6e7d7469-07c5-4bb2-a801-5eaef8fb7c1e/$ref ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthroot List Authenticationmethodmodes https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthroot-list-authenticationmethodmodes.md
If successful, this method returns a `200 OK` response code and a collection of
#### Request The following is an example of a request to retrieve the collection of **authenticationMethodModes** objects and their descriptions. .+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_authenticationmethodmodedetail"
The following is an example of a request to retrieve the collection of **authent
GET https://graph.microsoft.com/beta/identity/conditionalAccess/authenticationStrengths/authenticationMethodModes ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
Content-Type: application/json
#### Request The following is an example of a request to retrieve the flat collection of authenticationCombinations objects, representing all the possible allowed combinations (allowedCombinations) that may be used in an authenticationStrengthPolicy object. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_authenticationcombinations"
The following is an example of a request to retrieve the flat collection of auth
GET https://graph.microsoft.com/beta/identity/conditionalAccess/authenticationStrengths/authenticationCombinations ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
Content-Type: application/json
"Error: list_authenticationcombinations: Unable to locate a definition for resource type: microsoft.graph.authenticationMethodModes" ]
-} -->
+} -->
v1.0 Authenticationstrengthroot List Policies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthroot-list-policies.md
If successful, this method returns a `200 OK` response code and a collection of
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_authenticationstrengthpolicy"
The following is an example of a request.
GET https://graph.microsoft.com/beta/policies/authenticationStrengthPolicies ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Authenticationstrengthroot Post Policies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationstrengthroot-post-policies.md
If successful, this method returns a `201 Created` response code and an [authent
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_authenticationstrengthpolicy_from_"
Content-length: 239
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Bookingbusiness Getstaffavailability https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingbusiness-getstaffavailability.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
+
v1.0 Channel Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-get.md
GET https://graph.microsoft.com/beta/teams/893075dd-2487-4122-925f-022c42e20265/
[!INCLUDE [sample-code](../includes/snippets/go/get-channel-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [PHP](#tab/php) [!INCLUDE [sample-code](../includes/snippets/php/get-channel-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Channel List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-list.md
GET https://graph.microsoft.com/beta/teams/893075dd-2487-4122-925f-022c42e20265/
[!INCLUDE [sample-code](../includes/snippets/go/list-channels-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [PHP](#tab/php) [!INCLUDE [sample-code](../includes/snippets/php/list-channels-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
GET https://graph.microsoft.com/beta/teams/64c323f2-226a-4e64-8ba4-3e6e3f7b9330/
[!INCLUDE [sample-code](../includes/snippets/go/list-private-channels-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [PHP](#tab/php) [!INCLUDE [sample-code](../includes/snippets/php/list-private-channels-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
GET https://graph.microsoft.com/beta/teams/6a720ba5-7373-463b-bc9f-4cd04b5c6742/
[!INCLUDE [sample-code](../includes/snippets/go/list-shared-channels-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [PHP](#tab/php) [!INCLUDE [sample-code](../includes/snippets/php/list-shared-channels-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Chat Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-get.md
Content-type: application/json
#### Request The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_meeting_chat", "sampleKeys": ["19:meeting_ZDZlYTYxOWUtYzdlMi00ZmMxLWIxMTAtN2YzODZlZjAxYzI4@thread.v2"] }-->
-```http
+```msgraph-interactive
GET https://graph.microsoft.com/beta/chats/19:ebe3857aa388434bab0cad9d2e09f4de@thread.v2?$expand=lastMessagePreview ```+
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
+++
Content-type: application/json
} } }
-```
+```
v1.0 Chat Hideforuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-hideforuser.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/javascript/chat-hideforuser-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Java](#tab/java)
- # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/chat-hideforuser-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Chat List Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-list-messages.md
The following is an example of a request that lists the top two messages (`$top=
The following example shows the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_chat_messages_2",
The following example shows the request.
GET https://graph.microsoft.com/beta/chats/19:2da4c29f6d7041eca70b638b43d45437@thread.v2/messages?$top=2&$orderBy=lastModifiedDateTime desc&$filter=lastModifiedDateTime ge 2022-09-22T00:00:00.000Z and lastModifiedDateTime le 2022-09-24T00:00:00.000Z ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following example shows the response.
v1.0 Chat Markchatreadforuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-markchatreadforuser.md
Content-length: 106
[!INCLUDE [sample-code](../includes/snippets/javascript/chat-markchatreadforuser-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Java](#tab/java)
- # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/chat-markchatreadforuser-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Chat Markchatunreadforuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-markchatunreadforuser.md
Content-length: 158
[!INCLUDE [sample-code](../includes/snippets/javascript/chat-markchatunreadforuser-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Java](#tab/java)
- # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/chat-markchatunreadforuser-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Chat Unhideforuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-unhideforuser.md
Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/javascript/chat-unhideforuser-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-# [Java](#tab/java)
- # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/chat-unhideforuser-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Chatmessage Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-post.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | ChannelMessage.Send, Group.ReadWrite.All** | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Teamwork.Migrate.All, ChannelMessage.ReadWrite.All |
+| Application | Teamwork.Migrate.All |
> **Note**: Permissions marked with ** are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward.
Content-type: application/json
#### Request The following is an example of the request.
-> **Note:** The attachment's ID must be unique and can be a new randomly generated GUID. However, the attachment's ID must be the same in the _body_ and _attachments_ elements.
+> **Note:** The attachment ID must be unique and can be a new randomly generated GUID. However, the attachment ID must be the same in the _body_ and _attachments_ elements.
# [HTTP](#tab/http)
Content-type: application/json
#### Request The following is an example of the request.
-> **Note:** The **temporaryId** in the **hostedContents** collection is a random ID, but must be same across the **body** and **hostedContents** elements. (Notice the **temporaryId** set to **1** and the reference in body as `../hostedContents/1/$value`.)
+> **Note:** The **temporaryId** in the **hostedContents** collection is a random ID, but must be same across the **body** and **hostedContents** elements. (Notice the **temporaryId** set to `1` and the reference in body as `../hostedContents/1/$value`.).
-**contentBytes** must be set to binary string Base64-encoded bytes. You can do this in C# by using `Convert.ToBase64String(File.ReadAllBytes("image.png"));`
+**contentBytes** must be set to binary string Base64-encoded bytes. You can do this in C# by using `Convert.ToBase64String(File.ReadAllBytes("image.png"));`.
# [HTTP](#tab/http)
Content-type: application/json
#### Request The following is an example of the request.
-> **Note:** The **temporaryId** in the **hostedContents** collection is a random ID, but must be same across the **content** (in **attachments**) and **hostedContents** elements. (Notice the **temporaryId** set to **1** and the reference in content as `../hostedContents/1/$value`.)
+> **Note:** The **temporaryId** in the **hostedContents** collection is a random ID, but must be same across the **content** (in **attachments**) and **hostedContents** elements. (Notice the **temporaryId** set to `1` and the reference in content as `../hostedContents/1/$value`.).
-**contentBytes** must be set to binary string Base64-encoded bytes. You can do this in C# by using `Convert.ToBase64String(File.ReadAllBytes("image.png"));`
+**contentBytes** must be set to binary string Base64-encoded bytes. You can do this in C# by using `Convert.ToBase64String(File.ReadAllBytes("image.png"));`.
# [HTTP](#tab/http)
Content-type: application/json
#### Response
+The following is an example of the response.
+ <!-- { "blockType": "response", "truncated": true,
Content-type: application/json
} ```
-### Example 8 : @mention a team in a channel message
+### Example 8: @mention a team in a channel message
#### Request The following is an example of the request.
v1.0 Chatmessage Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-update.md
ms.prod: "microsoft-teams"
Update a [chatMessage](../resources/chatMessage.md) object.
-With the exception of the **policyViolation** property, all properties of a **chatMessage** can be updated in delegated permissions scenarios.
+All properties of a **chatMessage** can be updated in delegated permissions scenarios,
+except for read-only properties and the **policyViolation** property.
Only the **policyViolation** property of a **chatMessage** can be updated in application permissions scenarios. The update only works for chats where members are Microsoft Teams users. If one of the participants is using Skype, the operation will fail.
v1.0 Cloudpccrosscloudgovernmentorganizationmapping Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpccrosscloudgovernmentorganizationmapping-get.md
If successful, this method returns a `200 OK` response code and a [cloudPcCrossC
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_cloudpccrosscloudgovernmentorganizationmapping"
GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/crossCloud
X-MS-CloudPC-USGovCloudTenantAADToken: {token} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response <!-- {
v1.0 Cloudpcexportjob Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcexportjob-get.md
If successful, this method returns a `200 OK` response code and a [cloudPcExport
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_cloudpcexportjob"
The following is an example of a request.
GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/reports/exportJobs/TotalAggregatedRemoteConnectionReports__d39979c9-a0a2-4916-a158-1b984742ffff ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Cloudpcreports Getdailyaggregatedremoteconnectionreports https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcreports-getdailyaggregatedremoteconnectionreports.md
If successful, this action returns a `200 OK` response code and a Stream in the
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "cloudpcreportsthis.getdailyaggregatedremoteconnectionreports"
Content-length: 199
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Cloudpcreports Getrealtimeremoteconnectionlatency https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcreports-getrealtimeremoteconnectionlatency.md
If successful, this function returns a `200 OK` response code and a Stream in th
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "cloudpcreportsthis.getrealtimeremoteconnectionlatency"
The following is an example of a request.
GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/reports/getRealTimeRemoteConnectionLatency(cloudPcId='f5ff445f-7488-40f8-8ab9-ee784a9fffff') ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
++++ ### Response The following is an example of the response
v1.0 Cloudpcreports Getrealtimeremoteconnectionstatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcreports-getrealtimeremoteconnectionstatus.md
If successful, this function returns a `200 OK` response code and a Stream in th
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "cloudpcreportsthis.getrealtimeremoteconnectionstatus"
The following is an example of a request.
GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/reports/getRealTimeRemoteConnectionStatus(cloudPcId='f5ff445f-7488-40f8-8ab9-ee784a9fffff') ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
++++ ### Response The following is an example of the response
v1.0 Cloudpcreports Getremoteconnectionhistoricalreports https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcreports-getremoteconnectionhistoricalreports.md
If successful, this action returns a `200 OK` response code and a Stream in the
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "cloudpcreportsthis.getremoteconnectionhistoricalreports"
Content-length: 199
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Cloudpcreports Gettotalaggregatedremoteconnectionreports https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcreports-gettotalaggregatedremoteconnectionreports.md
If successful, this action returns a `200 OK` response code and a Stream in the
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "cloudpcreportsthis.gettotalaggregatedremoteconnectionreports"
Content-length: 199
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Cloudpcreports Post Exportjobs https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcreports-post-exportjobs.md
If successful, this method returns a `201 Created` response code and a [cloudPcE
### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_cloudpcexportjob_from_"
Content-length: 315
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response
v1.0 Conditionalaccessroot List Templates https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/conditionalaccessroot-list-templates.md
If successful, this method returns a `200 OK` response code and a collection of
#### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_conditionalaccesstemplate"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identity/conditionalAccess/templates ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
Content-Type: application/json
#### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_conditionalaccesstemplate_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identity/conditionalAccess/templates?$select=name,description,id,scenarios&$filter=scenarios has 'secureFoundation' ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
Content-Type: application/json
} ] }
-```
+```
v1.0 Conditionalaccesstemplate Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/conditionalaccesstemplate-get.md
If successful, this method returns a `200 OK` response code and a [conditionalAc
#### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_conditionalaccesstemplate"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identity/conditionalAccess/templates/c7503427-338e-4c5e-902d-abe252abfb43 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
Content-Type: application/json
#### Request The following is an example of a request.+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_conditionalaccesstemplate_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identity/conditionalAccess/templates/c7503427-338e-4c5e-902d-abe252abfb43?$select=details ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
Content-Type: application/json
} } }
-```
+```
v1.0 Devicemanagement Alertrecord Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrecord-get.md
If successful, this method returns a `200 OK` response code and an [microsoft.gr
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_alertrecord"
The following is an example of a request.
GET https://graph.microsoft.com/beta/deviceManagement/monitoring/alertRecords/6c46a7ba-e78a-45e5-a81c-179ab8fd3e8e ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response.
v1.0 Devicemanagement Alertrecord Getportalnotifications https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrecord-getportalnotifications.md
If successful, this function returns a `200 OK` response code and a collection o
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "alertrecordthis.getportalnotifications"
The following is an example of a request.
GET https://graph.microsoft.com/beta/deviceManagement/monitoring/alertRecords/getPortalNotifications ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response.
v1.0 Devicemanagement Alertrecord List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrecord-list.md
If successful, this method returns a `200 OK` response code and a collection of
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_alertrecord"
The following is an example of a request.
GET https://graph.microsoft.com/beta/deviceManagement/monitoring/alertRecords ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response.
v1.0 Devicemanagement Alertrecord Setportalnotificationassent https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrecord-setportalnotificationassent.md
If successful, this action returns a `204 No Content` response code.
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "alertrecordthis.setportalnotificationassent"
The following is an example of a request.
POST https://graph.microsoft.com/beta/deviceManagement/monitoring/alertRecords/6c46a7ba-e78a-45e5-a81c-179ab8fd3e8e/setPortalNotificationAsSent ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response.
v1.0 Devicemanagement Alertrule Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrule-get.md
If successful, this method returns a `200 OK` response code and an [microsoft.gr
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_alertrule"
The following is an example of a request.
GET https://graph.microsoft.com/beta/deviceManagement/monitoring/alertRules/30070507-6514-443b-8fa5-06979cedacdf ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response.
v1.0 Devicemanagement Alertrule List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrule-list.md
If successful, this method returns a `200 OK` response code and a collection of
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_alertrule"
The following is an example of a request.
GET https://graph.microsoft.com/beta/deviceManagement/monitoring/alertRules ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response.
v1.0 Devicemanagement Alertrule Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrule-post.md
If successful, this method returns a `201 Created` response code and an [microso
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "post_alertrule"
Content-Type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response.
v1.0 Devicemanagement Alertrule Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrule-update.md
If successful, this method returns a `200 OK` response code and an updated [micr
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_alertrule"
Content-Type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PHP](#tab/php)
++++ ### Response The following is an example of the response.
v1.0 Ediscovery Legalhold Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/ediscovery-legalhold-update.md
In the request body, supply the values for relevant fields that should be update
|Property|Type|Description| |:|:|:|
-|contentQuery|String|KQL query that specifies content to be held in the specified locations. For more information about KQL in eDiscovery, see [Keyword queries and search conditions for Content Search and eDiscovery](/microsoft-365/compliance/keyword-queries-and-search-conditions). To hold all content in the specified locations, leave **contentQuery** blank. |
|description|String| The legal hold description. | |displayName|String| The display name of the legal hold. | |isEnabled|Boolean|Indicates whether the hold is enabled and actively holding content. |
v1.0 Educationassignment List Submissions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignment-list-submissions.md
The following is an example of the request.
# [HTTP](#tab/http) <!-- { "blockType": "request",
- "sampleKeys": ["f4a941ff-9da6-4707-ba5b-0eae93cad0b4","3c77de7f-539b-49e1-9c96-1274f2f0ee3b"],
+ "sampleKeys": ["2003c52e-807a-4186-9b49-60c573095461","2be08d97-b140-4eec-8cbd-88238d571060"],
"name": "get_submissions" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/education/classes/f4a941ff-9da6-4707-ba5b-0eae93cad0b4/assignments/3c77de7f-539b-49e1-9c96-1274f2f0ee3b/submissions
+GET https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions
``` # [C#](#tab/csharp)
Content-type: application/json
Content-length: 873 {
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions",
"value": [ {
- "status": "working",
+ "status": "returned",
"submittedDateTime": null, "unsubmittedDateTime": null,
- "returnedDateTime": null,
- "resourcesFolderUrl": "https://graph.microsoft.com/beta/drives/b!DPA6q59Tw0mtgmyXRUmrQRqBZTesG-lMkl1cBmvvMeUEWrOk89nKRpUEr4ZhNYBc/items/016XPCQEDJCE5LX4OXABF37QSORAK5WKQD",
- "id": "4af73d2b-6b9c-493f-0688-979087bed39b",
+ "returnedDateTime": "2022-04-13T05:11:50.756165Z",
+ "reassignedDateTime": null,
+ "resourcesFolderUrl": null,
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226"
+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a",
"displayName": null } },
Content-length: 873
} }, "returnedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ },
+ "reassignedBy": {
"application": null, "device": null, "user": {
The following is an example of the request.
"name": "get_submissions_expand" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/efcdf80b-a5de-42ac-8579-e40b0223d48b/submissions?$expand=outcomes
+GET https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions?$expand=outcomes
``` # [C#](#tab/csharp)
Content-type: application/json
Content-length: 4492 {
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('72a7baec-c3e9-4213-a850-f62de0adad5f')/assignments('efcdf80b-a5de-42ac-8579-e40b0223d48b')/submissions(outcomes())",
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions(outcomes())",
"value": [ { "status": "returned", "submittedDateTime": null, "unsubmittedDateTime": null,
- "returnedDateTime": "2021-10-13T15:57:00.0349869Z",
+ "returnedDateTime": "2022-04-13T05:11:50.756165Z",
"reassignedDateTime": null, "resourcesFolderUrl": null,
- "id": "9bc724ee-d314-1ec5-725d-5f81228e85a6",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226"
+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a",
"displayName": null } },
Content-length: 4492
"application": null, "device": null, "user": {
- "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
Content-length: 4492
"displayName": null } },
+ "outcomes@odata.context": "https://canary.graph.microsoft.com/testprodbetaeduasg_local_submissions-deeplink/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions('d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a')/outcomes",
"outcomes": [ { "@odata.type": "#microsoft.graph.educationFeedbackOutcome",
Content-length: 4492
"lastModifiedBy": null, "points": null, "publishedPoints": null
- },
- {
- "@odata.type": "#microsoft.graph.educationRubricOutcome",
- "lastModifiedDateTime": "2021-10-13T15:57:00.0076092Z",
- "id": "65a46d78-1a2b-4a7e-bcf8-78a22ac2611b",
- "lastModifiedBy": {
- "application": null,
- "device": null,
- "user": {
- "id": null,
- "displayName": null
- }
- },
- "rubricQualityFeedback": [
- {
- "qualityId": "f4c7b781-4c0c-4113-a5fb-c0885b7ab510",
- "feedback": null
- }
- ],
- "rubricQualitySelectedLevels": [
- {
- "qualityId": "f4c7b781-4c0c-4113-a5fb-c0885b7ab510",
- "columnId": "ef99fe68-b6f8-4f67-a13b-9a81c1724788"
- }
- ],
- "publishedRubricQualityFeedback": [
- {
- "qualityId": "f4c7b781-4c0c-4113-a5fb-c0885b7ab510",
- "feedback": null
- }
- ],
- "publishedRubricQualitySelectedLevels": [
- {
- "qualityId": "f4c7b781-4c0c-4113-a5fb-c0885b7ab510",
- "columnId": "ef99fe68-b6f8-4f67-a13b-9a81c1724788"
- }
- ]
} ] }
The following is an example of the request.
"name": "get_submissions_prefer" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/education/classes/59069eb2-2a09-4d90-bb19-2089cc69d613/assignments/80da1069-a635-4913-813f-d775a5470a8f/submissions
+GET https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions
Prefer: include-unknown-enum-members ```
Content-type: application/json
Content-length: 4492 {
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('59069eb2-2a09-4d90-bb19-2089cc69d613')/assignments('80da1069-a635-4913-813f-d775a5470a8f')/submissions",
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions",
"value": [ {
- "status": "working",
+ "status": "returned",
"submittedDateTime": null, "unsubmittedDateTime": null,
- "returnedDateTime": null,
+ "returnedDateTime": "2022-04-13T05:11:50.756165Z",
"reassignedDateTime": null, "resourcesFolderUrl": null,
- "id": "f51a6687-a4a3-a8d9-ac4a-6ff81c5a8da7",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "0ca0dd79-57eb-4903-97dc-88c769dd2a3d"
+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "0ca0dd79-57eb-4903-97dc-88c769dd2a3d",
+ "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a",
"displayName": null } },
Content-length: 4492
"application": null, "device": null, "user": {
- "id": null,
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
Content-length: 4492
}, { "status": "reassigned",
- "submittedDateTime": "2021-11-10T00:57:17.0495233Z",
+ "submittedDateTime": "2022-04-13T05:10:00.4660243Z",
"unsubmittedDateTime": null,
- "returnedDateTime": null,
- "reassignedDateTime": "2021-11-10T01:03:25.7812455Z",
+ "returnedDateTime": "2022-04-13T05:12:14.6531582Z",
+ "reassignedDateTime": null,
"resourcesFolderUrl": null,
- "id": "869369de-3e5a-89eb-6f2d-83cd88f860b5",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22efbecaf4-6956-4a76-6e10-b901e4de91c5%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "efbecaf4-6956-4a76-6e10-b901e4de91c5",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "723e2402-f503-4825-a4d5-5143fbe6f53d"
+ "userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "723e2402-f503-4825-a4d5-5143fbe6f53d",
+ "id": "51cf5a99-d234-4e43-96de-cd65df14bfa1",
"displayName": null } },
Content-length: 4492
"application": null, "device": null, "user": {
- "id": null,
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
Content-length: 4492
"application": null, "device": null, "user": {
- "id": "afc58f1f-7c9e-4770-a448-e53ba43463a5",
+ "id": null,
"displayName": null } }
v1.0 Educationassignment Setupfeedbackresourcesfolder https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignment-setupfeedbackresourcesfolder.md
Content-type: application/json
### Response+ The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
+ <!-- { "blockType": "response", "truncated": true,
v1.0 Educationfeedbackresourceoutcome Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationfeedbackresourceoutcome-delete.md
Title: "Delete educationFeedbackResourceOutcome"
-description: "Delete a feedback resource from a submission. This can only be done by a teacher."
+description: "Delete a feedback resource from a submission."
ms.localizationpriority: medium ms.prod: "education"
DELETE /education/classes/{classId}/assignments/{assignmentId}/submissions/{subm
| Authorization | Bearer {token}. Required. | ## Request body
-Don't supply a request body for this method.
+Do not supply a request body for this method.
## Response If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
v1.0 Educationfeedbackresourceoutcome Post Outcomes https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationfeedbackresourceoutcome-post-outcomes.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Create a new [feedback resource](../resources/educationfeedbackresourceoutcome.md) for a submission.
-
-Only a teacher can perform this operation.
+Create a new [feedback resource](../resources/educationfeedbackresourceoutcome.md) for a submission. Only a teacher can perform this operation.
To create a new file-based resource, upload the file to the feedback resources folder associated with the assignment. If the file doesn't exist or is not in that folder, the `POST` request will fail.
Content-type: application/json
} } }- ```
+## See also
+
+To upload an existing file, see [Upload feedback files for education submissions](/graph/education-upload-feedback-resource-overview).
+ <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2022-05-06 14:57:30 UTC --> <!--
v1.0 Educationrubric Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationrubric-get.md
The following is an example of the request.
GET https://graph.microsoft.com/beta/education/me/rubrics/bf040af7-a5ff-4abe-a8c8-1bdc532344c2 ```
-## Optional query parameters
-
-This method supports the `$select` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
- # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-educationrubric-csharp-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Educationsubmission Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-get.md
The following is an example of the request.
"name": "get_educationsubmission" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/education/classes/59069eb2-2a09-4d90-bb19-2089cc69d613/assignments/80da1069-a635-4913-813f-d775a5470a8f/submissions/869369de-3e5a-89eb-6f2d-83cd88f860b5
+GET https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions/d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a
``` # [C#](#tab/csharp)
Content-type: application/json
Content-length: 712 {
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('59069eb2-2a09-4d90-bb19-2089cc69d613')/assignments('80da1069-a635-4913-813f-d775a5470a8f')/submissions/$entity",
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions/$entity",
"status": "returned",
- "submittedDateTime": "2021-11-10T00:57:17.0495233Z",
+ "submittedDateTime": null,
"unsubmittedDateTime": null,
- "returnedDateTime": "2021-11-10T01:03:25.7812455Z",
- "reassignedDateTime": "2021-11-10T01:03:25.7812455Z",
+ "returnedDateTime": "2022-04-13T05:11:50.756165Z",
+ "reassignedDateTime": null,
"resourcesFolderUrl": null,
- "id": "869369de-3e5a-89eb-6f2d-83cd88f860b5",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "723e2402-f503-4825-a4d5-5143fbe6f53d"
+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "723e2402-f503-4825-a4d5-5143fbe6f53d",
+ "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a",
"displayName": null } },
Content-length: 712
"application": null, "device": null, "user": {
- "id": "afc58f1f-7c9e-4770-a448-e53ba43463a5",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
Content-length: 712
"application": null, "device": null, "user": {
- "id": "afc58f1f-7c9e-4770-a448-e53ba43463a5",
+ "id": null,
"displayName": null } }
The following is an example of the request.
"name": "get_educationsubmission_prefer" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/education/classes/59069eb2-2a09-4d90-bb19-2089cc69d613/assignments/80da1069-a635-4913-813f-d775a5470a8f/submissions/869369de-3e5a-89eb-6f2d-83cd88f860b5
+GET https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions/efbecaf4-6956-4a76-6e10-b901e4de91c5
Prefer: include-unknown-enum-members ```
Content-type: application/json
Content-length: 712 {
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('59069eb2-2a09-4d90-bb19-2089cc69d613')/assignments('80da1069-a635-4913-813f-d775a5470a8f')/submissions/$entity",
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions/$entity",
"status": "reassigned",
- "submittedDateTime": "2021-11-10T00:57:17.0495233Z",
+ "submittedDateTime": "2022-04-13T05:10:00.4660243Z",
"unsubmittedDateTime": null,
- "returnedDateTime": null,
- "reassignedDateTime": "2021-11-10T01:03:25.7812455Z",
+ "returnedDateTime": "2022-04-13T05:12:14.6531582Z",
+ "reassignedDateTime": "2022-04-13T05:12:14.6531582Z",
"resourcesFolderUrl": null,
- "id": "869369de-3e5a-89eb-6f2d-83cd88f860b5",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22efbecaf4-6956-4a76-6e10-b901e4de91c5%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "efbecaf4-6956-4a76-6e10-b901e4de91c5",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "723e2402-f503-4825-a4d5-5143fbe6f53d"
+ "userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "723e2402-f503-4825-a4d5-5143fbe6f53d",
+ "id": "51cf5a99-d234-4e43-96de-cd65df14bfa1",
"displayName": null } },
Content-length: 712
"application": null, "device": null, "user": {
- "id": null,
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
Content-length: 712
"application": null, "device": null, "user": {
- "id": "afc58f1f-7c9e-4770-a448-e53ba43463a5",
+ "id": null,
"displayName": null } }
The following is an example of the request.
"name": "get_submission_expand" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/education/classes/59069eb2-2a09-4d90-bb19-2089cc69d613/assignments/80da1069-a635-4913-813f-d775a5470a8f/submissions/869369de-3e5a-89eb-6f2d-83cd88f860b5?$expand=*
+GET https://graph.microsoft.com/beta/education/classes/a86a5c30-0437-49d6-9c6b-b1ce0d8d5574/assignments/95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f/submissions/e1a0240e-f3af-f039-63e7-09c3cbf8d176?$expand=*
``` # [C#](#tab/csharp)
Content-type: application/json
Content-length: 4492 {
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('59069eb2-2a09-4d90-bb19-2089cc69d613')/assignments('80da1069-a635-4913-813f-d775a5470a8f')/submissions(outcomes(),resources(),submittedResources())/$entity",
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('a86a5c30-0437-49d6-9c6b-b1ce0d8d5574')/assignments('95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f')/submissions(outcomes(),resources(),submittedResources())/$entity",
"status": "returned",
- "submittedDateTime": "2021-11-10T00:57:17.0495233Z",
+ "submittedDateTime": "2022-10-24T21:03:53.3664034Z",
"unsubmittedDateTime": null,
- "returnedDateTime": "2021-11-10T01:03:25.7812455Z",
- "reassignedDateTime": "2021-11-10T01:03:25.7812455Z",
+ "returnedDateTime": "2022-10-24T21:04:42.7101616Z",
+ "reassignedDateTime": null,
"resourcesFolderUrl": null,
- "id": "869369de-3e5a-89eb-6f2d-83cd88f860b5",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%22a86a5c30-0437-49d6-9c6b-b1ce0d8d5574%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%2295da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22e1a0240e-f3af-f039-63e7-09c3cbf8d176%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "e1a0240e-f3af-f039-63e7-09c3cbf8d176",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "723e2402-f503-4825-a4d5-5143fbe6f53d"
+ "userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "723e2402-f503-4825-a4d5-5143fbe6f53d",
+ "id": "51cf5a99-d234-4e43-96de-cd65df14bfa1",
"displayName": null } },
Content-length: 4492
"application": null, "device": null, "user": {
- "id": "afc58f1f-7c9e-4770-a448-e53ba43463a5",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
Content-length: 4492
"application": null, "device": null, "user": {
- "id": "afc58f1f-7c9e-4770-a448-e53ba43463a5",
+ "id": null,
"displayName": null } },
+ "outcomes@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('a86a5c30-0437-49d6-9c6b-b1ce0d8d5574')/assignments('95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f')/submissions('e1a0240e-f3af-f039-63e7-09c3cbf8d176')/outcomes",
"outcomes": [ { "@odata.type": "#microsoft.graph.educationFeedbackOutcome",
- "lastModifiedDateTime": null,
+ "lastModifiedDateTime": "2022-10-24T21:04:42.3073523Z",
"id": "ca05367a-b292-42d5-aff7-5d279feeace8",
- "lastModifiedBy": null,
- "feedback": null,
- "publishedFeedback": null
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ },
+ "feedback": {
+ "feedbackDateTime": "2022-10-24T21:04:42.3073523Z",
+ "text": {
+ "content": "New feedback!",
+ "contentType": "text"
+ },
+ "feedbackBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ }
+ },
+ "publishedFeedback": {
+ "feedbackDateTime": "2022-10-24T21:04:25.2783852Z",
+ "text": {
+ "content": "Feedback",
+ "contentType": "text"
+ },
+ "feedbackBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ }
+ }
}, { "@odata.type": "#microsoft.graph.educationPointsOutcome",
- "lastModifiedDateTime": null,
+ "lastModifiedDateTime": "2022-10-24T21:04:42.7101541Z",
"id": "ea1351f6-ba33-4940-b2cb-6a7254af2dc8",
- "lastModifiedBy": null,
- "points": null,
- "publishedPoints": null
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ },
+ "points": {
+ "gradedDateTime": "2022-10-24T21:04:42.7101541Z",
+ "points": 456,
+ "gradedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ }
+ },
+ "publishedPoints": {
+ "gradedDateTime": "2022-10-24T21:04:25.6308301Z",
+ "points": 123,
+ "gradedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ }
+ }
}, { "@odata.type": "#microsoft.graph.educationRubricOutcome",
- "lastModifiedDateTime": "2021-11-10T01:03:25.7712076Z",
+ "lastModifiedDateTime": "2022-10-24T21:04:26.5833776Z",
"id": "65a46d78-1a2b-4a7e-bcf8-78a22ac2611b", "lastModifiedBy": { "application": null,
Content-length: 4492
}, "rubricQualityFeedback": [ {
- "qualityId": "a660004a-608d-4cd2-a6dc-4f43812444ee",
+ "qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c",
"feedback": null }, {
- "qualityId": "2c5ae75d-d347-426b-be2c-cfc81a6f0b32",
- "feedback": null
+ "qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b",
+ "feedback": {
+ "content": "Needs improvement",
+ "contentType": "text"
+ }
}, {
- "qualityId": "32fdea06-5cbb-4881-9093-96e59f59b8b8",
- "feedback": null
- },
- {
- "qualityId": "66137bd8-b9c2-40e1-a360-40b7ee75eaef",
+ "qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de",
"feedback": null } ], "rubricQualitySelectedLevels": [ {
- "qualityId": "a660004a-608d-4cd2-a6dc-4f43812444ee",
+ "qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c",
"columnId": null }, {
- "qualityId": "2c5ae75d-d347-426b-be2c-cfc81a6f0b32",
- "columnId": null
+ "qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b",
+ "columnId": "0f9823a2-174c-4ce0-8f12-e298c291f29b"
}, {
- "qualityId": "32fdea06-5cbb-4881-9093-96e59f59b8b8",
- "columnId": null
- },
- {
- "qualityId": "66137bd8-b9c2-40e1-a360-40b7ee75eaef",
+ "qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de",
"columnId": null } ], "publishedRubricQualityFeedback": [ {
- "qualityId": "a660004a-608d-4cd2-a6dc-4f43812444ee",
- "feedback": null
- },
- {
- "qualityId": "2c5ae75d-d347-426b-be2c-cfc81a6f0b32",
+ "qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c",
"feedback": null }, {
- "qualityId": "32fdea06-5cbb-4881-9093-96e59f59b8b8",
- "feedback": null
+ "qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b",
+ "feedback": {
+ "content": "Needs improvement",
+ "contentType": "text"
+ }
}, {
- "qualityId": "66137bd8-b9c2-40e1-a360-40b7ee75eaef",
+ "qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de",
"feedback": null } ], "publishedRubricQualitySelectedLevels": [ {
- "qualityId": "a660004a-608d-4cd2-a6dc-4f43812444ee",
+ "qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c",
"columnId": null }, {
- "qualityId": "2c5ae75d-d347-426b-be2c-cfc81a6f0b32",
- "columnId": null
- },
- {
- "qualityId": "32fdea06-5cbb-4881-9093-96e59f59b8b8",
- "columnId": null
+ "qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b",
+ "columnId": "0f9823a2-174c-4ce0-8f12-e298c291f29b"
}, {
- "qualityId": "66137bd8-b9c2-40e1-a360-40b7ee75eaef",
+ "qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de",
"columnId": null } ] } ],
+ "resources@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('a86a5c30-0437-49d6-9c6b-b1ce0d8d5574')/assignments('95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f')/submissions('e1a0240e-f3af-f039-63e7-09c3cbf8d176')/resources",
"resources": [],
+ "submittedResources@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('a86a5c30-0437-49d6-9c6b-b1ce0d8d5574')/assignments('95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f')/submissions('e1a0240e-f3af-f039-63e7-09c3cbf8d176')/submittedResources",
"submittedResources": [] } ```
v1.0 Educationsubmission List Outcomes https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-list-outcomes.md
Title: "List outcomes"
-description: "Retrieve a list of educationoutcome objects."
+description: "Retrieve a list of educationOutcome objects."
ms.localizationpriority: medium ms.prod: "education"
A submission for a points assignment (one that has a point value assigned) will
A submission for an assignment with an attached rubric, if the rubric is a credit rubric (no points), will have an [educationFeedbackOutcome](../resources/educationpointsoutcome.md) and an [educationRubricOutcome](../resources/educationrubricoutcome.md). (It might also return an [educationPointsOutcome](../resources/educationpointsoutcome.md), but that outcome is ignored.)
-A submission for an assignment with an attached rubric, if the rubric is a points rubric, will have an [educationFeedbackOutcome](../resources/educationpointsoutcome.md), an [educationPointsOutcome](../resources/educationpointsoutcome.md, and an [educationRubricOutcome](../resources/educationrubricoutcome.md).
+A submission for an assignment with an attached rubric, if the rubric is a points rubric, will have an [educationFeedbackOutcome](../resources/educationpointsoutcome.md), an [educationPointsOutcome](../resources/educationpointsoutcome.md), and an [educationRubricOutcome](../resources/educationrubricoutcome.md).
A submission for a feedback resource will have an [educationFeedbackResourceOutcome](../resources/educationfeedbackresourceoutcome.md).
-All outcome types have a regular and a published property appropriate to that type of outcome; for example, **points** and **publishedPoints**, **feedback** and **publishedFeedback**. The regular property is the most recent value updated by the teacher; the published property is the most recent value returned to the student.
+All outcome types have a regular and a published property appropriate to that type of outcome; for example, **points** and **publishedPoints**, **feedback** and **publishedFeedback**. The regular property is the most recent value updated by the teacher; the published property is the most recent value returned to the student.
## Permissions
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-GET /education/classes/{id}/assignments/{id}/submissions/{id}/outcomes
+GET /education/classes/{classId}/assignments/{assignmentId}/submissions/{submissionId}/outcomes
``` ## Optional query parameters
v1.0 Educationsubmission Reassign https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-reassign.md
The following is an example of the request.
}--> ```http
-POST /education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/7192332b-e904-4891-81e2-356242ab1858/submissions/02bb5de1-7205-2a25-fe33-f99cf53de1c4/reassign
+POST https://graph.microsoft.com/beta/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/assignments/db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a/submissions/4bca096a-7de3-8675-5e86-2fa149923860/reassign
``` # [C#](#tab/csharp)
HTTP/1.1 200 OK
"@odata.context": "https://graph.microsoft.com/beta/$metadata#educationSubmission", "@odata.type": "#microsoft.graph.educationSubmission", "status": "returned",
- "submittedDateTime": "2021-09-07T14:54:46.1606962Z",
- "unsubmittedDateTime": "2021-09-07T14:41:18.9512645Z",
- "returnedDateTime": "2021-09-07T21:38:40.5254847Z",
- "reassignedDateTime": "2021-09-07T21:38:40.5254847Z",
+ "submittedDateTime": "2022-10-19T23:32:49.3314767Z",
+ "unsubmittedDateTime": null,
+ "returnedDateTime": "2022-10-19T23:32:58.1079737Z",
+ "reassignedDateTime": "2022-10-19T23:32:58.1079737Z",
"resourcesFolderUrl": null,
- "id": "02bb5de1-7205-2a25-fe33-f99cf53de1c4",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%22bf1f1963-05f6-4cba-903c-5892b4ce3bd7%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%22db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%224bca096a-7de3-8675-5e86-2fa149923860%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "4bca096a-7de3-8675-5e86-2fa149923860",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226"
+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
HTTP/1.1 200 OK
"application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": null,
"displayName": null } },
HTTP/1.1 200 OK
"application": null, "device": null, "user": {
- "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
HTTP/1.1 200 OK
"application": null, "device": null, "user": {
- "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } }
The following is an example of the request.
}--> ```http
-POST /education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/7192332b-e904-4891-81e2-356242ab1858/submissions/02bb5de1-7205-2a25-fe33-f99cf53de1c4/reassign
+POST https://graph.microsoft.com/beta/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/assignments/db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a/submissions/b9dab587-5fcc-30ae-f7fa-41a47fb89972/reassign
Prefer: include-unknown-enum-members ```
HTTP/1.1 200 OK
"@odata.context": "https://graph.microsoft.com/beta/$metadata#educationSubmission", "@odata.type": "#microsoft.graph.educationSubmission", "status": "reassigned",
- "submittedDateTime": "2021-09-07T21:44:41.8377109Z",
- "unsubmittedDateTime": "2021-09-07T14:41:18.9512645Z",
+ "submittedDateTime": "2022-10-19T23:34:34.5246354Z",
+ "unsubmittedDateTime": null,
"returnedDateTime": null,
- "reassignedDateTime": "2021-09-07T21:45:42.9027726Z",
+ "reassignedDateTime": "2022-10-19T23:35:07.2786612Z",
"resourcesFolderUrl": null,
- "id": "02bb5de1-7205-2a25-fe33-f99cf53de1c4",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%22bf1f1963-05f6-4cba-903c-5892b4ce3bd7%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%22db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22b9dab587-5fcc-30ae-f7fa-41a47fb89972%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "b9dab587-5fcc-30ae-f7fa-41a47fb89972",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226"
+ "userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
HTTP/1.1 200 OK
"application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": null,
"displayName": null } },
HTTP/1.1 200 OK
"application": null, "device": null, "user": {
- "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } }
v1.0 Educationsubmission Return https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-return.md
The following is an example of the request.
}--> ```http
-POST https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/7192332b-e904-4891-81e2-356242ab1858/submissions/022fb52d-1278-d21f-e827-2221a6a3e516/return
+POST https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions/d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a/return
``` # [C#](#tab/csharp)
HTTP/1.1 200 Ok
"@odata.context": "https://graph.microsoft.com/beta/$metadata#educationSubmission", "@odata.type": "#microsoft.graph.educationSubmission", "status": "returned",
- "submittedDateTime": "2021-09-03T18:20:11.2167718Z",
+ "submittedDateTime": null,
"unsubmittedDateTime": null,
- "returnedDateTime": "2021-09-03T19:01:45.6526389Z",
- "resourcesFolderUrl": "https://graph.microsoft.com/beta/drives/b!OPmUsPgnBUiMIXMxWcj3neC1xck6I5NIsnFxfrLdmXodJYOAkI7rTLhw7ME_e42J/items/01QTY63RKYRQDN3FDQWNA24OCLHBD5C2SH",
- "id": "022fb52d-1278-d21f-e827-2221a6a3e516",
+ "returnedDateTime": "2022-10-19T23:00:30.9243194Z",
+ "reassignedDateTime": null,
+ "resourcesFolderUrl": null,
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226"
+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a",
"displayName": null } },
HTTP/1.1 200 Ok
"application": null, "device": null, "user": {
- "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ },
+ "reassignedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": null,
"displayName": null } }
v1.0 Educationsubmission Submit https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-submit.md
The following is an example of the request.
}--> ```http
-POST https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/7192332b-e904-4891-81e2-356242ab1858/submissions/02bb5de1-7205-2a25-fe33-f99cf53de1c4/submit
+POST https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions/efbecaf4-6956-4a76-6e10-b901e4de91c5/submit
``` # [C#](#tab/csharp)
HTTP/1.1 200 Ok
"@odata.context": "https://graph.microsoft.com/beta/$metadata#educationSubmission", "@odata.type": "#microsoft.graph.educationSubmission", "status": "submitted",
- "submittedDateTime": "2021-09-07T14:54:46.1606962Z",
- "unsubmittedDateTime": "2021-09-07T14:41:18.9512645Z",
- "returnedDateTime": null,
+ "submittedDateTime": "2022-10-19T23:02:20.4995757Z",
+ "unsubmittedDateTime": null,
+ "returnedDateTime": "2022-04-13T05:12:14.6531582Z",
+ "reassignedDateTime": null,
"resourcesFolderUrl": null,
- "id": "02bb5de1-7205-2a25-fe33-f99cf53de1c4",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22efbecaf4-6956-4a76-6e10-b901e4de91c5%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "efbecaf4-6956-4a76-6e10-b901e4de91c5",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226"
+ "userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } },
HTTP/1.1 200 Ok
"application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": null,
"displayName": null } }, "returnedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ },
+ "reassignedBy": {
"application": null, "device": null, "user": {
v1.0 Educationsubmission Unsubmit https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-unsubmit.md
The following is an example of the request.
}--> ```http
-POST https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/7192332b-e904-4891-81e2-356242ab1858/submissions/02bb5de1-7205-2a25-fe33-f99cf53de1c4/unsubmit
+POST https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/7242e03e-048c-437b-8810-3e89b285a362/submissions/3cea5cf6-55dc-d6c7-2f5b-3b5cd2e79c3a/unsubmit
``` # [C#](#tab/csharp)
HTTP/1.1 200 Ok
"@odata.type": "#microsoft.graph.educationSubmission", "status": "returned", "submittedDateTime": null,
- "unsubmittedDateTime": "2021-09-07T14:41:18.9512645Z",
- "returnedDateTime": null,
+ "unsubmittedDateTime": "2022-10-19T23:14:41.2934772Z",
+ "returnedDateTime": "2022-04-13T02:09:15.7223872Z",
+ "reassignedDateTime": null,
"resourcesFolderUrl": null,
- "id": "02bb5de1-7205-2a25-fe33-f99cf53de1c4",
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%227242e03e-048c-437b-8810-3e89b285a362%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%223cea5cf6-55dc-d6c7-2f5b-3b5cd2e79c3a%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "id": "3cea5cf6-55dc-d6c7-2f5b-3b5cd2e79c3a",
"recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226"
+ "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a"
}, "submittedBy": { "application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a",
"displayName": null } },
HTTP/1.1 200 Ok
"application": null, "device": null, "user": {
- "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
"displayName": null } }, "returnedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
+ "displayName": null
+ }
+ },
+ "reassignedBy": {
"application": null, "device": null, "user": {
v1.0 Educationsynchronizationprofile Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsynchronizationprofile-post.md
Title: "Create an educationSynchronizationProfile"
-description: "Create a request for a new school data synchronization profile in the tenant. Query the status to get the status of the profile. "
+description: "Create a request for a new school data synchronization profile in the tenant."
ms.localizationpriority: medium ms.prod: "education"
POST /education/synchronizationProfiles
In the request body, supply a JSON representation of the [educationSynchronizationProfile](../resources/educationsynchronizationprofile.md) object. ## Response
-If successful, this method returns a `202, Accepted` response code and an [educationSynchronizationProfile](../resources/educationsynchronizationprofile.md) object in the response body.
+If successful, this method returns a `202 Accepted` response code and an [educationSynchronizationProfile](../resources/educationsynchronizationprofile.md) object in the response body.
## Example
-##### Request
+### Request
The following is an example of the request. <!-- { "blockType": "ignored",
Content-type: application/json
{ "displayName": "Test Profile", "dataProvider": {
- "@odata.type": "#Microsoft.Education.DataSync.educationCsvDataProvider",
+ "@odata.type": "#microsoft.graph.educationCsvDataProvider",
"customizations": { "student": { "optionalPropertiesToSync": [
Content-type: application/json
} }, "identitySynchronizationConfiguration": {
- "@odata.type": "#Microsoft.Education.DataSync.educationIdentityCreationConfiguration",
+ "@odata.type": "#microsoft.graph.educationIdentityCreationConfiguration",
"userDomains": [ { "appliesTo": "student",
Content-type: application/json
} ```
-##### Response
+### Response
The following is an example of the response. >**Note:** The response object shown here might be shortened for readability.
v1.0 Group List Transitivemembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/group-list-transitivemembers.md
GET /groups/{id}/transitiveMembers
This method supports the [OData query parameters](/graph/query-parameters) to help customize the response, including `$search`, `$count`, and `$filter`. You can use `$search` on the **displayName** and **description** properties. When items are added or updated for this resource, they are specially indexed for use with the `$count` and `$search` query parameters. There can be a slight delay between when an item is added or updated and when it is available in the index.
+This API returns up to 100 member objects by default. The maximum page size that you can request through the `$top` query parameter is 999 objects.
+ To filter the results on the OData type, such as `microsoft.graph.user` or `microsoft.graph.group`, you must use the [advanced query parameters](/graph/aad-advanced-queries). That is, the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string. ## Request headers
v1.0 Identitygovernance Deleteditemcontainer Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-deleteditemcontainer-get.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_get_deleteditemcontainer_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/deletedItems/workflows/952b23c5-cc25-48c9-8848-95da4dd9dc6d?$select=id,category,displayName,description,version,executionConditions ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
Content-Type: application/json
"tasks@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/deletedItems/workflows('952b23c5-cc25-48c9-8848-95da4dd9dc6d')/tasks", "tasks": [] }
-```
+```
v1.0 Identitygovernance Lifecycleworkflowscontainer List Deleteditems https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-lifecycleworkflowscontainer-list-deleteditems.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_list_deleteditemcontainer_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/deletedItems/workflows?$select=id,category,displayName,description,version&$filter=category eq 'leaver' ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
Content-Type: application/json
} ] }
-```
+```
v1.0 Identitygovernance Lifecycleworkflowscontainer List Taskdefinitions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-lifecycleworkflowscontainer-list-taskdefinitions.md
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/taskD
``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go)
v1.0 Identitygovernance Run Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-run-get.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_get_workflow_run"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/runs/e65e08a0-d68d-41dc-915b-8c4019af5cc2?$select=id,failedTasksCount,failedUsersCount,processingStatus,totalTasksCount,totalUnprocessedTasksCount,totalUsersCount ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response
Content-Type: application/json
"totalUsersCount": 1, "totalUnprocessedTasksCount": 0 }
-```
+```
v1.0 Identitygovernance Run List Taskprocessingresults https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-run-list-taskprocessingresults.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_list_run_taskprocessingresult_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/runs/e65e08a0-d68d-41dc-915b-8c4019af5cc2/userProcessingResults/40efc576-840f-47d0-ab95-5abca800f8a2//taskProcessingResults?$select=id,failureReason,processingStatus,subject,task ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
Content-Type: application/json
} ] }
-```
+```
v1.0 Identitygovernance Run List Userprocessingresults https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-run-list-userprocessingresults.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_get_run_taskprocessingresult_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/runs/e65e08a0-d68d-41dc-915b-8c4019af5cc2/userProcessingResults?$select=id,failedTasksCount,processingStatus,totalTasksCount,totalUnprocessedTasksCount,subject ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
Content-Type: application/json
} ] }
-```
+```
v1.0 Identitygovernance Taskreport List Taskprocessingresults https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-taskreport-list-taskprocessingresults.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_list_taskreport_taskprocessingresult_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/taskReports/443c7611-45df-48c0-bf5e-dc6068c402f0/taskProcessingResults?$select=id,failureReason,processingStatus,subject,task ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
Content-Type: application/json
} ] }
-```
+```
v1.0 Identitygovernance Userprocessingresult Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-userprocessingresult-get.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_get_run_userprocessingresult"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/runs/e65e08a0-d68d-41dc-915b-8c4019af5cc2/userProcessingResults/40efc576-840f-47d0-ab95-5abca800f8a2?$select=id,failedTasksCount,processingStatus,totalTasksCount,totalUnprocessedTasksCount,subject ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
v1.0 Identitygovernance Userprocessingresult List Taskprocessingresults https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-userprocessingresult-list-taskprocessingresults.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_list_workflow_userprocessingresult_taskprocessingresult_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/userProcessingResults/40efc576-840f-47d0-ab95-5abca800f8a2/taskProcessingResults?$select=id,processingStatus,failureReason,subject,task ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response
Content-Type: application/json
} ] }
-```
+```
v1.0 Identitygovernance Workflow List Runs https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-workflow-list-runs.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_list_run_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/runs?$select=id,failedTasksCount,failedUsersCount,processingStatus,totalTasksCount,totalUnprocessedTasksCount,totalUsersCount,id ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
Content-Type: application/json
} ] }
-```
+```
v1.0 Identitygovernance Workflow List Taskreports https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-workflow-list-taskreports.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_list_taskreport_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/taskReports?$select=id,failedUsersCount,processingStatus,successfulUsersCount,totalUsersCount,unprocessedUsersCount,taskDefinition,taskProcessingResults ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response
Content-Type: application/json
} ] }
-```
+```
v1.0 Identitygovernance Workflow List Userprocessingresults https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-workflow-list-userprocessingresults.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_list_userprocessingresult_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/156ce798-1eb6-4e0a-8515-e79f54d04390/userProcessingResults?$select=id,failedTasksCount,processingStatus,totalTasksCount,totalUnprocessedTasksCount,workflowExecutionType,subject ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
Content-Type: application/json
} ] }
-```
+```
v1.0 Identitygovernance Workflow List Versions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-workflow-list-versions.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_list_workflowversion_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/versions?$select=category,displayName,versionNumber ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response <!-- {
Content-Type: application/json
} ] }
-```
+```
v1.0 Identitygovernance Workflowversion Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-workflowversion-get.md
Content-Type: application/json
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "lifecycleworkflows_get_workflowversion_select"
The following is an example of a request.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/versions/2?$select=category,displayName,versionNumber,executionConditions&$expand=tasks ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response <!-- { "blockType": "response",
Content-Type: application/json
} ] }
-```
+```
v1.0 Intune Apps Ioslobapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-ioslobapp-create.md
The following table shows the properties that are required when you create the i
|expirationDateTime|DateTimeOffset|The expiration time.| |versionNumber|String|The version number of iOS Line of Business (LoB) app.| |buildNumber|String|The build number of iOS Line of Business (LoB) app.|
-|identityVersion|String|The identity version.|
+|identityVersion|String|The identity version. This property is being deprecated in 2211(November 2022)|
v1.0 Intune Apps Ioslobapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-ioslobapp-update.md
The following table shows the properties that are required when you create the [
|expirationDateTime|DateTimeOffset|The expiration time.| |versionNumber|String|The version number of iOS Line of Business (LoB) app.| |buildNumber|String|The build number of iOS Line of Business (LoB) app.|
-|identityVersion|String|The identity version.|
+|identityVersion|String|The identity version. This property is being deprecated in 2211(November 2022)|
v1.0 Intune Apps Macoslobapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macoslobapp-create.md
The following table shows the properties that are required when you create the m
|committedContentVersion|String|The internal committed content version. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |fileName|String|The name of the main Lob application file. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |size|Int64|The total size, including all uploaded files. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)|
-|bundleId|String|The bundle id.|
-|minimumSupportedOperatingSystem|[macOSMinimumOperatingSystem](../resources/intune-apps-macosminimumoperatingsystem.md)|The value for the minimum applicable operating system.|
-|buildNumber|String|The build number of MacOS Line of Business (LoB) app.|
-|versionNumber|String|The version number of MacOS Line of Business (LoB) app.|
-|childApps|[macOSLobChildApp](../resources/intune-apps-macoslobchildapp.md) collection|The app list in this bundle package|
-|identityVersion|String|The identity version.|
-|md5HashChunkSize|Int32|The chunk size for MD5 hash|
-|md5Hash|String collection|The MD5 hash codes|
-|ignoreVersionDetection|Boolean|A boolean to control whether the app's version will be used to detect the app after it is installed on a device. Set this to true for macOS Line of Business (LoB) apps that use a self update feature.|
-|installAsManaged|Boolean|A boolean to control whether the app will be installed as managed (requires macOS 11.0 and other PKG restrictions).|
+|bundleId|String|The primary bundleId of the package.|
+|minimumSupportedOperatingSystem|[macOSMinimumOperatingSystem](../resources/intune-apps-macosminimumoperatingsystem.md)|ComplexType macOSMinimumOperatingSystem that indicates the minimum operating system applicable for the application.|
+|buildNumber|String|The build number of the package. This should match the package CFBundleShortVersionString of the .pkg file.|
+|versionNumber|String|The version number of the package. This should match the package CFBundleVersion in the packageinfo file.|
+|childApps|[macOSLobChildApp](../resources/intune-apps-macoslobchildapp.md) collection|List of ComplexType macOSLobChildApp objects. Represents the apps expected to be installed by the package.|
+|identityVersion|String|The identity version. This property is being deprecated in 2211(November 2022).|
+|md5HashChunkSize|Int32|The chunk size for MD5 hash. This is '0' or empty if the package was uploaded directly. If the Intune App Wrapping Tool is used to create a .intunemac, this value can be found inside the Detection.xml file.|
+|md5Hash|String collection|The MD5 hash codes. This is empty if the package was uploaded directly. If the Intune App Wrapping Tool is used to create a .intunemac, this value can be found inside the Detection.xml file.|
+|ignoreVersionDetection|Boolean|When TRUE, indicates that the app's version will NOT be used to detect if the app is installed on a device. When FALSE, indicates that the app's version will be used to detect if the app is installed on a device. Set this to true for apps that use a self update feature.|
+|installAsManaged|Boolean|When TRUE, indicates that the app will be installed as managed (requires macOS 11.0 and other managed package restrictions). When FALSE, indicates that the app will be installed as unmanaged.|
v1.0 Intune Apps Macoslobapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macoslobapp-update.md
The following table shows the properties that are required when you create the [
|committedContentVersion|String|The internal committed content version. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |fileName|String|The name of the main Lob application file. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |size|Int64|The total size, including all uploaded files. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)|
-|bundleId|String|The bundle id.|
-|minimumSupportedOperatingSystem|[macOSMinimumOperatingSystem](../resources/intune-apps-macosminimumoperatingsystem.md)|The value for the minimum applicable operating system.|
-|buildNumber|String|The build number of MacOS Line of Business (LoB) app.|
-|versionNumber|String|The version number of MacOS Line of Business (LoB) app.|
-|childApps|[macOSLobChildApp](../resources/intune-apps-macoslobchildapp.md) collection|The app list in this bundle package|
-|identityVersion|String|The identity version.|
-|md5HashChunkSize|Int32|The chunk size for MD5 hash|
-|md5Hash|String collection|The MD5 hash codes|
-|ignoreVersionDetection|Boolean|A boolean to control whether the app's version will be used to detect the app after it is installed on a device. Set this to true for macOS Line of Business (LoB) apps that use a self update feature.|
-|installAsManaged|Boolean|A boolean to control whether the app will be installed as managed (requires macOS 11.0 and other PKG restrictions).|
+|bundleId|String|The primary bundleId of the package.|
+|minimumSupportedOperatingSystem|[macOSMinimumOperatingSystem](../resources/intune-apps-macosminimumoperatingsystem.md)|ComplexType macOSMinimumOperatingSystem that indicates the minimum operating system applicable for the application.|
+|buildNumber|String|The build number of the package. This should match the package CFBundleShortVersionString of the .pkg file.|
+|versionNumber|String|The version number of the package. This should match the package CFBundleVersion in the packageinfo file.|
+|childApps|[macOSLobChildApp](../resources/intune-apps-macoslobchildapp.md) collection|List of ComplexType macOSLobChildApp objects. Represents the apps expected to be installed by the package.|
+|identityVersion|String|The identity version. This property is being deprecated in 2211(November 2022).|
+|md5HashChunkSize|Int32|The chunk size for MD5 hash. This is '0' or empty if the package was uploaded directly. If the Intune App Wrapping Tool is used to create a .intunemac, this value can be found inside the Detection.xml file.|
+|md5Hash|String collection|The MD5 hash codes. This is empty if the package was uploaded directly. If the Intune App Wrapping Tool is used to create a .intunemac, this value can be found inside the Detection.xml file.|
+|ignoreVersionDetection|Boolean|When TRUE, indicates that the app's version will NOT be used to detect if the app is installed on a device. When FALSE, indicates that the app's version will be used to detect if the app is installed on a device. Set this to true for apps that use a self update feature.|
+|installAsManaged|Boolean|When TRUE, indicates that the app will be installed as managed (requires macOS 11.0 and other managed package restrictions). When FALSE, indicates that the app will be installed as unmanaged.|
v1.0 Intune Apps Macosmicrosoftdefenderapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmicrosoftdefenderapp-create.md
+
+ Title: "Create macOSMicrosoftDefenderApp"
+description: "Create a new macOSMicrosoftDefenderApp object."
+
+localization_priority: Normal
++
+# Create macOSMicrosoftDefenderApp
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Create a new [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object.
+
+## Prerequisites
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementApps.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementApps.ReadWrite.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceAppManagement/mobileApps
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+In the request body, supply a JSON representation for the macOSMicrosoftDefenderApp object.
+
+The following table shows the properties that are required when you create the macOSMicrosoftDefenderApp.
+
+|Property|Type|Description|
+|:|:|:|
+|id|String|Key of the entity. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|displayName|String|The admin provided or imported title of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|description|String|The description of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|publisher|String|The publisher of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|largeIcon|[mimeContent](../resources/intune-shared-mimecontent.md)|The large icon, to be displayed in the app details and used for upload of the icon. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|createdDateTime|DateTimeOffset|The date and time the app was created. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|lastModifiedDateTime|DateTimeOffset|The date and time the app was last modified. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|isFeatured|Boolean|The value indicating whether the app is marked as featured by the admin. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|privacyInformationUrl|String|The privacy statement Url. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|informationUrl|String|The more information Url. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|owner|String|The owner of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|developer|String|The developer of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|notes|String|Notes for the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|uploadState|Int32|The upload state. Possible values are: 0 - `Not Ready`, 1 - `Ready`, 2 - `Processing`. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|publishingState|[mobileAppPublishingState](../resources/intune-apps-mobileapppublishingstate.md)|The publishing state for the app. The app cannot be assigned unless the app is published. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md). Possible values are: `notPublished`, `processing`, `published`.|
+|isAssigned|Boolean|The value indicating whether the app is assigned to at least one group. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|roleScopeTagIds|String collection|List of scope tag ids for this mobile app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+++
+## Response
+If successful, this method returns a `201 Created` response code and a [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps
+Content-type: application/json
+Content-length: 781
+
+{
+ "@odata.type": "#microsoft.graph.macOSMicrosoftDefenderApp",
+ "displayName": "Display Name value",
+ "description": "Description value",
+ "publisher": "Publisher value",
+ "largeIcon": {
+ "@odata.type": "microsoft.graph.mimeContent",
+ "type": "Type value",
+ "value": "dmFsdWU="
+ },
+ "isFeatured": true,
+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
+ "informationUrl": "https://example.com/informationUrl/",
+ "owner": "Owner value",
+ "developer": "Developer value",
+ "notes": "Notes value",
+ "uploadState": 11,
+ "publishingState": "processing",
+ "isAssigned": true,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ],
+ "dependentAppCount": 1,
+ "supersedingAppCount": 3,
+ "supersededAppCount": 2
+}
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+Content-Length: 953
+
+{
+ "@odata.type": "#microsoft.graph.macOSMicrosoftDefenderApp",
+ "id": "ca25fa0c-fa0c-ca25-0cfa-25ca0cfa25ca",
+ "displayName": "Display Name value",
+ "description": "Description value",
+ "publisher": "Publisher value",
+ "largeIcon": {
+ "@odata.type": "microsoft.graph.mimeContent",
+ "type": "Type value",
+ "value": "dmFsdWU="
+ },
+ "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
+ "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
+ "isFeatured": true,
+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
+ "informationUrl": "https://example.com/informationUrl/",
+ "owner": "Owner value",
+ "developer": "Developer value",
+ "notes": "Notes value",
+ "uploadState": 11,
+ "publishingState": "processing",
+ "isAssigned": true,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ],
+ "dependentAppCount": 1,
+ "supersedingAppCount": 3,
+ "supersededAppCount": 2
+}
+```
+++++
v1.0 Intune Apps Macosmicrosoftdefenderapp Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmicrosoftdefenderapp-delete.md
+
+ Title: "Delete macOSMicrosoftDefenderApp"
+description: "Deletes a macOSMicrosoftDefenderApp."
+
+localization_priority: Normal
++
+# Delete macOSMicrosoftDefenderApp
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Deletes a [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md).
+
+## Prerequisites
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementApps.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementApps.ReadWrite.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /deviceAppManagement/mobileApps/{mobileAppId}
+DELETE /deviceAppManagement/mobileApps/{mobileAppId}/userStatuses/{userAppInstallStatusId}/app
+DELETE /deviceAppManagement/mobileApps/{mobileAppId}/deviceStatuses/{mobileAppInstallStatusId}/app
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns a `204 No Content` response code.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 204 No Content
+```
+++++
v1.0 Intune Apps Macosmicrosoftdefenderapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmicrosoftdefenderapp-get.md
+
+ Title: "Get macOSMicrosoftDefenderApp"
+description: "Read properties and relationships of the macOSMicrosoftDefenderApp object."
+
+localization_priority: Normal
++
+# Get macOSMicrosoftDefenderApp
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Read properties and relationships of the [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object.
+
+## Prerequisites
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /deviceAppManagement/mobileApps/{mobileAppId}
+GET /deviceAppManagement/mobileApps/{mobileAppId}/userStatuses/{userAppInstallStatusId}/app
+GET /deviceAppManagement/mobileApps/{mobileAppId}/deviceStatuses/{mobileAppInstallStatusId}/app
+```
+
+## Optional query parameters
+This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns a `200 OK` response code and [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+GET https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 1026
+
+{
+ "value": {
+ "@odata.type": "#microsoft.graph.macOSMicrosoftDefenderApp",
+ "id": "ca25fa0c-fa0c-ca25-0cfa-25ca0cfa25ca",
+ "displayName": "Display Name value",
+ "description": "Description value",
+ "publisher": "Publisher value",
+ "largeIcon": {
+ "@odata.type": "microsoft.graph.mimeContent",
+ "type": "Type value",
+ "value": "dmFsdWU="
+ },
+ "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
+ "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
+ "isFeatured": true,
+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
+ "informationUrl": "https://example.com/informationUrl/",
+ "owner": "Owner value",
+ "developer": "Developer value",
+ "notes": "Notes value",
+ "uploadState": 11,
+ "publishingState": "processing",
+ "isAssigned": true,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ],
+ "dependentAppCount": 1,
+ "supersedingAppCount": 3,
+ "supersededAppCount": 2
+ }
+}
+```
+++++
v1.0 Intune Apps Macosmicrosoftdefenderapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmicrosoftdefenderapp-list.md
+
+ Title: "List macOSMicrosoftDefenderApps"
+description: "List properties and relationships of the macOSMicrosoftDefenderApp objects."
+
+localization_priority: Normal
++
+# List macOSMicrosoftDefenderApps
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+List properties and relationships of the [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) objects.
+
+## Prerequisites
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /deviceAppManagement/mobileApps
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this method returns a `200 OK` response code and a collection of [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) objects in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+GET https://graph.microsoft.com/beta/deviceAppManagement/mobileApps
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 1094
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.macOSMicrosoftDefenderApp",
+ "id": "ca25fa0c-fa0c-ca25-0cfa-25ca0cfa25ca",
+ "displayName": "Display Name value",
+ "description": "Description value",
+ "publisher": "Publisher value",
+ "largeIcon": {
+ "@odata.type": "microsoft.graph.mimeContent",
+ "type": "Type value",
+ "value": "dmFsdWU="
+ },
+ "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
+ "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
+ "isFeatured": true,
+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
+ "informationUrl": "https://example.com/informationUrl/",
+ "owner": "Owner value",
+ "developer": "Developer value",
+ "notes": "Notes value",
+ "uploadState": 11,
+ "publishingState": "processing",
+ "isAssigned": true,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ],
+ "dependentAppCount": 1,
+ "supersedingAppCount": 3,
+ "supersededAppCount": 2
+ }
+ ]
+}
+```
+++++
v1.0 Intune Apps Macosmicrosoftdefenderapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmicrosoftdefenderapp-update.md
+
+ Title: "Update macOSMicrosoftDefenderApp"
+description: "Update the properties of a macOSMicrosoftDefenderApp object."
+
+localization_priority: Normal
++
+# Update macOSMicrosoftDefenderApp
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Update the properties of a [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object.
+
+## Prerequisites
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementApps.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementApps.ReadWrite.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /deviceAppManagement/mobileApps/{mobileAppId}
+PATCH /deviceAppManagement/mobileApps/{mobileAppId}/userStatuses/{userAppInstallStatusId}/app
+PATCH /deviceAppManagement/mobileApps/{mobileAppId}/deviceStatuses/{mobileAppInstallStatusId}/app
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+In the request body, supply a JSON representation for the [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object.
+
+The following table shows the properties that are required when you create the [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md).
+
+|Property|Type|Description|
+|:|:|:|
+|id|String|Key of the entity. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|displayName|String|The admin provided or imported title of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|description|String|The description of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|publisher|String|The publisher of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|largeIcon|[mimeContent](../resources/intune-shared-mimecontent.md)|The large icon, to be displayed in the app details and used for upload of the icon. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|createdDateTime|DateTimeOffset|The date and time the app was created. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|lastModifiedDateTime|DateTimeOffset|The date and time the app was last modified. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|isFeatured|Boolean|The value indicating whether the app is marked as featured by the admin. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|privacyInformationUrl|String|The privacy statement Url. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|informationUrl|String|The more information Url. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|owner|String|The owner of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|developer|String|The developer of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|notes|String|Notes for the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|uploadState|Int32|The upload state. Possible values are: 0 - `Not Ready`, 1 - `Ready`, 2 - `Processing`. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|publishingState|[mobileAppPublishingState](../resources/intune-apps-mobileapppublishingstate.md)|The publishing state for the app. The app cannot be assigned unless the app is published. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md). Possible values are: `notPublished`, `processing`, `published`.|
+|isAssigned|Boolean|The value indicating whether the app is assigned to at least one group. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|roleScopeTagIds|String collection|List of scope tag ids for this mobile app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+++
+## Response
+If successful, this method returns a `200 OK` response code and an updated [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}
+Content-type: application/json
+Content-length: 781
+
+{
+ "@odata.type": "#microsoft.graph.macOSMicrosoftDefenderApp",
+ "displayName": "Display Name value",
+ "description": "Description value",
+ "publisher": "Publisher value",
+ "largeIcon": {
+ "@odata.type": "microsoft.graph.mimeContent",
+ "type": "Type value",
+ "value": "dmFsdWU="
+ },
+ "isFeatured": true,
+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
+ "informationUrl": "https://example.com/informationUrl/",
+ "owner": "Owner value",
+ "developer": "Developer value",
+ "notes": "Notes value",
+ "uploadState": 11,
+ "publishingState": "processing",
+ "isAssigned": true,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ],
+ "dependentAppCount": 1,
+ "supersedingAppCount": 3,
+ "supersededAppCount": 2
+}
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 953
+
+{
+ "@odata.type": "#microsoft.graph.macOSMicrosoftDefenderApp",
+ "id": "ca25fa0c-fa0c-ca25-0cfa-25ca0cfa25ca",
+ "displayName": "Display Name value",
+ "description": "Description value",
+ "publisher": "Publisher value",
+ "largeIcon": {
+ "@odata.type": "microsoft.graph.mimeContent",
+ "type": "Type value",
+ "value": "dmFsdWU="
+ },
+ "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
+ "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
+ "isFeatured": true,
+ "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
+ "informationUrl": "https://example.com/informationUrl/",
+ "owner": "Owner value",
+ "developer": "Developer value",
+ "notes": "Notes value",
+ "uploadState": 11,
+ "publishingState": "processing",
+ "isAssigned": true,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ],
+ "dependentAppCount": 1,
+ "supersedingAppCount": 3,
+ "supersededAppCount": 2
+}
+```
+++++
v1.0 Intune Apps Macosmicrosoftedgeapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmicrosoftedgeapp-create.md
The following table shows the properties that are required when you create the m
|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
-|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`.|
+|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`, `unknownFutureValue`.|
v1.0 Intune Apps Macosmicrosoftedgeapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmicrosoftedgeapp-update.md
The following table shows the properties that are required when you create the [
|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
-|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`.|
+|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`, `unknownFutureValue`.|
v1.0 Intune Apps Windowsmicrosoftedgeapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-windowsmicrosoftedgeapp-create.md
The following table shows the properties that are required when you create the w
|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
-|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`.|
+|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`, `unknownFutureValue`.|
|displayLanguageLocale|String|The language locale to use when the Edge app displays text to the user.|
v1.0 Intune Apps Windowsmicrosoftedgeapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-windowsmicrosoftedgeapp-update.md
The following table shows the properties that are required when you create the [
|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
-|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`.|
+|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`, `unknownFutureValue`.|
|displayLanguageLocale|String|The language locale to use when the Edge app displays text to the user.|
v1.0 Intune Apps Wingetapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-wingetapp-create.md
The following table shows the properties that are required when you create the w
|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|manifestHash|String|Hash of package metadata properties used to validate that the application matches the metadata in the source repository.|
|packageIdentifier|String|The PackageIdentifier from the WinGet source repository REST API. This also maps to the Id when using the WinGet client command line application. Required at creation time, cannot be modified on existing objects.| |installExperience|[winGetAppInstallExperience](../resources/intune-apps-wingetappinstallexperience.md)|The install experience settings associated with this application, which are used to ensure the desired install experiences on the target device are taken into account. This includes the account type (System or User) that actions should be run as on target devices. Required at creation time.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps Content-type: application/json
-Content-length: 943
+Content-length: 985
{ "@odata.type": "#microsoft.graph.winGetApp",
Content-length: 943
"dependentAppCount": 1, "supersedingAppCount": 3, "supersededAppCount": 2,
+ "manifestHash": "Manifest Hash value",
"packageIdentifier": "Package Identifier value", "installExperience": { "@odata.type": "microsoft.graph.winGetAppInstallExperience",
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 1115
+Content-Length: 1157
{ "@odata.type": "#microsoft.graph.winGetApp",
Content-Length: 1115
"dependentAppCount": 1, "supersedingAppCount": 3, "supersededAppCount": 2,
+ "manifestHash": "Manifest Hash value",
"packageIdentifier": "Package Identifier value", "installExperience": { "@odata.type": "microsoft.graph.winGetAppInstallExperience",
v1.0 Intune Apps Wingetapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-wingetapp-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1198
+Content-Length: 1242
{ "value": {
Content-Length: 1198
"dependentAppCount": 1, "supersedingAppCount": 3, "supersededAppCount": 2,
+ "manifestHash": "Manifest Hash value",
"packageIdentifier": "Package Identifier value", "installExperience": { "@odata.type": "microsoft.graph.winGetAppInstallExperience",
v1.0 Intune Apps Wingetapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-wingetapp-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1276
+Content-Length: 1322
{ "value": [
Content-Length: 1276
"dependentAppCount": 1, "supersedingAppCount": 3, "supersededAppCount": 2,
+ "manifestHash": "Manifest Hash value",
"packageIdentifier": "Package Identifier value", "installExperience": { "@odata.type": "microsoft.graph.winGetAppInstallExperience",
v1.0 Intune Apps Wingetapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-wingetapp-update.md
The following table shows the properties that are required when you create the [
|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|manifestHash|String|Hash of package metadata properties used to validate that the application matches the metadata in the source repository.|
|packageIdentifier|String|The PackageIdentifier from the WinGet source repository REST API. This also maps to the Id when using the WinGet client command line application. Required at creation time, cannot be modified on existing objects.| |installExperience|[winGetAppInstallExperience](../resources/intune-apps-wingetappinstallexperience.md)|The install experience settings associated with this application, which are used to ensure the desired install experiences on the target device are taken into account. This includes the account type (System or User) that actions should be run as on target devices. Required at creation time.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId} Content-type: application/json
-Content-length: 943
+Content-length: 985
{ "@odata.type": "#microsoft.graph.winGetApp",
Content-length: 943
"dependentAppCount": 1, "supersedingAppCount": 3, "supersededAppCount": 2,
+ "manifestHash": "Manifest Hash value",
"packageIdentifier": "Package Identifier value", "installExperience": { "@odata.type": "microsoft.graph.winGetAppInstallExperience",
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1115
+Content-Length: 1157
{ "@odata.type": "#microsoft.graph.winGetApp",
Content-Length: 1115
"dependentAppCount": 1, "supersedingAppCount": 3, "supersededAppCount": 2,
+ "manifestHash": "Manifest Hash value",
"packageIdentifier": "Package Identifier value", "installExperience": { "@odata.type": "microsoft.graph.winGetAppInstallExperience",
v1.0 Intune Deviceconfig Androiddeviceownergeneraldeviceconfiguration Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownergeneraldeviceconfiguration-create.md
The following table shows the properties that are required when you create the a
|networkEscapeHatchAllowed|Boolean|Indicates whether or not the device will allow connecting to a temporary network connection at boot time.| |nfcBlockOutgoingBeam|Boolean|Indicates whether or not to block NFC outgoing beam.| |passwordBlockKeyguard|Boolean|Indicates whether or not the keyguard is disabled.|
-|passwordBlockKeyguardFeatures|[androidKeyguardFeature](../resources/intune-deviceconfig-androidkeyguardfeature.md) collection|List of device keyguard features to block. This collection can contain a maximum of 7 elements. Possible values are: `notConfigured`, `camera`, `notifications`, `unredactedNotifications`, `trustAgents`, `fingerprint`, `remoteInput`, `allFeatures`, `face`, `iris`, `biometrics`.|
+|passwordBlockKeyguardFeatures|[androidKeyguardFeature](../resources/intune-deviceconfig-androidkeyguardfeature.md) collection|List of device keyguard features to block. This collection can contain a maximum of 11 elements. Possible values are: `notConfigured`, `camera`, `notifications`, `unredactedNotifications`, `trustAgents`, `fingerprint`, `remoteInput`, `allFeatures`, `face`, `iris`, `biometrics`.|
|passwordExpirationDays|Int32|Indicates the amount of time that a password can be set for before it expires and a new password will be required. Valid values 1 to 365| |passwordMinimumLength|Int32|Indicates the minimum length of the password required on the device. Valid values 4 to 16| |passwordMinimumLetterCharacters|Int32|Indicates the minimum number of letter characters required for device password. Valid values 1 to 16|
v1.0 Intune Deviceconfig Androiddeviceownergeneraldeviceconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfig-androiddeviceownergeneraldeviceconfiguration-update.md
The following table shows the properties that are required when you create the [
|networkEscapeHatchAllowed|Boolean|Indicates whether or not the device will allow connecting to a temporary network connection at boot time.| |nfcBlockOutgoingBeam|Boolean|Indicates whether or not to block NFC outgoing beam.| |passwordBlockKeyguard|Boolean|Indicates whether or not the keyguard is disabled.|
-|passwordBlockKeyguardFeatures|[androidKeyguardFeature](../resources/intune-deviceconfig-androidkeyguardfeature.md) collection|List of device keyguard features to block. This collection can contain a maximum of 7 elements. Possible values are: `notConfigured`, `camera`, `notifications`, `unredactedNotifications`, `trustAgents`, `fingerprint`, `remoteInput`, `allFeatures`, `face`, `iris`, `biometrics`.|
+|passwordBlockKeyguardFeatures|[androidKeyguardFeature](../resources/intune-deviceconfig-androidkeyguardfeature.md) collection|List of device keyguard features to block. This collection can contain a maximum of 11 elements. Possible values are: `notConfigured`, `camera`, `notifications`, `unredactedNotifications`, `trustAgents`, `fingerprint`, `remoteInput`, `allFeatures`, `face`, `iris`, `biometrics`.|
|passwordExpirationDays|Int32|Indicates the amount of time that a password can be set for before it expires and a new password will be required. Valid values 1 to 365| |passwordMinimumLength|Int32|Indicates the minimum length of the password required on the device. Valid values 4 to 16| |passwordMinimumLetterCharacters|Int32|Indicates the minimum number of letter characters required for device password. Valid values 1 to 16|
v1.0 Intune Deviceconfig Devicecompliancepolicy Setscheduledretirestate https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfig-devicecompliancepolicy-setscheduledretirestate.md
The following table shows the parameters that can be used with this action.
|Property|Type|Description| |:|:|:|
+|scopedToAllDevices|Boolean|Not yet documented|
|state|[scheduledRetireState](../resources/intune-deviceconfig-scheduledretirestate.md)|Not yet documented| |managedDeviceIds|String collection|Not yet documented|
Here is an example of the request.
POST https://graph.microsoft.com/beta/deviceManagement/deviceCompliancePolicies/setScheduledRetireState Content-type: application/json
-Content-length: 95
+Content-length: 126
{
+ "scopedToAllDevices": true,
"state": "confirmRetire", "managedDeviceIds": [ "Managed Device Ids value"
v1.0 Intune Deviceconfigv2 Devicemanagementcompliancepolicy Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementcompliancepolicy-create.md
The following table shows the properties that are required when you create the d
|name|String|Policy name| |description|String|Policy description| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this policy. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
|createdDateTime|DateTimeOffset|Policy creation date and time. This property is read-only.| |lastModifiedDateTime|DateTimeOffset|Policy last modification date and time. This property is read-only.| |settingCount|Int32|Number of settings. This property is read-only.|
v1.0 Intune Deviceconfigv2 Devicemanagementcompliancepolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementcompliancepolicy-update.md
The following table shows the properties that are required when you create the [
|name|String|Policy name| |description|String|Policy description| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this policy. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
|createdDateTime|DateTimeOffset|Policy creation date and time. This property is read-only.| |lastModifiedDateTime|DateTimeOffset|Policy last modification date and time. This property is read-only.| |settingCount|Int32|Number of settings. This property is read-only.|
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationcategory Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationcategory-create.md
The following table shows the properties that are required when you create the d
|name|String|Name of the item| |displayName|String|Display name of the item| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms types, which settings in the category have. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies types, which settings in the category have. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies types, which settings in the category have. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicates that the category contains settings that are used for Compliance or Configuration. Possible values are: `none`, `configuration`, `compliance`.| |parentCategoryId|String|Parent id of the category.| |rootCategoryId|String|Root id of the category.|
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationcategory Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationcategory-update.md
The following table shows the properties that are required when you create the [
|name|String|Name of the item| |displayName|String|Display name of the item| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms types, which settings in the category have. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies types, which settings in the category have. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies types, which settings in the category have. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicates that the category contains settings that are used for Compliance or Configuration. Possible values are: `none`, `configuration`, `compliance`.| |parentCategoryId|String|Parent id of the category.| |rootCategoryId|String|Root id of the category.|
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Assign https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-assign.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-POST /deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}/assign
POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assign POST /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId}/assign ```
If successful, this action returns a `200 OK` response code and a [deviceManagem
### Request Here is an example of the request. ``` http
-POST https://graph.microsoft.com/beta/deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}/assign
+POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assign
Content-type: application/json Content-length: 593
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-create.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-POST /deviceManagementConfigurationPolicy
POST /deviceManagement/configurationPolicies POST /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies ```
The following table shows the properties that are required when you create the d
|name|String|Policy name| |description|String|Policy description| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this policy. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
|createdDateTime|DateTimeOffset|Policy creation date and time| |lastModifiedDateTime|DateTimeOffset|Policy last modification date and time| |settingCount|Int32|Number of settings|
If successful, this method returns a `201 Created` response code and a [deviceMa
### Request Here is an example of the request. ``` http
-POST https://graph.microsoft.com/beta/deviceManagementConfigurationPolicy
+POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies
Content-type: application/json
-Content-length: 789
+Content-length: 809
{ "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicy",
Content-length: 789
"templateDisplayVersion": "Template Display Version value" }, "priorityMetaData": {
- "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData"
+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
+ "priority": 8
} } ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 961
+Content-Length: 981
{ "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicy",
Content-Length: 961
"templateDisplayVersion": "Template Display Version value" }, "priorityMetaData": {
- "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData"
+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
+ "priority": 8
} } ```
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Createcopy https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-createcopy.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-POST /deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}/createCopy
POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/createCopy POST /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId}/createCopy ```
If successful, this action returns a `200 OK` response code and a [deviceManagem
### Request Here is an example of the request. ``` http
-POST https://graph.microsoft.com/beta/deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}/createCopy
+POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/createCopy
Content-type: application/json Content-length: 82
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1028
+Content-Length: 1050
{ "value": {
Content-Length: 1028
"templateDisplayVersion": "Template Display Version value" }, "priorityMetaData": {
- "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData"
+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
+ "priority": 8
} } }
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-delete.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-DELETE /deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}
DELETE /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId} DELETE /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId} ```
If successful, this method returns a `204 No Content` response code.
### Request Here is an example of the request. ``` http
-DELETE https://graph.microsoft.com/beta/deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}
+DELETE https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}
``` ### Response
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-get.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-GET /deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}
GET /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId} GET /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId} ```
If successful, this method returns a `200 OK` response code and [deviceManagemen
### Request Here is an example of the request. ``` http
-GET https://graph.microsoft.com/beta/deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}
+GET https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}
``` ### Response
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1028
+Content-Length: 1050
{ "value": {
Content-Length: 1028
"templateDisplayVersion": "Template Display Version value" }, "priorityMetaData": {
- "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData"
+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
+ "priority": 8
} } }
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-list.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-GET /deviceManagementConfigurationPolicy
GET /deviceManagement/configurationPolicies GET /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies ```
If successful, this method returns a `200 OK` response code and a collection of
### Request Here is an example of the request. ``` http
-GET https://graph.microsoft.com/beta/deviceManagementConfigurationPolicy
+GET https://graph.microsoft.com/beta/deviceManagement/configurationPolicies
``` ### Response
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1090
+Content-Length: 1114
{ "value": [
Content-Length: 1090
"templateDisplayVersion": "Template Display Version value" }, "priorityMetaData": {
- "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData"
+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
+ "priority": 8
} } ]
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Reorder https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-reorder.md
+
+ Title: "reorder action"
+description: "Not yet documented"
+
+localization_priority: Normal
++
+# reorder action
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Not yet documented
+
+## Prerequisites
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementConfiguration.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementConfiguration.Read.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/reorder
+POST /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId}/reorder
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+In the request body, supply JSON representation of the parameters.
+
+The following table shows the parameters that can be used with this action.
+
+|Property|Type|Description|
+|:|:|:|
+|priority|Int32|Not yet documented|
+++
+## Response
+If successful, this action returns a `204 No Content` response code.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/reorder
+
+Content-type: application/json
+Content-length: 21
+
+{
+ "priority": 8
+}
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 204 No Content
+```
+++++
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-update.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-PATCH /deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}
PATCH /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId} PATCH /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId} ```
The following table shows the properties that are required when you create the [
|name|String|Policy name| |description|String|Policy description| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this policy. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
|createdDateTime|DateTimeOffset|Policy creation date and time| |lastModifiedDateTime|DateTimeOffset|Policy last modification date and time| |settingCount|Int32|Number of settings|
If successful, this method returns a `200 OK` response code and an updated [devi
### Request Here is an example of the request. ``` http
-PATCH https://graph.microsoft.com/beta/deviceManagementConfigurationPolicy/{deviceManagementConfigurationPolicyId}
+PATCH https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}
Content-type: application/json
-Content-length: 789
+Content-length: 809
{ "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicy",
Content-length: 789
"templateDisplayVersion": "Template Display Version value" }, "priorityMetaData": {
- "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData"
+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
+ "priority": 8
} } ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 961
+Content-Length: 981
{ "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicy",
Content-Length: 961
"templateDisplayVersion": "Template Display Version value" }, "priorityMetaData": {
- "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData"
+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
+ "priority": 8
} } ```
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicytemplate Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicytemplate-create.md
The following table shows the properties that are required when you create the d
|displayVersion|String|Description of template version| |lifecycleState|[deviceManagementTemplateLifecycleState](../resources/intune-deviceconfigv2-devicemanagementtemplatelifecyclestate.md)|Indicate current lifecycle state of template. Possible values are: `invalid`, `draft`, `active`, `superseded`, `deprecated`, `retired`.| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this template. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this template. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
-|templateFamily|[deviceManagementConfigurationTemplateFamily](../resources/intune-deviceconfigv2-devicemanagementconfigurationtemplatefamily.md)|TemplateFamily for this template. Possible values are: `none`, `endpointSecurityAntivirus`, `endpointSecurityDiskEncryption`, `endpointSecurityFirewall`, `endpointSecurityEndpointDetectionAndResponse`, `endpointSecurityAttackSurfaceReduction`, `endpointSecurityAccountProtection`, `endpointSecurityApplicationControl`, `enrollmentConfiguration`, `baseline`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this template. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
+|templateFamily|[deviceManagementConfigurationTemplateFamily](../resources/intune-deviceconfigv2-devicemanagementconfigurationtemplatefamily.md)|TemplateFamily for this template. Possible values are: `none`, `endpointSecurityAntivirus`, `endpointSecurityDiskEncryption`, `endpointSecurityFirewall`, `endpointSecurityEndpointDetectionAndResponse`, `endpointSecurityAttackSurfaceReduction`, `endpointSecurityAccountProtection`, `endpointSecurityApplicationControl`, `endpointSecurityEndpointPrivilegeManagement`, `enrollmentConfiguration`, `appQuietTime`, `baseline`, `unknownFutureValue`.|
|allowUnmanagedSettings|Boolean|Allow unmanaged setting templates| |settingTemplateCount|Int32|Number of setting templates. Valid values 0 to 2147483647. This property is read-only.|
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicytemplate Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicytemplate-update.md
The following table shows the properties that are required when you create the [
|displayVersion|String|Description of template version| |lifecycleState|[deviceManagementTemplateLifecycleState](../resources/intune-deviceconfigv2-devicemanagementtemplatelifecyclestate.md)|Indicate current lifecycle state of template. Possible values are: `invalid`, `draft`, `active`, `superseded`, `deprecated`, `retired`.| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this template. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this template. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
-|templateFamily|[deviceManagementConfigurationTemplateFamily](../resources/intune-deviceconfigv2-devicemanagementconfigurationtemplatefamily.md)|TemplateFamily for this template. Possible values are: `none`, `endpointSecurityAntivirus`, `endpointSecurityDiskEncryption`, `endpointSecurityFirewall`, `endpointSecurityEndpointDetectionAndResponse`, `endpointSecurityAttackSurfaceReduction`, `endpointSecurityAccountProtection`, `endpointSecurityApplicationControl`, `enrollmentConfiguration`, `baseline`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this template. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
+|templateFamily|[deviceManagementConfigurationTemplateFamily](../resources/intune-deviceconfigv2-devicemanagementconfigurationtemplatefamily.md)|TemplateFamily for this template. Possible values are: `none`, `endpointSecurityAntivirus`, `endpointSecurityDiskEncryption`, `endpointSecurityFirewall`, `endpointSecurityEndpointDetectionAndResponse`, `endpointSecurityAttackSurfaceReduction`, `endpointSecurityAccountProtection`, `endpointSecurityApplicationControl`, `endpointSecurityEndpointPrivilegeManagement`, `enrollmentConfiguration`, `appQuietTime`, `baseline`, `unknownFutureValue`.|
|allowUnmanagedSettings|Boolean|Allow unmanaged setting templates| |settingTemplateCount|Int32|Number of setting templates. Valid values 0 to 2147483647. This property is read-only.|
v1.0 Intune Devices Comanagementeligibledevice Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-comanagementeligibledevice-create.md
The following table shows the properties that are required when you create the c
|upn|String|UPN| |userEmail|String|UserEmail| |userName|String|UserName|
-|status|[comanagementEligibleType](../resources/intune-devices-comanagementeligibletype.md)|ComanagementEligibleStatus. Possible values are: `comanaged`, `eligible`, `eligibleButNotAzureAdJoined`, `needsOsUpdate`, `ineligible`, `scheduledForEnrollment`.|
+|status|[comanagementEligibleType](../resources/intune-devices-comanagementeligibletype.md)|ComanagementEligibleStatus. Possible values are: `comanaged`, `eligible`, `eligibleButNotAzureAdJoined`, `needsOsUpdate`, `ineligible`, `scheduledForEnrollment`, `unknownFutureValue`.|
v1.0 Intune Devices Comanagementeligibledevice Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-comanagementeligibledevice-update.md
The following table shows the properties that are required when you create the [
|upn|String|UPN| |userEmail|String|UserEmail| |userName|String|UserName|
-|status|[comanagementEligibleType](../resources/intune-devices-comanagementeligibletype.md)|ComanagementEligibleStatus. Possible values are: `comanaged`, `eligible`, `eligibleButNotAzureAdJoined`, `needsOsUpdate`, `ineligible`, `scheduledForEnrollment`.|
+|status|[comanagementEligibleType](../resources/intune-devices-comanagementeligibletype.md)|ComanagementEligibleStatus. Possible values are: `comanaged`, `eligible`, `eligibleButNotAzureAdJoined`, `needsOsUpdate`, `ineligible`, `scheduledForEnrollment`, `unknownFutureValue`.|
v1.0 Intune Devices Detectedapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-detectedapp-create.md
The following table shows the properties that are required when you create the d
|sizeInByte|Int64|Discovered application size in bytes. Read-only| |deviceCount|Int32|The number of devices that have installed this application| |publisher|String|Indicates the publisher of the discovered application. For example: 'Microsoft'. The default value is an empty string.|
-|platform|[detectedAppPlatformType](../resources/intune-devices-detectedappplatformtype.md)|Indicates the operating system / platform of the discovered application. Some possible values are Windows, iOS, macOS. The default value is unknown (0). Possible values are: `unknown`, `windows`, `windowsMobile`, `windowsHolographic`, `ios`, `macOS`, `chromeOS`, `androidOSP`, `androidDeviceAdministrator`, `androidWorkProfile`, `androidDedicatedAndFullyManaged`.|
+|platform|[detectedAppPlatformType](../resources/intune-devices-detectedappplatformtype.md)|Indicates the operating system / platform of the discovered application. Some possible values are Windows, iOS, macOS. The default value is unknown (0). Possible values are: `unknown`, `windows`, `windowsMobile`, `windowsHolographic`, `ios`, `macOS`, `chromeOS`, `androidOSP`, `androidDeviceAdministrator`, `androidWorkProfile`, `androidDedicatedAndFullyManaged`, `unknownFutureValue`.|
v1.0 Intune Devices Detectedapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-detectedapp-update.md
The following table shows the properties that are required when you create the [
|sizeInByte|Int64|Discovered application size in bytes. Read-only| |deviceCount|Int32|The number of devices that have installed this application| |publisher|String|Indicates the publisher of the discovered application. For example: 'Microsoft'. The default value is an empty string.|
-|platform|[detectedAppPlatformType](../resources/intune-devices-detectedappplatformtype.md)|Indicates the operating system / platform of the discovered application. Some possible values are Windows, iOS, macOS. The default value is unknown (0). Possible values are: `unknown`, `windows`, `windowsMobile`, `windowsHolographic`, `ios`, `macOS`, `chromeOS`, `androidOSP`, `androidDeviceAdministrator`, `androidWorkProfile`, `androidDedicatedAndFullyManaged`.|
+|platform|[detectedAppPlatformType](../resources/intune-devices-detectedappplatformtype.md)|Indicates the operating system / platform of the discovered application. Some possible values are Windows, iOS, macOS. The default value is unknown (0). Possible values are: `unknown`, `windows`, `windowsMobile`, `windowsHolographic`, `ios`, `macOS`, `chromeOS`, `androidOSP`, `androidDeviceAdministrator`, `androidWorkProfile`, `androidDedicatedAndFullyManaged`, `unknownFutureValue`.|
v1.0 Intune Devices Devicelogcollectionresponse Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-devicelogcollectionresponse-create.md
The following table shows the properties that are required when you create the d
|initiatedByUserPrincipalName|String|The UPN for who initiated the request| |expirationDateTimeUTC|DateTimeOffset|The DateTime of the expiration of the logs| |size|Double|The size of the logs. Valid values -1.79769313486232E+308 to 1.79769313486232E+308|
+|enrolledByUser|String|The User Principal Name (UPN) of the user that enrolled the device|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/logCollectionRequests Content-type: application/json
-Content-length: 479
+Content-length: 526
{ "@odata.type": "#microsoft.graph.deviceLogCollectionResponse",
Content-length: 479
"receivedDateTimeUTC": "2016-12-31T23:59:48.6545758-08:00", "initiatedByUserPrincipalName": "Initiated By User Principal Name value", "expirationDateTimeUTC": "2017-01-01T00:02:49.2157996-08:00",
- "size": 1.3333333333333333
+ "size": 1.3333333333333333,
+ "enrolledByUser": "Enrolled By User value"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 528
+Content-Length: 575
{ "@odata.type": "#microsoft.graph.deviceLogCollectionResponse",
Content-Length: 528
"receivedDateTimeUTC": "2016-12-31T23:59:48.6545758-08:00", "initiatedByUserPrincipalName": "Initiated By User Principal Name value", "expirationDateTimeUTC": "2017-01-01T00:02:49.2157996-08:00",
- "size": 1.3333333333333333
+ "size": 1.3333333333333333,
+ "enrolledByUser": "Enrolled By User value"
} ```
v1.0 Intune Devices Devicelogcollectionresponse Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-devicelogcollectionresponse-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 567
+Content-Length: 616
{ "value": {
Content-Length: 567
"receivedDateTimeUTC": "2016-12-31T23:59:48.6545758-08:00", "initiatedByUserPrincipalName": "Initiated By User Principal Name value", "expirationDateTimeUTC": "2017-01-01T00:02:49.2157996-08:00",
- "size": 1.3333333333333333
+ "size": 1.3333333333333333,
+ "enrolledByUser": "Enrolled By User value"
} } ```
v1.0 Intune Devices Devicelogcollectionresponse List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-devicelogcollectionresponse-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 601
+Content-Length: 652
{ "value": [
Content-Length: 601
"receivedDateTimeUTC": "2016-12-31T23:59:48.6545758-08:00", "initiatedByUserPrincipalName": "Initiated By User Principal Name value", "expirationDateTimeUTC": "2017-01-01T00:02:49.2157996-08:00",
- "size": 1.3333333333333333
+ "size": 1.3333333333333333,
+ "enrolledByUser": "Enrolled By User value"
} ] }
v1.0 Intune Devices Devicelogcollectionresponse Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-devicelogcollectionresponse-update.md
The following table shows the properties that are required when you create the [
|initiatedByUserPrincipalName|String|The UPN for who initiated the request| |expirationDateTimeUTC|DateTimeOffset|The DateTime of the expiration of the logs| |size|Double|The size of the logs. Valid values -1.79769313486232E+308 to 1.79769313486232E+308|
+|enrolledByUser|String|The User Principal Name (UPN) of the user that enrolled the device|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/logCollectionRequests/{deviceLogCollectionResponseId} Content-type: application/json
-Content-length: 479
+Content-length: 526
{ "@odata.type": "#microsoft.graph.deviceLogCollectionResponse",
Content-length: 479
"receivedDateTimeUTC": "2016-12-31T23:59:48.6545758-08:00", "initiatedByUserPrincipalName": "Initiated By User Principal Name value", "expirationDateTimeUTC": "2017-01-01T00:02:49.2157996-08:00",
- "size": 1.3333333333333333
+ "size": 1.3333333333333333,
+ "enrolledByUser": "Enrolled By User value"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 528
+Content-Length: 575
{ "@odata.type": "#microsoft.graph.deviceLogCollectionResponse",
Content-Length: 528
"receivedDateTimeUTC": "2016-12-31T23:59:48.6545758-08:00", "initiatedByUserPrincipalName": "Initiated By User Principal Name value", "expirationDateTimeUTC": "2017-01-01T00:02:49.2157996-08:00",
- "size": 1.3333333333333333
+ "size": 1.3333333333333333,
+ "enrolledByUser": "Enrolled By User value"
} ```
v1.0 Intune Devices Devicemanagement Getcomanagementeligibledevicessummary https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-devicemanagement-getcomanagementeligibledevicessummary.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 251
+Content-Length: 291
{ "value": { "@odata.type": "microsoft.graph.comanagementEligibleDevicesSummary", "comanagedCount": 14, "eligibleCount": 13,
+ "scheduledForEnrollmentCount": 11,
"eligibleButNotAzureAdJoinedCount": 0, "needsOsUpdateCount": 2, "ineligibleCount": 15
v1.0 Intune Devices Devicemanagement Userexperienceanalyticssummarizeddevicescopes https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-devicemanagement-userexperienceanalyticssummarizeddevicescopes.md
+
+ Title: "userExperienceAnalyticsSummarizedDeviceScopes function"
+description: "Not yet documented"
+
+localization_priority: Normal
++
+# userExperienceAnalyticsSummarizedDeviceScopes function
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Not yet documented
+
+## Prerequisites
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementManagedDevices.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementConfiguration.Read.All, DeviceManagementManagedDevices.Read.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /deviceManagement/userExperienceAnalyticsSummarizedDeviceScopes
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this function returns a `200 OK` response code and a [userExperienceAnalyticsDeviceScopeSummary](../resources/intune-devices-userexperienceanalyticsdevicescopesummary.md) in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+GET https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsSummarizedDeviceScopes
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 351
+
+{
+ "value": {
+ "@odata.type": "microsoft.graph.userExperienceAnalyticsDeviceScopeSummary",
+ "totalDeviceScopes": 1,
+ "totalDeviceScopesEnabled": 8,
+ "completedDeviceScopeIds": [
+ "Completed Device Scope Ids value"
+ ],
+ "insufficientDataDeviceScopeIds": [
+ "Insufficient Data Device Scope Ids value"
+ ]
+ }
+}
+```
+++++
v1.0 Intune Devices Manageddevice Createdevicelogcollectionrequest https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-manageddevice-createdevicelogcollectionrequest.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 567
+Content-Length: 616
{ "value": {
Content-Length: 567
"receivedDateTimeUTC": "2016-12-31T23:59:48.6545758-08:00", "initiatedByUserPrincipalName": "Initiated By User Principal Name value", "expirationDateTimeUTC": "2017-01-01T00:02:49.2157996-08:00",
- "size": 1.3333333333333333
+ "size": 1.3333333333333333,
+ "enrolledByUser": "Enrolled By User value"
} } ```
v1.0 Intune Devices Manageddevice Initiatemobiledevicemanagementkeyrecovery https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-manageddevice-initiatemobiledevicemanagementkeyrecovery.md
+
+ Title: "initiateMobileDeviceManagementKeyRecovery action"
+description: "Perform MDM key recovery and TPM attestation"
+
+localization_priority: Normal
++
+# initiateMobileDeviceManagementKeyRecovery action
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Perform MDM key recovery and TPM attestation
+
+## Prerequisites
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementManagedDevices.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementConfiguration.Read.All, DeviceManagementManagedDevices.Read.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceManagement/managedDevices/{managedDeviceId}/initiateMobileDeviceManagementKeyRecovery
+POST /deviceManagement/comanagedDevices/{managedDeviceId}/initiateMobileDeviceManagementKeyRecovery
+POST /deviceManagement/deviceHealthScripts/{deviceHealthScriptId}/deviceRunStates/{deviceHealthScriptDeviceStateId}/managedDevice/initiateMobileDeviceManagementKeyRecovery
+POST /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/initiateMobileDeviceManagementKeyRecovery
+POST /deviceManagement/deviceComplianceScripts/{deviceComplianceScriptId}/deviceRunStates/{deviceComplianceScriptDeviceStateId}/managedDevice/initiateMobileDeviceManagementKeyRecovery
+POST /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/users/{userId}/managedDevices/{managedDeviceId}/initiateMobileDeviceManagementKeyRecovery
+POST /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/detectedApps/{detectedAppId}/managedDevices/{managedDeviceId}/initiateMobileDeviceManagementKeyRecovery
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this action returns a `204 No Content` response code.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/managedDevices/{managedDeviceId}/initiateMobileDeviceManagementKeyRecovery
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 204 No Content
+```
+++++
v1.0 Intune Devices Manageddevice Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-manageddevice-update.md
The following table shows the properties that are required when you create the [
|id|String|Unique Identifier for the device. This property is read-only.| |userId|String|Unique Identifier for the user associated with the device. This property is read-only.| |deviceName|String|Name of the device. This property is read-only.|
-|hardwareInformation|[hardwareInformation](../resources/intune-devices-hardwareinformation.md)|The hardward details for the device. Includes information such as storage space, manufacturer, serial number, etc. This property is read-only.|
+|hardwareInformation|[hardwareInformation](../resources/intune-devices-hardwareinformation.md)|The hardward details for the device. Includes information such as storage space, manufacturer, serial number, etc. Return default value in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only.|
|ownerType|[ownerType](../resources/intune-shared-ownertype.md)|Ownership of the device. Can be 'company' or 'personal'. Possible values are: `unknown`, `company`, `personal`.| |managedDeviceOwnerType|[managedDeviceOwnerType](../resources/intune-shared-manageddeviceownertype.md)|Ownership of the device. Can be 'company' or 'personal'. Possible values are: `unknown`, `company`, `personal`.| |deviceActionResults|[deviceActionResult](../resources/intune-devices-deviceactionresult.md) collection|List of ComplexType deviceActionResult objects. This property is read-only.|
The following table shows the properties that are required when you create the [
|subscriberCarrier|String|Subscriber Carrier. This property is read-only.| |meid|String|MEID. This property is read-only.| |totalStorageSpaceInBytes|Int64|Total Storage in Bytes. This property is read-only.|
-|freeStorageSpaceInBytes|Int64|Free Storage in Bytes. This property is read-only.|
+|freeStorageSpaceInBytes|Int64|Free Storage in Bytes. Default value is 0. Read-only. This property is read-only.|
|managedDeviceName|String|Automatically generated name to identify a device. Can be overwritten to a user friendly name.| |partnerReportedThreatState|[managedDevicePartnerReportedHealthState](../resources/intune-devices-manageddevicepartnerreportedhealthstate.md)|Indicates the threat state of a device when a Mobile Threat Defense partner is in use by the account and device. Read Only. This property is read-only. Possible values are: `unknown`, `activated`, `deactivated`, `secured`, `lowSeverity`, `mediumSeverity`, `highSeverity`, `unresponsive`, `compromised`, `misconfigured`.| |retireAfterDateTime|DateTimeOffset|Indicates the time after when a device will be auto retired because of scheduled action. This property is read-only.|
The following table shows the properties that are required when you create the [
|autopilotEnrolled|Boolean|Reports if the managed device is enrolled via auto-pilot. This property is read-only.| |requireUserEnrollmentApproval|Boolean|Reports if the managed iOS device is user approval enrollment. This property is read-only.| |managementCertificateExpirationDate|DateTimeOffset|Reports device management certificate expiration date. This property is read-only.|
-|iccid|String|Integrated Circuit Card Identifier, it is A SIM card's unique identification number. This property is read-only.|
-|udid|String|Unique Device Identifier for iOS and macOS devices. This property is read-only.|
+|iccid|String|Integrated Circuit Card Identifier, it is A SIM card's unique identification number. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only.|
+|udid|String|Unique Device Identifier for iOS and macOS devices. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only.|
|roleScopeTagIds|String collection|List of Scope Tag IDs for this Device instance.| |windowsActiveMalwareCount|Int32|Count of active malware for this windows device. This property is read-only.| |windowsRemediatedMalwareCount|Int32|Count of remediated malware for this windows device. This property is read-only.|
-|notes|String|Notes on the device created by IT Admin|
+|notes|String|Notes on the device created by IT Admin. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported.|
|configurationManagerClientHealthState|[configurationManagerClientHealthState](../resources/intune-devices-configurationmanagerclienthealthstate.md)|Configuration manager client health state, valid only for devices managed by MDM/ConfigMgr Agent| |configurationManagerClientInformation|[configurationManagerClientInformation](../resources/intune-devices-configurationmanagerclientinformation.md)|Configuration manager client information, valid only for devices managed, duel-managed or tri-managed by ConfigMgr Agent| |ethernetMacAddress|String|Ethernet MAC. This property is read-only.|
-|physicalMemoryInBytes|Int64|Total Memory in Bytes. This property is read-only.|
+|physicalMemoryInBytes|Int64|Total Memory in Bytes. Return default value 0 in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. Default value is 0. Read-only. This property is read-only.|
|processorArchitecture|[managedDeviceArchitecture](../resources/intune-devices-manageddevicearchitecture.md)|Processor architecture. This property is read-only. Possible values are: `unknown`, `x86`, `x64`, `arm`, `arM64`.| |specificationVersion|String|Specification version. This property is read-only.| |joinType|[joinType](../resources/intune-devices-jointype.md)|Device join type. Possible values are: `unknown`, `azureADJoined`, `azureADRegistered`, `hybridAzureADJoined`.| |skuFamily|String|Device sku family|
-|skuNumber|Int32|Device sku number, see also: https://docs.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only.|
+|skuNumber|Int32|Device sku number, see also: https://learn.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only.|
|managementFeatures|[managedDeviceManagementFeatures](../resources/intune-devices-manageddevicemanagementfeatures.md)|Device management features. Possible values are: `none`, `microsoftManagedDesktop`.| |chromeOSDeviceInfo|[chromeOSDeviceProperty](../resources/intune-devices-chromeosdeviceproperty.md) collection|List of properties of the ChromeOS Device.| |enrollmentProfileName|String|Name of the enrollment profile assigned to the device. Default value is empty string, indicating no enrollment profile was assgined. This property is read-only.|
Content-Length: 9187
+
v1.0 Intune Devices Remoteactionaudit Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-remoteactionaudit-create.md
The following table shows the properties that are required when you create the r
|deviceDisplayName|String|Intune device name.| |userName|String|\[deprecated\] Please use InitiatedByUserPrincipalName instead.| |initiatedByUserPrincipalName|String|User who initiated the device action, format is UPN.|
-|action|[remoteAction](../resources/intune-devices-remoteaction.md)|The action name. Possible values are: `unknown`, `factoryReset`, `removeCompanyData`, `resetPasscode`, `remoteLock`, `enableLostMode`, `disableLostMode`, `locateDevice`, `rebootNow`, `recoverPasscode`, `cleanWindowsDevice`, `logoutSharedAppleDeviceActiveUser`, `quickScan`, `fullScan`, `windowsDefenderUpdateSignatures`, `factoryResetKeepEnrollmentData`, `updateDeviceAccount`, `automaticRedeployment`, `shutDown`, `rotateBitLockerKeys`, `rotateFileVaultKey`, `getFileVaultKey`, `setDeviceName`, `activateDeviceEsim`, `deprovision`, `disable`, `reenable`, `moveDeviceToOrganizationalUnit`.|
+|action|[remoteAction](../resources/intune-devices-remoteaction.md)|The action name. Possible values are: `unknown`, `factoryReset`, `removeCompanyData`, `resetPasscode`, `remoteLock`, `enableLostMode`, `disableLostMode`, `locateDevice`, `rebootNow`, `recoverPasscode`, `cleanWindowsDevice`, `logoutSharedAppleDeviceActiveUser`, `quickScan`, `fullScan`, `windowsDefenderUpdateSignatures`, `factoryResetKeepEnrollmentData`, `updateDeviceAccount`, `automaticRedeployment`, `shutDown`, `rotateBitLockerKeys`, `rotateFileVaultKey`, `getFileVaultKey`, `setDeviceName`, `activateDeviceEsim`, `deprovision`, `disable`, `reenable`, `moveDeviceToOrganizationalUnit`, `initiateMobileDeviceManagementKeyRecovery`.|
|requestDateTime|DateTimeOffset|Time when the action was issued, given in UTC.| |deviceOwnerUserPrincipalName|String|Upn of the device owner.| |deviceIMEI|String|IMEI of the device.|
v1.0 Intune Devices Remoteactionaudit Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-remoteactionaudit-update.md
The following table shows the properties that are required when you create the [
|deviceDisplayName|String|Intune device name.| |userName|String|\[deprecated\] Please use InitiatedByUserPrincipalName instead.| |initiatedByUserPrincipalName|String|User who initiated the device action, format is UPN.|
-|action|[remoteAction](../resources/intune-devices-remoteaction.md)|The action name. Possible values are: `unknown`, `factoryReset`, `removeCompanyData`, `resetPasscode`, `remoteLock`, `enableLostMode`, `disableLostMode`, `locateDevice`, `rebootNow`, `recoverPasscode`, `cleanWindowsDevice`, `logoutSharedAppleDeviceActiveUser`, `quickScan`, `fullScan`, `windowsDefenderUpdateSignatures`, `factoryResetKeepEnrollmentData`, `updateDeviceAccount`, `automaticRedeployment`, `shutDown`, `rotateBitLockerKeys`, `rotateFileVaultKey`, `getFileVaultKey`, `setDeviceName`, `activateDeviceEsim`, `deprovision`, `disable`, `reenable`, `moveDeviceToOrganizationalUnit`.|
+|action|[remoteAction](../resources/intune-devices-remoteaction.md)|The action name. Possible values are: `unknown`, `factoryReset`, `removeCompanyData`, `resetPasscode`, `remoteLock`, `enableLostMode`, `disableLostMode`, `locateDevice`, `rebootNow`, `recoverPasscode`, `cleanWindowsDevice`, `logoutSharedAppleDeviceActiveUser`, `quickScan`, `fullScan`, `windowsDefenderUpdateSignatures`, `factoryResetKeepEnrollmentData`, `updateDeviceAccount`, `automaticRedeployment`, `shutDown`, `rotateBitLockerKeys`, `rotateFileVaultKey`, `getFileVaultKey`, `setDeviceName`, `activateDeviceEsim`, `deprovision`, `disable`, `reenable`, `moveDeviceToOrganizationalUnit`, `initiateMobileDeviceManagementKeyRecovery`.|
|requestDateTime|DateTimeOffset|Time when the action was issued, given in UTC.| |deviceOwnerUserPrincipalName|String|Upn of the device owner.| |deviceIMEI|String|IMEI of the device.|
v1.0 Intune Devices Userexperienceanalyticsmetric Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-userexperienceanalyticsmetric-create.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-POST /deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression
-POST /deviceManagement/userExperienceAnalyticsRegressionSummary/manufacturerRegression
-POST /deviceManagement/userExperienceAnalyticsRegressionSummary/operatingSystemRegression
POST /deviceManagement/userExperienceAnalyticsBaselines/{userExperienceAnalyticsBaselineId}/deviceBootPerformanceMetrics/metricValues ```
If successful, this method returns a `201 Created` response code and a [userExpe
### Request Here is an example of the request. ``` http
-POST https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression
+POST https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsBaselines/{userExperienceAnalyticsBaselineId}/deviceBootPerformanceMetrics/metricValues
Content-type: application/json Content-length: 128
v1.0 Intune Devices Userexperienceanalyticsmetric Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-userexperienceanalyticsmetric-delete.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-DELETE /deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression/{userExperienceAnalyticsMetricId}
-DELETE /deviceManagement/userExperienceAnalyticsRegressionSummary/manufacturerRegression/{userExperienceAnalyticsMetricId}
-DELETE /deviceManagement/userExperienceAnalyticsRegressionSummary/operatingSystemRegression/{userExperienceAnalyticsMetricId}
DELETE /deviceManagement/userExperienceAnalyticsMetricHistory/{userExperienceAnalyticsMetricHistoryId}/userExperienceAnalyticsMetric DELETE /deviceManagement/userExperienceAnalyticsBaselines/{userExperienceAnalyticsBaselineId}/deviceBootPerformanceMetrics/metricValues/{userExperienceAnalyticsMetricId} ```
If successful, this method returns a `204 No Content` response code.
### Request Here is an example of the request. ``` http
-DELETE https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression/{userExperienceAnalyticsMetricId}
+DELETE https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsMetricHistory/{userExperienceAnalyticsMetricHistoryId}/userExperienceAnalyticsMetric
``` ### Response
v1.0 Intune Devices Userexperienceanalyticsmetric Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-userexperienceanalyticsmetric-get.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-GET /deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression/{userExperienceAnalyticsMetricId}
-GET /deviceManagement/userExperienceAnalyticsRegressionSummary/manufacturerRegression/{userExperienceAnalyticsMetricId}
-GET /deviceManagement/userExperienceAnalyticsRegressionSummary/operatingSystemRegression/{userExperienceAnalyticsMetricId}
GET /deviceManagement/userExperienceAnalyticsMetricHistory/{userExperienceAnalyticsMetricHistoryId}/userExperienceAnalyticsMetric GET /deviceManagement/userExperienceAnalyticsBaselines/{userExperienceAnalyticsBaselineId}/deviceBootPerformanceMetrics/metricValues/{userExperienceAnalyticsMetricId} ```
If successful, this method returns a `200 OK` response code and [userExperienceA
### Request Here is an example of the request. ``` http
-GET https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression/{userExperienceAnalyticsMetricId}
+GET https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsMetricHistory/{userExperienceAnalyticsMetricHistoryId}/userExperienceAnalyticsMetric
``` ### Response
v1.0 Intune Devices Userexperienceanalyticsmetric List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-userexperienceanalyticsmetric-list.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-GET /deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression
-GET /deviceManagement/userExperienceAnalyticsRegressionSummary/manufacturerRegression
-GET /deviceManagement/userExperienceAnalyticsRegressionSummary/operatingSystemRegression
GET /deviceManagement/userExperienceAnalyticsBaselines/{userExperienceAnalyticsBaselineId}/deviceBootPerformanceMetrics/metricValues ```
If successful, this method returns a `200 OK` response code and a collection of
### Request Here is an example of the request. ``` http
-GET https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression
+GET https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsBaselines/{userExperienceAnalyticsBaselineId}/deviceBootPerformanceMetrics/metricValues
``` ### Response
v1.0 Intune Devices Userexperienceanalyticsmetric Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-userexperienceanalyticsmetric-update.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-PATCH /deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression/{userExperienceAnalyticsMetricId}
-PATCH /deviceManagement/userExperienceAnalyticsRegressionSummary/manufacturerRegression/{userExperienceAnalyticsMetricId}
-PATCH /deviceManagement/userExperienceAnalyticsRegressionSummary/operatingSystemRegression/{userExperienceAnalyticsMetricId}
PATCH /deviceManagement/userExperienceAnalyticsMetricHistory/{userExperienceAnalyticsMetricHistoryId}/userExperienceAnalyticsMetric PATCH /deviceManagement/userExperienceAnalyticsBaselines/{userExperienceAnalyticsBaselineId}/deviceBootPerformanceMetrics/metricValues/{userExperienceAnalyticsMetricId} ```
If successful, this method returns a `200 OK` response code and an updated [user
### Request Here is an example of the request. ``` http
-PATCH https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsRegressionSummary/modelRegression/{userExperienceAnalyticsMetricId}
+PATCH https://graph.microsoft.com/beta/deviceManagement/userExperienceAnalyticsMetricHistory/{userExperienceAnalyticsMetricHistoryId}/userExperienceAnalyticsMetric
Content-type: application/json Content-length: 128
v1.0 Intune Devices Windowsmanageddevice Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-windowsmanageddevice-create.md
The following table shows the properties that are required when you create the w
|id|String|Unique Identifier for the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |userId|String|Unique Identifier for the user associated with the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |deviceName|String|Name of the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|hardwareInformation|[hardwareInformation](../resources/intune-devices-hardwareinformation.md)|The hardward details for the device. Includes information such as storage space, manufacturer, serial number, etc. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|hardwareInformation|[hardwareInformation](../resources/intune-devices-hardwareinformation.md)|The hardward details for the device. Includes information such as storage space, manufacturer, serial number, etc. Return default value in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|ownerType|[ownerType](../resources/intune-shared-ownertype.md)|Ownership of the device. Can be 'company' or 'personal' Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `company`, `personal`.| |managedDeviceOwnerType|[managedDeviceOwnerType](../resources/intune-shared-manageddeviceownertype.md)|Ownership of the device. Can be 'company' or 'personal' Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `company`, `personal`.| |deviceActionResults|[deviceActionResult](../resources/intune-devices-deviceactionresult.md) collection|List of ComplexType deviceActionResult objects. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
The following table shows the properties that are required when you create the w
|subscriberCarrier|String|Subscriber Carrier. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |meid|String|MEID. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |totalStorageSpaceInBytes|Int64|Total Storage in Bytes. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|freeStorageSpaceInBytes|Int64|Free Storage in Bytes. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|freeStorageSpaceInBytes|Int64|Free Storage in Bytes. Default value is 0. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|managedDeviceName|String|Automatically generated name to identify a device. Can be overwritten to a user friendly name. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |partnerReportedThreatState|[managedDevicePartnerReportedHealthState](../resources/intune-devices-manageddevicepartnerreportedhealthstate.md)|Indicates the threat state of a device when a Mobile Threat Defense partner is in use by the account and device. Read Only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `activated`, `deactivated`, `secured`, `lowSeverity`, `mediumSeverity`, `highSeverity`, `unresponsive`, `compromised`, `misconfigured`.| |retireAfterDateTime|DateTimeOffset|Indicates the time after when a device will be auto retired because of scheduled action. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
The following table shows the properties that are required when you create the w
|autopilotEnrolled|Boolean|Reports if the managed device is enrolled via auto-pilot. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |requireUserEnrollmentApproval|Boolean|Reports if the managed iOS device is user approval enrollment. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |managementCertificateExpirationDate|DateTimeOffset|Reports device management certificate expiration date. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|iccid|String|Integrated Circuit Card Identifier, it is A SIM card's unique identification number. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|udid|String|Unique Device Identifier for iOS and macOS devices. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|iccid|String|Integrated Circuit Card Identifier, it is A SIM card's unique identification number. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|udid|String|Unique Device Identifier for iOS and macOS devices. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|roleScopeTagIds|String collection|List of Scope Tag IDs for this Device instance. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |windowsActiveMalwareCount|Int32|Count of active malware for this windows device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |windowsRemediatedMalwareCount|Int32|Count of remediated malware for this windows device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|notes|String|Notes on the device created by IT Admin Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|notes|String|Notes on the device created by IT Admin. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|configurationManagerClientHealthState|[configurationManagerClientHealthState](../resources/intune-devices-configurationmanagerclienthealthstate.md)|Configuration manager client health state, valid only for devices managed by MDM/ConfigMgr Agent Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |configurationManagerClientInformation|[configurationManagerClientInformation](../resources/intune-devices-configurationmanagerclientinformation.md)|Configuration manager client information, valid only for devices managed, duel-managed or tri-managed by ConfigMgr Agent Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |ethernetMacAddress|String|Ethernet MAC. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|physicalMemoryInBytes|Int64|Total Memory in Bytes. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|physicalMemoryInBytes|Int64|Total Memory in Bytes. Return default value 0 in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. Default value is 0. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|processorArchitecture|[managedDeviceArchitecture](../resources/intune-devices-manageddevicearchitecture.md)|Processor architecture. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `x86`, `x64`, `arm`, `arM64`.| |specificationVersion|String|Specification version. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |joinType|[joinType](../resources/intune-devices-jointype.md)|Device join type Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `azureADJoined`, `azureADRegistered`, `hybridAzureADJoined`.| |skuFamily|String|Device sku family Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|skuNumber|Int32|Device sku number, see also: https://docs.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|skuNumber|Int32|Device sku number, see also: https://learn.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|managementFeatures|[managedDeviceManagementFeatures](../resources/intune-devices-manageddevicemanagementfeatures.md)|Device management features Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `none`, `microsoftManagedDesktop`.| |chromeOSDeviceInfo|[chromeOSDeviceProperty](../resources/intune-devices-chromeosdeviceproperty.md) collection|List of properties of the ChromeOS Device. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |enrollmentProfileName|String|Name of the enrollment profile assigned to the device. Default value is empty string, indicating no enrollment profile was assgined. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
Content-Length: 9194
+
v1.0 Intune Devices Windowsmanageddevice Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-devices-windowsmanageddevice-update.md
The following table shows the properties that are required when you create the [
|id|String|Unique Identifier for the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |userId|String|Unique Identifier for the user associated with the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |deviceName|String|Name of the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|hardwareInformation|[hardwareInformation](../resources/intune-devices-hardwareinformation.md)|The hardward details for the device. Includes information such as storage space, manufacturer, serial number, etc. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|hardwareInformation|[hardwareInformation](../resources/intune-devices-hardwareinformation.md)|The hardward details for the device. Includes information such as storage space, manufacturer, serial number, etc. Return default value in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|ownerType|[ownerType](../resources/intune-shared-ownertype.md)|Ownership of the device. Can be 'company' or 'personal' Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `company`, `personal`.| |managedDeviceOwnerType|[managedDeviceOwnerType](../resources/intune-shared-manageddeviceownertype.md)|Ownership of the device. Can be 'company' or 'personal' Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `company`, `personal`.| |deviceActionResults|[deviceActionResult](../resources/intune-devices-deviceactionresult.md) collection|List of ComplexType deviceActionResult objects. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
The following table shows the properties that are required when you create the [
|subscriberCarrier|String|Subscriber Carrier. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |meid|String|MEID. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |totalStorageSpaceInBytes|Int64|Total Storage in Bytes. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|freeStorageSpaceInBytes|Int64|Free Storage in Bytes. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|freeStorageSpaceInBytes|Int64|Free Storage in Bytes. Default value is 0. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|managedDeviceName|String|Automatically generated name to identify a device. Can be overwritten to a user friendly name. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |partnerReportedThreatState|[managedDevicePartnerReportedHealthState](../resources/intune-devices-manageddevicepartnerreportedhealthstate.md)|Indicates the threat state of a device when a Mobile Threat Defense partner is in use by the account and device. Read Only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `activated`, `deactivated`, `secured`, `lowSeverity`, `mediumSeverity`, `highSeverity`, `unresponsive`, `compromised`, `misconfigured`.| |retireAfterDateTime|DateTimeOffset|Indicates the time after when a device will be auto retired because of scheduled action. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
The following table shows the properties that are required when you create the [
|autopilotEnrolled|Boolean|Reports if the managed device is enrolled via auto-pilot. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |requireUserEnrollmentApproval|Boolean|Reports if the managed iOS device is user approval enrollment. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |managementCertificateExpirationDate|DateTimeOffset|Reports device management certificate expiration date. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|iccid|String|Integrated Circuit Card Identifier, it is A SIM card's unique identification number. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|udid|String|Unique Device Identifier for iOS and macOS devices. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|iccid|String|Integrated Circuit Card Identifier, it is A SIM card's unique identification number. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|udid|String|Unique Device Identifier for iOS and macOS devices. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|roleScopeTagIds|String collection|List of Scope Tag IDs for this Device instance. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |windowsActiveMalwareCount|Int32|Count of active malware for this windows device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |windowsRemediatedMalwareCount|Int32|Count of remediated malware for this windows device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|notes|String|Notes on the device created by IT Admin Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|notes|String|Notes on the device created by IT Admin. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|configurationManagerClientHealthState|[configurationManagerClientHealthState](../resources/intune-devices-configurationmanagerclienthealthstate.md)|Configuration manager client health state, valid only for devices managed by MDM/ConfigMgr Agent Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |configurationManagerClientInformation|[configurationManagerClientInformation](../resources/intune-devices-configurationmanagerclientinformation.md)|Configuration manager client information, valid only for devices managed, duel-managed or tri-managed by ConfigMgr Agent Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |ethernetMacAddress|String|Ethernet MAC. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|physicalMemoryInBytes|Int64|Total Memory in Bytes. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|physicalMemoryInBytes|Int64|Total Memory in Bytes. Return default value 0 in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. Default value is 0. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|processorArchitecture|[managedDeviceArchitecture](../resources/intune-devices-manageddevicearchitecture.md)|Processor architecture. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `x86`, `x64`, `arm`, `arM64`.| |specificationVersion|String|Specification version. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |joinType|[joinType](../resources/intune-devices-jointype.md)|Device join type Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `azureADJoined`, `azureADRegistered`, `hybridAzureADJoined`.| |skuFamily|String|Device sku family Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|skuNumber|Int32|Device sku number, see also: https://docs.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|skuNumber|Int32|Device sku number, see also: https://learn.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|managementFeatures|[managedDeviceManagementFeatures](../resources/intune-devices-manageddevicemanagementfeatures.md)|Device management features Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `none`, `microsoftManagedDesktop`.| |chromeOSDeviceInfo|[chromeOSDeviceProperty](../resources/intune-devices-chromeosdeviceproperty.md) collection|List of properties of the ChromeOS Device. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |enrollmentProfileName|String|Name of the enrollment profile assigned to the device. Default value is empty string, indicating no enrollment profile was assgined. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
Content-Length: 9194
+
v1.0 Intune Enrollment Depenrollmentprofile Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-enrollment-depenrollmentprofile-create.md
The following table shows the properties that are required when you create the d
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information.|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information.|
|supportDepartment|String|Support department information| |passCodeDisabled|Boolean|Indicates if Passcode setup pane is disabled| |isMandatory|Boolean|Indicates if the profile is mandatory|
Content-Length: 1403
+
v1.0 Intune Enrollment Depenrollmentprofile Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-enrollment-depenrollmentprofile-update.md
The following table shows the properties that are required when you create the [
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information.|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information.|
|supportDepartment|String|Support department information| |passCodeDisabled|Boolean|Indicates if Passcode setup pane is disabled| |isMandatory|Boolean|Indicates if the profile is mandatory|
Content-Length: 1403
+
v1.0 Intune Enrollment Depiosenrollmentprofile Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-enrollment-depiosenrollmentprofile-create.md
The following table shows the properties that are required when you create the d
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
|supportDepartment|String|Support department information Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |isMandatory|Boolean|Indicates if the profile is mandatory Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |locationDisabled|Boolean|Indicates if Location service setup pane is disabled Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
The following table shows the properties that are required when you create the d
|userSessionTimeoutInSeconds|Int32|Indicates timeout of temporary session| |passcodeLockGracePeriodInSeconds|Int32|Indicates timeout before locked screen requires the user to enter the device passocde to unlock it| |carrierActivationUrl|String|Carrier URL for activating device eSIM.|
-|userlessSharedAadModeEnabled|Boolean|Indicates that this apple device is designated to support 'shared device mode' scenarios. This is distinct from the 'shared iPad' scenario. See https://docs.microsoft.com/mem/intune/enrollment/device-enrollment-shared-ios|
+|userlessSharedAadModeEnabled|Boolean|Indicates that this apple device is designated to support 'shared device mode' scenarios. This is distinct from the 'shared iPad' scenario. See https://learn.microsoft.com/mem/intune/enrollment/device-enrollment-shared-ios|
Content-Length: 2426
+
v1.0 Intune Enrollment Depiosenrollmentprofile Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-enrollment-depiosenrollmentprofile-update.md
The following table shows the properties that are required when you create the [
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
|supportDepartment|String|Support department information Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |isMandatory|Boolean|Indicates if the profile is mandatory Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |locationDisabled|Boolean|Indicates if Location service setup pane is disabled Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
The following table shows the properties that are required when you create the [
|userSessionTimeoutInSeconds|Int32|Indicates timeout of temporary session| |passcodeLockGracePeriodInSeconds|Int32|Indicates timeout before locked screen requires the user to enter the device passocde to unlock it| |carrierActivationUrl|String|Carrier URL for activating device eSIM.|
-|userlessSharedAadModeEnabled|Boolean|Indicates that this apple device is designated to support 'shared device mode' scenarios. This is distinct from the 'shared iPad' scenario. See https://docs.microsoft.com/mem/intune/enrollment/device-enrollment-shared-ios|
+|userlessSharedAadModeEnabled|Boolean|Indicates that this apple device is designated to support 'shared device mode' scenarios. This is distinct from the 'shared iPad' scenario. See https://learn.microsoft.com/mem/intune/enrollment/device-enrollment-shared-ios|
Content-Length: 2426
+
v1.0 Intune Enrollment Depmacosenrollmentprofile Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-enrollment-depmacosenrollmentprofile-create.md
The following table shows the properties that are required when you create the d
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
|supportDepartment|String|Support department information Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |isMandatory|Boolean|Indicates if the profile is mandatory Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |locationDisabled|Boolean|Indicates if Location service setup pane is disabled Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
Content-Length: 1993
+
v1.0 Intune Enrollment Depmacosenrollmentprofile Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-enrollment-depmacosenrollmentprofile-update.md
The following table shows the properties that are required when you create the [
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
|supportDepartment|String|Support department information Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |isMandatory|Boolean|Indicates if the profile is mandatory Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)| |locationDisabled|Boolean|Indicates if Location service setup pane is disabled Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
Content-Length: 1993
+
v1.0 Intune Gpanalyticsservice Grouppolicymigrationreport Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-gpanalyticsservice-grouppolicymigrationreport-create.md
The following table shows the properties that are required when you create the g
|totalSettingsCount|Int32|The total number of Group Policy Settings from GPO file.| |supportedSettingsCount|Int32|The number of Group Policy Settings supported by Intune.| |supportedSettingsPercent|Int32|The Percentage of Group Policy Settings supported by Intune.|
+|roleScopeTagIds|String collection|The list of scope tags for the configuration.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/groupPolicyMigrationReports Content-type: application/json
-Content-length: 544
+Content-length: 606
{ "@odata.type": "#microsoft.graph.groupPolicyMigrationReport",
Content-length: 544
"targetedInActiveDirectory": true, "totalSettingsCount": 2, "supportedSettingsCount": 6,
- "supportedSettingsPercent": 8
+ "supportedSettingsPercent": 8,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 716
+Content-Length: 778
{ "@odata.type": "#microsoft.graph.groupPolicyMigrationReport",
Content-Length: 716
"targetedInActiveDirectory": true, "totalSettingsCount": 2, "supportedSettingsCount": 6,
- "supportedSettingsPercent": 8
+ "supportedSettingsPercent": 8,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ```
v1.0 Intune Gpanalyticsservice Grouppolicymigrationreport Createmigrationreport https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-gpanalyticsservice-grouppolicymigrationreport-createmigrationreport.md
Here is an example of the request.
POST https://graph.microsoft.com/beta/deviceManagement/groupPolicyMigrationReports/createMigrationReport Content-type: application/json
-Content-length: 438
+Content-length: 506
{ "groupPolicyObjectFile": {
Content-length: 438
"ouDistinguishedName": "Ou Distinguished Name value", "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "content": "Content value"
+ "content": "Content value",
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} } ```
v1.0 Intune Gpanalyticsservice Grouppolicymigrationreport Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-gpanalyticsservice-grouppolicymigrationreport-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 763
+Content-Length: 831
{ "value": {
Content-Length: 763
"targetedInActiveDirectory": true, "totalSettingsCount": 2, "supportedSettingsCount": 6,
- "supportedSettingsPercent": 8
+ "supportedSettingsPercent": 8,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} } ```
v1.0 Intune Gpanalyticsservice Grouppolicymigrationreport List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-gpanalyticsservice-grouppolicymigrationreport-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 805
+Content-Length: 879
{ "value": [
Content-Length: 805
"targetedInActiveDirectory": true, "totalSettingsCount": 2, "supportedSettingsCount": 6,
- "supportedSettingsPercent": 8
+ "supportedSettingsPercent": 8,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ] }
v1.0 Intune Gpanalyticsservice Grouppolicymigrationreport Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-gpanalyticsservice-grouppolicymigrationreport-update.md
The following table shows the properties that are required when you create the [
|totalSettingsCount|Int32|The total number of Group Policy Settings from GPO file.| |supportedSettingsCount|Int32|The number of Group Policy Settings supported by Intune.| |supportedSettingsPercent|Int32|The Percentage of Group Policy Settings supported by Intune.|
+|roleScopeTagIds|String collection|The list of scope tags for the configuration.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/groupPolicyMigrationReports/{groupPolicyMigrationReportId} Content-type: application/json
-Content-length: 544
+Content-length: 606
{ "@odata.type": "#microsoft.graph.groupPolicyMigrationReport",
Content-length: 544
"targetedInActiveDirectory": true, "totalSettingsCount": 2, "supportedSettingsCount": 6,
- "supportedSettingsPercent": 8
+ "supportedSettingsPercent": 8,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 716
+Content-Length: 778
{ "@odata.type": "#microsoft.graph.groupPolicyMigrationReport",
Content-Length: 716
"targetedInActiveDirectory": true, "totalSettingsCount": 2, "supportedSettingsCount": 6,
- "supportedSettingsPercent": 8
+ "supportedSettingsPercent": 8,
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ```
v1.0 Intune Gpanalyticsservice Grouppolicyobjectfile Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-gpanalyticsservice-grouppolicyobjectfile-create.md
The following table shows the properties that are required when you create the g
|createdDateTime|DateTimeOffset|The date and time at which the GroupPolicy was first uploaded.| |lastModifiedDateTime|DateTimeOffset|The date and time at which the GroupPolicyObjectFile was last modified.| |content|String|The Group Policy Object file content.|
+|roleScopeTagIds|String collection|The list of scope tags for the configuration.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/groupPolicyObjectFiles Content-type: application/json
-Content-length: 217
+Content-length: 279
{ "@odata.type": "#microsoft.graph.groupPolicyObjectFile", "groupPolicyObjectId": "ca1c97af-97af-ca1c-af97-1ccaaf971cca", "ouDistinguishedName": "Ou Distinguished Name value",
- "content": "Content value"
+ "content": "Content value",
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 389
+Content-Length: 451
{ "@odata.type": "#microsoft.graph.groupPolicyObjectFile",
Content-Length: 389
"ouDistinguishedName": "Ou Distinguished Name value", "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "content": "Content value"
+ "content": "Content value",
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ```
v1.0 Intune Gpanalyticsservice Grouppolicyobjectfile Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-gpanalyticsservice-grouppolicyobjectfile-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 422
+Content-Length: 490
{ "value": {
Content-Length: 422
"ouDistinguishedName": "Ou Distinguished Name value", "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "content": "Content value"
+ "content": "Content value",
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} } ```
v1.0 Intune Gpanalyticsservice Grouppolicyobjectfile List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-gpanalyticsservice-grouppolicyobjectfile-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 450
+Content-Length: 524
{ "value": [
Content-Length: 450
"ouDistinguishedName": "Ou Distinguished Name value", "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "content": "Content value"
+ "content": "Content value",
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ] }
v1.0 Intune Gpanalyticsservice Grouppolicyobjectfile Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-gpanalyticsservice-grouppolicyobjectfile-update.md
The following table shows the properties that are required when you create the [
|createdDateTime|DateTimeOffset|The date and time at which the GroupPolicy was first uploaded.| |lastModifiedDateTime|DateTimeOffset|The date and time at which the GroupPolicyObjectFile was last modified.| |content|String|The Group Policy Object file content.|
+|roleScopeTagIds|String collection|The list of scope tags for the configuration.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/groupPolicyObjectFiles/{groupPolicyObjectFileId} Content-type: application/json
-Content-length: 217
+Content-length: 279
{ "@odata.type": "#microsoft.graph.groupPolicyObjectFile", "groupPolicyObjectId": "ca1c97af-97af-ca1c-af97-1ccaaf971cca", "ouDistinguishedName": "Ou Distinguished Name value",
- "content": "Content value"
+ "content": "Content value",
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 389
+Content-Length: 451
{ "@odata.type": "#microsoft.graph.groupPolicyObjectFile",
Content-Length: 389
"ouDistinguishedName": "Ou Distinguished Name value", "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "content": "Content value"
+ "content": "Content value",
+ "roleScopeTagIds": [
+ "Role Scope Tag Ids value"
+ ]
} ```
v1.0 Intune Mam Defaultmanagedappprotection Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-mam-defaultmanagedappprotection-create.md
The following table shows the properties that are required when you create the d
|requireClass3Biometrics|Boolean|Require user to apply Class 3 Biometrics on their Android device.| |requirePinAfterBiometricChange|Boolean|A PIN prompt will override biometric prompts if class 3 biometrics are updated on the device.| |fingerprintAndBiometricEnabled|Boolean|Indicate to the client to enable both biometrics and fingerprints for the app.|
+|minimumWarningSdkVersion|String|Versions less than the specified version will result in warning message on the managed app from accessing company data. (iOS only)|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceAppManagement/defaultManagedAppProtections Content-type: application/json
-Content-length: 5790
+Content-length: 5858
{ "@odata.type": "#microsoft.graph.defaultManagedAppProtection",
Content-length: 5790
"appActionIfDevicePasscodeComplexityLessThanHigh": "wipe", "requireClass3Biometrics": true, "requirePinAfterBiometricChange": true,
- "fingerprintAndBiometricEnabled": true
+ "fingerprintAndBiometricEnabled": true,
+ "minimumWarningSdkVersion": "Minimum Warning Sdk Version value"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 5962
+Content-Length: 6030
{ "@odata.type": "#microsoft.graph.defaultManagedAppProtection",
Content-Length: 5962
"appActionIfDevicePasscodeComplexityLessThanHigh": "wipe", "requireClass3Biometrics": true, "requirePinAfterBiometricChange": true,
- "fingerprintAndBiometricEnabled": true
+ "fingerprintAndBiometricEnabled": true,
+ "minimumWarningSdkVersion": "Minimum Warning Sdk Version value"
} ```
v1.0 Intune Mam Defaultmanagedappprotection Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-mam-defaultmanagedappprotection-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 6243
+Content-Length: 6313
{ "value": {
Content-Length: 6243
"appActionIfDevicePasscodeComplexityLessThanHigh": "wipe", "requireClass3Biometrics": true, "requirePinAfterBiometricChange": true,
- "fingerprintAndBiometricEnabled": true
+ "fingerprintAndBiometricEnabled": true,
+ "minimumWarningSdkVersion": "Minimum Warning Sdk Version value"
} } ```
v1.0 Intune Mam Defaultmanagedappprotection List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-mam-defaultmanagedappprotection-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 6519
+Content-Length: 6591
{ "value": [
Content-Length: 6519
"appActionIfDevicePasscodeComplexityLessThanHigh": "wipe", "requireClass3Biometrics": true, "requirePinAfterBiometricChange": true,
- "fingerprintAndBiometricEnabled": true
+ "fingerprintAndBiometricEnabled": true,
+ "minimumWarningSdkVersion": "Minimum Warning Sdk Version value"
} ] }
v1.0 Intune Mam Defaultmanagedappprotection Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-mam-defaultmanagedappprotection-update.md
The following table shows the properties that are required when you create the [
|requireClass3Biometrics|Boolean|Require user to apply Class 3 Biometrics on their Android device.| |requirePinAfterBiometricChange|Boolean|A PIN prompt will override biometric prompts if class 3 biometrics are updated on the device.| |fingerprintAndBiometricEnabled|Boolean|Indicate to the client to enable both biometrics and fingerprints for the app.|
+|minimumWarningSdkVersion|String|Versions less than the specified version will result in warning message on the managed app from accessing company data. (iOS only)|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceAppManagement/defaultManagedAppProtections/{defaultManagedAppProtectionId} Content-type: application/json
-Content-length: 5790
+Content-length: 5858
{ "@odata.type": "#microsoft.graph.defaultManagedAppProtection",
Content-length: 5790
"appActionIfDevicePasscodeComplexityLessThanHigh": "wipe", "requireClass3Biometrics": true, "requirePinAfterBiometricChange": true,
- "fingerprintAndBiometricEnabled": true
+ "fingerprintAndBiometricEnabled": true,
+ "minimumWarningSdkVersion": "Minimum Warning Sdk Version value"
} ```
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 5962
+Content-Length: 6030
{ "@odata.type": "#microsoft.graph.defaultManagedAppProtection",
Content-Length: 5962
"appActionIfDevicePasscodeComplexityLessThanHigh": "wipe", "requireClass3Biometrics": true, "requirePinAfterBiometricChange": true,
- "fingerprintAndBiometricEnabled": true
+ "fingerprintAndBiometricEnabled": true,
+ "minimumWarningSdkVersion": "Minimum Warning Sdk Version value"
} ```
v1.0 Intune Mam Devicemanagementreports Getmobileapplicationmanagementappconfigurationreport https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-mam-devicemanagementreports-getmobileapplicationmanagementappconfigurationreport.md
+
+ Title: "getMobileApplicationManagementAppConfigurationReport action"
+description: "Not yet documented"
+
+localization_priority: Normal
++
+# getMobileApplicationManagementAppConfigurationReport action
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Not yet documented
+
+## Prerequisites
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceManagement/reports/getMobileApplicationManagementAppConfigurationReport
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+In the request body, supply JSON representation of the parameters.
+
+The following table shows the parameters that can be used with this action.
+
+|Property|Type|Description|
+|:|:|:|
+|name|String|Not yet documented|
+|select|String collection|Not yet documented|
+|search|String|Not yet documented|
+|groupBy|String collection|Not yet documented|
+|orderBy|String collection|Not yet documented|
+|skip|Int32|Not yet documented|
+|top|Int32|Not yet documented|
+|sessionId|String|Not yet documented|
+|filter|String|Not yet documented|
+++
+## Response
+If successful, this action returns a `200 OK` response code and a Stream in the response body.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/reports/getMobileApplicationManagementAppConfigurationReport
+
+Content-type: application/json
+Content-length: 278
+
+{
+ "name": "Name value",
+ "select": [
+ "Select value"
+ ],
+ "search": "Search value",
+ "groupBy": [
+ "Group By value"
+ ],
+ "orderBy": [
+ "Order By value"
+ ],
+ "skip": 4,
+ "top": 3,
+ "sessionId": "Session Id value",
+ "filter": "Filter value"
+}
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+Content-Length: 127
+
+{
+ "value": "Z2V0TW9iaWxlQXBwbGljYXRpb25NYW5hZ2VtZW50QXBwQ29uZmlndXJhdGlvblJlcG9ydCBJbnR1bmUgRG9jIFNhbXBsZSA1NTA5OTkwMDg="
+}
+```
+++++
v1.0 Intune Onboarding Devicemanagementpartner Terminate https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-onboarding-devicemanagementpartner-terminate.md
+
+ Title: "terminate action"
+description: "Not yet documented"
+
+localization_priority: Normal
++
+# terminate action
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Not yet documented
+
+## Prerequisites
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|DeviceManagementServiceConfig.Read.All, DeviceManagementConfiguration.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementServiceConfig.Read.All, DeviceManagementConfiguration.Read.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceManagement/deviceManagementPartners/{deviceManagementPartnerId}/terminate
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this action returns a `204 No Content` response code.
+
+## Example
+
+### Request
+Here is an example of the request.
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/deviceManagementPartners/{deviceManagementPartnerId}/terminate
+```
+
+### Response
+Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
+``` http
+HTTP/1.1 204 No Content
+```
+++++
v1.0 Intune Onboarding Windows10enrollmentcompletionpageconfiguration Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-onboarding-windows10enrollmentcompletionpageconfiguration-create.md
The following table shows the properties that are required when you create the w
|allowDeviceUseOnInstallFailure|Boolean|Allow the user to continue using the device on installation failure| |selectedMobileAppIds|String collection|Selected applications to track the installation status| |allowNonBlockingAppInstallation|Boolean|Install all required apps as non blocking apps during white glove|
+|installQualityUpdates|Boolean|Allows quality updates installation during OOBE|
|trackInstallProgressForAutopilotOnly|Boolean|Only show installation progress for Autopilot enrollment scenarios| |disableUserStatusTrackingAfterFirstUser|Boolean|Only show installation progress for first user post enrollment|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/deviceEnrollmentConfigurations Content-type: application/json
-Content-length: 839
+Content-length: 873
{ "@odata.type": "#microsoft.graph.windows10EnrollmentCompletionPageConfiguration",
Content-length: 839
"Selected Mobile App Ids value" ], "allowNonBlockingAppInstallation": true,
+ "installQualityUpdates": true,
"trackInstallProgressForAutopilotOnly": true, "disableUserStatusTrackingAfterFirstUser": true }
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 1011
+Content-Length: 1045
{ "@odata.type": "#microsoft.graph.windows10EnrollmentCompletionPageConfiguration",
Content-Length: 1011
"Selected Mobile App Ids value" ], "allowNonBlockingAppInstallation": true,
+ "installQualityUpdates": true,
"trackInstallProgressForAutopilotOnly": true, "disableUserStatusTrackingAfterFirstUser": true }
v1.0 Intune Onboarding Windows10enrollmentcompletionpageconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-onboarding-windows10enrollmentcompletionpageconfiguration-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1080
+Content-Length: 1116
{ "value": {
Content-Length: 1080
"Selected Mobile App Ids value" ], "allowNonBlockingAppInstallation": true,
+ "installQualityUpdates": true,
"trackInstallProgressForAutopilotOnly": true, "disableUserStatusTrackingAfterFirstUser": true }
v1.0 Intune Onboarding Windows10enrollmentcompletionpageconfiguration List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-onboarding-windows10enrollmentcompletionpageconfiguration-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1144
+Content-Length: 1182
{ "value": [
Content-Length: 1144
"Selected Mobile App Ids value" ], "allowNonBlockingAppInstallation": true,
+ "installQualityUpdates": true,
"trackInstallProgressForAutopilotOnly": true, "disableUserStatusTrackingAfterFirstUser": true }
v1.0 Intune Onboarding Windows10enrollmentcompletionpageconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-onboarding-windows10enrollmentcompletionpageconfiguration-update.md
The following table shows the properties that are required when you create the [
|allowDeviceUseOnInstallFailure|Boolean|Allow the user to continue using the device on installation failure| |selectedMobileAppIds|String collection|Selected applications to track the installation status| |allowNonBlockingAppInstallation|Boolean|Install all required apps as non blocking apps during white glove|
+|installQualityUpdates|Boolean|Allows quality updates installation during OOBE|
|trackInstallProgressForAutopilotOnly|Boolean|Only show installation progress for Autopilot enrollment scenarios| |disableUserStatusTrackingAfterFirstUser|Boolean|Only show installation progress for first user post enrollment|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/deviceEnrollmentConfigurations/{deviceEnrollmentConfigurationId} Content-type: application/json
-Content-length: 839
+Content-length: 873
{ "@odata.type": "#microsoft.graph.windows10EnrollmentCompletionPageConfiguration",
Content-length: 839
"Selected Mobile App Ids value" ], "allowNonBlockingAppInstallation": true,
+ "installQualityUpdates": true,
"trackInstallProgressForAutopilotOnly": true, "disableUserStatusTrackingAfterFirstUser": true }
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 1011
+Content-Length: 1045
{ "@odata.type": "#microsoft.graph.windows10EnrollmentCompletionPageConfiguration",
Content-Length: 1011
"Selected Mobile App Ids value" ], "allowNonBlockingAppInstallation": true,
+ "installQualityUpdates": true,
"trackInstallProgressForAutopilotOnly": true, "disableUserStatusTrackingAfterFirstUser": true }
v1.0 Intune Partnerintegration Organizationalmessagedetail Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-partnerintegration-organizationalmessagedetail-create.md
- Title: "Create organizationalMessageDetail"
-description: "Create a new organizationalMessageDetail object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Create organizationalMessageDetail
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Create a new [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object.
-
-## Prerequisites
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
-
-## HTTP Request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-POST /deviceManagement/organizationalMessageDetails
-```
-
-## Request headers
-|Header|Value|
-|:|:|
-|Authorization|Bearer &lt;token&gt; Required.|
-|Accept|application/json|
-
-## Request body
-In the request body, supply a JSON representation for the organizationalMessageDetail object.
-
-The following table shows the properties that are required when you create the organizationalMessageDetail.
-
-|Property|Type|Description|
-|:|:|:|
-|id|String|A unique identifier for the organizational message|
-|scenario|[organizationalMessageScenario](../resources/intune-partnerintegration-organizationalmessagescenario.md)|Indicates the scenario for the message. Possible values are: `onboarding`, `lifecycle`, `unknownFutureValue`.|
-|surface|[organizationalMessageSurface](../resources/intune-partnerintegration-organizationalmessagesurface.md)|Indicates the area where content will be displayed to customers. Possible values are: `actionCenter`, `getStarted`, `softLanding`, `unknownFutureValue`.|
-|status|[organizationalMessageStatus](../resources/intune-partnerintegration-organizationalmessagestatus.md)|Indicates the deployment status of the message. Possible values are: `scheduled`, `active`, `completed`, `cancelled`, `unknownFutureValue`.|
-|startDateTime|DateTimeOffset|The date and time of when the message will start being displayed to clients|
-|endDateTime|DateTimeOffset|The date and time of when the message will stop being displayed to clients|
-|createdDateTime|DateTimeOffset|The date and time of when the message was created|
-|lastModifiedDateTime|DateTimeOffset|The date and time of when the message was last modified|
-|userEngagementStatistics|[organizationalMessageInsights](../resources/intune-partnerintegration-organizationalmessageinsights.md)|The statistics containing how the message was interacted with by clients. This includes the number of impressions, clicks, and dismisses from targeted clients.|
-|frequency|[organizationalMessageFrequency](../resources/intune-partnerintegration-organizationalmessagefrequency.md)|The frequency at which a client will see the message. Possible values are: `weeklyOnce`, `monthlyOnce`, `monthlyTwice`, `unknownFutureValue`.|
-|targeting|[organizationalMessageTargeting](../resources/intune-partnerintegration-organizationalmessagetargeting.md)|The groups of devices that will receive the message. This also contains a list of excluded groups that will not receive the message regardless of the device being part of an included group|
-|content|[organizationalMessageContent](../resources/intune-partnerintegration-organizationalmessagecontent.md)|The content that will be displayed to clients for the message. This includes the text portion of the message and the displayed logo|
-|theme|[organizationalMessageTheme](../resources/intune-partnerintegration-organizationalmessagetheme.md)|Indicates the theme for the experience. Possible values are: `update`, `training`, `welcomeToWindows`, `explore`, `unknownFutureValue`.|
-|variant|String|Indicates the corresponding variant for the experience|
---
-## Response
-If successful, this method returns a `201 Created` response code and a [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object in the response body.
-
-## Example
-
-### Request
-Here is an example of the request.
-``` http
-POST https://graph.microsoft.com/beta/deviceManagement/organizationalMessageDetails
-Content-type: application/json
-Content-length: 2049
-
-{
- "@odata.type": "#microsoft.graph.organizationalMessageDetail",
- "scenario": "lifecycle",
- "surface": "getStarted",
- "status": "active",
- "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
- "endDateTime": "2017-01-01T00:03:30.9241974-08:00",
- "userEngagementStatistics": {
- "@odata.type": "microsoft.graph.organizationalMessageInsights",
- "impressions": 11,
- "clicks": 6,
- "dismisses": 9
- },
- "frequency": "monthlyOnce",
- "targeting": {
- "@odata.type": "microsoft.graph.organizationalMessageTargeting",
- "targetingType": "unknownFutureValue",
- "includeIds": [
- "Include Ids value"
- ],
- "excludeIds": [
- "Exclude Ids value"
- ]
- },
- "content": {
- "@odata.type": "microsoft.graph.organizationalMessageContent",
- "guidedContentId": "Guided Content Id value",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logoInfo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogo",
- "logo": "bG9nbw==",
- "contentType": "unknownFutureValue",
- "logoCdnUrl": "https://example.com/logoCdnUrl/"
- }
- },
- "theme": "training",
- "variant": "Variant value"
-}
-```
-
-### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
-``` http
-HTTP/1.1 201 Created
-Content-Type: application/json
-Content-Length: 2221
-
-{
- "@odata.type": "#microsoft.graph.organizationalMessageDetail",
- "id": "affbf3ad-f3ad-affb-adf3-fbafadf3fbaf",
- "scenario": "lifecycle",
- "surface": "getStarted",
- "status": "active",
- "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
- "endDateTime": "2017-01-01T00:03:30.9241974-08:00",
- "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
- "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "userEngagementStatistics": {
- "@odata.type": "microsoft.graph.organizationalMessageInsights",
- "impressions": 11,
- "clicks": 6,
- "dismisses": 9
- },
- "frequency": "monthlyOnce",
- "targeting": {
- "@odata.type": "microsoft.graph.organizationalMessageTargeting",
- "targetingType": "unknownFutureValue",
- "includeIds": [
- "Include Ids value"
- ],
- "excludeIds": [
- "Exclude Ids value"
- ]
- },
- "content": {
- "@odata.type": "microsoft.graph.organizationalMessageContent",
- "guidedContentId": "Guided Content Id value",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logoInfo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogo",
- "logo": "bG9nbw==",
- "contentType": "unknownFutureValue",
- "logoCdnUrl": "https://example.com/logoCdnUrl/"
- }
- },
- "theme": "training",
- "variant": "Variant value"
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessagedetail Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-partnerintegration-organizationalmessagedetail-get.md
- Title: "Get organizationalMessageDetail"
-description: "Read properties and relationships of the organizationalMessageDetail object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Get organizationalMessageDetail
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Read properties and relationships of the [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object.
-
-## Prerequisites
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
-
-## HTTP Request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-GET /deviceManagement/organizationalMessageDetails/{organizationalMessageDetailId}
-```
-
-## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
-
-## Request headers
-|Header|Value|
-|:|:|
-|Authorization|Bearer &lt;token&gt; Required.|
-|Accept|application/json|
-
-## Request body
-Do not supply a request body for this method.
-
-## Response
-If successful, this method returns a `200 OK` response code and [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object in the response body.
-
-## Example
-
-### Request
-Here is an example of the request.
-``` http
-GET https://graph.microsoft.com/beta/deviceManagement/organizationalMessageDetails/{organizationalMessageDetailId}
-```
-
-### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-Content-Length: 2368
-
-{
- "value": {
- "@odata.type": "#microsoft.graph.organizationalMessageDetail",
- "id": "affbf3ad-f3ad-affb-adf3-fbafadf3fbaf",
- "scenario": "lifecycle",
- "surface": "getStarted",
- "status": "active",
- "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
- "endDateTime": "2017-01-01T00:03:30.9241974-08:00",
- "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
- "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "userEngagementStatistics": {
- "@odata.type": "microsoft.graph.organizationalMessageInsights",
- "impressions": 11,
- "clicks": 6,
- "dismisses": 9
- },
- "frequency": "monthlyOnce",
- "targeting": {
- "@odata.type": "microsoft.graph.organizationalMessageTargeting",
- "targetingType": "unknownFutureValue",
- "includeIds": [
- "Include Ids value"
- ],
- "excludeIds": [
- "Exclude Ids value"
- ]
- },
- "content": {
- "@odata.type": "microsoft.graph.organizationalMessageContent",
- "guidedContentId": "Guided Content Id value",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logoInfo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogo",
- "logo": "bG9nbw==",
- "contentType": "unknownFutureValue",
- "logoCdnUrl": "https://example.com/logoCdnUrl/"
- }
- },
- "theme": "training",
- "variant": "Variant value"
- }
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessagedetail List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-partnerintegration-organizationalmessagedetail-list.md
- Title: "List organizationalMessageDetails"
-description: "List properties and relationships of the organizationalMessageDetail objects."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# List organizationalMessageDetails
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-List properties and relationships of the [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) objects.
-
-## Prerequisites
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
-
-## HTTP Request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-GET /deviceManagement/organizationalMessageDetails
-```
-
-## Request headers
-|Header|Value|
-|:|:|
-|Authorization|Bearer &lt;token&gt; Required.|
-|Accept|application/json|
-
-## Request body
-Do not supply a request body for this method.
-
-## Response
-If successful, this method returns a `200 OK` response code and a collection of [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) objects in the response body.
-
-## Example
-
-### Request
-Here is an example of the request.
-``` http
-GET https://graph.microsoft.com/beta/deviceManagement/organizationalMessageDetails
-```
-
-### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-Content-Length: 2510
-
-{
- "value": [
- {
- "@odata.type": "#microsoft.graph.organizationalMessageDetail",
- "id": "affbf3ad-f3ad-affb-adf3-fbafadf3fbaf",
- "scenario": "lifecycle",
- "surface": "getStarted",
- "status": "active",
- "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
- "endDateTime": "2017-01-01T00:03:30.9241974-08:00",
- "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
- "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "userEngagementStatistics": {
- "@odata.type": "microsoft.graph.organizationalMessageInsights",
- "impressions": 11,
- "clicks": 6,
- "dismisses": 9
- },
- "frequency": "monthlyOnce",
- "targeting": {
- "@odata.type": "microsoft.graph.organizationalMessageTargeting",
- "targetingType": "unknownFutureValue",
- "includeIds": [
- "Include Ids value"
- ],
- "excludeIds": [
- "Exclude Ids value"
- ]
- },
- "content": {
- "@odata.type": "microsoft.graph.organizationalMessageContent",
- "guidedContentId": "Guided Content Id value",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logoInfo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogo",
- "logo": "bG9nbw==",
- "contentType": "unknownFutureValue",
- "logoCdnUrl": "https://example.com/logoCdnUrl/"
- }
- },
- "theme": "training",
- "variant": "Variant value"
- }
- ]
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessagedetail Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-partnerintegration-organizationalmessagedetail-update.md
- Title: "Update organizationalMessageDetail"
-description: "Update the properties of a organizationalMessageDetail object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Update organizationalMessageDetail
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Update the properties of a [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object.
-
-## Prerequisites
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
-
-## HTTP Request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-PATCH /deviceManagement/organizationalMessageDetails/{organizationalMessageDetailId}
-```
-
-## Request headers
-|Header|Value|
-|:|:|
-|Authorization|Bearer &lt;token&gt; Required.|
-|Accept|application/json|
-
-## Request body
-In the request body, supply a JSON representation for the [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object.
-
-The following table shows the properties that are required when you create the [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md).
-
-|Property|Type|Description|
-|:|:|:|
-|id|String|A unique identifier for the organizational message|
-|scenario|[organizationalMessageScenario](../resources/intune-partnerintegration-organizationalmessagescenario.md)|Indicates the scenario for the message. Possible values are: `onboarding`, `lifecycle`, `unknownFutureValue`.|
-|surface|[organizationalMessageSurface](../resources/intune-partnerintegration-organizationalmessagesurface.md)|Indicates the area where content will be displayed to customers. Possible values are: `actionCenter`, `getStarted`, `softLanding`, `unknownFutureValue`.|
-|status|[organizationalMessageStatus](../resources/intune-partnerintegration-organizationalmessagestatus.md)|Indicates the deployment status of the message. Possible values are: `scheduled`, `active`, `completed`, `cancelled`, `unknownFutureValue`.|
-|startDateTime|DateTimeOffset|The date and time of when the message will start being displayed to clients|
-|endDateTime|DateTimeOffset|The date and time of when the message will stop being displayed to clients|
-|createdDateTime|DateTimeOffset|The date and time of when the message was created|
-|lastModifiedDateTime|DateTimeOffset|The date and time of when the message was last modified|
-|userEngagementStatistics|[organizationalMessageInsights](../resources/intune-partnerintegration-organizationalmessageinsights.md)|The statistics containing how the message was interacted with by clients. This includes the number of impressions, clicks, and dismisses from targeted clients.|
-|frequency|[organizationalMessageFrequency](../resources/intune-partnerintegration-organizationalmessagefrequency.md)|The frequency at which a client will see the message. Possible values are: `weeklyOnce`, `monthlyOnce`, `monthlyTwice`, `unknownFutureValue`.|
-|targeting|[organizationalMessageTargeting](../resources/intune-partnerintegration-organizationalmessagetargeting.md)|The groups of devices that will receive the message. This also contains a list of excluded groups that will not receive the message regardless of the device being part of an included group|
-|content|[organizationalMessageContent](../resources/intune-partnerintegration-organizationalmessagecontent.md)|The content that will be displayed to clients for the message. This includes the text portion of the message and the displayed logo|
-|theme|[organizationalMessageTheme](../resources/intune-partnerintegration-organizationalmessagetheme.md)|Indicates the theme for the experience. Possible values are: `update`, `training`, `welcomeToWindows`, `explore`, `unknownFutureValue`.|
-|variant|String|Indicates the corresponding variant for the experience|
---
-## Response
-If successful, this method returns a `200 OK` response code and an updated [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object in the response body.
-
-## Example
-
-### Request
-Here is an example of the request.
-``` http
-PATCH https://graph.microsoft.com/beta/deviceManagement/organizationalMessageDetails/{organizationalMessageDetailId}
-Content-type: application/json
-Content-length: 2049
-
-{
- "@odata.type": "#microsoft.graph.organizationalMessageDetail",
- "scenario": "lifecycle",
- "surface": "getStarted",
- "status": "active",
- "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
- "endDateTime": "2017-01-01T00:03:30.9241974-08:00",
- "userEngagementStatistics": {
- "@odata.type": "microsoft.graph.organizationalMessageInsights",
- "impressions": 11,
- "clicks": 6,
- "dismisses": 9
- },
- "frequency": "monthlyOnce",
- "targeting": {
- "@odata.type": "microsoft.graph.organizationalMessageTargeting",
- "targetingType": "unknownFutureValue",
- "includeIds": [
- "Include Ids value"
- ],
- "excludeIds": [
- "Exclude Ids value"
- ]
- },
- "content": {
- "@odata.type": "microsoft.graph.organizationalMessageContent",
- "guidedContentId": "Guided Content Id value",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logoInfo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogo",
- "logo": "bG9nbw==",
- "contentType": "unknownFutureValue",
- "logoCdnUrl": "https://example.com/logoCdnUrl/"
- }
- },
- "theme": "training",
- "variant": "Variant value"
-}
-```
-
-### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-Content-Length: 2221
-
-{
- "@odata.type": "#microsoft.graph.organizationalMessageDetail",
- "id": "affbf3ad-f3ad-affb-adf3-fbafadf3fbaf",
- "scenario": "lifecycle",
- "surface": "getStarted",
- "status": "active",
- "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
- "endDateTime": "2017-01-01T00:03:30.9241974-08:00",
- "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
- "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
- "userEngagementStatistics": {
- "@odata.type": "microsoft.graph.organizationalMessageInsights",
- "impressions": 11,
- "clicks": 6,
- "dismisses": 9
- },
- "frequency": "monthlyOnce",
- "targeting": {
- "@odata.type": "microsoft.graph.organizationalMessageTargeting",
- "targetingType": "unknownFutureValue",
- "includeIds": [
- "Include Ids value"
- ],
- "excludeIds": [
- "Exclude Ids value"
- ]
- },
- "content": {
- "@odata.type": "microsoft.graph.organizationalMessageContent",
- "guidedContentId": "Guided Content Id value",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logoInfo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogo",
- "logo": "bG9nbw==",
- "contentType": "unknownFutureValue",
- "logoCdnUrl": "https://example.com/logoCdnUrl/"
- }
- },
- "theme": "training",
- "variant": "Variant value"
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessageguidedcontent Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-partnerintegration-organizationalmessageguidedcontent-create.md
- Title: "Create organizationalMessageGuidedContent"
-description: "Create a new organizationalMessageGuidedContent object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Create organizationalMessageGuidedContent
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Create a new [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object.
-
-## Prerequisites
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
-
-## HTTP Request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-POST /deviceManagement/organizationalMessageGuidedContents
-```
-
-## Request headers
-|Header|Value|
-|:|:|
-|Authorization|Bearer &lt;token&gt; Required.|
-|Accept|application/json|
-
-## Request body
-In the request body, supply a JSON representation for the organizationalMessageGuidedContent object.
-
-The following table shows the properties that are required when you create the organizationalMessageGuidedContent.
-
-|Property|Type|Description|
-|:|:|:|
-|id|String|A unique identifier for the guided content|
-|scenario|[organizationalMessageScenario](../resources/intune-partnerintegration-organizationalmessagescenario.md)|Indicates the scenario for the guided content. Possible values are: `onboarding`, `lifecycle`, `unknownFutureValue`.|
-|theme|[organizationalMessageTheme](../resources/intune-partnerintegration-organizationalmessagetheme.md)|Indicates the theme for the guided content. Possible values are: `update`, `training`, `welcomeToWindows`, `explore`, `unknownFutureValue`.|
-|surface|[organizationalMessageSurface](../resources/intune-partnerintegration-organizationalmessagesurface.md)|Indicates the area where content will be displayed to customers. Possible values are: `actionCenter`, `getStarted`, `softLanding`, `unknownFutureValue`.|
-|placementDetails|[organizationalMessagePlacementDetail](../resources/intune-partnerintegration-organizationalmessageplacementdetail.md) collection|Contains the different types of text content that can be displayed to customers along with their localized values|
-|logo|[organizationalMessageLogoGuide](../resources/intune-partnerintegration-organizationalmessagelogoguide.md)|Example of the logo that will be displayed to customers and its size requirements|
---
-## Response
-If successful, this method returns a `201 Created` response code and a [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object in the response body.
-
-## Example
-
-### Request
-Here is an example of the request.
-``` http
-POST https://graph.microsoft.com/beta/deviceManagement/organizationalMessageGuidedContents
-Content-type: application/json
-Content-length: 1403
-
-{
- "@odata.type": "#microsoft.graph.organizationalMessageGuidedContent",
- "scenario": "lifecycle",
- "theme": "training",
- "surface": "getStarted",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide",
- "logoCdnUrl": "https://example.com/logoCdnUrl/",
- "assetName": "Asset Name value",
- "dimensions": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",
- "minWidth": 8,
- "maxWidth": 8,
- "minHeight": 9,
- "maxHeight": 9
- }
- }
-}
-```
-
-### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
-``` http
-HTTP/1.1 201 Created
-Content-Type: application/json
-Content-Length: 1452
-
-{
- "@odata.type": "#microsoft.graph.organizationalMessageGuidedContent",
- "id": "13e64843-4843-13e6-4348-e6134348e613",
- "scenario": "lifecycle",
- "theme": "training",
- "surface": "getStarted",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide",
- "logoCdnUrl": "https://example.com/logoCdnUrl/",
- "assetName": "Asset Name value",
- "dimensions": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",
- "minWidth": 8,
- "maxWidth": 8,
- "minHeight": 9,
- "maxHeight": 9
- }
- }
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessageguidedcontent Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-partnerintegration-organizationalmessageguidedcontent-get.md
- Title: "Get organizationalMessageGuidedContent"
-description: "Read properties and relationships of the organizationalMessageGuidedContent object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Get organizationalMessageGuidedContent
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Read properties and relationships of the [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object.
-
-## Prerequisites
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
-
-## HTTP Request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-GET /deviceManagement/organizationalMessageGuidedContents/{organizationalMessageGuidedContentId}
-```
-
-## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
-
-## Request headers
-|Header|Value|
-|:|:|
-|Authorization|Bearer &lt;token&gt; Required.|
-|Accept|application/json|
-
-## Request body
-Do not supply a request body for this method.
-
-## Response
-If successful, this method returns a `200 OK` response code and [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object in the response body.
-
-## Example
-
-### Request
-Here is an example of the request.
-``` http
-GET https://graph.microsoft.com/beta/deviceManagement/organizationalMessageGuidedContents/{organizationalMessageGuidedContentId}
-```
-
-### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-Content-Length: 1557
-
-{
- "value": {
- "@odata.type": "#microsoft.graph.organizationalMessageGuidedContent",
- "id": "13e64843-4843-13e6-4348-e6134348e613",
- "scenario": "lifecycle",
- "theme": "training",
- "surface": "getStarted",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide",
- "logoCdnUrl": "https://example.com/logoCdnUrl/",
- "assetName": "Asset Name value",
- "dimensions": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",
- "minWidth": 8,
- "maxWidth": 8,
- "minHeight": 9,
- "maxHeight": 9
- }
- }
- }
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessageguidedcontent List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-partnerintegration-organizationalmessageguidedcontent-list.md
- Title: "List organizationalMessageGuidedContents"
-description: "List properties and relationships of the organizationalMessageGuidedContent objects."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# List organizationalMessageGuidedContents
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-List properties and relationships of the [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) objects.
-
-## Prerequisites
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|
-
-## HTTP Request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-GET /deviceManagement/organizationalMessageGuidedContents
-```
-
-## Request headers
-|Header|Value|
-|:|:|
-|Authorization|Bearer &lt;token&gt; Required.|
-|Accept|application/json|
-
-## Request body
-Do not supply a request body for this method.
-
-## Response
-If successful, this method returns a `200 OK` response code and a collection of [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) objects in the response body.
-
-## Example
-
-### Request
-Here is an example of the request.
-``` http
-GET https://graph.microsoft.com/beta/deviceManagement/organizationalMessageGuidedContents
-```
-
-### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-Content-Length: 1657
-
-{
- "value": [
- {
- "@odata.type": "#microsoft.graph.organizationalMessageGuidedContent",
- "id": "13e64843-4843-13e6-4348-e6134348e613",
- "scenario": "lifecycle",
- "theme": "training",
- "surface": "getStarted",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide",
- "logoCdnUrl": "https://example.com/logoCdnUrl/",
- "assetName": "Asset Name value",
- "dimensions": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",
- "minWidth": 8,
- "maxWidth": 8,
- "minHeight": 9,
- "maxHeight": 9
- }
- }
- }
- ]
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessageguidedcontent Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-partnerintegration-organizationalmessageguidedcontent-update.md
- Title: "Update organizationalMessageGuidedContent"
-description: "Update the properties of a organizationalMessageGuidedContent object."
-
-localization_priority: Normal
-doc_type: apiPageType
--
-# Update organizationalMessageGuidedContent
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Update the properties of a [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object.
-
-## Prerequisites
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-|Permission type|Permissions (from least to most privileged)|
-|:|:|
-|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
-|Delegated (personal Microsoft account)|Not supported.|
-|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|
-
-## HTTP Request
-<!-- {
- "blockType": "ignored"
-}
>
-``` http
-PATCH /deviceManagement/organizationalMessageGuidedContents/{organizationalMessageGuidedContentId}
-```
-
-## Request headers
-|Header|Value|
-|:|:|
-|Authorization|Bearer &lt;token&gt; Required.|
-|Accept|application/json|
-
-## Request body
-In the request body, supply a JSON representation for the [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object.
-
-The following table shows the properties that are required when you create the [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md).
-
-|Property|Type|Description|
-|:|:|:|
-|id|String|A unique identifier for the guided content|
-|scenario|[organizationalMessageScenario](../resources/intune-partnerintegration-organizationalmessagescenario.md)|Indicates the scenario for the guided content. Possible values are: `onboarding`, `lifecycle`, `unknownFutureValue`.|
-|theme|[organizationalMessageTheme](../resources/intune-partnerintegration-organizationalmessagetheme.md)|Indicates the theme for the guided content. Possible values are: `update`, `training`, `welcomeToWindows`, `explore`, `unknownFutureValue`.|
-|surface|[organizationalMessageSurface](../resources/intune-partnerintegration-organizationalmessagesurface.md)|Indicates the area where content will be displayed to customers. Possible values are: `actionCenter`, `getStarted`, `softLanding`, `unknownFutureValue`.|
-|placementDetails|[organizationalMessagePlacementDetail](../resources/intune-partnerintegration-organizationalmessageplacementdetail.md) collection|Contains the different types of text content that can be displayed to customers along with their localized values|
-|logo|[organizationalMessageLogoGuide](../resources/intune-partnerintegration-organizationalmessagelogoguide.md)|Example of the logo that will be displayed to customers and its size requirements|
---
-## Response
-If successful, this method returns a `200 OK` response code and an updated [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object in the response body.
-
-## Example
-
-### Request
-Here is an example of the request.
-``` http
-PATCH https://graph.microsoft.com/beta/deviceManagement/organizationalMessageGuidedContents/{organizationalMessageGuidedContentId}
-Content-type: application/json
-Content-length: 1403
-
-{
- "@odata.type": "#microsoft.graph.organizationalMessageGuidedContent",
- "scenario": "lifecycle",
- "theme": "training",
- "surface": "getStarted",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide",
- "logoCdnUrl": "https://example.com/logoCdnUrl/",
- "assetName": "Asset Name value",
- "dimensions": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",
- "minWidth": 8,
- "maxWidth": 8,
- "minHeight": 9,
- "maxHeight": 9
- }
- }
-}
-```
-
-### Response
-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
-``` http
-HTTP/1.1 200 OK
-Content-Type: application/json
-Content-Length: 1452
-
-{
- "@odata.type": "#microsoft.graph.organizationalMessageGuidedContent",
- "id": "13e64843-4843-13e6-4348-e6134348e613",
- "scenario": "lifecycle",
- "theme": "training",
- "surface": "getStarted",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "card0",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "Variant Id value",
- "name": "Name value",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "Locale value",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "Title value",
- "message": "Message value",
- "clickUrl": "https://example.com/clickUrl/",
- "buttonText": "Button Text value"
- }
- }
- ]
- }
- ]
- }
- ],
- "logo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide",
- "logoCdnUrl": "https://example.com/logoCdnUrl/",
- "assetName": "Asset Name value",
- "dimensions": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",
- "minWidth": 8,
- "maxWidth": 8,
- "minHeight": 9,
- "maxHeight": 9
- }
- }
-}
-```
-----
v1.0 Intune Shared Devicemanagementscript Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-shared-devicemanagementscript-create.md
The following table shows the properties that are required when you create the d
|id|String|Unique Identifier for the device management script.| |displayName|String|Name of the device management script.| |description|String|Optional description for the device management script.|
-|runSchedule|[runSchedule](../resources/intune-devices-runschedule.md)|The interval for script to run. If not defined the script will run once|
|scriptContent|Binary|The script content.| |createdDateTime|DateTimeOffset|The date and time the device management script was created. This property is read-only.| |lastModifiedDateTime|DateTimeOffset|The date and time the device management script was last modified. This property is read-only.|
Content-length: 443
"@odata.type": "#microsoft.graph.deviceManagementScript", "displayName": "Display Name value", "description": "Description value",
+ "runSchedule": {
+ "@odata.type": "microsoft.graph.runSchedule"
+ },
"scriptContent": "c2NyaXB0Q29udGVudA==", "runAsAccount": "user", "enforceSignatureCheck": true,
v1.0 Intune Shared Devicemanagementscript List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-shared-devicemanagementscript-list.md
Content-Length: 716
"id": "59ea4525-4525-59ea-2545-ea592545ea59", "displayName": "Display Name value", "description": "Description value",
+ "runSchedule": {
+ "@odata.type": "microsoft.graph.runSchedule"
+ },
"scriptContent": "c2NyaXB0Q29udGVudA==", "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
v1.0 Intune Shared Devicemanagementscript Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-shared-devicemanagementscript-update.md
The following table shows the properties that are required when you create the [
|id|String|Unique Identifier for the device management script.| |displayName|String|Name of the device management script.| |description|String|Optional description for the device management script.|
-|runSchedule|[runSchedule](../resources/intune-devices-runschedule.md)|The interval for script to run. If not defined the script will run once|
|scriptContent|Binary|The script content.| |createdDateTime|DateTimeOffset|The date and time the device management script was created. This property is read-only.| |lastModifiedDateTime|DateTimeOffset|The date and time the device management script was last modified. This property is read-only.|
Content-length: 443
"@odata.type": "#microsoft.graph.deviceManagementScript", "displayName": "Display Name value", "description": "Description value",
+ "runSchedule": {
+ "@odata.type": "microsoft.graph.runSchedule"
+ },
"scriptContent": "c2NyaXB0Q29udGVudA==", "runAsAccount": "user", "enforceSignatureCheck": true,
v1.0 Intune Wip Intunebrandingprofile Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-wip-intunebrandingprofile-create.md
The following table shows the properties that are required when you create the i
|companyPortalBlockedActions|[companyPortalBlockedAction](../resources/intune-shared-companyportalblockedaction.md) collection|Collection of blocked actions on the company portal as per platform and device ownership types.| |showAzureADEnterpriseApps|Boolean|Boolean that indicates if AzureAD Enterprise Apps will be shown in Company Portal| |showOfficeWebApps|Boolean|Boolean that indicates if Office WebApps will be shown in Company Portal|
+|showConfigurationManagerApps|Boolean|Boolean that indicates if Configuration Manager Apps will be shown in Company Portal|
|sendDeviceOwnershipChangePushNotification|Boolean|Boolean that indicates if a push notification is sent to users when their device ownership type changes from personal to corporate| |enrollmentAvailability|[enrollmentAvailabilityOptions](../resources/intune-shared-enrollmentavailabilityoptions.md)|Customized device enrollment flow displayed to the end user . Possible values are: `availableWithPrompts`, `availableWithoutPrompts`, `unavailable`.| |disableClientTelemetry|Boolean|Applies to telemetry sent from all clients to the Intune service. When disabled, all proactive troubleshooting and issue warnings within the client are turned off, and telemetry settings appear inactive or hidden to the device user.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/intuneBrandingProfiles Content-type: application/json
-Content-length: 1975
+Content-length: 2016
{ "@odata.type": "#microsoft.graph.intuneBrandingProfile",
Content-length: 1975
], "showAzureADEnterpriseApps": true, "showOfficeWebApps": true,
+ "showConfigurationManagerApps": true,
"sendDeviceOwnershipChangePushNotification": true, "enrollmentAvailability": "availableWithoutPrompts", "disableClientTelemetry": true,
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 201 Created Content-Type: application/json
-Content-Length: 2147
+Content-Length: 2188
{ "@odata.type": "#microsoft.graph.intuneBrandingProfile",
Content-Length: 2147
], "showAzureADEnterpriseApps": true, "showOfficeWebApps": true,
+ "showConfigurationManagerApps": true,
"sendDeviceOwnershipChangePushNotification": true, "enrollmentAvailability": "availableWithoutPrompts", "disableClientTelemetry": true,
v1.0 Intune Wip Intunebrandingprofile Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-wip-intunebrandingprofile-get.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 2284
+Content-Length: 2327
{ "value": {
Content-Length: 2284
], "showAzureADEnterpriseApps": true, "showOfficeWebApps": true,
+ "showConfigurationManagerApps": true,
"sendDeviceOwnershipChangePushNotification": true, "enrollmentAvailability": "availableWithoutPrompts", "disableClientTelemetry": true,
v1.0 Intune Wip Intunebrandingprofile List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-wip-intunebrandingprofile-list.md
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 2416
+Content-Length: 2461
{ "value": [
Content-Length: 2416
], "showAzureADEnterpriseApps": true, "showOfficeWebApps": true,
+ "showConfigurationManagerApps": true,
"sendDeviceOwnershipChangePushNotification": true, "enrollmentAvailability": "availableWithoutPrompts", "disableClientTelemetry": true,
v1.0 Intune Wip Intunebrandingprofile Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-wip-intunebrandingprofile-update.md
The following table shows the properties that are required when you create the [
|companyPortalBlockedActions|[companyPortalBlockedAction](../resources/intune-shared-companyportalblockedaction.md) collection|Collection of blocked actions on the company portal as per platform and device ownership types.| |showAzureADEnterpriseApps|Boolean|Boolean that indicates if AzureAD Enterprise Apps will be shown in Company Portal| |showOfficeWebApps|Boolean|Boolean that indicates if Office WebApps will be shown in Company Portal|
+|showConfigurationManagerApps|Boolean|Boolean that indicates if Configuration Manager Apps will be shown in Company Portal|
|sendDeviceOwnershipChangePushNotification|Boolean|Boolean that indicates if a push notification is sent to users when their device ownership type changes from personal to corporate| |enrollmentAvailability|[enrollmentAvailabilityOptions](../resources/intune-shared-enrollmentavailabilityoptions.md)|Customized device enrollment flow displayed to the end user . Possible values are: `availableWithPrompts`, `availableWithoutPrompts`, `unavailable`.| |disableClientTelemetry|Boolean|Applies to telemetry sent from all clients to the Intune service. When disabled, all proactive troubleshooting and issue warnings within the client are turned off, and telemetry settings appear inactive or hidden to the device user.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/intuneBrandingProfiles/{intuneBrandingProfileId} Content-type: application/json
-Content-length: 1975
+Content-length: 2016
{ "@odata.type": "#microsoft.graph.intuneBrandingProfile",
Content-length: 1975
], "showAzureADEnterpriseApps": true, "showOfficeWebApps": true,
+ "showConfigurationManagerApps": true,
"sendDeviceOwnershipChangePushNotification": true, "enrollmentAvailability": "availableWithoutPrompts", "disableClientTelemetry": true,
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 200 OK Content-Type: application/json
-Content-Length: 2147
+Content-Length: 2188
{ "@odata.type": "#microsoft.graph.intuneBrandingProfile",
Content-Length: 2147
], "showAzureADEnterpriseApps": true, "showOfficeWebApps": true,
+ "showConfigurationManagerApps": true,
"sendDeviceOwnershipChangePushNotification": true, "enrollmentAvailability": "availableWithoutPrompts", "disableClientTelemetry": true,
v1.0 Learningcontent Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/learningcontent-update.md
PATCH /employeeExperience/learningProviders/{learningProviderId}/learningContent
|contributors|String collection|The authors, creators, or contributors of the learning content. Optional.| |createdDateTime|DateTimeOffset|The date when the learning content was created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Optional.| |description|String|The description or summary for the learning content. Optional.|
-|duration|Duration|The duration of the learning content in seconds. Optional.|
+|duration|Duration|The duration of the learning content in seconds. The value is represented in ISO 8601 format for durations. Optional.|
|externalId|String|Unique external content ID for the learning content. Required.| |format|String|The format of the learning content. For example, `Course`, `Video`, `Book`, `Book Summary`, `Audiobook Summary`. Optional.| |isActive|Boolean|Indicates whether the content is active or not. Inactive content will not show up in the UI. The default value is `true`. Optional.|
Content-Type: application/json
"numberOfPages": 9, "duration": "PT20M", "format": "Book",
- "createdDateTime": "2018-01-01T00:00:00",
+ "createdDateTime": "2018-01-01T00:00:00Z",
"lastModifiedDateTime": "2021-04-01T04:26:06.1995367Z",
- "contributor": "Scott Simpson",
+ "contributors": ["Scott Simpson"],
"additionalTags": [ "Create private or public teams", "Add members to teams"
v1.0 Managedtenants Auditevent Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-auditevent-get.md
Title: "Get auditEvent"
description: "Read the properties and relationships of an auditEvent object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Cloudpcconnection Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-cloudpcconnection-get.md
Title: "Get cloudPcConnection"
description: "Read the properties and relationships of a cloudPcConnection object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Cloudpcdevice Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-cloudpcdevice-get.md
Title: "Get cloudPcDevice"
description: "Read the properties and relationships of a cloudPcDevice object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Cloudpcoverview Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-cloudpcoverview-get.md
Title: "Get cloudPcOverview"
description: "Read the properties and relationships of a cloudPcOverview object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Conditionalaccesspolicycoverage Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-conditionalaccesspolicycoverage-get.md
Title: "Get conditionalAccessPolicyCoverage"
description: "Read the properties and relationships of a conditionalAccessPolicyCoverage object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Credentialuserregistrationssummary Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-credentialuserregistrationssummary-get.md
Title: "Get credentialUserRegistrationsSummary"
description: "Read the properties and relationships of a credentialUserRegistrationsSummary object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Devicecompliancepolicysettingstatesummary Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-devicecompliancepolicysettingstatesummary-get.md
Title: "Get deviceCompliancePolicySettingStateSummary"
description: "Read the properties and relationships of a deviceCompliancePolicySettingStateSummary object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Manageddevicecompliance Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-manageddevicecompliance-get.md
Title: "Get managedDeviceCompliance"
description: "Read the properties and relationships of a managedDeviceCompliance object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Manageddevicecompliancetrend Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-manageddevicecompliancetrend-get.md
Title: "Get managedDeviceComplianceTrend"
description: "Read the properties and relationships of a managedDeviceComplianceTrend object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Aggregatedpolicycompliances https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-aggregatedpolicycompliances.md
Title: "List aggregatedPolicyCompliances"
description: "Get a list of the aggregatedPolicyCompliance objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Auditevents https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-auditevents.md
Title: "List auditEvents"
description: "Get a list of the auditEvent objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Cloudpcconnections https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-cloudpcconnections.md
Title: "List cloudPcConnections"
description: "Get a list of the cloudPcConnection objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Cloudpcdevices https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-cloudpcdevices.md
Title: "List cloudPcDevices"
description: "Get a list of the cloudPcDevice objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Cloudpcsoverview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-cloudpcsoverview.md
Title: "List cloudPcOverviews"
description: "Get a list of the cloudPcOverview objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Conditionalaccesspolicycoverages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-conditionalaccesspolicycoverages.md
Title: "List conditionalAccessPolicyCoverages"
description: "Get a list of the conditionalAccessPolicyCoverage objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Credentialuserregistrationssummaries https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-credentialuserregistrationssummaries.md
Title: "List credentialUserRegistrationsSummaries"
description: "Get a list of the credentialUserRegistrationsSummary objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Devicecompliancepolicysettingstatesummary https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-devicecompliancepolicysettingstatesummary.md
Title: "List deviceCompliancePolicySettingStateSummary"
description: "Get a list of the deviceCompliancePolicySettingStateSummary objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Manageddevicecompliances https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-manageddevicecompliances.md
Title: "List managedDeviceCompliances"
description: "Get a list of the managedDeviceCompliance objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Manageddevicecompliancetrends https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-manageddevicecompliancetrends.md
Title: "List managedDeviceComplianceTrends"
description: "Get a list of the managedDeviceComplianceTrend objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Managementactions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-managementactions.md
Title: "List managementActions"
description: "Get a list of the managementAction objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Managementactiontenantdeploymentstatuses https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-managementactiontenantdeploymentstatuses.md
Title: "List managementActionTenantDeploymentStatus"
description: "Get a list of the managementActionTenantDeploymentStatus objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Managementintents https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-managementintents.md
Title: "List managementIntents"
description: "Get a list of the managementIntent objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Managementtemplates https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-managementtemplates.md
Title: "List managementTemplates"
description: "Get a list of the managementTemplate objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Myroles https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-myroles.md
Title: "List myRoles"
description: "Get the roles that a signed-in user has through a delegated relationship across managed tenants." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Tenantgroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-tenantgroups.md
Title: "List tenantGroups"
description: "Get a list of the tenantGroup objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Tenants https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-tenants.md
Title: "List tenants"
description: "Get a list of the tenant objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Tenantscustomizedinformation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-tenantscustomizedinformation.md
Title: "List tenantCustomizedInformation"
description: "Get a list of the tenantCustomizedInformation objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Tenantsdetailedinformation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-tenantsdetailedinformation.md
Title: "List tenantDetailedInformation"
description: "Get a list of the tenantDetailedInformation objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Tenanttags https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-tenanttags.md
Title: "List tenantTags"
description: "Get a list of the tenantTag objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Tenantusage https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-tenantusage.md
Title: "List tenantUsage"
description: "Get a list of the tenantUsage objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Windowsdevicemalwarestates https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-windowsdevicemalwarestates.md
Title: "List windowsDeviceMalwareStates"
description: "Get a list of the windowsDeviceMalwareState objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant List Windowsprotectionstates https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-windowsprotectionstates.md
Title: "List windowsProtectionStates"
description: "Get a list of the windowsProtectionState objects and their properties." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managedtenant Post Tenanttags https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-post-tenanttags.md
Title: "Create tenantTag"
description: "Create a new tenantTag object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managementaction Apply https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managementaction-apply.md
Title: "managementAction: apply"
description: "Applies a management action against a specific managed tenant. By performing this operation the appropriate configurations will be made and policies created. As example when applying the require multi-factor authentication for admins management action will create an Azure Active Directory conditional access policy that requires multi-factor authentication for all users that have been assigned an administrative directory role." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managementaction Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managementaction-get.md
Title: "Get managementAction"
description: "Read the properties and relationships of a managementAction object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managementactiontenantdeploymentstatus Changedeploymentstatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managementactiontenantdeploymentstatus-changedeploymentstatus.md
Title: "managementActionTenantDeploymentStatus: changeDeploymentStatus"
description: "Changes the tenant level deployment status for the management action. This information is used to provide insights into what management actions are in a specific state. As example there might be a plan to apply the require multi-factor authentication for admins, so it would be ideal to change the status to planned to reflect the appropriate status." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managementactiontenantdeploymentstatus Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managementactiontenantdeploymentstatus-get.md
Title: "Get managementActionTenantDeploymentStatus"
description: "Read the properties and relationships of a managementActionTenantDeploymentStatus object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managementintent Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managementintent-get.md
Title: "Get managementIntent"
description: "Read the properties and relationships of a managementIntent object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Managementtemplate Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managementtemplate-get.md
Title: "Get managementTemplate"
description: "Read the properties and relationships of a managementTemplate object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenant Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenant-get.md
Title: "Get tenant"
description: "Read the properties and relationships of a tenant object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenant Offboardtenant https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenant-offboardtenant.md
Title: "tenant: offboardTenant"
description: "Carries out the appropriate procedures to remove a managed tenant from the multi-tenant management platform. No relationships, such as commerce and delegate administrative privileges, will be impacted. The only change made by invoking this action is the tenant will be deprovisioned from the multi-tenant management platform." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenant Resettenantonboardingstatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenant-resettenantonboardingstatus.md
Title: "tenant: resetTenantOnboardingStatus"
description: "Carries out the appropriate procedures to reset the onboarding status for the managed tenant that was removed from the multi-tenant management platform using the offboardTenant action. By invoking this action the platform will attempt to onboard the managed tenant for management." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenantcustomizedinformation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenantcustomizedinformation-get.md
Title: "Get tenantCustomizedInformation"
description: "Read the properties and relationships of a tenantCustomizedInformation object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenantcustomizedinformation Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenantcustomizedinformation-update.md
Title: "Update tenantCustomizedInformation"
description: "Update the properties of a tenantCustomizedInformation object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenantdetailedinformation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenantdetailedinformation-get.md
Title: "Get tenantDetailedInformation"
description: "Read the properties and relationships of a tenantDetailedInformation object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenantgroup Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenantgroup-get.md
Title: "Get tenantGroup"
description: "Read the properties and relationships of a tenantGroup object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenantgroup Tenantsearch https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenantgroup-tenantsearch.md
Title: "tenantGroup: tenantSearch"
description: "Searches for the specified managed tenants across tenant groups." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenanttag Assigntag https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenanttag-assigntag.md
Title: "tenantTag: assignTag"
description: "Assign the tenant tag to the specified managed tenants." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenanttag Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenanttag-delete.md
Title: "Delete tenantTag"
description: "Delete a tenantTag object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenanttag Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenanttag-get.md
Title: "Get tenantTag"
description: "Read the properties and relationships of a tenantTag object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenanttag Unassigntag https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenanttag-unassigntag.md
Title: "tenantTag: unassignTag"
description: "Un-assigns the tenant tag from the specified managed tenants." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Tenanttag Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-tenanttag-update.md
Title: "Update tenantTag"
description: "Update the properties of a tenantTag object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Windowsdevicemalwarestate Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-windowsdevicemalwarestate-get.md
Title: "Get windowsDeviceMalwareState"
description: "Read the properties and relationships of a windowsDeviceMalwareState object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Managedtenants Windowsprotectionstate Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-windowsprotectionstate-get.md
Title: "Get windowsProtectionState"
description: "Read the properties and relationships of a windowsProtectionState object." ms.localizationpriority: medium doc_type: apiPageType
v1.0 Oauth2permissiongrant Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/oauth2permissiongrant-delta.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) | Directory.Read.All, Directory.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |
-|oauth2permissiongrant | Directory.Read.All, DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All |
+|Application | Directory.Read.All, DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All |
## HTTP request
GET /oauth2PermissionGrants/delta
## Query parameters
-Tracking changes incurs a round of one or more **delta** function calls. If you use any query parameter
-(other than `$deltatoken` and `$skiptoken`), you must specify
-it in the initial **delta** request. Microsoft Graph automatically encodes any specified parameters
-into the token portion of the `@odata.nextLink` or `@odata.deltaLink` URL provided in the response.
-You only need to specify any query parameters once up front.
-In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL from the previous response. That URL already
+Tracking changes incurs a round of one or more **delta** function calls. If you use any query parameter
+(other than `$deltatoken` and `$skiptoken`), you must specify
+it in the initial **delta** request. Microsoft Graph automatically encodes any specified parameters
+into the token portion of the `@odata.nextLink` or `@odata.deltaLink` URL provided in the response.
+You only need to specify any query parameters once up front.
+In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL from the previous response. That URL already
includes the encoded parameters. | Query parameter | Type |Description|
GET https://graph.microsoft.com/beta/oauth2PermissionGrants/delta
### Response >**Note:** The response object shown here might be shortened for readability.
-<!-- {
+<!-- {
"blockType": "response", "truncated": true, "@odata.type": "microsoft.graph.oAuth2PermissionGrant",
- "isCollection": true
-} -->
+ "isCollection": true
+} -->
```http HTTP/1.1 200 OK Content-type: application/json
v1.0 Organization Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/organization-get.md
Content-type: application/json
"country": null, "countryLetterCode": "NL", "createdDateTime": "2021-08-02T10:30:06Z",
+ "defaultUsageLocation": "String",
"displayName": "Contoso", "isMultipleDataLocationsForServicesEnabled": null, "marketingNotificationEmails": [],
v1.0 Organization List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/organization-list.md
Content-type: application/json
"country": null, "countryLetterCode": "NL", "createdDateTime": "2021-08-02T10:30:06Z",
+ "defaultUsageLocation": "String",
"displayName": "Contoso", "isMultipleDataLocationsForServicesEnabled": null, "marketingNotificationEmails": [],
v1.0 Plannerbucket List Tasks https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/plannerbucket-list-tasks.md
Title: "List tasks"
-description: "Retrieve a list of **plannerTask** objects associated to a plannerBucket object."
+description: "Retrieve a list of plannerTask objects associated to a plannerBucket object."
ms.localizationpriority: medium ms.prod: "planner"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve a list of **plannerTask** objects associated to a [plannerBucket](../resources/plannerbucket.md) object.
+Retrieve a list of [plannerTask](../resources/plannertask.md) objects associated to a [plannerBucket](../resources/plannerbucket.md) object.
+ ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
Do not supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and collection of [plannerTask](../resources/plannertask.md) objects in the response body.
+If successful, this method returns a `200 OK` response code and a collection of [plannerTask](../resources/plannertask.md) objects in the response body.
This method can return any of the [HTTP status codes](/graph/errors). The most common errors that apps should handle for this method are the 403 and 404 responses. For more information about these errors, see [Common Planner error conditions](../resources/planner-overview.md#common-planner-error-conditions). ## Example
-##### Request
-Here is an example of the request.
+### Request
+The following is an example of the request.
# [HTTP](#tab/http) <!-- {
GET https://graph.microsoft.com/beta/planner/buckets/gcrYAaAkgU2EQUvpkNNXLGQAGTt
-##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+### Response
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
v1.0 Plannertask Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/plannertask-get.md
Title: "Get plannerTask"
-description: "Retrieve the properties and relationships of **plannertask** object."
+description: "Retrieve the properties and relationships of plannerTask object."
ms.localizationpriority: medium ms.prod: "planner"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve the properties and relationships of **plannertask** object.
+Retrieve the properties and relationships of [plannerTask](../resources/plannertask.md) object.
+ ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
Do not supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and [plannerTask](../resources/plannertask.md) object in the response body.
+If successful, this method returns a `200 OK` response code and a [plannerTask](../resources/plannertask.md) object in the response body.
This method can return any of the [HTTP status codes](/graph/errors). The most common errors that apps should handle for this method are the 403 and 404 responses. For more information about these errors, see [Common Planner error conditions](../resources/planner-overview.md#common-planner-error-conditions). ## Example
-##### Request
-Here is an example of the request.
+### Request
+The following is an example of the request.
# [HTTP](#tab/http) <!-- {
GET https://graph.microsoft.com/beta/planner/tasks/01gzSlKkIUSUl6DF_EilrmQAKDhh
-##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+### Response
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
v1.0 Presence Setpresence https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/presence-setpresence.md
Similarly, an application can have its own presence session for a user and be ab
The following is the precedence for how session states are aggregated, with "A > B" representing A having precedence over B: * User-preferred state > session-level states (user-preferred state overrides session-level states)
-* Among session-level states: DoNotDisturb (currently not supported for **setPresence**) > Busy > Available > Away
+* Among session-level states: DoNotDisturb > Busy > Available > Away
### Timeout, expiration, and keep alive A presence session may **time out** and **expire**, so the application needs to call this API before the **timeout**, to maintain the state for the session; or before the **expiration**, to keep the session alive.
In the request body, provide a JSON object with the following parameters.
Supported combinations of `availability` and `activity` are:
-| availability | activity | Description |
-| :-- | :- | :- |
-| Available | Available | Updates the presence session as Available. |
-| Busy | InACall | Updates the presence session as Busy, InACall. |
-| Busy | InAConferenceCall | Updates the presence session as Busy, InAConferenceCall. |
-| Away | Away | Updates the presence session as Away. |
+| availability | activity | Description |
+| :-- | :- | :-- |
+| Available | Available | Updates the presence session as Available. |
+| Busy | InACall | Updates the presence session as Busy, InACall. |
+| Busy | InAConferenceCall | Updates the presence session as Busy, InAConferenceCall. |
+| Away | Away | Updates the presence session as Away. |
+| DoNotDisturb | Presenting | Updates the presence session as DoNotDisturb, Presenting. |
## Response If successful, this method returns a `200 OK` response code.
v1.0 Print List Recentshares https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/print-list-recentshares.md
If successful, this method returns a `200 OK` response code and a collection of
### Request The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_recentprintershares"
The following is an example of the request.
GET https://graph.microsoft.com/beta/me/print/recentPrinterShares ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
++++ ### Response The following is an example of the response. >**Note:** The response object shown here might be shortened for readability.
v1.0 Security Alert Post Comments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-alert-post-comments.md
If successful, this method returns a `200 OK` response code and an updated list
### Request The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "sampleKeys": ["da637865765418431569_-773071023"],
Content-Type: application/json
} ```
+# [JavaScript](#tab/javascript)
++++ ### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
v1.0 Security Ediscoverycase Post Legalholds https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycase-post-legalholds.md
You can specify the following properties when you create an **ediscoveryHoldPoli
|:|:|:| |displayName|String|The display name of the legal hold policy. Required.| |description|String|The description of the legal hold policy. Optional.|
-|contentQuery|String|The content query of the legal hold policy. Optional.|
## Response
Content-Type: application/json
{ "displayname": "My legalHold with sources", "description": "Created from Graph API",
- "contentQuery": "Bazooka",
"userSources@odata.bind": [ { "@odata.type": "microsoft.graph.security.userSource",
Content-Type: application/json
"@odata.context": "https://graph.microsoft.com/beta/$metadata#security/cases/ediscoveryCases('b0073e4e-4184-41c6-9eb7-8c8cc3e2288b')/legalHolds/$entity", "isEnabled": true, "errors": [],
- "contentQuery": "Bazooka",
"description": "Created from Graph API", "createdDateTime": "2022-05-23T03:54:11.1Z", "lastModifiedDateTime": "2022-05-23T03:54:11.1Z",
v1.0 Security Ediscoveryholdpolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoveryholdpolicy-update.md
PATCH /security/cases/ediscoveryCases/{ediscoveryCaseId}/legalHolds/{ediscoveryH
|Property|Type|Description| |:|:|:| |description|String|The description of the legal hold policy. Optional.|
-|contentQuery|String|The content query of the legal hold policy. Optional.|
## Response
PATCH https://graph.microsoft.com/beta/security/cases/ediscoveryCases/b0073e4e-4
{ "description": "updated description",
- "contentQuery": "bazooka bazooka"
} ```
v1.0 Security Incident Post Comments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-incident-post-comments.md
If successful, this method returns a `200 OK` response code and an updated list
### Request The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "sampleKeys": ["3962396"],
Content-Type: application/json
} ```
+# [JavaScript](#tab/javascript)
++++ ### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
v1.0 Security Security Runhuntingquery https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-security-runhuntingquery.md
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"
POST https://graph.microsoft.com/beta/security/runHuntingQuery
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PHP](#tab/php)
++++ ### Response >**Note:** The response object shown here might be shortened for readability.
Content-type: application/json
} ] }
-```
+```
v1.0 Serviceprincipal Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/serviceprincipal-get.md
GET https://graph.microsoft.com/beta/servicePrincipals/{id}?$select=customSecuri
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php)
v1.0 Sites List Followed https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/sites-list-followed.md
Namespace: microsoft.graph
List the [sites](../resources/site.md) that have been followed by the signed in user.
+>**Note:** This API has a [known issue](/graph/known-issues#sites-and-lists-sharepoint) and might return incorrect results.
+ ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Team Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/team-get.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (work or school account) | Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, Group.Read.All**, Group.ReadWrite.All**, Directory.Read.All**, Directory.ReadWrite.All** | |Delegated (personal Microsoft account) | Not supported. | |Application | TeamSettings.Read.Group*, TeamSettings.ReadWrite.Group*, Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, Group.Read.All**, Group.ReadWrite.All**, Directory.Read.All**, Directory.ReadWrite.All** |+ [!INCLUDE [teamwork-permissions-note](../../../includes/teamwork-permissions-note.md)] > **Note**: This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they are not a member of.
v1.0 Team Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/team-post.md
Content-Type: application/json
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go)
v1.0 Team Put Schedule https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/team-put-schedule.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/go/team-put-schedule-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [PHP](#tab/php) [!INCLUDE [sample-code](../includes/snippets/php/team-put-schedule-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
PUT https://graph.microsoft.com/beta/teams/871dbd5c-3a6a-4392-bfe1-042452793a50/
[!INCLUDE [sample-code](../includes/snippets/go/team-put-schedule-2-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [PHP](#tab/php) [!INCLUDE [sample-code](../includes/snippets/php/team-put-schedule-2-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 User List People https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/user-list-people.md
This method supports the following OData query parameters to help customize the
|:|:--|:-| |$filter|string|Limits the response to only those people whose record contains the specified criteria.| |$orderby|string|By default the people in the response are sorted by their relevance to your query. You can change the order of the people in the response using the *$orderby* parameter.|
-|$search|string|Search for people by name or alias. Supports Fuzzy matching. Parameter only works for searching the signed-in user's relevant people, not for searching people relevant to other users. Also supports the `topic` keyword to find people based on topics extracted from e-mail conversations with that person. See the *Perform a fuzzy search* section at [Get relevant information about people](/graph/people-example#perform-a-fuzzy-search) for information and examples.|
+|$search|string|Search for people by name or alias. Supports Fuzzy matching. Parameter only works for searching the signed-in user's relevant people, not for searching people relevant to other users. Also supports the `topic` keyword to find people based on topics extracted from e-mail conversations with that person. For information and examples, see the *Perform a fuzzy search* section at [Use the People API to get information about the people most relevant to you](/graph/people-insights-overview#perform-a-fuzzy-search).|
|$select|string|Comma-separated list of properties to include in the response. For optimal performance, only select the subset of properties needed.| |$skip|int|Skip the first n results, useful for paging. This is not supported when using *$search*.| |$top|int|Number of results to be returned.|
v1.0 Virtualendpoint Post Crosscloudgovernmentorganizationmapping https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/virtualendpoint-post-crosscloudgovernmentorganizationmapping.md
If successful, this method returns a `200 OK` response code and a [cloudPcCrossC
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_cloudpccrosscloudgovernmentorganizationmapping_from_"
X-MS-CloudPC-USGovCloudTenantAADToken: {token}
{} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PHP](#tab/php)
++++ ### Response <!-- {
v1.0 Accesspackage https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/accesspackage.md
To assign a user to an access package, [create an accessPackageAssignmentRequest
| [List accessPackagesIncompatibleWith](../api/accesspackage-list-accesspackagesincompatiblewith.md) | [accessPackage](accesspackage.md) collection | Retrieve a list of the **accesspackage** objects which list this access package as incompatible. | |[filterByCurrentUser](../api/accesspackage-filterbycurrentuser.md)|[accessPackage](../resources/accesspackage.md) collection|Retrieve the list of **accessPackage** objects filtered on the signed-in user.| | [getApplicablePolicyRequirements](../api/accesspackage-getapplicablepolicyrequirements.md) | [accessPackageAssignmentRequestRequirements](../resources/accesspackageassignmentrequestrequirements.md) collection | Retrieve a list of **accessPackageAssignmentRequestRequirement** objects with request requirements. |
+| [moveToCatalog](../api/accesspackage-movetocatalog.md) | None | Move an access package to a different catalog.|
## Properties
v1.0 Collapseproperty https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/collapseproperty.md
+
+ Title: "collapseProperty resource type"
+description: "Specifies the collapse criteria of search results."
+ms.localizationpriority: medium
+++
+# collapseProperty resource type
+
+Namespace: microsoft.graph
++
+Specifies the criteria used for collapsing search results. Applies only to sortable/refinable properties.
+
+## Properties
+
+| Property | Type | Description |
+|:-|:|:|
+|fields|String Collection| Defines the collapse group to trim results. The properties in this collection must be sortable/refinable properties. Required.|
+|limit|Int16| Defines a maximum limit count for this field. This numeric value must be a positive integer. Required.|
+
+## JSON representation
+
+The following is a JSON representation of the resource.
+
+<!-- {
+ "blockType": "resource",
+ "optionalProperties": [
+
+ ],
+ "@odata.type": "microsoft.graph.collapseProperty",
+ "baseType": null
+}-->
+
+```json
+{
+ "fields": ["String"],
+ "limit": 1024
+}
+```
+
+<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
+2019-02-04 14:57:30 UTC -->
+<!-- {
+ "type": "#page.annotation",
+ "description": "collapseProperty resource",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": ""
+}-->
v1.0 Conditionalaccessapplications https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/conditionalaccessapplications.md
Represents the applications and user actions included in and excluded from the c
|:-- |:- |:-- | | includeApplications | String collection | Can be one of the following: <li> The list of client IDs (**appId**) the policy applies to, unless explicitly excluded (in **excludeApplications**) <li> `All` <li> `Office365` - For the list of apps included in `Office365`, see [Conditional Access target apps: Office 365](/azure/active-directory/conditional-access/concept-conditional-access-cloud-apps) | | excludeApplications | String collection | Can be one of the following: <li> The list of client IDs (**appId**) explicitly excluded from the policy.<li> `Office365` - For the list of apps included in `Office365`, see [Conditional Access target apps: Office 365](/azure/active-directory/conditional-access/concept-conditional-access-cloud-apps) |
+| applicationFilter | [conditionalAccessFilter](conditionalaccessfilter.md) | Filter that defines the dynamic-application-syntax rule to include/exclude cloud applications. A filter can use custom security attributes to include/exclude applications. |
| includeUserActions | String collection | User actions to include. Supported values are `urn:user:registersecurityinfo` and `urn:user:registerdevice` | | includeAuthenticationContextClassReferences | String collection | Authentication context class references include. Supported values are `c1` through `c25`. |
The following is a JSON representation of the resource.
"optionalProperties": [ "includeApplications", "excludeApplications",
+ "applicationFilter",
"includeUserActions" ], "@odata.type": "microsoft.graph.conditionalAccessApplications"
The following is a JSON representation of the resource.
{ "includeApplications": ["String"], "excludeApplications": ["String"],
+ "applicationFilter": {"@odata.type": "microsoft.graph.conditionalAccessFilter"},
"includeUserActions": ["String"] } ```
v1.0 Conditionalaccessclientapplications https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/conditionalaccessclientapplications.md
Represents client applications (service principals and workload identities) incl
|:|:|:| |excludeServicePrincipals|String collection|Service principal IDs excluded from the policy scope.| |includeServicePrincipals|String collection|Service principal IDs included in the policy scope, or `ServicePrincipalsInMyTenant`. |
+|servicePrincipalFilter | [conditionalAccessFilter](conditionalaccessfilter.md) | Filter that defines the dynamic-servicePrincipal-syntax rule to include/exclude service principals. A filter can use custom security attributes to include/exclude service principals. |
## Relationships None.
The following is a JSON representation of the resource.
], "excludeServicePrincipals": [ "String"
- ]
+ ],
+ "servicePrincipalFilter": {"@odata.type": "microsoft.graph.conditionalAccessFilter"},
} ```
v1.0 Educationassignment https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/educationassignment.md
When an **assignment** is created, it is in a Draft state. Students can't see th
The **assignment** APIs are exposed in the class namespace.
+Inherits from [entity](../resources/entity.md).
+ ## Methods | Method | Return Type |Description|
The **assignment** APIs are exposed in the class namespace.
## Properties | Property | Type |Description| |:|:--|:-|
-|id|String| Read-only.|
|addedStudentAction|String|Optional field to control the **assignment** behavior for students who are added after the **assignment** is published. If not specified, defaults to `none` value. Currently supports only two values: `none` or `assignIfOpen`.| |addToCalendarAction| educationAddToCalendarOptions|Optional field to control the **assignment** behavior for adding **assignments** to students' and teachers' calendars when the **assignment** is published. The possible values are: `none`, `studentsAndPublisher`, `studentsAndTeamOwners`, `unknownFutureValue`, and `studentsOnly`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value(s) in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `studentsOnly`. The default value is `none`.| |allowLateSubmissions|Boolean| Identifies whether students can submit after the due date. If this property is not specified during create, it defaults to true. |
The **assignment** APIs are exposed in the class namespace.
|dueDateTime|DateTimeOffset|Date when the students **assignment** is due. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`| |feedbackResourcesFolderUrl|String|Folder URL where all the feedback file resources for this **assignment** are stored.| |grading|[educationAssignmentGradeType](educationassignmentgradetype.md)|How the **assignment** will be graded. |
+|id|String| The unique identifier for the **assignment**. Inherited from [entity](../resources/entity.md). Read-only.|
|instructions|[itemBody](itembody.md)| Instructions for the **assignment**. This along with the display name tell the student what to do. | |lastModifiedBy|[identitySet](identityset.md)| Who last modified the **assignment**. | |lastModifiedDateTime|DateTimeOffset|Moment when the **assignment** was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`|
The following is a JSON representation of the resource.
```json {
- "id": "String (identifier)",
- "addedStudentAction": "none",
- "addToCalendarAction": "string",
- "allowLateSubmissions": true,
- "allowStudentsToAddResourcesToSubmission": true,
+ "addedStudentAction": "String",
+ "addToCalendarAction": "String",
+ "allowLateSubmissions": "Boolean",
+ "allowStudentsToAddResourcesToSubmission": "Boolean",
"assignDateTime": "String (timestamp)", "assignTo": {"@odata.type": "microsoft.graph.educationAssignmentRecipient"}, "assignedDateTime": "String (timestamp)",
The following is a JSON representation of the resource.
"createdDateTime": "String (timestamp)", "displayName": "String", "dueDateTime": "String (timestamp)",
+ "feedbackResourcesFolderUrl": "String",
"grading": {"@odata.type": "microsoft.graph.educationAssignmentGradeType"},
+ "id": "String (identifier)",
"instructions": {"@odata.type": "microsoft.graph.itemBody"}, "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"}, "lastModifiedDateTime": "String (timestamp)",
- "notificationChannelUrl": "string",
- "status": "string",
- "webUrl": "string",
- "resourcesFolderUrl": "string"
+ "notificationChannelUrl": "String",
+ "status": "String",
+ "webUrl": "String",
+ "resourcesFolderUrl": "String"
} ```
v1.0 Educationfeedbackresourceoutcome https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/educationfeedbackresourceoutcome.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Represents feedback on an [educationOutcome](educationoutcome.md) object in the form of a document.
+Represents feedback on an [educationOutcome](../resources/educationoutcome.md) object in the form of a document.
+
+Inherits from [educationOutcome](../resources/educationoutcome.md).
## Methods | Method | Return Type | Description | |:-|:|:|
-| [Create educationFeedbackResourceOutcome](../api/educationfeedbackresourceoutcome-post-outcomes.md) | [educationOutcome](educationoutcome.md) | Create a new [feedback resource](../resources/educationfeedbackresourceoutcome.md) for a submission. |
+| [Create educationFeedbackResourceOutcome](../api/educationfeedbackresourceoutcome-post-outcomes.md) | [educationOutcome](../resources/educationoutcome.md) | Create a new [feedback resource](../resources/educationfeedbackresourceoutcome.md) for a submission. |
| [Delete educationFeedbackResourceOutcome](../api/educationfeedbackresourceoutcome-delete.md) | None | Delete a [feedback resource](../resources/educationfeedbackresourceoutcome.md) from a submission. | ## Properties | Property | Type | Description | |:-|:|:|
-|feedbackResource|[educationResource](educationresource.md)|The actual feedback resource.|
-|id|String|Unique identifier for the **educationFeedbackResourceOutcome**.|
-|resourceStatus|educationFeedbackResourceOutcomeStatus|The status of the feedback resource. The possible values are: `notPublished`, `pendingPublish`, `published`, `failedPublish`, and `unknownFutureValue`.|
+|feedbackResource|[educationResource](../resources/educationresource.md)|The actual feedback resource.|
+|id|String|Unique identifier for the **educationFeedbackResourceOutcome**. Inherited from [entity](../resources/entity.md).|
+|lastModifiedBy|[identitySet](../resources/identityset.md)|The individual who updated the resource. Inherited from [educationOutcome](../resources/educationoutcome.md).|
+|lastModifiedDateTime|DateTimeOffset|The moment in time when the resource was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2021 is `2021-01-01T00:00:00Z`. Inherited from [educationOutcome](../resources/educationoutcome.md).|
+|resourceStatus|educationFeedbackResourceOutcomeStatus|The status of the feedback resource. The possible values are: `notPublished`, `pendingPublish`, `published`, `failedPublish`, `unknownFutureValue`.|
## Relationships
The following is a JSON representation of the resource.
{ "feedbackResource": {"@odata.type": "microsoft.graph.educationResource"}, "id": "String (identifier)",
+ "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
+ "lastModifiedDateTime": "String (timestamp)",
"resourceStatus": {"@odata.type": "microsoft.graph.educationFeedbackResourceOutcomeStatus"} } ```
v1.0 Educationoutcome https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/educationoutcome.md
Title: "educationOutcome resource type"
-description: "The result of grading an assignment"
+description: "Represents a base class for the result of grading an assignment."
ms.localizationpriority: medium ms.prod: "education"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-The result of grading an assignment. This is a base class; the derived types are [educationFeedbackOutcome](educationfeedbackoutcome.md), [educationPointsOutcome](educationpointsoutcome.md), [educationRubricOutcome](educationrubricoutcome.md), and [educationFeedbackResourceOutcome](educationfeedbackresourceoutcome.md).
+Represents a base class for the result of grading an assignment. The derived types are [educationFeedbackOutcome](educationfeedbackoutcome.md), [educationPointsOutcome](educationpointsoutcome.md), [educationRubricOutcome](educationrubricoutcome.md), and [educationFeedbackResourceOutcome](educationfeedbackresourceoutcome.md).
+
+Inherits from [entity](../resources/entity.md).
## Methods | Method | Return Type | Description | |:-|:|:|
-| [Update educationOutcome](../api/educationoutcome-update.md) | [educationOutcome](educationoutcome.md) | Update educationOutcome object. |
+| [Update educationOutcome](../api/educationoutcome-update.md) | [educationOutcome](educationoutcome.md) | Update the **educationOutcome** object. |
## Properties | Property | Type |Description| |:|:--|:-|
-|id|String|Read-only.|
+|id|String|Unique identifier for the **educationOutcome** object. Inherited from [entity](../resources/entity.md). Read-only.|
|lastModifiedBy|[identitySet](identityset.md)|The individual who updated the resource.|
-|lastModifiedDateTime|DateTimeOffset|Moment in time when the resource was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2021 is `2021-01-01T00:00:00Z`.|
+|lastModifiedDateTime|DateTimeOffset|The moment in time when the resource was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2021 is `2021-01-01T00:00:00Z`.|
## Relationships
v1.0 Educationsubmission https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/educationsubmission.md
If [setUpResourcesFolder](../api/educationsubmission-setupResourcesFolder.md) ha
|unsubmittedDateTime|DateTimeOffset|Moment in time when the submission was moved from submitted into the working state. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`| |reassignedBy|[identitySet](identityset.md)|User who moved the status of this submission to reassigned.| |reassignedDateTime|DateTimeOffset|Moment in time when the submission was reassigned. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`|
+|webUrl|String| The deep link URL for the given **submission**.|
## Relationships | Relationship | Type |Description|
The following is a JSON representation of the resource.
```json {
- "id":"String (identifier)",
- "recipient":{"@odata.type":"microsoft.graph.educationSubmissionRecipient"},
- "returnedBy":{"@odata.type":"microsoft.graph.identitySet"},
- "returnedDateTime":"String (timestamp)",
- "resourcesFolderUrl":"String",
- "status":"string",
- "submittedBy":{"@odata.type":"microsoft.graph.identitySet"},
- "submittedDateTime":"String (timestamp)",
- "unsubmittedBy":{"@odata.type":"microsoft.graph.identitySet"},
- "unsubmittedDateTime":"String (timestamp)",
- "reassignedBy":{"@odata.type":"microsoft.graph.identitySet"},
- "reassignedDateTime":"String (timestamp)"
+ "id": "String (identifier)",
+ "reassignedBy": {"@odata.type":"microsoft.graph.identitySet"},
+ "reassignedDateTime": "String (timestamp)",
+ "recipient": {"@odata.type":"microsoft.graph.educationSubmissionRecipient"},
+ "resourcesFolderUrl": "String",
+ "returnedBy": {"@odata.type":"microsoft.graph.identitySet"},
+ "returnedDateTime": "String (timestamp)",
+ "status": "String",
+ "submittedBy": {"@odata.type":"microsoft.graph.identitySet"},
+ "submittedDateTime": "String (timestamp)",
+ "unsubmittedBy": {"@odata.type":"microsoft.graph.identitySet"},
+ "unsubmittedDateTime": "String (timestamp)",
+ "webUrl": "String"
} ```
v1.0 Entitlementmanagement Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/entitlementmanagement-overview.md
The following table lists the methods that you can use to interact with entitlem
| [Add group to incompatibleGroups](../api/accesspackage-post-incompatiblegroup.md) | None | Add a link to indicate membership of a **group** is incompatible with a specified access package. | | [Remove group from incompatibleGroups](../api/accesspackage-delete-incompatiblegroup.md) | None | Remove a link that indicated a **group** membership was incompatible.| | [List accessPackagesIncompatibleWith](../api/accesspackage-list-accesspackagesincompatiblewith.md) | [accessPackage](accesspackage.md) collection | Retrieve a list of the **accesspackage** objects which list this access package as incompatible. |
+| [moveToCatalog](../api/accesspackage-movetocatalog.md) | None | Move an access package to a different catalog.|
| [List accessPackageAssignmentPolicies](../api/entitlementmanagement-list-accesspackageassignmentpolicies.md) | [accessPackageAssignmentPolicy](accesspackageassignmentpolicy.md) collection | Retrieve a list of **accessPackageAssignmentPolicy** objects. | | [Create accessPackageAssignmentPolicy](../api/entitlementmanagement-post-accesspackageassignmentpolicies.md) | [accessPackageAssignmentPolicy](accesspackageassignmentpolicy.md)| Create a new **accessPackageAssignmentPolicy** object. | | [Get accessPackageAssignmentPolicy](../api/accesspackageassignmentpolicy-get.md) | [accessPackageAssignmentPolicy](accesspackageassignmentpolicy.md) | Read properties and relationships of an **accessPackageAssignmentPolicy** object. |
v1.0 Enums Managedtenants https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/enums-managedtenants.md
Title: "Multi-tenant management enumeration values"
description: "Microsoft Graph multi-tenant management enumeration values" ms.localizationpriority: medium doc_type: enumTypes
v1.0 Enums https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/enums.md
Namespace: microsoft.graph
|unknownFutureValue| ### educationAddToCalendarOptions values+ |Member| |:| |none|
Namespace: microsoft.graph
|studentsOnly| ### educationAssignmentStatus values+ |Member| |:| |draft|
Namespace: microsoft.graph
|unknownFutureValue| ### educationSubmissionStatus values+ |Member| |:| |working|
Namespace: microsoft.graph
|reassigned| ### educationFeedbackResourceOutcomeStatus values+ |Member| |:| |notPublished|
v1.0 Group https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/group.md
This resource supports:
| [List deleted groups](../api/directory-deleteditems-list.md) | [directoryObject](directoryobject.md) collection | Retrieve the groups deleted in the tenant in the last 30 days. | | [List deleted groups owned by user](../api/directory-deleteditems-getuserownedobjects.md) | [directoryObject](directoryobject.md) collection | Retrieve the groups deleted in the tenant in the last 30 days and that are owned by a user. | | [Get deleted group](../api/directory-deleteditems-get.md) | [directoryObject](directoryobject.md) collection | Retrieve a deleted group by ID. |
-| [Restore deleted group](../api/directory-deleteditems-delete.md) | [directoryObject](directoryobject.md) collection | Restore a group deleted in the tenant in the last 30 days. |
-| [Permanently delete group](../api/directory-deleteditems-restore.md) | [directoryObject](directoryobject.md) collection | Permanently delete a deleted group from the tenant. |
+| [Restore deleted group](../api/directory-deleteditems-restore.md) | [directoryObject](directoryobject.md) collection | Restore a group deleted in the tenant in the last 30 days. |
+| [Permanently delete group](../api/directory-deleteditems-delete.md) | [directoryObject](directoryobject.md) collection | Permanently delete a deleted group from the tenant. |
| [checkMemberGroups](../api/directoryobject-checkmembergroups.md) | String collection | Check for membership in a list of groups. The function is transitive. | | [getMemberGroups](../api/directoryobject-getmembergroups.md) | String collection | Return all the groups that the group is a member of. The function is transitive. | | [checkMemberObjects](../api/directoryobject-checkmemberobjects.md) | String collection | Check for membership in a list of group, directory role, or administrative unit objects. The function is transitive. |
v1.0 Intune Apps Ioslobapp https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-apps-ioslobapp.md
Inherits from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)
|expirationDateTime|DateTimeOffset|The expiration time.| |versionNumber|String|The version number of iOS Line of Business (LoB) app.| |buildNumber|String|The build number of iOS Line of Business (LoB) app.|
-|identityVersion|String|The identity version.|
+|identityVersion|String|The identity version. This property is being deprecated in 2211(November 2022)|
## Relationships |Relationship|Type|Description|
v1.0 Intune Apps Macoslobapp https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-apps-macoslobapp.md
Title: "macOSLobApp resource type"
-description: "Contains properties and inherited properties for the MacOS LOB App."
+description: "Contains properties and inherited properties for the macOS LOB App."
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Contains properties and inherited properties for the MacOS LOB App.
+Contains properties and inherited properties for the macOS LOB App.
Inherits from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)
Inherits from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)
|committedContentVersion|String|The internal committed content version. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |fileName|String|The name of the main Lob application file. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |size|Int64|The total size, including all uploaded files. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)|
-|bundleId|String|The bundle id.|
-|minimumSupportedOperatingSystem|[macOSMinimumOperatingSystem](../resources/intune-apps-macosminimumoperatingsystem.md)|The value for the minimum applicable operating system.|
-|buildNumber|String|The build number of MacOS Line of Business (LoB) app.|
-|versionNumber|String|The version number of MacOS Line of Business (LoB) app.|
-|childApps|[macOSLobChildApp](../resources/intune-apps-macoslobchildapp.md) collection|The app list in this bundle package|
-|identityVersion|String|The identity version.|
-|md5HashChunkSize|Int32|The chunk size for MD5 hash|
-|md5Hash|String collection|The MD5 hash codes|
-|ignoreVersionDetection|Boolean|A boolean to control whether the app's version will be used to detect the app after it is installed on a device. Set this to true for macOS Line of Business (LoB) apps that use a self update feature.|
-|installAsManaged|Boolean|A boolean to control whether the app will be installed as managed (requires macOS 11.0 and other PKG restrictions).|
+|bundleId|String|The primary bundleId of the package.|
+|minimumSupportedOperatingSystem|[macOSMinimumOperatingSystem](../resources/intune-apps-macosminimumoperatingsystem.md)|ComplexType macOSMinimumOperatingSystem that indicates the minimum operating system applicable for the application.|
+|buildNumber|String|The build number of the package. This should match the package CFBundleShortVersionString of the .pkg file.|
+|versionNumber|String|The version number of the package. This should match the package CFBundleVersion in the packageinfo file.|
+|childApps|[macOSLobChildApp](../resources/intune-apps-macoslobchildapp.md) collection|List of ComplexType macOSLobChildApp objects. Represents the apps expected to be installed by the package.|
+|identityVersion|String|The identity version. This property is being deprecated in 2211(November 2022).|
+|md5HashChunkSize|Int32|The chunk size for MD5 hash. This is '0' or empty if the package was uploaded directly. If the Intune App Wrapping Tool is used to create a .intunemac, this value can be found inside the Detection.xml file.|
+|md5Hash|String collection|The MD5 hash codes. This is empty if the package was uploaded directly. If the Intune App Wrapping Tool is used to create a .intunemac, this value can be found inside the Detection.xml file.|
+|ignoreVersionDetection|Boolean|When TRUE, indicates that the app's version will NOT be used to detect if the app is installed on a device. When FALSE, indicates that the app's version will be used to detect if the app is installed on a device. Set this to true for apps that use a self update feature.|
+|installAsManaged|Boolean|When TRUE, indicates that the app will be installed as managed (requires macOS 11.0 and other managed package restrictions). When FALSE, indicates that the app will be installed as unmanaged.|
## Relationships |Relationship|Type|Description|
v1.0 Intune Apps Macoslobappassignmentsettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-apps-macoslobappassignmentsettings.md
+
+ Title: "macOsLobAppAssignmentSettings resource type"
+description: "Contains properties used to assign a macOS LOB app to a group."
+
+localization_priority: Normal
++
+# macOsLobAppAssignmentSettings resource type
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Contains properties used to assign a macOS LOB app to a group.
++
+Inherits from [mobileAppAssignmentSettings](../resources/intune-shared-mobileappassignmentsettings.md)
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|uninstallOnDeviceRemoval|Boolean|When TRUE, indicates that the app should be uninstalled when the device is removed from Intune. When FALSE, indicates that the app will not be uninstalled when the device is removed from Intune.|
+
+## Relationships
+None
+
+## JSON Representation
+Here is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.macOsLobAppAssignmentSettings"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.macOsLobAppAssignmentSettings",
+ "uninstallOnDeviceRemoval": true
+}
+```
+++++
v1.0 Intune Apps Macoslobchildapp https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-apps-macoslobchildapp.md
Title: "macOSLobChildApp resource type"
-description: "Contains properties the MacOS LOB App in a bundle package"
+description: "Contains properties of a macOS .app in the package"
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Contains properties the MacOS LOB App in a bundle package
+Contains properties of a macOS .app in the package
## Properties |Property|Type|Description| |:|:|:|
-|bundleId|String|The Identity Name.|
-|buildNumber|String|The build number of MacOS Line of Business (LoB) app.|
-|versionNumber|String|The version number of MacOS Line of Business (LoB) app.|
+|bundleId|String|The bundleId of the app.|
+|buildNumber|String|The build number of the app.|
+|versionNumber|String|The version number of the app.|
## Relationships None
v1.0 Intune Apps Macosmdatpapp https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-apps-macosmdatpapp.md
Title: "macOSMdatpApp resource type"
-description: "Contains properties and inherited properties for the macOS Microsoft Defender Advanced Threat Protection (MDATP) App."
+description: "Contains properties and inherited properties for the macOS Microsoft Defender Advanced Threat Protection (MDATP) App. This will be deprecated for MacOSMicrosoftDefenderApp."
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Contains properties and inherited properties for the macOS Microsoft Defender Advanced Threat Protection (MDATP) App.
+Contains properties and inherited properties for the macOS Microsoft Defender Advanced Threat Protection (MDATP) App. This will be deprecated for MacOSMicrosoftDefenderApp.
Inherits from [mobileApp](../resources/intune-shared-mobileapp.md)
v1.0 Intune Apps Macosmicrosoftdefenderapp https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-apps-macosmicrosoftdefenderapp.md
+
+ Title: "macOSMicrosoftDefenderApp resource type"
+description: "Contains properties and inherited properties for the macOS Microsoft Defender App."
+
+localization_priority: Normal
++
+# macOSMicrosoftDefenderApp resource type
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Contains properties and inherited properties for the macOS Microsoft Defender App.
++
+Inherits from [mobileApp](../resources/intune-shared-mobileapp.md)
+
+## Methods
+|Method|Return Type|Description|
+|:|:|:|
+|[List macOSMicrosoftDefenderApps](../api/intune-apps-macosmicrosoftdefenderapp-list.md)|[macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) collection|List properties and relationships of the [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) objects.|
+|[Get macOSMicrosoftDefenderApp](../api/intune-apps-macosmicrosoftdefenderapp-get.md)|[macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md)|Read properties and relationships of the [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object.|
+|[Create macOSMicrosoftDefenderApp](../api/intune-apps-macosmicrosoftdefenderapp-create.md)|[macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md)|Create a new [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object.|
+|[Delete macOSMicrosoftDefenderApp](../api/intune-apps-macosmicrosoftdefenderapp-delete.md)|None|Deletes a [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md).|
+|[Update macOSMicrosoftDefenderApp](../api/intune-apps-macosmicrosoftdefenderapp-update.md)|[macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md)|Update the properties of a [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String|Key of the entity. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|displayName|String|The admin provided or imported title of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|description|String|The description of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|publisher|String|The publisher of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|largeIcon|[mimeContent](../resources/intune-shared-mimecontent.md)|The large icon, to be displayed in the app details and used for upload of the icon. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|createdDateTime|DateTimeOffset|The date and time the app was created. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|lastModifiedDateTime|DateTimeOffset|The date and time the app was last modified. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|isFeatured|Boolean|The value indicating whether the app is marked as featured by the admin. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|privacyInformationUrl|String|The privacy statement Url. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|informationUrl|String|The more information Url. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|owner|String|The owner of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|developer|String|The developer of the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|notes|String|Notes for the app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|uploadState|Int32|The upload state. Possible values are: 0 - `Not Ready`, 1 - `Ready`, 2 - `Processing`. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|publishingState|[mobileAppPublishingState](../resources/intune-apps-mobileapppublishingstate.md)|The publishing state for the app. The app cannot be assigned unless the app is published. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md). Possible values are: `notPublished`, `processing`, `published`.|
+|isAssigned|Boolean|The value indicating whether the app is assigned to at least one group. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|roleScopeTagIds|String collection|List of scope tag ids for this mobile app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|categories|[mobileAppCategory](../resources/intune-apps-mobileappcategory.md) collection|The list of categories for this app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|assignments|[mobileAppAssignment](../resources/intune-apps-mobileappassignment.md) collection|The list of group assignments for this mobile app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|installSummary|[mobileAppInstallSummary](../resources/intune-apps-mobileappinstallsummary.md)|Mobile App Install Summary. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|deviceStatuses|[mobileAppInstallStatus](../resources/intune-apps-mobileappinstallstatus.md) collection|The list of installation states for this mobile app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|userStatuses|[userAppInstallStatus](../resources/intune-apps-userappinstallstatus.md) collection|The list of installation states for this mobile app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|relationships|[mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md) collection|The set of direct relationships for this app. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+
+## JSON Representation
+Here is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.macOSMicrosoftDefenderApp"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.macOSMicrosoftDefenderApp",
+ "id": "String (identifier)",
+ "displayName": "String",
+ "description": "String",
+ "publisher": "String",
+ "largeIcon": {
+ "@odata.type": "microsoft.graph.mimeContent",
+ "type": "String",
+ "value": "binary"
+ },
+ "createdDateTime": "String (timestamp)",
+ "lastModifiedDateTime": "String (timestamp)",
+ "isFeatured": true,
+ "privacyInformationUrl": "String",
+ "informationUrl": "String",
+ "owner": "String",
+ "developer": "String",
+ "notes": "String",
+ "uploadState": 1024,
+ "publishingState": "String",
+ "isAssigned": true,
+ "roleScopeTagIds": [
+ "String"
+ ],
+ "dependentAppCount": 1024,
+ "supersedingAppCount": 1024,
+ "supersededAppCount": 1024
+}
+```
+++++
v1.0 Intune Apps Macosmicrosoftedgeapp https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-apps-macosmicrosoftedgeapp.md
Title: "macOSMicrosoftEdgeApp resource type"
-description: "Contains properties and inherited properties for the MacOS Microsoft Edge App."
+description: "Contains properties and inherited properties for the macOS Microsoft Edge App."
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Contains properties and inherited properties for the MacOS Microsoft Edge App.
+Contains properties and inherited properties for the macOS Microsoft Edge App.
Inherits from [mobileApp](../resources/intune-shared-mobileapp.md)
Inherits from [mobileApp](../resources/intune-shared-mobileapp.md)
|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
-|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`.|
+|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`, `unknownFutureValue`.|
## Relationships |Relationship|Type|Description|
v1.0 Intune Apps Macosminimumoperatingsystem https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-apps-macosminimumoperatingsystem.md
Title: "macOSMinimumOperatingSystem resource type"
-description: "The minimum operating system required for a MacOS app."
+description: "The minimum operating system required for a macOS app."
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-The minimum operating system required for a MacOS app.
+The minimum operating system required for a macOS app.
## Properties |Property|Type|Description| |:|:|:|
-|v10_7|Boolean|When TRUE, indicates macOS 10.7 or later is required to install the app. When FALSE, indicates some other OS version is the minimum OS to install the app. Default value is FALSE.|
-|v10_8|Boolean|When TRUE, indicates macOS 10.8 or later is required to install the app. When FALSE, indicates some other OS version is the minimum OS to install the app. Default value is FALSE.|
-|v10_9|Boolean|When TRUE, indicates macOS 10.9 or later is required to install the app. When FALSE, indicates some other OS version is the minimum OS to install the app. Default value is FALSE.|
-|v10_10|Boolean|When TRUE, indicates macOS 10.10 or later is required to install the app. When FALSE, indicates some other OS version is the minimum OS to install the app. Default value is FALSE.|
-|v10_11|Boolean|When TRUE, indicates macOS 10.11 or later is required to install the app. When FALSE, indicates some other OS version is the minimum OS to install the app. Default value is FALSE.|
+|v10_7|Boolean|When TRUE, indicates Mac OS X 10.7 or later is required to install the app. When FALSE, indicates some other OS version is the minimum OS to install the app. Default value is FALSE.|
+|v10_8|Boolean|When TRUE, indicates OS X 10.8 or later is required to install the app. When FALSE, indicates some other OS version is the minimum OS to install the app. Default value is FALSE.|
+|v10_9|Boolean|When TRUE, indicates OS X 10.9 or later is required to install the app. When FALSE, indicates some other OS version is the minimum OS to install the app. Default value is FALSE.|
+|v10_10|Boolean|When TRUE, indicates OS X 10.10 or later is required to install the app. When FALSE, indicates some other OS version is the minimum OS to install the app. Default value is FALSE.|
+|v10_11|Boolean|When TRUE, indicates OS X 10.11 or later is required to install the app. When FALSE, indicates some other OS version is the minimum OS to install the app. Default value is FALSE.|
|v10_12|Boolean|When TRUE, indicates macOS 10.12 or later is required to install the app. When FALSE, indicates some other OS version is the minimum OS to install the app. Default value is FALSE.| |v10_13|Boolean|When TRUE, indicates macOS 10.13 or later is required to install the app. When FALSE, indicates some other OS version is the minimum OS to install the app. Default value is FALSE.| |v10_14|Boolean|When TRUE, indicates macOS 10.14 or later is required to install the app. When FALSE, indicates some other OS version is the minimum OS to install the app. Default value is FALSE.|
v1.0 Intune Apps Microsoftedgechannel https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-apps-microsoftedgechannel.md
The enum to specify the channels for Microsoft Edge apps.
## Members |Member|Value|Description| |:|:|:|
-|dev|0|Not yet documented|
-|beta|1|Not yet documented|
-|stable|2|Not yet documented|
+|dev|0|The Dev Channel is intended to help you plan and develop with the latest capabilities of Microsoft Edge.|
+|beta|1|The Beta Channel is intended for production deployment to a representative sample set of users. New features ship about every 4 weeks. Security and quality updates ship as needed.|
+|stable|2|The Stable Channel is intended for broad deployment within organizations, and it's the channel that most users should be on. New features ship about every 4 weeks. Security and quality updates ship as needed.|
+|unknownFutureValue|3|Evolvable enumeration sentinel value. Do not use.|
v1.0 Intune Apps Windowsmicrosoftedgeapp https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-apps-windowsmicrosoftedgeapp.md
Inherits from [mobileApp](../resources/intune-shared-mobileapp.md)
|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
-|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`.|
+|channel|[microsoftEdgeChannel](../resources/intune-apps-microsoftedgechannel.md)|The channel to install on target devices. Possible values are: `dev`, `beta`, `stable`, `unknownFutureValue`.|
|displayLanguageLocale|String|The language locale to use when the Edge app displays text to the user.| ## Relationships
v1.0 Intune Apps Wingetapp https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-apps-wingetapp.md
Inherits from [mobileApp](../resources/intune-shared-mobileapp.md)
|dependentAppCount|Int32|The total number of dependencies the child app has. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)|
+|manifestHash|String|Hash of package metadata properties used to validate that the application matches the metadata in the source repository.|
|packageIdentifier|String|The PackageIdentifier from the WinGet source repository REST API. This also maps to the Id when using the WinGet client command line application. Required at creation time, cannot be modified on existing objects.| |installExperience|[winGetAppInstallExperience](../resources/intune-apps-wingetappinstallexperience.md)|The install experience settings associated with this application, which are used to ensure the desired install experiences on the target device are taken into account. This includes the account type (System or User) that actions should be run as on target devices. Required at creation time.|
Here is a JSON representation of the resource.
"dependentAppCount": 1024, "supersedingAppCount": 1024, "supersededAppCount": 1024,
+ "manifestHash": "String",
"packageIdentifier": "String", "installExperience": { "@odata.type": "microsoft.graph.winGetAppInstallExperience",
v1.0 Intune Deviceconfig Androiddeviceownergeneraldeviceconfiguration https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-deviceconfig-androiddeviceownergeneraldeviceconfiguration.md
Inherits from [deviceConfiguration](../resources/intune-shared-deviceconfigurati
|networkEscapeHatchAllowed|Boolean|Indicates whether or not the device will allow connecting to a temporary network connection at boot time.| |nfcBlockOutgoingBeam|Boolean|Indicates whether or not to block NFC outgoing beam.| |passwordBlockKeyguard|Boolean|Indicates whether or not the keyguard is disabled.|
-|passwordBlockKeyguardFeatures|[androidKeyguardFeature](../resources/intune-deviceconfig-androidkeyguardfeature.md) collection|List of device keyguard features to block. This collection can contain a maximum of 7 elements.|
+|passwordBlockKeyguardFeatures|[androidKeyguardFeature](../resources/intune-deviceconfig-androidkeyguardfeature.md) collection|List of device keyguard features to block. This collection can contain a maximum of 11 elements.|
|passwordExpirationDays|Int32|Indicates the amount of time that a password can be set for before it expires and a new password will be required. Valid values 1 to 365| |passwordMinimumLength|Int32|Indicates the minimum length of the password required on the device. Valid values 4 to 16| |passwordMinimumLetterCharacters|Int32|Indicates the minimum number of letter characters required for device password. Valid values 1 to 16|
v1.0 Intune Deviceconfigv2 Devicemanagementcompliancepolicy https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementcompliancepolicy.md
Device Management Compliance Policy
|name|String|Policy name| |description|String|Policy description| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this policy. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
|createdDateTime|DateTimeOffset|Policy creation date and time. This property is read-only.| |lastModifiedDateTime|DateTimeOffset|Policy last modification date and time. This property is read-only.| |settingCount|Int32|Number of settings. This property is read-only.|
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationcategory https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationcategory.md
Device Management Configuration Policy
|name|String|Name of the item| |displayName|String|Display name of the item| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms types, which settings in the category have. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies types, which settings in the category have. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies types, which settings in the category have. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicates that the category contains settings that are used for Compliance or Configuration. Possible values are: `none`, `configuration`, `compliance`.| |parentCategoryId|String|Parent id of the category.| |rootCategoryId|String|Root id of the category.|
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationexchangeonlinesettingapplicability https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationexchangeonlinesettingapplicability.md
Inherits from [deviceManagementConfigurationSettingApplicability](../resources/i
|description|String|description of the setting Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md)| |platform|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platform setting can be applied on Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.| |deviceMode|[deviceManagementConfigurationDeviceMode](../resources/intune-deviceconfigv2-devicemanagementconfigurationdevicemode.md)|Device Mode that setting can be applied on Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `kiosk`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Which technology channels this setting can be deployed through Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Which technology channels this setting can be deployed through Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
## Relationships None
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicy https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationpolicy.md
Device Management Configuration Policy
|[Update deviceManagementConfigurationPolicy](../api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-update.md)|[deviceManagementConfigurationPolicy](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicy.md)|Update the properties of a [deviceManagementConfigurationPolicy](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicy.md) object.| |[assign action](../api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-assign.md)|[deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) collection|Not yet documented| |[createCopy action](../api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-createcopy.md)|[deviceManagementConfigurationPolicy](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicy.md)|Not yet documented|
+|[reorder action](../api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-reorder.md)|None|Not yet documented|
## Properties |Property|Type|Description|
Device Management Configuration Policy
|name|String|Policy name| |description|String|Policy description| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this policy. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
|createdDateTime|DateTimeOffset|Policy creation date and time| |lastModifiedDateTime|DateTimeOffset|Policy last modification date and time| |settingCount|Int32|Number of settings|
Here is a JSON representation of the resource.
"templateDisplayVersion": "String" }, "priorityMetaData": {
- "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData"
+ "@odata.type": "microsoft.graph.deviceManagementPriorityMetaData",
+ "priority": 1024
} } ```
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicytemplate https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationpolicytemplate.md
Device Management Configuration Policy Template
|displayVersion|String|Description of template version| |lifecycleState|[deviceManagementTemplateLifecycleState](../resources/intune-deviceconfigv2-devicemanagementtemplatelifecyclestate.md)|Indicate current lifecycle state of template. Possible values are: `invalid`, `draft`, `active`, `superseded`, `deprecated`, `retired`.| |platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this template. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this template. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
-|templateFamily|[deviceManagementConfigurationTemplateFamily](../resources/intune-deviceconfigv2-devicemanagementconfigurationtemplatefamily.md)|TemplateFamily for this template. Possible values are: `none`, `endpointSecurityAntivirus`, `endpointSecurityDiskEncryption`, `endpointSecurityFirewall`, `endpointSecurityEndpointDetectionAndResponse`, `endpointSecurityAttackSurfaceReduction`, `endpointSecurityAccountProtection`, `endpointSecurityApplicationControl`, `enrollmentConfiguration`, `baseline`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this template. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
+|templateFamily|[deviceManagementConfigurationTemplateFamily](../resources/intune-deviceconfigv2-devicemanagementconfigurationtemplatefamily.md)|TemplateFamily for this template. Possible values are: `none`, `endpointSecurityAntivirus`, `endpointSecurityDiskEncryption`, `endpointSecurityFirewall`, `endpointSecurityEndpointDetectionAndResponse`, `endpointSecurityAttackSurfaceReduction`, `endpointSecurityAccountProtection`, `endpointSecurityApplicationControl`, `endpointSecurityEndpointPrivilegeManagement`, `enrollmentConfiguration`, `appQuietTime`, `baseline`, `unknownFutureValue`.|
|allowUnmanagedSettings|Boolean|Allow unmanaged setting templates| |settingTemplateCount|Int32|Number of setting templates. Valid values 0 to 2147483647. This property is read-only.|
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationpolicytemplatereference https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationpolicytemplatereference.md
Policy template reference information
|Property|Type|Description| |:|:|:| |templateId|String|Template id|
-|templateFamily|[deviceManagementConfigurationTemplateFamily](../resources/intune-deviceconfigv2-devicemanagementconfigurationtemplatefamily.md)|Template Family of the referenced Template. This property is read-only. Possible values are: `none`, `endpointSecurityAntivirus`, `endpointSecurityDiskEncryption`, `endpointSecurityFirewall`, `endpointSecurityEndpointDetectionAndResponse`, `endpointSecurityAttackSurfaceReduction`, `endpointSecurityAccountProtection`, `endpointSecurityApplicationControl`, `enrollmentConfiguration`, `baseline`.|
+|templateFamily|[deviceManagementConfigurationTemplateFamily](../resources/intune-deviceconfigv2-devicemanagementconfigurationtemplatefamily.md)|Template Family of the referenced Template. This property is read-only. Possible values are: `none`, `endpointSecurityAntivirus`, `endpointSecurityDiskEncryption`, `endpointSecurityFirewall`, `endpointSecurityEndpointDetectionAndResponse`, `endpointSecurityAttackSurfaceReduction`, `endpointSecurityAccountProtection`, `endpointSecurityApplicationControl`, `endpointSecurityEndpointPrivilegeManagement`, `enrollmentConfiguration`, `appQuietTime`, `baseline`, `unknownFutureValue`.|
|templateDisplayName|String|Template Display Name of the referenced template. This property is read-only.| |templateDisplayVersion|String|Template Display Version of the referenced Template. This property is read-only.|
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationsettingapplicability https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md
Not yet documented
|description|String|description of the setting| |platform|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platform setting can be applied on. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.| |deviceMode|[deviceManagementConfigurationDeviceMode](../resources/intune-deviceconfigv2-devicemanagementconfigurationdevicemode.md)|Device Mode that setting can be applied on. Possible values are: `none`, `kiosk`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Which technology channels this setting can be deployed through. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Which technology channels this setting can be deployed through. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
## Relationships None
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationtechnologies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md
Describes which technology this setting can be deployed with
|exchangeOnline|256|Setting can be deployed through the Exchange Online agent channel| |linuxMdm|1024|Setting can be deployed through the Linux Mdm channel| |enrollment|4096|Setting can be deployed through device enrollment.|
-|unknownFutureValue|1073741824|Sentinel member for cases where the client cannot handle the new enum values.|
+|endpointPrivilegeManagement|8192|Setting can be deployed using the Endpoint privilege management channel|
+|unknownFutureValue|16384|Evolvable enumeration sentinel value. Do not use.|
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationtemplatefamily https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationtemplatefamily.md
Describes the TemplateFamily for the Template entity
|endpointSecurityAttackSurfaceReduction|14|Template Family for EndpointSecurityAttackSurfaceReduction that help reduce your attack surfaces, by minimizing the places where your organization is vulnerable to cyberthreats and attacks| |endpointSecurityAccountProtection|15|Template Family for EndpointSecurityAccountProtection that facilitates protecting the identity and accounts of users| |endpointSecurityApplicationControl|16|Template Family for ApplicationControl that helps mitigate security threats by restricting the applications that users can run and the code that runs in the System Core (kernel)|
+|endpointSecurityEndpointPrivilegeManagement|17|Template Family for EPM Elevation Rules|
|enrollmentConfiguration|18|Template Family for EnrollmentConfiguration|
+|appQuietTime|19|Template Family for QuietTimeIndicates Template Family for all the Apps QuietTime policies and templates|
|baseline|20|Template Family for Baseline|
+|unknownFutureValue|21|Evolvable enumeration sentinel value. Do not use.|
v1.0 Intune Deviceconfigv2 Devicemanagementconfigurationwindowssettingapplicability https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementconfigurationwindowssettingapplicability.md
Inherits from [deviceManagementConfigurationSettingApplicability](../resources/i
|description|String|description of the setting Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md)| |platform|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platform setting can be applied on Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.| |deviceMode|[deviceManagementConfigurationDeviceMode](../resources/intune-deviceconfigv2-devicemanagementconfigurationdevicemode.md)|Device Mode that setting can be applied on Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `kiosk`.|
-|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Which technology channels this setting can be deployed through Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `unknownFutureValue`.|
+|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Which technology channels this setting can be deployed through Inherited from [deviceManagementConfigurationSettingApplicability](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingapplicability.md). Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `linuxMdm`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`.|
|configurationServiceProviderVersion|String|Version of CSP setting is a part of| |maximumSupportedVersion|String|Maximum supported version of Windows| |minimumSupportedVersion|String|Minimum supported version of Windows|
v1.0 Intune Deviceconfigv2 Devicemanagementprioritymetadata https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-deviceconfigv2-devicemanagementprioritymetadata.md
Title: "deviceManagementPriorityMetaData resource type"
-description: "Not yet documented"
+description: "Priority metadata of the policy."
localization_priority: Normal ms.prod: "intune"
Namespace: microsoft.graph
> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-Not yet documented
+Priority metadata of the policy.
## Properties |Property|Type|Description| |:|:|:|
+|priority|Int32|Priority of the policy. Valid values 1 to 500|
## Relationships None
Here is a JSON representation of the resource.
--> ``` json {
- "@odata.type": "#microsoft.graph.deviceManagementPriorityMetaData"
+ "@odata.type": "#microsoft.graph.deviceManagementPriorityMetaData",
+ "priority": 1024
} ```
v1.0 Intune Devices Comanagementeligibledevice https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-comanagementeligibledevice.md
Device Co-Management eligibility state
|upn|String|UPN| |userEmail|String|UserEmail| |userName|String|UserName|
-|status|[comanagementEligibleType](../resources/intune-devices-comanagementeligibletype.md)|ComanagementEligibleStatus. Possible values are: `comanaged`, `eligible`, `eligibleButNotAzureAdJoined`, `needsOsUpdate`, `ineligible`, `scheduledForEnrollment`.|
+|status|[comanagementEligibleType](../resources/intune-devices-comanagementeligibletype.md)|ComanagementEligibleStatus. Possible values are: `comanaged`, `eligible`, `eligibleButNotAzureAdJoined`, `needsOsUpdate`, `ineligible`, `scheduledForEnrollment`, `unknownFutureValue`.|
## Relationships None
v1.0 Intune Devices Comanagementeligibledevicessummary https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-comanagementeligibledevicessummary.md
Not yet documented
|:|:|:| |comanagedCount|Int32|Count of devices already Co-Managed| |eligibleCount|Int32|Count of devices fully eligible for Co-Management|
+|scheduledForEnrollmentCount|Int32|Count of devices scheduled for Co-Management enrollment. Valid values 0 to 9999999|
|eligibleButNotAzureAdJoinedCount|Int32|Count of devices eligible for Co-Management but not yet joined to Azure Active Directory| |needsOsUpdateCount|Int32|Count of devices that will be eligible for Co-Management after an OS update| |ineligibleCount|Int32|Count of devices ineligible for Co-Management|
Here is a JSON representation of the resource.
"@odata.type": "#microsoft.graph.comanagementEligibleDevicesSummary", "comanagedCount": 1024, "eligibleCount": 1024,
+ "scheduledForEnrollmentCount": 1024,
"eligibleButNotAzureAdJoinedCount": 1024, "needsOsUpdateCount": 1024, "ineligibleCount": 1024
v1.0 Intune Devices Comanagementeligibletype https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-comanagementeligibletype.md
Not yet documented
|needsOsUpdate|4|Not yet documented| |ineligible|5|Not yet documented| |scheduledForEnrollment|6|Devices scheduled for Co-Management enrollment|
+|unknownFutureValue|7|Evolvable enumeration sentinel value. Do not use.|
v1.0 Intune Devices Detectedapp https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-detectedapp.md
A managed or unmanaged app that is installed on a managed device. Unmanaged apps
|sizeInByte|Int64|Discovered application size in bytes. Read-only| |deviceCount|Int32|The number of devices that have installed this application| |publisher|String|Indicates the publisher of the discovered application. For example: 'Microsoft'. The default value is an empty string.|
-|platform|[detectedAppPlatformType](../resources/intune-devices-detectedappplatformtype.md)|Indicates the operating system / platform of the discovered application. Some possible values are Windows, iOS, macOS. The default value is unknown (0). Possible values are: `unknown`, `windows`, `windowsMobile`, `windowsHolographic`, `ios`, `macOS`, `chromeOS`, `androidOSP`, `androidDeviceAdministrator`, `androidWorkProfile`, `androidDedicatedAndFullyManaged`.|
+|platform|[detectedAppPlatformType](../resources/intune-devices-detectedappplatformtype.md)|Indicates the operating system / platform of the discovered application. Some possible values are Windows, iOS, macOS. The default value is unknown (0). Possible values are: `unknown`, `windows`, `windowsMobile`, `windowsHolographic`, `ios`, `macOS`, `chromeOS`, `androidOSP`, `androidDeviceAdministrator`, `androidWorkProfile`, `androidDedicatedAndFullyManaged`, `unknownFutureValue`.|
## Relationships |Relationship|Type|Description|
v1.0 Intune Devices Detectedappplatformtype https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-detectedappplatformtype.md
Indicates the operating system / platform of the discovered application. Some p
|androidDeviceAdministrator|8|Indicates that the platform of the detected application is Android device administrator.| |androidWorkProfile|9|Indicates that the platform of the detected application is Android work profile.| |androidDedicatedAndFullyManaged|10|Indicates that the platform of the detected application is Android dedicated and fully managed.|
+|unknownFutureValue|11|Evolvable enumeration sentinel value. Do not use.|
v1.0 Intune Devices Devicelogcollectionresponse https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-devicelogcollectionresponse.md
Windows Log Collection request entity.
|initiatedByUserPrincipalName|String|The UPN for who initiated the request| |expirationDateTimeUTC|DateTimeOffset|The DateTime of the expiration of the logs| |size|Double|The size of the logs. Valid values -1.79769313486232E+308 to 1.79769313486232E+308|
+|enrolledByUser|String|The User Principal Name (UPN) of the user that enrolled the device|
## Relationships None
Here is a JSON representation of the resource.
"receivedDateTimeUTC": "String (timestamp)", "initiatedByUserPrincipalName": "String", "expirationDateTimeUTC": "String (timestamp)",
- "size": "4.2"
+ "size": "4.2",
+ "enrolledByUser": "String"
} ```
v1.0 Intune Devices Devicescopeaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-devicescopeaction.md
Trigger on the service to either START or STOP computing metrics data based on a
## Members |Member|Value|Description| |:|:|:|
-|stop|0|Stop computing metrics data|
+|stop|0|Stop computing metrics data|
|start|1|Start computing metrics data| -
v1.0 Intune Devices Manageddevice https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-manageddevice.md
Devices that are managed or pre-enrolled through Intune
|[reenable action](../api/intune-devices-manageddevice-reenable.md)|None|Not yet documented| |[moveDevicesToOU action](../api/intune-devices-manageddevice-movedevicestoou.md)|None|Not yet documented| |[removeDeviceFirmwareConfigurationInterfaceManagement action](../api/intune-devices-manageddevice-removedevicefirmwareconfigurationinterfacemanagement.md)|None|Remove device from Device Firmware Configuration Interface management|
+|[initiateMobileDeviceManagementKeyRecovery action](../api/intune-devices-manageddevice-initiatemobiledevicemanagementkeyrecovery.md)|None|Perform MDM key recovery and TPM attestation|
|[getOemWarranty function](../api/intune-devices-manageddevice-getoemwarranty.md)|[oemWarranty](../resources/intune-devices-oemwarranty.md)|Not yet documented| |[appDiagnostics function](../api/intune-devices-manageddevice-appdiagnostics.md)|[powerliftIncidentMetadata](../resources/intune-devices-powerliftincidentmetadata.md) collection|Not yet documented| |[downloadAppDiagnostics action](../api/intune-devices-manageddevice-downloadappdiagnostics.md)|Stream|Not yet documented|
Devices that are managed or pre-enrolled through Intune
|id|String|Unique Identifier for the device. This property is read-only.| |userId|String|Unique Identifier for the user associated with the device. This property is read-only.| |deviceName|String|Name of the device. This property is read-only.|
-|hardwareInformation|[hardwareInformation](../resources/intune-devices-hardwareinformation.md)|The hardward details for the device. Includes information such as storage space, manufacturer, serial number, etc. This property is read-only.|
+|hardwareInformation|[hardwareInformation](../resources/intune-devices-hardwareinformation.md)|The hardward details for the device. Includes information such as storage space, manufacturer, serial number, etc. Return default value in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only.|
|ownerType|[ownerType](../resources/intune-shared-ownertype.md)|Ownership of the device. Can be 'company' or 'personal'. Possible values are: `unknown`, `company`, `personal`.| |managedDeviceOwnerType|[managedDeviceOwnerType](../resources/intune-shared-manageddeviceownertype.md)|Ownership of the device. Can be 'company' or 'personal'. Possible values are: `unknown`, `company`, `personal`.| |deviceActionResults|[deviceActionResult](../resources/intune-devices-deviceactionresult.md) collection|List of ComplexType deviceActionResult objects. This property is read-only.|
Devices that are managed or pre-enrolled through Intune
|subscriberCarrier|String|Subscriber Carrier. This property is read-only.| |meid|String|MEID. This property is read-only.| |totalStorageSpaceInBytes|Int64|Total Storage in Bytes. This property is read-only.|
-|freeStorageSpaceInBytes|Int64|Free Storage in Bytes. This property is read-only.|
+|freeStorageSpaceInBytes|Int64|Free Storage in Bytes. Default value is 0. Read-only. This property is read-only.|
|managedDeviceName|String|Automatically generated name to identify a device. Can be overwritten to a user friendly name.| |partnerReportedThreatState|[managedDevicePartnerReportedHealthState](../resources/intune-devices-manageddevicepartnerreportedhealthstate.md)|Indicates the threat state of a device when a Mobile Threat Defense partner is in use by the account and device. Read Only. This property is read-only. Possible values are: `unknown`, `activated`, `deactivated`, `secured`, `lowSeverity`, `mediumSeverity`, `highSeverity`, `unresponsive`, `compromised`, `misconfigured`.| |retireAfterDateTime|DateTimeOffset|Indicates the time after when a device will be auto retired because of scheduled action. This property is read-only.|
Devices that are managed or pre-enrolled through Intune
|autopilotEnrolled|Boolean|Reports if the managed device is enrolled via auto-pilot. This property is read-only.| |requireUserEnrollmentApproval|Boolean|Reports if the managed iOS device is user approval enrollment. This property is read-only.| |managementCertificateExpirationDate|DateTimeOffset|Reports device management certificate expiration date. This property is read-only.|
-|iccid|String|Integrated Circuit Card Identifier, it is A SIM card's unique identification number. This property is read-only.|
-|udid|String|Unique Device Identifier for iOS and macOS devices. This property is read-only.|
+|iccid|String|Integrated Circuit Card Identifier, it is A SIM card's unique identification number. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only.|
+|udid|String|Unique Device Identifier for iOS and macOS devices. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only.|
|roleScopeTagIds|String collection|List of Scope Tag IDs for this Device instance.| |windowsActiveMalwareCount|Int32|Count of active malware for this windows device. This property is read-only.| |windowsRemediatedMalwareCount|Int32|Count of remediated malware for this windows device. This property is read-only.|
-|notes|String|Notes on the device created by IT Admin|
+|notes|String|Notes on the device created by IT Admin. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported.|
|configurationManagerClientHealthState|[configurationManagerClientHealthState](../resources/intune-devices-configurationmanagerclienthealthstate.md)|Configuration manager client health state, valid only for devices managed by MDM/ConfigMgr Agent| |configurationManagerClientInformation|[configurationManagerClientInformation](../resources/intune-devices-configurationmanagerclientinformation.md)|Configuration manager client information, valid only for devices managed, duel-managed or tri-managed by ConfigMgr Agent| |ethernetMacAddress|String|Ethernet MAC. This property is read-only.|
-|physicalMemoryInBytes|Int64|Total Memory in Bytes. This property is read-only.|
+|physicalMemoryInBytes|Int64|Total Memory in Bytes. Return default value 0 in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. Default value is 0. Read-only. This property is read-only.|
|processorArchitecture|[managedDeviceArchitecture](../resources/intune-devices-manageddevicearchitecture.md)|Processor architecture. This property is read-only. Possible values are: `unknown`, `x86`, `x64`, `arm`, `arM64`.| |specificationVersion|String|Specification version. This property is read-only.| |joinType|[joinType](../resources/intune-devices-jointype.md)|Device join type. Possible values are: `unknown`, `azureADJoined`, `azureADRegistered`, `hybridAzureADJoined`.| |skuFamily|String|Device sku family|
-|skuNumber|Int32|Device sku number, see also: https://docs.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only.|
+|skuNumber|Int32|Device sku number, see also: https://learn.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only.|
|managementFeatures|[managedDeviceManagementFeatures](../resources/intune-devices-manageddevicemanagementfeatures.md)|Device management features. Possible values are: `none`, `microsoftManagedDesktop`.| |chromeOSDeviceInfo|[chromeOSDeviceProperty](../resources/intune-devices-chromeosdeviceproperty.md) collection|List of properties of the ChromeOS Device.| |enrollmentProfileName|String|Name of the enrollment profile assigned to the device. Default value is empty string, indicating no enrollment profile was assgined. This property is read-only.|
Here is a JSON representation of the resource.
+
v1.0 Intune Devices Manageddeviceremoteaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-manageddeviceremoteaction.md
Not yet documented
|moveDeviceToOrganizationalUnit|13|Name of the moveDevicesToOU action.| |activateDeviceEsim|14|Name of action to Activate eSIM on the device.| |collectDiagnostics|15|Name of the collectDiagnostics action.|
+|initiateMobileDeviceManagementKeyRecovery|16|Name of action to initiate MDM key recovery|
v1.0 Intune Devices Remoteaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-remoteaction.md
Remote actions Intune supports.
|disable|25|Indicate user initiates an action to disable the device.| |reenable|26|Indicate user initiates an action to reenable the device.| |moveDeviceToOrganizationalUnit|27|Indicate user initiates an action to move the device to a new organizational unit.|
+|initiateMobileDeviceManagementKeyRecovery|28|Add device action of InitiateMobileDeviceManagementKeyRecovery|
v1.0 Intune Devices Remoteactionaudit https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-remoteactionaudit.md
Report of remote actions initiated on the devices belonging to a certain tenant.
|deviceDisplayName|String|Intune device name.| |userName|String|\[deprecated\] Please use InitiatedByUserPrincipalName instead.| |initiatedByUserPrincipalName|String|User who initiated the device action, format is UPN.|
-|action|[remoteAction](../resources/intune-devices-remoteaction.md)|The action name. Possible values are: `unknown`, `factoryReset`, `removeCompanyData`, `resetPasscode`, `remoteLock`, `enableLostMode`, `disableLostMode`, `locateDevice`, `rebootNow`, `recoverPasscode`, `cleanWindowsDevice`, `logoutSharedAppleDeviceActiveUser`, `quickScan`, `fullScan`, `windowsDefenderUpdateSignatures`, `factoryResetKeepEnrollmentData`, `updateDeviceAccount`, `automaticRedeployment`, `shutDown`, `rotateBitLockerKeys`, `rotateFileVaultKey`, `getFileVaultKey`, `setDeviceName`, `activateDeviceEsim`, `deprovision`, `disable`, `reenable`, `moveDeviceToOrganizationalUnit`.|
+|action|[remoteAction](../resources/intune-devices-remoteaction.md)|The action name. Possible values are: `unknown`, `factoryReset`, `removeCompanyData`, `resetPasscode`, `remoteLock`, `enableLostMode`, `disableLostMode`, `locateDevice`, `rebootNow`, `recoverPasscode`, `cleanWindowsDevice`, `logoutSharedAppleDeviceActiveUser`, `quickScan`, `fullScan`, `windowsDefenderUpdateSignatures`, `factoryResetKeepEnrollmentData`, `updateDeviceAccount`, `automaticRedeployment`, `shutDown`, `rotateBitLockerKeys`, `rotateFileVaultKey`, `getFileVaultKey`, `setDeviceName`, `activateDeviceEsim`, `deprovision`, `disable`, `reenable`, `moveDeviceToOrganizationalUnit`, `initiateMobileDeviceManagementKeyRecovery`.|
|requestDateTime|DateTimeOffset|Time when the action was issued, given in UTC.| |deviceOwnerUserPrincipalName|String|Upn of the device owner.| |deviceIMEI|String|IMEI of the device.|
v1.0 Intune Devices Userexperienceanalyticsanomalyseverityoverview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsanomalyseverityoverview.md
The user experience analytics anomaly severity overview entity contains the coun
|mediumSeverityAnomalyCount|Int32|The number of medium severity anomalies which have been detected. Valid values -2147483648 to 2147483647| |highSeverityAnomalyCount|Int32|The number of high severity anomalies which have been detected. Valid values -2147483648 to 2147483647| |informationalSeverityAnomalyCount|Int32|The number of informational severity anomalies which have been detected. Valid values -2147483648 to 2147483647|
-|otherSeverityAnomalyCount|Int32|The number of anomalies which have been detected with undefined severity. Valid values -2147483648 to 2147483647|
## Relationships None
Here is a JSON representation of the resource.
"lowSeverityAnomalyCount": 1024, "mediumSeverityAnomalyCount": 1024, "highSeverityAnomalyCount": 1024,
- "informationalSeverityAnomalyCount": 1024,
- "otherSeverityAnomalyCount": 1024
+ "informationalSeverityAnomalyCount": 1024
} ```
v1.0 Intune Devices Userexperienceanalyticsdevicescopesummary https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-userexperienceanalyticsdevicescopesummary.md
+
+ Title: "userExperienceAnalyticsDeviceScopeSummary resource type"
+description: "The user experience analytics tenant level information for all the device scope configurations"
+
+localization_priority: Normal
++
+# userExperienceAnalyticsDeviceScopeSummary resource type
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+The user experience analytics tenant level information for all the device scope configurations
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|totalDeviceScopes|Int32|The total number of user experience analytics device scopes. Valid values -2147483648 to 2147483647|
+|totalDeviceScopesEnabled|Int32|The total number of user experience analytics device scopes that are enabled. Valid values -2147483648 to 2147483647|
+|completedDeviceScopeIds|String collection|A collection of the user experience analytics device scope Unique Identifiers that are enabled and finished recalculating the report metric.|
+|insufficientDataDeviceScopeIds|String collection|A collection of user experience analytics device scope Unique Identitfiers that are enabled but there is insufficient data to calculate results.|
+
+## Relationships
+None
+
+## JSON Representation
+Here is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.userExperienceAnalyticsDeviceScopeSummary"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.userExperienceAnalyticsDeviceScopeSummary",
+ "totalDeviceScopes": 1024,
+ "totalDeviceScopesEnabled": 1024,
+ "completedDeviceScopeIds": [
+ "String"
+ ],
+ "insufficientDataDeviceScopeIds": [
+ "String"
+ ]
+}
+```
+++++
v1.0 Intune Devices Windowsmanageddevice https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-devices-windowsmanageddevice.md
Inherits from [managedDevice](../resources/intune-devices-manageddevice.md)
|id|String|Unique Identifier for the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |userId|String|Unique Identifier for the user associated with the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |deviceName|String|Name of the device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|hardwareInformation|[hardwareInformation](../resources/intune-devices-hardwareinformation.md)|The hardward details for the device. Includes information such as storage space, manufacturer, serial number, etc. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|hardwareInformation|[hardwareInformation](../resources/intune-devices-hardwareinformation.md)|The hardward details for the device. Includes information such as storage space, manufacturer, serial number, etc. Return default value in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|ownerType|[ownerType](../resources/intune-shared-ownertype.md)|Ownership of the device. Can be 'company' or 'personal' Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `company`, `personal`.| |managedDeviceOwnerType|[managedDeviceOwnerType](../resources/intune-shared-manageddeviceownertype.md)|Ownership of the device. Can be 'company' or 'personal' Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `company`, `personal`.| |deviceActionResults|[deviceActionResult](../resources/intune-devices-deviceactionresult.md) collection|List of ComplexType deviceActionResult objects. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
Inherits from [managedDevice](../resources/intune-devices-manageddevice.md)
|subscriberCarrier|String|Subscriber Carrier. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |meid|String|MEID. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |totalStorageSpaceInBytes|Int64|Total Storage in Bytes. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|freeStorageSpaceInBytes|Int64|Free Storage in Bytes. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|freeStorageSpaceInBytes|Int64|Free Storage in Bytes. Default value is 0. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|managedDeviceName|String|Automatically generated name to identify a device. Can be overwritten to a user friendly name. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |partnerReportedThreatState|[managedDevicePartnerReportedHealthState](../resources/intune-devices-manageddevicepartnerreportedhealthstate.md)|Indicates the threat state of a device when a Mobile Threat Defense partner is in use by the account and device. Read Only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `activated`, `deactivated`, `secured`, `lowSeverity`, `mediumSeverity`, `highSeverity`, `unresponsive`, `compromised`, `misconfigured`.| |retireAfterDateTime|DateTimeOffset|Indicates the time after when a device will be auto retired because of scheduled action. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
Inherits from [managedDevice](../resources/intune-devices-manageddevice.md)
|autopilotEnrolled|Boolean|Reports if the managed device is enrolled via auto-pilot. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |requireUserEnrollmentApproval|Boolean|Reports if the managed iOS device is user approval enrollment. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |managementCertificateExpirationDate|DateTimeOffset|Reports device management certificate expiration date. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|iccid|String|Integrated Circuit Card Identifier, it is A SIM card's unique identification number. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|udid|String|Unique Device Identifier for iOS and macOS devices. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|iccid|String|Integrated Circuit Card Identifier, it is A SIM card's unique identification number. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|udid|String|Unique Device Identifier for iOS and macOS devices. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|roleScopeTagIds|String collection|List of Scope Tag IDs for this Device instance. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |windowsActiveMalwareCount|Int32|Count of active malware for this windows device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |windowsRemediatedMalwareCount|Int32|Count of remediated malware for this windows device. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|notes|String|Notes on the device created by IT Admin Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|notes|String|Notes on the device created by IT Admin. Return default value null in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. $Search is not supported. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|configurationManagerClientHealthState|[configurationManagerClientHealthState](../resources/intune-devices-configurationmanagerclienthealthstate.md)|Configuration manager client health state, valid only for devices managed by MDM/ConfigMgr Agent Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |configurationManagerClientInformation|[configurationManagerClientInformation](../resources/intune-devices-configurationmanagerclientinformation.md)|Configuration manager client information, valid only for devices managed, duel-managed or tri-managed by ConfigMgr Agent Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |ethernetMacAddress|String|Ethernet MAC. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|physicalMemoryInBytes|Int64|Total Memory in Bytes. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|physicalMemoryInBytes|Int64|Total Memory in Bytes. Return default value 0 in LIST managedDevices. Real value only returned in singel device GET call with device id and included in select parameter. Supports: $select. Default value is 0. Read-only. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|processorArchitecture|[managedDeviceArchitecture](../resources/intune-devices-manageddevicearchitecture.md)|Processor architecture. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `x86`, `x64`, `arm`, `arM64`.| |specificationVersion|String|Specification version. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |joinType|[joinType](../resources/intune-devices-jointype.md)|Device join type Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `unknown`, `azureADJoined`, `azureADRegistered`, `hybridAzureADJoined`.| |skuFamily|String|Device sku family Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
-|skuNumber|Int32|Device sku number, see also: https://docs.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
+|skuNumber|Int32|Device sku number, see also: https://learn.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Valid values 0 to 2147483647. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
|managementFeatures|[managedDeviceManagementFeatures](../resources/intune-devices-manageddevicemanagementfeatures.md)|Device management features Inherited from [managedDevice](../resources/intune-devices-manageddevice.md). Possible values are: `none`, `microsoftManagedDesktop`.| |chromeOSDeviceInfo|[chromeOSDeviceProperty](../resources/intune-devices-chromeosdeviceproperty.md) collection|List of properties of the ChromeOS Device. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)| |enrollmentProfileName|String|Name of the enrollment profile assigned to the device. Default value is empty string, indicating no enrollment profile was assgined. This property is read-only. Inherited from [managedDevice](../resources/intune-devices-manageddevice.md)|
Here is a JSON representation of the resource.
+
v1.0 Intune Enrollment Depenrollmentbaseprofile https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-enrollment-depenrollmentbaseprofile.md
Inherits from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofi
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information.|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information.|
|supportDepartment|String|Support department information| |isMandatory|Boolean|Indicates if the profile is mandatory| |locationDisabled|Boolean|Indicates if Location service setup pane is disabled|
Here is a JSON representation of the resource.
+
v1.0 Intune Enrollment Depenrollmentprofile https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-enrollment-depenrollmentprofile.md
Inherits from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofi
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information.|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information.|
|supportDepartment|String|Support department information| |passCodeDisabled|Boolean|Indicates if Passcode setup pane is disabled| |isMandatory|Boolean|Indicates if the profile is mandatory|
Here is a JSON representation of the resource.
+
v1.0 Intune Enrollment Depiosenrollmentprofile https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-enrollment-depiosenrollmentprofile.md
Inherits from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrol
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. 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)|
Inherits from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrol
|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|
## Relationships None
Here is a JSON representation of the resource.
+
v1.0 Intune Enrollment Depmacosenrollmentprofile https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-enrollment-depmacosenrollmentprofile.md
Inherits from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrol
|enableAuthenticationViaCompanyPortal|Boolean|Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |requireCompanyPortalOnSetupAssistantEnrolledDevices|Boolean|Indicates that Company Portal is required on setup assistant enrolled devices Inherited from [enrollmentProfile](../resources/intune-enrollment-enrollmentprofile.md)| |isDefault|Boolean|Indicates if this is the default profile Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
-|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. See https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Inherited from [depEnrollmentBaseProfile](../resources/intune-enrollment-depenrollmentbaseprofile.md)|
+|supervisedModeEnabled|Boolean|Supervised mode, True to enable, false otherwise. 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)|
Here is a JSON representation of the resource.
+
v1.0 Intune Gpanalyticsservice Grouppolicymigrationreport https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-gpanalyticsservice-grouppolicymigrationreport.md
The Group Policy migration report.
|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.|
## Relationships |Relationship|Type|Description|
Here is a JSON representation of the resource.
"targetedInActiveDirectory": true, "totalSettingsCount": 1024, "supportedSettingsCount": 1024,
- "supportedSettingsPercent": 1024
+ "supportedSettingsPercent": 1024,
+ "roleScopeTagIds": [
+ "String"
+ ]
} ```
v1.0 Intune Gpanalyticsservice Grouppolicyobjectfile https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-gpanalyticsservice-grouppolicyobjectfile.md
The Group Policy Object file uploaded by admin.
|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.|
## Relationships None
Here is a JSON representation of the resource.
"ouDistinguishedName": "String", "createdDateTime": "String (timestamp)", "lastModifiedDateTime": "String (timestamp)",
- "content": "String"
+ "content": "String",
+ "roleScopeTagIds": [
+ "String"
+ ]
} ```
v1.0 Intune Mam Appmanagementlevel https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-mam-appmanagementlevel.md
Management levels for apps
|androidEnterpriseDedicatedDevicesWithAzureAdSharedMode|8|Android Enterprise dedicated devices with Azure AD Shared mode| |androidOpenSourceProjectUserAssociated|16|Android Open Source Project (AOSP) devices| |androidOpenSourceProjectUserless|32|Android Open Source Project (AOSP) userless devices|
+|unknownFutureValue|64|Place holder for evolvable enum|
v1.0 Intune Mam Defaultmanagedappprotection https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-mam-defaultmanagedappprotection.md
Inherits from [managedAppProtection](../resources/intune-mam-managedappprotectio
|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)|
## Relationships |Relationship|Type|Description|
Here is a JSON representation of the resource.
"appActionIfDevicePasscodeComplexityLessThanHigh": "String", "requireClass3Biometrics": true, "requirePinAfterBiometricChange": true,
- "fingerprintAndBiometricEnabled": true
+ "fingerprintAndBiometricEnabled": true,
+ "minimumWarningSdkVersion": "String"
} ```
v1.0 Intune Mam Devicemanagementreports https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-mam-devicemanagementreports.md
Singleton entity that acts as a container for all device management functionalit
|[Get deviceManagementReports](../api/intune-mam-devicemanagementreports-get.md)|[deviceManagementReports](../resources/intune-mam-devicemanagementreports.md)|Read properties and relationships of the [deviceManagementReports](../resources/intune-mam-devicemanagementreports.md) object.| |[Update deviceManagementReports](../api/intune-mam-devicemanagementreports-update.md)|[deviceManagementReports](../resources/intune-mam-devicemanagementreports.md)|Update the properties of a [deviceManagementReports](../resources/intune-mam-devicemanagementreports.md) object.| |[getMobileApplicationManagementAppRegistrationSummaryReport action](../api/intune-mam-devicemanagementreports-getmobileapplicationmanagementappregistrationsummaryreport.md)|Stream|Not yet documented|
+|[getMobileApplicationManagementAppConfigurationReport action](../api/intune-mam-devicemanagementreports-getmobileapplicationmanagementappconfigurationreport.md)|Stream|Not yet documented|
## Properties |Property|Type|Description|
v1.0 Intune Mam Targetedmanagedappprotection https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-mam-targetedmanagedappprotection.md
Inherits from [managedAppProtection](../resources/intune-mam-managedappprotectio
|dialerRestrictionLevel|[managedAppPhoneNumberRedirectLevel](../resources/intune-mam-managedappphonenumberredirectlevel.md)|The classes of dialer apps that are allowed to click-to-open a phone number. Inherited from [managedAppProtection](../resources/intune-mam-managedappprotection.md). Possible values are: `allApps`, `managedApps`, `customApp`, `blocked`.| |gracePeriodToBlockAppsDuringOffClockHours|Duration|A grace period before blocking app access during off clock hours. Inherited from [managedAppProtection](../resources/intune-mam-managedappprotection.md)| |isAssigned|Boolean|Indicates if the policy is deployed to any inclusion groups or not.|
-|targetedAppManagementLevels|[appManagementLevel](../resources/intune-mam-appmanagementlevel.md)|The intended app management levels for this policy. Possible values are: `unspecified`, `unmanaged`, `mdm`, `androidEnterprise`, `androidEnterpriseDedicatedDevicesWithAzureAdSharedMode`, `androidOpenSourceProjectUserAssociated`, `androidOpenSourceProjectUserless`.|
+|targetedAppManagementLevels|[appManagementLevel](../resources/intune-mam-appmanagementlevel.md)|The intended app management levels for this policy. Possible values are: `unspecified`, `unmanaged`, `mdm`, `androidEnterprise`, `androidEnterpriseDedicatedDevicesWithAzureAdSharedMode`, `androidOpenSourceProjectUserAssociated`, `androidOpenSourceProjectUserless`, `unknownFutureValue`.|
|appGroupType|[targetedManagedAppGroupType](../resources/intune-mam-targetedmanagedappgrouptype.md)|Public Apps selection: group or individual. Possible values are: `selectedPublicApps`, `allCoreMicrosoftApps`, `allMicrosoftApps`, `allApps`.| ## Relationships
v1.0 Intune Onboarding Devicemanagementpartner https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-onboarding-devicemanagementpartner.md
Entity which represents a connection to device management partner.
|[Create deviceManagementPartner](../api/intune-onboarding-devicemanagementpartner-create.md)|[deviceManagementPartner](../resources/intune-onboarding-devicemanagementpartner.md)|Create a new [deviceManagementPartner](../resources/intune-onboarding-devicemanagementpartner.md) object.| |[Delete deviceManagementPartner](../api/intune-onboarding-devicemanagementpartner-delete.md)|None|Deletes a [deviceManagementPartner](../resources/intune-onboarding-devicemanagementpartner.md).| |[Update deviceManagementPartner](../api/intune-onboarding-devicemanagementpartner-update.md)|[deviceManagementPartner](../resources/intune-onboarding-devicemanagementpartner.md)|Update the properties of a [deviceManagementPartner](../resources/intune-onboarding-devicemanagementpartner.md) object.|
+|[terminate action](../api/intune-onboarding-devicemanagementpartner-terminate.md)|None|Not yet documented|
## Properties |Property|Type|Description|
v1.0 Intune Onboarding Windows10enrollmentcompletionpageconfiguration https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-onboarding-windows10enrollmentcompletionpageconfiguration.md
Inherits from [deviceEnrollmentConfiguration](../resources/intune-shared-devicee
|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 a JSON representation of the resource.
"String" ], "allowNonBlockingAppInstallation": true,
+ "installQualityUpdates": true,
"trackInstallProgressForAutopilotOnly": true, "disableUserStatusTrackingAfterFirstUser": true }
v1.0 Intune Partnerintegration Organizationalmessagecontent https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-partnerintegration-organizationalmessagecontent.md
- Title: "organizationalMessageContent resource type"
-description: "Contains the entire content of the message that will be displayed to the clients"
-
-localization_priority: Normal
-doc_type: resourcePageType
--
-# organizationalMessageContent resource type
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Contains the entire content of the message that will be displayed to the clients
-
-## Properties
-|Property|Type|Description|
-|:|:|:|
-|guidedContentId|String|The ID of the guided content that this content is using|
-|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|
-|logoInfo|[organizationalMessageLogo](../resources/intune-partnerintegration-organizationalmessagelogo.md)|The logo that will be displayed to the clients. This will contain ether the binary contents of the logo or a url to the logo's location|
-
-## Relationships
-None
-
-## JSON Representation
-Here is a JSON representation of the resource.
-<!-- {
- "blockType": "resource",
- "@odata.type": "microsoft.graph.organizationalMessageContent"
-}
>
-``` json
-{
- "@odata.type": "#microsoft.graph.organizationalMessageContent",
- "guidedContentId": "String",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "String",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "String",
- "name": "String",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "String",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "String",
- "message": "String",
- "clickUrl": "String",
- "buttonText": "String"
- }
- }
- ]
- }
- ]
- }
- ],
- "logoInfo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogo",
- "logo": "binary",
- "contentType": "String",
- "logoCdnUrl": "String"
- }
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessagedetail https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-partnerintegration-organizationalmessagedetail.md
- Title: "organizationalMessageDetail resource type"
-description: "This will allow the admin to see the specific details of an organizational message that has been created for their tenant"
-
-localization_priority: Normal
-doc_type: resourcePageType
--
-# organizationalMessageDetail resource type
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-This will allow the admin to see the specific details of an organizational message that has been created for their tenant
-
-## Methods
-|Method|Return Type|Description|
-|:|:|:|
-|[List organizationalMessageDetails](../api/intune-partnerintegration-organizationalmessagedetail-list.md)|[organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) collection|List properties and relationships of the [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) objects.|
-|[Get organizationalMessageDetail](../api/intune-partnerintegration-organizationalmessagedetail-get.md)|[organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md)|Read properties and relationships of the [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object.|
-|[Create organizationalMessageDetail](../api/intune-partnerintegration-organizationalmessagedetail-create.md)|[organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md)|Create a new [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object.|
-|[Delete organizationalMessageDetail](../api/intune-partnerintegration-organizationalmessagedetail-delete.md)|None|Deletes a [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md).|
-|[Update organizationalMessageDetail](../api/intune-partnerintegration-organizationalmessagedetail-update.md)|[organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md)|Update the properties of a [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object.|
-
-## Properties
-|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|
-
-## Relationships
-None
-
-## JSON Representation
-Here is a JSON representation of the resource.
-<!-- {
- "blockType": "resource",
- "keyProperty": "id",
- "@odata.type": "microsoft.graph.organizationalMessageDetail"
-}
>
-``` json
-{
- "@odata.type": "#microsoft.graph.organizationalMessageDetail",
- "id": "String (identifier)",
- "scenario": "String",
- "surface": "String",
- "status": "String",
- "startDateTime": "String (timestamp)",
- "endDateTime": "String (timestamp)",
- "createdDateTime": "String (timestamp)",
- "lastModifiedDateTime": "String (timestamp)",
- "userEngagementStatistics": {
- "@odata.type": "microsoft.graph.organizationalMessageInsights",
- "impressions": 1024,
- "clicks": 1024,
- "dismisses": 1024
- },
- "frequency": "String",
- "targeting": {
- "@odata.type": "microsoft.graph.organizationalMessageTargeting",
- "targetingType": "String",
- "includeIds": [
- "String"
- ],
- "excludeIds": [
- "String"
- ]
- },
- "content": {
- "@odata.type": "microsoft.graph.organizationalMessageContent",
- "guidedContentId": "String",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "String",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "String",
- "name": "String",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "String",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "String",
- "message": "String",
- "clickUrl": "String",
- "buttonText": "String"
- }
- }
- ]
- }
- ]
- }
- ],
- "logoInfo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogo",
- "logo": "binary",
- "contentType": "String",
- "logoCdnUrl": "String"
- }
- },
- "theme": "String",
- "variant": "String"
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessagefrequency https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-partnerintegration-organizationalmessagefrequency.md
- Title: "organizationalMessageFrequency enum type"
-description: "Indicates the frequency at which a client will see the message"
-
-localization_priority: Normal
-doc_type: enumPageType
--
-# organizationalMessageFrequency enum type
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Indicates the frequency at which a client will see the message
-
-## Members
-|Member|Value|Description|
-|:|:|:|
-|weeklyOnce|0|Indicates that the message will be displayed once a week|
-|monthlyOnce|1|Indicates that the message will be displayed once a month|
-|monthlyTwice|2|Indicates that the message will be displayed twice a month|
-|unknownFutureValue|3|UnknownFutureValue, Evolvable enumeration sentinel value. Do not use.|
-----
v1.0 Intune Partnerintegration Organizationalmessageguidedcontent https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-partnerintegration-organizationalmessageguidedcontent.md
- Title: "organizationalMessageGuidedContent resource type"
-description: "This will allow the admin to see the different templated organizational messages that can be created"
-
-localization_priority: Normal
-doc_type: resourcePageType
--
-# organizationalMessageGuidedContent resource type
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-This will allow the admin to see the different templated organizational messages that can be created
-
-## Methods
-|Method|Return Type|Description|
-|:|:|:|
-|[List organizationalMessageGuidedContents](../api/intune-partnerintegration-organizationalmessageguidedcontent-list.md)|[organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) collection|List properties and relationships of the [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) objects.|
-|[Get organizationalMessageGuidedContent](../api/intune-partnerintegration-organizationalmessageguidedcontent-get.md)|[organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md)|Read properties and relationships of the [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object.|
-|[Create organizationalMessageGuidedContent](../api/intune-partnerintegration-organizationalmessageguidedcontent-create.md)|[organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md)|Create a new [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object.|
-|[Delete organizationalMessageGuidedContent](../api/intune-partnerintegration-organizationalmessageguidedcontent-delete.md)|None|Deletes a [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md).|
-|[Update organizationalMessageGuidedContent](../api/intune-partnerintegration-organizationalmessageguidedcontent-update.md)|[organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md)|Update the properties of a [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object.|
-
-## Properties
-|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|
-
-## Relationships
-None
-
-## JSON Representation
-Here is a JSON representation of the resource.
-<!-- {
- "blockType": "resource",
- "keyProperty": "id",
- "@odata.type": "microsoft.graph.organizationalMessageGuidedContent"
-}
>
-``` json
-{
- "@odata.type": "#microsoft.graph.organizationalMessageGuidedContent",
- "id": "String (identifier)",
- "scenario": "String",
- "theme": "String",
- "surface": "String",
- "placementDetails": [
- {
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "String",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "String",
- "name": "String",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "String",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "String",
- "message": "String",
- "clickUrl": "String",
- "buttonText": "String"
- }
- }
- ]
- }
- ]
- }
- ],
- "logo": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide",
- "logoCdnUrl": "String",
- "assetName": "String",
- "dimensions": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",
- "minWidth": 1024,
- "maxWidth": 1024,
- "minHeight": 1024,
- "maxHeight": 1024
- }
- }
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessageinsights https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-partnerintegration-organizationalmessageinsights.md
- Title: "organizationalMessageInsights resource type"
-description: "Contains statistics into how the organizational message was interacted with by clients"
-
-localization_priority: Normal
-doc_type: resourcePageType
--
-# organizationalMessageInsights resource type
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Contains statistics into how the organizational message was interacted with by clients
-
-## Properties
-|Property|Type|Description|
-|:|:|:|
-|impressions|Int32|The number of times this message was shown to all clients|
-|clicks|Int32|The number of times this message was clicked on|
-|dismisses|Int32|The number of times this message was dismissed by a user. This may not be collected for some surfaces and will be null|
-
-## Relationships
-None
-
-## JSON Representation
-Here is a JSON representation of the resource.
-<!-- {
- "blockType": "resource",
- "@odata.type": "microsoft.graph.organizationalMessageInsights"
-}
>
-``` json
-{
- "@odata.type": "#microsoft.graph.organizationalMessageInsights",
- "impressions": 1024,
- "clicks": 1024,
- "dismisses": 1024
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessagelocalizedtext https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-partnerintegration-organizationalmessagelocalizedtext.md
- Title: "organizationalMessageLocalizedText resource type"
-description: "Contains the text to be displayed for a given locale"
-
-localization_priority: Normal
-doc_type: resourcePageType
--
-# organizationalMessageLocalizedText resource type
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Contains the text to be displayed for a given locale
-
-## Properties
-|Property|Type|Description|
-|:|:|:|
-|locale|String|The locale for this text|
-|text|[organizationalMessageText](../resources/intune-partnerintegration-organizationalmessagetext.md)|The text that will be displayed to a user from this specific locale|
-
-## Relationships
-None
-
-## JSON Representation
-Here is a JSON representation of the resource.
-<!-- {
- "blockType": "resource",
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText"
-}
>
-``` json
-{
- "@odata.type": "#microsoft.graph.organizationalMessageLocalizedText",
- "locale": "String",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "String",
- "message": "String",
- "clickUrl": "String",
- "buttonText": "String"
- }
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessagelogo https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-partnerintegration-organizationalmessagelogo.md
- Title: "organizationalMessageLogo resource type"
-description: "Contains the logo's binary content or a url to the logo's downloadable location. Either both logo and contentType contain valid values or logoCdnUrl contains a valid url"
-
-localization_priority: Normal
-doc_type: resourcePageType
--
-# organizationalMessageLogo resource type
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Contains the logo's binary content or a url to the logo's downloadable location. Either both logo and contentType contain valid values or logoCdnUrl contains a valid url
-
-## Properties
-|Property|Type|Description|
-|:|:|:|
-|logo|Binary|The binary contents of the logo. This is null when logoCdnUrl is used to send the logo|
-|contentType|[organizationalMessageLogoType](../resources/intune-partnerintegration-organizationalmessagelogotype.md)|The content type of the logo that is contained in the logo array. This is null when logoCdnUrl is used to send the logo. Possible values are: `png`, `unknownFutureValue`.|
-|logoCdnUrl|String|The url at which the logo resides. This is null when logo and contentType are used to send the logo|
-
-## Relationships
-None
-
-## JSON Representation
-Here is a JSON representation of the resource.
-<!-- {
- "blockType": "resource",
- "@odata.type": "microsoft.graph.organizationalMessageLogo"
-}
>
-``` json
-{
- "@odata.type": "#microsoft.graph.organizationalMessageLogo",
- "logo": "binary",
- "contentType": "String",
- "logoCdnUrl": "String"
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessagelogodimensions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-partnerintegration-organizationalmessagelogodimensions.md
- Title: "organizationalMessageLogoDimensions resource type"
-description: "Contains the required size dimensions of a logo"
-
-localization_priority: Normal
-doc_type: resourcePageType
--
-# organizationalMessageLogoDimensions resource type
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Contains the required size dimensions of a logo
-
-## Properties
-|Property|Type|Description|
-|:|:|:|
-|minWidth|Int32|Minimum width of the logo|
-|maxWidth|Int32|Maximum width of the logo|
-|minHeight|Int32|Minimum height of the logo|
-|maxHeight|Int32|Maximum height of the logo|
-
-## Relationships
-None
-
-## JSON Representation
-Here is a JSON representation of the resource.
-<!-- {
- "blockType": "resource",
- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions"
-}
>
-``` json
-{
- "@odata.type": "#microsoft.graph.organizationalMessageLogoDimensions",
- "minWidth": 1024,
- "maxWidth": 1024,
- "minHeight": 1024,
- "maxHeight": 1024
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessagelogoguide https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-partnerintegration-organizationalmessagelogoguide.md
- Title: "organizationalMessageLogoGuide resource type"
-description: "Example logo and its size requirements"
-
-localization_priority: Normal
-doc_type: resourcePageType
--
-# organizationalMessageLogoGuide resource type
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Example logo and its size requirements
-
-## Properties
-|Property|Type|Description|
-|:|:|:|
-|logoCdnUrl|String|The url at which the logo resides|
-|assetName|String|The asset name is the key for this specific logo. This is used to compute the required token when accessing the logoCdnUrl to fetch the logo|
-|dimensions|[organizationalMessageLogoDimensions](../resources/intune-partnerintegration-organizationalmessagelogodimensions.md)|The required size dimensions of the logo|
-
-## Relationships
-None
-
-## JSON Representation
-Here is a JSON representation of the resource.
-<!-- {
- "blockType": "resource",
- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide"
-}
>
-``` json
-{
- "@odata.type": "#microsoft.graph.organizationalMessageLogoGuide",
- "logoCdnUrl": "String",
- "assetName": "String",
- "dimensions": {
- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",
- "minWidth": 1024,
- "maxWidth": 1024,
- "minHeight": 1024,
- "maxHeight": 1024
- }
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessagelogotype https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-partnerintegration-organizationalmessagelogotype.md
- Title: "organizationalMessageLogoType enum type"
-description: "Indicates the content type of the logo"
-
-localization_priority: Normal
-doc_type: enumPageType
--
-# organizationalMessageLogoType enum type
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Indicates the content type of the logo
-
-## Members
-|Member|Value|Description|
-|:|:|:|
-|png|0|Indicates that logo is a png file|
-|unknownFutureValue|1|UnknownFutureValue, Evolvable enumeration sentinel value. Do not use.|
-----
v1.0 Intune Partnerintegration Organizationalmessageplacement https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-partnerintegration-organizationalmessageplacement.md
- Title: "organizationalMessagePlacement enum type"
-description: "Indicates the name of the placement"
-
-localization_priority: Normal
-doc_type: enumPageType
--
-# organizationalMessagePlacement enum type
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Indicates the name of the placement
-
-## Members
-|Member|Value|Description|
-|:|:|:|
-|default|0|Indicates the default area for text to be displayed. This is the only valid placement value for the actionCenter and softLanding surfaces|
-|card0|1|Indicates the area where the first card is displayed. Only applies to the getStarted surface|
-|card1|2|Indicates the area where the second card is displayed. Only applies to the getStarted surface|
-|card2|3|Indicates the area where the third card is displayed. Only applies to the getStarted surface|
-|card3|4|Indicates the area where the fourth card is displayed. Only applies to the getStarted surface|
-|unknownFutureValue|5|UnknownFutureValue, Evolvable enumeration sentinel value. Do not use.|
-----
v1.0 Intune Partnerintegration Organizationalmessageplacementdetail https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-partnerintegration-organizationalmessageplacementdetail.md
- Title: "organizationalMessagePlacementDetail resource type"
-description: "Contains the different variants of text that can be displayed for a given placement within a surface"
-
-localization_priority: Normal
-doc_type: resourcePageType
--
-# organizationalMessagePlacementDetail resource type
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Contains the different variants of text that can be displayed for a given placement within a surface
-
-## Properties
-|Property|Type|Description|
-|:|:|:|
-|placement|[organizationalMessagePlacement](../resources/intune-partnerintegration-organizationalmessageplacement.md)|Indicates the name of the placement. Possible values are: `default`, `card0`, `card1`, `card2`, `card3`, `unknownFutureValue`.|
-|variants|[organizationalMessageVariant](../resources/intune-partnerintegration-organizationalmessagevariant.md) collection|The list of different variants that can be displayed for this placement|
-
-## Relationships
-None
-
-## JSON Representation
-Here is a JSON representation of the resource.
-<!-- {
- "blockType": "resource",
- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail"
-}
>
-``` json
-{
- "@odata.type": "#microsoft.graph.organizationalMessagePlacementDetail",
- "placement": "String",
- "variants": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageVariant",
- "variantId": "String",
- "name": "String",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "String",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "String",
- "message": "String",
- "clickUrl": "String",
- "buttonText": "String"
- }
- }
- ]
- }
- ]
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessagescenario https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-partnerintegration-organizationalmessagescenario.md
- Title: "organizationalMessageScenario enum type"
-description: "Indicates the scenario for the message"
-
-localization_priority: Normal
-doc_type: enumPageType
--
-# organizationalMessageScenario enum type
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Indicates the scenario for the message
-
-## Members
-|Member|Value|Description|
-|:|:|:|
-|onboarding|0|Indicates onboarding scenario|
-|lifecycle|1|Indicates lifecycle scenario|
-|unknownFutureValue|2|UnknownFutureValue, Evolvable enumeration sentinel value. Do not use.|
-----
v1.0 Intune Partnerintegration Organizationalmessagestatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-partnerintegration-organizationalmessagestatus.md
- Title: "organizationalMessageStatus enum type"
-description: "Indicates the deployment status of the message"
-
-localization_priority: Normal
-doc_type: enumPageType
--
-# organizationalMessageStatus enum type
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Indicates the deployment status of the message
-
-## Members
-|Member|Value|Description|
-|:|:|:|
-|scheduled|0|Indicates that the message has been scheduled for a future date|
-|active|1|Indicates that the message is currently live and being presented to clients|
-|completed|2|Indicates that the message has been displayed to users already and is no longer active|
-|cancelled|3|Indicates that the message has been cancelled and will not be shown|
-|unknownFutureValue|4|UnknownFutureValue, Evolvable enumeration sentinel value. Do not use.|
-----
v1.0 Intune Partnerintegration Organizationalmessagesurface https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-partnerintegration-organizationalmessagesurface.md
- Title: "organizationalMessageSurface enum type"
-description: "Indicates the area where content will be displayed to customers"
-
-localization_priority: Normal
-doc_type: enumPageType
--
-# organizationalMessageSurface enum type
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Indicates the area where content will be displayed to customers
-
-## Members
-|Member|Value|Description|
-|:|:|:|
-|actionCenter|0|Indicates the message will be displayed on the Window's Action Center|
-|getStarted|1|Indicates the message will be displayed on the Get Started page|
-|softLanding|2|Indicates the message will be displayed to the Soft Landing which is anchored to the Windows taskbar|
-|unknownFutureValue|3|UnknownFutureValue, Evolvable enumeration sentinel value. Do not use.|
-----
v1.0 Intune Partnerintegration Organizationalmessagetargeting https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-partnerintegration-organizationalmessagetargeting.md
- Title: "organizationalMessageTargeting resource type"
-description: "Contains the groups of devices that will be targeted to receive the organizational message. If a device is part of the excluded group, then it will not receive the message, regardless of the device being part of an included group"
-
-localization_priority: Normal
-doc_type: resourcePageType
--
-# organizationalMessageTargeting resource type
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Contains the groups of devices that will be targeted to receive the organizational message. If a device is part of the excluded group, then it will not receive the message, regardless of the device being part of an included group
-
-## Properties
-|Property|Type|Description|
-|:|:|:|
-|targetingType|[organizationalMessageTargetingType](../resources/intune-partnerintegration-organizationalmessagetargetingtype.md)|Indicates the type of targeting. Possible values are: `aadGroup`, `unknownFutureValue`.|
-|includeIds|String collection|The groups that will be targeted and receive the message|
-|excludeIds|String collection|The groups that will not receive the message. If a user from an excluded group is part of an included group, it will not receive the message|
-
-## Relationships
-None
-
-## JSON Representation
-Here is a JSON representation of the resource.
-<!-- {
- "blockType": "resource",
- "@odata.type": "microsoft.graph.organizationalMessageTargeting"
-}
>
-``` json
-{
- "@odata.type": "#microsoft.graph.organizationalMessageTargeting",
- "targetingType": "String",
- "includeIds": [
- "String"
- ],
- "excludeIds": [
- "String"
- ]
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessagetargetingtype https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-partnerintegration-organizationalmessagetargetingtype.md
- Title: "organizationalMessageTargetingType enum type"
-description: "Indicates the type of targeting"
-
-localization_priority: Normal
-doc_type: enumPageType
--
-# organizationalMessageTargetingType enum type
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Indicates the type of targeting
-
-## Members
-|Member|Value|Description|
-|:|:|:|
-|aadGroup|0|Indicates that client devices are targeted by their AAD group|
-|unknownFutureValue|1|UnknownFutureValue, Evolvable enumeration sentinel value. Do not use.|
-----
v1.0 Intune Partnerintegration Organizationalmessagetenantconsent https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-partnerintegration-organizationalmessagetenantconsent.md
- Title: "organizationalMessageTenantConsent resource type"
-description: "This will allow the admin to see tenant consent info for specific tenant"
-
-localization_priority: Normal
-doc_type: resourcePageType
--
-# organizationalMessageTenantConsent resource type
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-This will allow the admin to see tenant consent info for specific tenant
-
-## Properties
-|Property|Type|Description|
-|:|:|:|
-|firstPartyMessageAllowed|Boolean|Indicates if first party message is allowed|
-
-## Relationships
-None
-
-## JSON Representation
-Here is a JSON representation of the resource.
-<!-- {
- "blockType": "resource",
- "@odata.type": "microsoft.graph.organizationalMessageTenantConsent"
-}
>
-``` json
-{
- "@odata.type": "#microsoft.graph.organizationalMessageTenantConsent",
- "firstPartyMessageAllowed": true
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessagetext https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-partnerintegration-organizationalmessagetext.md
- Title: "organizationalMessageText resource type"
-description: "Contains the text that will be displayed to users for a particular variant"
-
-localization_priority: Normal
-doc_type: resourcePageType
--
-# organizationalMessageText resource type
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Contains the text that will be displayed to users for a particular variant
-
-## Properties
-|Property|Type|Description|
-|:|:|:|
-|title|String|Indicates the title that will be displayed|
-|message|String|Indicates the message that will be displayed|
-|clickUrl|String|Indicates the url that the user will be directed to when the message is clicked|
-|buttonText|String|Indicates the text that will be displayed on the button of the message. This field applies to the softLanding surface|
-
-## Relationships
-None
-
-## JSON Representation
-Here is a JSON representation of the resource.
-<!-- {
- "blockType": "resource",
- "@odata.type": "microsoft.graph.organizationalMessageText"
-}
>
-``` json
-{
- "@odata.type": "#microsoft.graph.organizationalMessageText",
- "title": "String",
- "message": "String",
- "clickUrl": "String",
- "buttonText": "String"
-}
-```
-----
v1.0 Intune Partnerintegration Organizationalmessagetheme https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-partnerintegration-organizationalmessagetheme.md
- Title: "organizationalMessageTheme enum type"
-description: "Indicates the theme for the guided content"
-
-localization_priority: Normal
-doc_type: enumPageType
--
-# organizationalMessageTheme enum type
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Indicates the theme for the guided content
-
-## Members
-|Member|Value|Description|
-|:|:|:|
-|update|0|Indicates the Update theme|
-|training|1|Indicates the Training theme|
-|welcomeToWindows|2|Indicates the Welcome to Windows theme|
-|explore|3|Indicates the Explore|
-|unknownFutureValue|4|UnknownFutureValue, Evolvable enumeration sentinel value. Do not use.|
-----
v1.0 Intune Partnerintegration Organizationalmessagevariant https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-partnerintegration-organizationalmessagevariant.md
- Title: "organizationalMessageVariant resource type"
-description: "Contains the localized text to be displayed for a given variant"
-
-localization_priority: Normal
-doc_type: resourcePageType
--
-# organizationalMessageVariant resource type
-
-Namespace: microsoft.graph
-
-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
-
-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
-
-Contains the localized text to be displayed for a given variant
-
-## Properties
-|Property|Type|Description|
-|:|:|:|
-|variantId|String|A unique identifier for this variant|
-|name|String|The name of the variant|
-|localizedTexts|[organizationalMessageLocalizedText](../resources/intune-partnerintegration-organizationalmessagelocalizedtext.md) collection|The list of localized texts for this variant|
-
-## Relationships
-None
-
-## JSON Representation
-Here is a JSON representation of the resource.
-<!-- {
- "blockType": "resource",
- "@odata.type": "microsoft.graph.organizationalMessageVariant"
-}
>
-``` json
-{
- "@odata.type": "#microsoft.graph.organizationalMessageVariant",
- "variantId": "String",
- "name": "String",
- "localizedTexts": [
- {
- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",
- "locale": "String",
- "text": {
- "@odata.type": "microsoft.graph.organizationalMessageText",
- "title": "String",
- "message": "String",
- "clickUrl": "String",
- "buttonText": "String"
- }
- }
- ]
-}
-```
-----
v1.0 Intune Policyset Macoslobappassignmentsettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-policyset-macoslobappassignmentsettings.md
+
+ Title: "macOsLobAppAssignmentSettings resource type"
+description: "Contains properties used to assign an Mac LOB app to a group."
+
+localization_priority: Normal
++
+# macOsLobAppAssignmentSettings resource type
+
+Namespace: microsoft.graph
+
+> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
+
+> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.
+
+Contains properties used to assign an Mac LOB app to a group.
++
+Inherits from [mobileAppAssignmentSettings](../resources/intune-shared-mobileappassignmentsettings.md)
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|uninstallOnDeviceRemoval|Boolean|Whether or not to uninstall the app when device is removed from Intune.|
+
+## Relationships
+None
+
+## JSON Representation
+Here is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.macOsLobAppAssignmentSettings"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.macOsLobAppAssignmentSettings",
+ "uninstallOnDeviceRemoval": true
+}
+```
+++++
v1.0 Intune Wip Intunebrandingprofile https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/intune-wip-intunebrandingprofile.md
This entity contains data which is used in customizing the tenant level appearan
|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 a JSON representation of the resource.
], "showAzureADEnterpriseApps": true, "showOfficeWebApps": true,
+ "showConfigurationManagerApps": true,
"sendDeviceOwnershipChangePushNotification": true, "enrollmentAvailability": "String", "disableClientTelemetry": true,
v1.0 Invitationparticipantinfo https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/invitationparticipantinfo.md
Represents an entity that is being invited to a group call.
| identity | [identitySet](identityset.md) | The [identitySet](identityset.md) associated with this invitation. | | participantId | String | Optional. The ID of the target participant. | | replacesCallId | String | Optional. The call which the target identity is currently a part of. For peer-to-peer case, the call will be dropped once the participant is added successfully. |
+| removeFromDefaultAudioRoutingGroup | Boolean | Optional. Whether to remove them from the main mixer. |
+| hidden | Boolean | Optional. Whether to hide the participant from the roster. |
## JSON representation
The following is a JSON representation of the resource.
"endpointType": "String", "identity": {"@odata.type": "#microsoft.graph.identitySet"}, "participantId": "String",
- "replacesCallId": "String"
+ "replacesCallId": "String",
+ "removeFromDefaultAudioRoutingGroup": "Boolean",
+ "hidden": "Boolean"
} ```
v1.0 Learningcontent https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/learningcontent.md
Inherits from [entity](../resources/entity.md).
|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.| |id|String|The unique identifier for the learning content. Not nullable. Read-only. Inherited from [entity](../resources/entity.md).|
v1.0 Licenseassignmentstate https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/licenseAssignmentState.md
The **licenseAssignmentStates** property of the [user](user.md) entity is a coll
## Properties | Property | Type |Description| |:|:--|:-|
-|assignedByGroup|string|The id of the group that assigns this license. If the assignment is a direct-assigned license, this field will be Null. Read-Only.|
-|disabledPlans|Collection(String)|The service plans that are disabled in this assignment. Read-Only.|
+|assignedByGroup|String|Indicates whether the license is directly-assigned or inherited from a group. If directly-assigned, this field is `null`; if inherited through a group membership, this field contains the ID of the group. Read-Only.|
+|disabledPlans|String collection|The service plans that are disabled in this assignment. Read-Only.|
|error|String|License assignment failure error. If the license is assigned successfully, this field will be Null. Read-Only. The possible values are `CountViolation`, `MutuallyExclusiveViolation`, `DependencyViolation`, `ProhibitedInUsageLocationViolation`, `UniquenessViolation`, and `Other`. For more information on how to identify and resolve license assignment errors see [here](/azure/active-directory/users-groups-roles/licensing-groups-resolve-problems).| |lastUpdatedDateTime|DateTimeOffset|The timestamp when the state of the license assignment was last updated.| |skuId|String|The unique identifier for the SKU. Read-Only.|
v1.0 Managedtenants Aggregatedpolicycompliance https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-aggregatedpolicycompliance.md
Title: "aggregatedPolicyCompliance resource type"
description: "Represents an aggregate view of device compliance for a managed tenant." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Auditevent https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-auditevent.md
Title: "auditEvent resource type"
description: "Represents an audit event for managed tenants in Microsoft 365 Lighthouse." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Cloudpcconnection https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-cloudpcconnection.md
Title: "cloudPcConnection resource type"
description: "Represents a cloud PC connection for a given managed tenant." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Cloudpcdevice https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-cloudpcdevice.md
Title: "cloudPcDevice resource type"
description: "Represents a cloud PC device that belongs to a given managed tenant." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Cloudpcoverview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-cloudpcoverview.md
Title: "cloudPcOverview resource type"
description: "Represents an overview of cloud PCs for a given managed tenant." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Conditionalaccesspolicycoverage https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-conditionalaccesspolicycoverage.md
Title: "conditionalAccessPolicyCoverage resource type"
description: "Represents information about any Azure Active Directory policy that defines access rules of a resource for a given managed tenant." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Credentialuserregistrationssummary https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-credentialuserregistrationssummary.md
Title: "credentialUserRegistrationsSummary resource type"
description: "Represents a summary of Azure Active Directory credential user registrations for a given managed tenant." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Devicecompliancepolicysettingstatesummary https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-devicecompliancepolicysettingstatesummary.md
Title: "deviceCompliancePolicySettingStateSummary resource type"
description: "Represents a summary of device compliance policy setting states for a given managed tenant." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Manageddevicecompliance https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-manageddevicecompliance.md
Title: "managedDeviceCompliance resource type"
description: "Represents the state of device compliance for each managed device belonging to a given managed tenant." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Manageddevicecompliancetrend https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-manageddevicecompliancetrend.md
Title: "managedDeviceComplianceTrend resource type"
description: "Represents a trend of compliant and non-compliant devices for a given managed tenant." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Managedtenant https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-managedtenant.md
Title: "managedTenant resource type"
description: "Represent the available operations that interact with the multi-tenant management platform." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Managedtenantexecutionerror https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-managedtenantexecutionerror.md
Title: "managedTenantExecutionError resource type"
description: "Represents an exception for a managed tenant operation." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Managedtenantgenericerror https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-managedtenantgenericerror.md
Title: "managedTenantGenericError resource type"
description: "Represents a generic error for a managed tenant." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Managedtenantoperationerror https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-managedtenantoperationerror.md
Title: "managedTenantOperationError resource type"
description: "An abstract type that represents an error for a managed tenant operation." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Managementaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-managementaction.md
Title: "managementAction resource type"
description: "Represents a baseline management action for a given managed tenant." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Managementactiondeploymentstatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-managementactiondeploymentstatus.md
Title: "managementActionDeploymentStatus resource type"
description: "Represents the deployment status for a given managed tenant." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Managementactioninfo https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-managementactioninfo.md
Title: "managementActionInfo resource type"
description: "Represents reference information for a management action." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Managementactiontenantdeploymentstatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-managementactiontenantdeploymentstatus.md
Title: "managementActionTenantDeploymentStatus resource type"
description: "Represents tenant level deployment status for the management action." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Managementintent https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-managementintent.md
Title: "managementIntent resource type"
description: "Represents metadata for a baseline and what management templates are included." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Managementintentinfo https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-managementintentinfo.md
Title: "managementIntentInfo resource type"
description: "Represents relationship information for a management intent." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Managementtemplate https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-managementtemplate.md
Title: "managementTemplate resource type"
description: "Represents a group of actions and setting that can be performed against a managed tenant." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Managementtemplatedetailedinfo https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-managementtemplatedetailedinfo.md
Title: "managementTemplateDetailedInfo resource type"
description: "Represents detailed information for the management template." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Myrole https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-myrole.md
Title: "myRole resource type"
description: "Represents the role assignments to a signed-in user for a managed tenant." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Roleassignment https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-roleassignment.md
Title: "roleAssignment resource type"
description: "Represents the role assignment to a signed-in user for a managed tenant." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Roledefinition https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-roledefinition.md
Title: "roleDefinition resource type"
description: "Represents detailed information for the role definition." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Serviceusage https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-serviceusage.md
Title: "serviceUsage resource type"
description: "Represents monthly active usage data for a service in a managed tenant." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Setting https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-setting.md
Title: "setting resource type"
description: "Represents a setting that is used within a baseline." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Templateparameter https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-templateparameter.md
Title: "templateParameter resource type"
description: "Represents a parameter utilized in a management template." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Tenant https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-tenant.md
Title: "tenant resource type"
description: "Represents a tenant associated with the managing entity." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Tenantcontactinformation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-tenantcontactinformation.md
Title: "tenantContactInformation resource type"
description: "Represents a contact at a managed tenant." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Tenantcontract https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-tenantcontract.md
Title: "tenantContract resource type"
description: "Represents relationship information between a tenant and the managing entity." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Tenantcustomizedinformation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-tenantcustomizedinformation.md
Title: "tenantCustomizedInformation resource type"
description: "Represents customizable information for a managed tenant." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Tenantdetailedinformation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-tenantdetailedinformation.md
Title: "tenantDetailedInformation resource type"
description: "Represents detailed information for a managed tenant." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Tenantgroup https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-tenantgroup.md
Title: "tenantGroup resource type"
description: "Represents a logical group of managed tenants." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Tenantinfo https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-tenantinfo.md
Title: "tenantInfo resource type"
description: "Represents information for a managed tenant." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Tenantstatusinformation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-tenantstatusinformation.md
Title: "tenantStatusInformation resource type"
description: "Represents onboarding status information for a managed tenant." ms.localizationpriority: medium doc_type: resourcePageType
Represents onboarding status information for a managed tenant.
## Properties |Property|Type|Description| |:|:|:|
-|delegatedPrivilegeStatus|delegatedPrivilegeStatus|The status of the delegated admin privilege relationship between the managing entity and the managed tenant. Possible values are: `none`, `delegatedAdminPrivileges`, `unknownFutureValue`. Optional. Read-only.|
+|delegatedPrivilegeStatus|delegatedPrivilegeStatus|The status of the delegated admin privilege relationship between the managing entity and the managed tenant. Possible values are: `none`, `delegatedAdminPrivileges`, `unknownFutureValue`, `granularDelegatedAdminPrivileges`, `delegatedAndGranularDelegetedAdminPrivileges`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following values from this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `granularDelegatedAdminPrivileges` , `delegatedAndGranularDelegetedAdminPrivileges`. Optional. Read-only.|
|lastDelegatedPrivilegeRefreshDateTime|DateTimeOffset|The date and time the delegated admin privileges status was updated. Optional. Read-only.| |offboardedByUserId|String|The identifier for the account that offboarded the managed tenant. Optional. Read-only.| |offboardedDateTime|DateTimeOffset|The date and time when the managed tenant was offboarded. Optional. Read-only.|
v1.0 Managedtenants Tenanttag https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-tenanttag.md
Title: "tenantTag resource type"
description: "Represents a tag that can be assigned to managed tenant." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Tenantusage https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-tenantusage.md
Title: "tenantUsage resource type"
description: "Represents the number of monthly active users per service in a managed tenant for the previous month. The time period for the data is a sliding window that takes a snapshot once a day." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Windowsdevicemalwarestate https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-windowsdevicemalwarestate.md
Title: "windowsDeviceMalwareState resource type"
description: "Represents the state of discovered malware for devices runnings Windows that have been registered for management." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Windowsprotectionstate https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-windowsprotectionstate.md
Title: "windowsProtectionState resource type"
description: "Represent the Windows protection state for managed devices running Windows." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Workloadaction https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-workloadaction.md
Title: "workloadAction resource type"
description: "Represents an action that will be performed for a specific workload." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Workloadactiondeploymentstatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-workloadactiondeploymentstatus.md
Title: "workloadActionDeploymentStatus resource type"
description: "Represents the deployment status for the workload action." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Managedtenants Workloadstatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-workloadstatus.md
Title: "workloadStatus resource type"
description: "Represent the status for a workload." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 Microsoft Teams Team Usage Reports https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/microsoft-teams-team-usage-reports.md
Title: "Microsoft Teams team usage reports"
-description: "Use the Microsoft Teams team usage reports to get insights into the usage of teams in your organization."
+ Title: "Microsoft Teams team activity reports"
+description: "Use the Microsoft Teams team activity reports to get insights into the usage of teams in your organization."
ms.localizationpriority: medium ms.prod: "reports" doc_type: conceptualPageType
-# Microsoft Teams team usage reports
+# Microsoft Teams team activity reports
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Use the Microsoft Teams team usage reports to get insights into the usage of teams in your organization.
+Use the Microsoft Teams team activity reports to get insights into the usage of teams in your organization.
## Reports
v1.0 Organization https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/organization.md
This resource lets you add your own data to custom properties using [extensions]
| Method | Return Type |Description| |:|:--|:-| |[Get organization](../api/organization-get.md) | [organization](organization.md) collection|Read properties and relationships of organization object.|
-|[Update organization](../api/organization-update.md) | [organization](organization.md) |Update organization object. The only properties that can be updated are: **marketingNotificationMails**, **technicalNotificationMails**, **securityComplianceNotificationMails**, **securityComplianceNotificationPhones** and **privacyProfile**. |
+|[Update organization](../api/organization-update.md) | None | Update organization object. The only properties that can be updated are: **marketingNotificationMails**, **technicalNotificationMails**, **securityComplianceNotificationMails**, **securityComplianceNotificationPhones**, and **privacyProfile**. |
| [Get organization settings](../api/organizationsettings-get.md) | [organizationSettings](organizationsettings.md) | Read the organization settings object. | |**Open extensions**| | | |[Create open extension](../api/opentypeextension-post-opentypeextension.md) |[openTypeExtension](opentypeextension.md)| Create an open extension and add custom properties to a new or existing resource.|
This resource lets you add your own data to custom properties using [extensions]
| country | String | Country/region name of the address for the organization. | | countryLetterCode | String | Country or region abbreviation for the organization in ISO 3166-2 format. | | createdDateTime | DateTimeOffset | Timestamp of when the organization was created. The value cannot be modified and is automatically populated when the organization is 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`. Read-only. |
+| defaultUsageLocation | String | Two-letter ISO 3166 country code indicating the default service usage location of an organization. |
| deletedDateTime | DateTimeOffset | Represents date and time of when the Azure AD tenant was deleted using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only. | | directorySizeQuota | [directorySizeQuota](directorySizeQuota.md) | The directory size quota information of an organization. | | displayName | String | The display name for the tenant. |
Here is a JSON representation of the resource
"country": "String", "countryLetterCode": "String", "createdDateTime": "String (timestamp)",
+ "defaultUsageLocation": "String",
"deletedDateTime": "String (timestamp)", "directorySizeQuota": {"@odata.type": "microsoft.graph.directorySizeQuota"}, "displayName": "String",
v1.0 Plannerassignedtotaskboardtaskformat https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/plannerassignedtotaskboardtaskformat.md
Title: "plannerAssignedToTaskBoardTaskFormat resource type"
-description: "The **plannerAssignedToTaskBoardTaskFormat** resource represents the information used to render a task correctly in the AssignedTo view of the Task Board (a view organized by users to whom tasks are assigned to). Each task will have one **plannerAssignedToTaskBoardTaskFormat** object associated with it."
+description: "Represents the information used to render a task correctly in the AssignedTo view of the Task Board (a view organized by users to whom tasks are assigned to)."
ms.localizationpriority: medium ms.prod: "planner"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-The **plannerAssignedToTaskBoardTaskFormat** resource represents the information used to render a task correctly in the AssignedTo view of the Task Board (a view organized by users to whom tasks are assigned to). Each [task](plannertask.md) will have one **plannerAssignedToTaskBoardTaskFormat** object associated with it.
+Represents the information used to render a task correctly in the **AssignedTo** view of the task board (a view organized by users to whom tasks are assigned to). Each [task](plannertask.md) will have one **plannerAssignedToTaskBoardTaskFormat** object associated with it.
## Methods
The **plannerAssignedToTaskBoardTaskFormat** resource represents the information
## Properties | Property | Type |Description| |:|:--|:-|
-|id|String| Read-only. ID of the resource. It is 28 characters long and case-sensitive. [Format validation](tasks-identifiers-disclaimer.md) is done on the service.|
+|id|String| ID of the resource. It is 28 characters long and case-sensitive. [Format validation](tasks-identifiers-disclaimer.md) is done on the service. Read-only.|
|orderHintsByAssignee|[plannerOrderHintsByAssignee](plannerorderhintsbyassignee.md)|Dictionary of hints used to order tasks on the AssignedTo view of the Task Board. The key of each entry is one of the users the task is assigned to and the value is the order hint. The format of each value is defined as outlined [here](planner-order-hint-format.md).| |unassignedOrderHint|String|Hint value used to order the task on the AssignedTo view of the Task Board when the task is not assigned to anyone, or if the orderHintsByAssignee dictionary does not provide an order hint for the user the task is assigned to. The format is defined as outlined [here](planner-order-hint-format.md).| ## Relationships
-None
-
+None.
## JSON representation
-Here is a JSON representation of the resource.
+The following is a JSON representation of the resource.
<!-- { "blockType": "resource",
Here is a JSON representation of the resource.
"orderHintsByAssignee": {"@odata.type": "microsoft.graph.plannerOrderHintsByAssignee"}, "unassignedOrderHint": "String" }- ``` <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
v1.0 Plannerroster https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/plannerroster.md
Title: "plannerRoster resource type"
-description: "The **plannerRoster** resource represents a collection of users who are collaborating on a plannerPlan."
+description: "Represents a collection of users who are collaborating on a plannerPlan."
ms.localizationpriority: medium ms.prod: "planner"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-The **plannerRoster** resource represents a collection of users who are collaborating on a [plannerPlan](plannerplan.md). A **plannerRoster** is a simple set of users, where everyone has the same level of permissions and they can be created by everyone, unless disabled by the tenant administrator. A **plannerRoster** can contain one plan.
+Represents a collection of users who are collaborating on a [plannerPlan](plannerplan.md). A **plannerRoster** is a simple set of users, where everyone has the same level of permissions and they can be created by everyone, unless disabled by the tenant administrator. A **plannerRoster** can contain one plan.
Deleting a **plannerRoster** will also delete the plan and all tasks in the plan. A **plannerRoster** will also be automatically deleted under the following conditions:
Deleting a **plannerRoster** will also delete the plan and all tasks in the plan
|:|:|:| |[Create plannerRoster](../api/planner-post-rosters.md)|[plannerRoster](../resources/plannerroster.md)|Create a new [plannerRoster](../resources/plannerroster.md) object.| |[Get plannerRoster](../api/plannerroster-get.md)|[plannerRoster](../resources/plannerroster.md)|Read the properties and relationships of a [plannerRoster](../resources/plannerroster.md) object.|
-|[Delete plannerRoster](../api/plannerroster-delete.md)|None|Deletes a [plannerRoster](../resources/plannerroster.md) object.|
+|[Delete plannerRoster](../api/plannerroster-delete.md)|None|Delete a [plannerRoster](../resources/plannerroster.md) object.|
|[List members](../api/plannerroster-list-members.md)|[plannerRosterMember](../resources/plannerrostermember.md) collection|Get the plannerRosterMember resources from the members navigation property.| |[Create plannerRosterMember](../api/plannerroster-post-members.md)|[plannerRosterMember](../resources/plannerrostermember.md)|Create a new plannerRosterMember object.| |[List plans](../api/plannerroster-list-plans.md)|[plannerPlan](../resources/plannerplan.md) collection|Get the plannerPlan resources from the plans navigation property.|
Deleting a **plannerRoster** will also delete the plan and all tasks in the plan
## Properties |Property|Type|Description| |:|:|:|
-|id|String|Read only. Identifier of the **plannerRoster**. Inherited from [entity](../resources/entity.md)|
+|id|String|Identifier of the **plannerRoster**. Read only. Inherited from [entity](../resources/entity.md)|
## Relationships |Relationship|Type|Description|
v1.0 Report https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/report.md
Microsoft Graph controls access to resources via permissions. You must specify t
## Settings
-In Microsoft 365 reports, user information such as usernames, groups, and sites is concealed; actual values are not displayed. You can use the [adminReportSettings ](../resources/adminreportsettings.md) API to control the display of user information in the reports.
+In Microsoft 365 reports, user information such as usernames, groups, and sites is concealed; actual values are not displayed. You can use the [adminReportSettings](/graph/api/resources/resources/adminreportsettings.md) API to control the display of user information in the reports.
## Cloud deployments
The following table shows the availability for each API across all cloud deploym
| APIs | Microsoft Graph global service | **Microsoft Cloud for US Government** | **Microsoft Cloud China operated by 21Vianet** | **Microsoft Cloud Germany** | **Microsoft Cloud for USNat and USSec** | | | | - | - | | |
-| [Microsoft 365 activations](/graph/api/resources/office-365-activations-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | Γ₧û |
+| [Admin Report Settings](/graph/api/resources/resources/adminreportsettings.md) | Γ£ö | Γ£ö | Γ£ö | Γ₧û | Γ£ö |
+| [Microsoft 365 activations](/graph/api/resources/office-365-activations-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | Γ₧û |
| [Microsoft 365 active users](/graph/api/resources/office-365-active-users-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | Γ₧û | | [Microsoft 365 Apps usage](/graph/api/resources/microsoft-365-apps-usage-report?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | Γ₧û | | [Microsoft 365 browser usage](/graph/api/resources/microsoft-365-browser-usage-report?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ₧û | Γ₧û | Γ₧û |
v1.0 Riskyuserhistoryitem https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/riskyuserhistoryitem.md
Title: "riskyUserHistoryItem resource type"
-description: "Represents the risk history of Azure AD users"
+description: "Represents the risk history of an Azure Active Directory (Azure AD) user as determined by Azure AD Identity Protection."
ms.localizationpriority: medium ms.prod: "identity-and-sign-in"
doc_type: resourcePageType
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Represents the risk history of an Azure AD user as determined by Azure AD Identity Protection.
+Represents the risk history of an Azure Active Directory (Azure AD) user as determined by Azure AD Identity Protection.
+
+Inherits from [riskyUser](../resources/riskyuser.md).
>[!NOTE] > 1. Using this API requires an Azure AD Premium P2 license.
Represents the risk history of an Azure AD user as determined by Azure AD Identi
| Property | Type | Description | |:|:--|:|
-| userId | string | The id of the user. |
-| initiatedBy | bool | The id of actor that does the operation. |
-| activity | [riskUserActivity](riskuseractivity.md)| The activity related to user risk level change. |
+|activity|[riskUserActivity](../resources/riskuseractivity.md)|The activity related to user risk level change.|
+|id|String|The unique identifier for the **riskyUserHistoryItem** object. Inherited from [entity](../resources/entity.md).|
+|initiatedBy|String|The ID of actor that does the operation.|
+|isDeleted|Boolean|Indicates whether the user is deleted. Inherited from [riskyUser](../resources/riskyuser.md).|
+|isProcessing|Boolean|Indicates whether a user's risky state is being processed by the backend. Inherited from [riskyUser](../resources/riskyuser.md).|
+|riskDetail|riskDetail|Details of the detected risk. Inherited from [riskyUser](../resources/riskyuser.md). Possible values are: `none`, `adminGeneratedTemporaryPassword`, `userPerformedSecuredPasswordChange`, `userPerformedSecuredPasswordReset`, `adminConfirmedSigninSafe`, `aiConfirmedSigninSafe`, `userPassedMFADrivenByRiskBasedPolicy`, `adminDismissedAllRiskForUser`, `adminConfirmedSigninCompromised`, `hidden`, `adminConfirmedUserCompromised`, `unknownFutureValue`.|
+|riskLastUpdatedDateTime|DateTimeOffset|The date and time when the risky user was last updated. The DateTimeOffset 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`. Inherited from [riskyUser](../resources/riskyuser.md).|
+|riskLevel|riskLevel|Level of the detected risky user. Inherited from [riskyUser](../resources/riskyuser.md). Possible values are: `low`, `medium`, `high`, `hidden`, `none`, `unknownFutureValue`.|
+|riskState|riskState|State of the user's risk. Inherited from [riskyUser](../resources/riskyuser.md). Possible values are: `none`, `confirmedSafe`, `remediated`, `dismissed`, `atRisk`, `confirmedCompromised`, `unknownFutureValue`.|
+|userDisplayName|String|Risky user display name. Inherited from [riskyUser](../resources/riskyuser.md).|
+|userId|String|The ID of the user.|
+|userPrincipalName|String|Risky user principal name. Inherited from [riskyUser](../resources/riskyuser.md).|
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|history|[riskyUserHistoryItem](../resources/riskyuserhistoryitem.md) collection| The activity related to user risk level change. Inherited from [riskyUser](../resources/riskyuser.md).|
## JSON representation
+The following is a JSON representation of the resource.
+ <!-- { "blockType": "resource", "optionalProperties": [ ],
v1.0 Search Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/search-api-overview.md
Search requests run on behalf of the user. Search results are scoped to enforce
|[Get the most relevant emails](#get-the-most-relevant-emails) | **enableTopResults** | |[Get selected properties](#get-selected-properties) | **fields** | |[Use KQL in query terms](#keyword-query-language-kql-support) | **query** |
+|[Collapse search results](#collapse-search-results)| **collapseProperties**|
|[Sort search results](#sort-search-results)| **sortProperties** | |[Refine results using aggregations](#refine-results-using-aggregations)| **aggregations** | |[Search custom types imported using connectors](/graph/search-concept-custom-types)| **contentSources** |
Depending on the entity type, the searchable properties vary. For details, see:
- [Email properties](/microsoft-365/compliance/keyword-queries-and-search-conditions#searchable-email-properties) - [Site properties](/microsoft-365/compliance/keyword-queries-and-search-conditions#searchable-site-properties)
+## Collapse search results
+
+The **collapseProperties** property contains a set of criteria, fields, and limit size, which are used for collapsing results in a response body. Using **collapseProperties** only impacts the recall but not ranking/sorting.
+
+The [query](../api/search-query.md) method lets you customize the collapse property by specifying **collapseProperties** on the `requests` parameter, which is a collection of [collapseProperty](collapseproperty.md) objects. This allows you to specify a set of one or more collapse properties.
+
+Note that collapsing results is currently only supported on the following SharePoint and OneDrive types: [driveItem](driveitem.md), [listItem](listitem.md), [drive](drive.md), [list](list.md), [site](site.md).
+
+The properties on which the collapse clause are applied need to be queryable and either sortable or refinable in the SharePoint [search schema](/sharepoint/manage-search-schema). For multi-level collapse, each subsequent property limit size specified in a multi-level request should be less than or equal to the previous; otherwise, the response will return an `HTTP 400 Bad Request` error.
+
+For examples that show how to collapse results, see [collapse search results](/graph/search-concept-collapse).
+ ## Sort search results Search results in the response are sorted in the following default sort order:
For backward compatibility, the original properties and types are accessible and
- [Search person](/graph/search-concept-person) - [Search content in Sharepoint and OneDrive](/graph/search-concept-files) - [Search custom types imported using connectors](/graph/search-concept-custom-types)
+ - [Collapse search results](/graph/search-concept-collapse)
- [Sort search results](/graph/search-concept-sort) - [Refine search results](/graph/search-concept-aggregation) - [Request spelling correction](/graph/search-concept-speller)
v1.0 Searchrequest https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/searchrequest.md
The JSON blob contains the types of resources expected in the response, the unde
|sharePointOneDriveOptions|[sharePointOneDriveOptions](sharePointOneDriveOptions.md)|Indicates the kind of contents to be searched when a search is performed using application permissions. Optional.| |size|Int32|The size of the page to be retrieved. Optional.| |sortProperties|[sortProperty](sortProperty.md) collection|Contains the ordered collection of fields and direction to sort results. There can be at most 5 sort properties in the collection. Optional.|
+|collapseProperties|[collapseProperty](collapseproperty.md) collection|Contains the ordered collection of fields and limit to collapse results. Optional.|
|trimDuplicates|Boolean|Indicates whether to trim away the duplicate SharePoint files from search results. Default value is `false`. Optional.| |stored_fields (deprecated)|String collection |This is now replaced by the **fields** property. |
The following is a JSON representation of the resource.
"sharePointOneDriveOptions": {"@odata.type": "microsoft.graph.sharePointOneDriveOptions"}, "size": 1024, "sortProperties": [{"@odata.type": "microsoft.graph.sortProperty"}],
+ "collapseProperties": [{"@odata.type": "microsoft.graph.collapseProperty"}],
"trimDuplicates": false } ```
The following is a JSON representation of the resource.
- [Search content in SharePoint and OneDrive](/graph/search-concept-files) (files, lists, and sites) - [Search custom types imported using connectors](/graph/search-concept-custom-types) - [Sort search results](/graph/search-concept-sort)
+- [Collapse search results](/graph/search-concept-collapse)
- [Trim duplicate search results](/graph/search-concept-trim-duplicate) - [Use aggregations](/graph/search-concept-aggregation) to refine search results - [Use display layout](/graph/search-concept-display-layout)
v1.0 Shift https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/shift.md
Title: shift resource type
-description: A shift is a unit of scheduled work in the schedule.
-
+ Title: "shift resource type"
+description: "A shift is a unit of scheduled work in the schedule."
+ ms.localizationpriority: medium doc_type: resourcePageType
A unit of scheduled work in a [schedule](schedule.md).
| Method | Return Type | Description | | : | : | :-- |
-| [Create shift](../api/schedule-post-shifts.md) | [shift](shift.md) | Create a new `shift`. |
-| [List shifts](../api/schedule-list-shifts.md) | [shift](shift.md) collection | Get the list of `shifts` in this schedule. |
-| [Get shift](../api/shift-get.md) | [shift](shift.md) | Get a `shift` by ID. |
-| [Replace shift](../api/shift-put.md) | [shift](shift.md) | Replace a `shift`. |
-| [Delete shift](../api/shift-delete.md) | None | Delete a `shift` from the schedule. |
+| [Create shift](../api/schedule-post-shifts.md) | [shift](shift.md) | Create a new **shift**. |
+| [List shifts](../api/schedule-list-shifts.md) | [shift](shift.md) collection | Get the list of **shifts** in this schedule. |
+| [Get shift](../api/shift-get.md) | [shift](shift.md) | Get a **shift** by ID. |
+| [Replace shift](../api/shift-put.md) | [shift](shift.md) | Replace a **shift**. |
+| [Delete shift](../api/shift-delete.md) | None | Delete a **shift** from the schedule. |
## Properties | Property | Type | Description | | -- | -- | -- |
-| id | `string` | ID of the `shift`. |
-| userId | `string` | ID of the user assigned to the `shift`. Required. |
-| schedulingGroupId | `string` | ID of the scheduling group the `shift` is part of. Required. |
-| sharedShift | [shiftItem](shiftitem.md) | The shared version of this `shift` that is viewable by both employees and managers. Required. |
-| draftShift | [shiftItem](shiftitem.md) | The draft version of this `shift` that is viewable by managers. Required. |
-| createdDateTime | `DateTimeOffset` | The timestamp on which this `shift` was first 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`. |
-| lastModifiedDateTime | `DateTimeOffset` | The timestamp on which this `shift` was last updated. 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`. |
-| lastModifiedBy | [identitySet](identityset.md) | The identity that last updated this `shift`. |
+| createdDateTime | DateTimeOffset | The timestamp on which this **shift** was first 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`. |
+| draftShift | [shiftItem](shiftitem.md) | The draft version of this **shift** that is viewable by managers. Required. |
+| id | String | ID of the **shift**. |
+| lastModifiedBy | [identitySet](identityset.md) | The identity that last updated this **shift**. |
+| lastModifiedDateTime | DateTimeOffset | The timestamp on which this **shift** was last updated. 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`. |
+
+| sharedShift | [shiftItem](shiftitem.md) | The shared version of this **shift** that is viewable by both employees and managers. Required. |
+| schedulingGroupId | String | ID of the scheduling group the **shift** is part of. Required. |
+| userId | String | ID of the user assigned to the **shift**. Required. |
## JSON representation
The following is a JSON representation of the resource.
```json {
- "id": "SHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8",
- "createdDateTime": "2019-03-14T04:32:51.451Z",
- "lastModifiedDateTime": "2019-03-14T05:32:51.451Z",
- "userId": "c5d0c76b-80c4-481c-be50-923cd8d680a1",
- "schedulingGroupId": "TAG_228940ed-ff84-4e25-b129-1b395cf78be0",
- "lastModifiedBy": {"@odata.type":"microsoft.graph.identitySet"},
- "sharedShift": {"@odata.type":"microsoft.graph.shiftItem"},
- "draftShift": {"@odata.type":"microsoft.graph.shiftItem"}
+ "createdDateTime": "DateTimeOffset",
+ "draftShift": { "@odata.type": "microsoft.graph.shiftItem" },
+ "id": "String",
+ "lastModifiedBy": { "@odata.type": "microsoft.graph.identitySet" },
+ "lastModifiedDateTime": "DateTimeOffset",
+ "schedulingGroupId": "String",
+ "sharedShift": { "@odata.type": "microsoft.graph.shiftItem" },
+ "userId": "String"
} ```
v1.0 Subscription https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/subscription.md
A subscription allows a client app to receive change notifications about changes
- A [list][] under a SharePoint [site][]. - A [message][], [event][], or [contact][] in Outlook. - An [online meeting][] in Microsoft Teams.*-- The [presence][] of a user in Microsoft Teams.*
+- The [presence][] of a user in Microsoft Teams.
- A [team](./team.md) in Microsoft Teams. - A [printer][] (when a print job for the printer gets to JobFetchable state - ready to be fetched for printing) and a [printTaskDefinition][] in Universal Print. For more information, see [Subscribe to change notifications from cloud printing APIs](/graph/universal-print-webhook-notifications). - A [todoTask][] of a user in Microsoft To Do.
v1.0 Tenantrelationship https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/tenantrelationship.md
Title: "tenantRelationship resource type"
description: "Represent the various type of tenant relationships." ms.localizationpriority: medium doc_type: resourcePageType
v1.0 User https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/user.md
This resource supports:
| aboutMe | String | A freeform text entry field for the user to describe themselves. <br><br>Returned only on `$select`. | | accountEnabled | Boolean | `true` if the account is enabled; otherwise, `false`. This property is required when a user is created. <br><br>Supports `$filter` (`eq`, `ne`, `not`, and `in`). | | ageGroup | [ageGroup](#agegroup-values) | Sets the age group of the user. Allowed values: `null`, `Minor`, `NotAdult` and `Adult`. Refer to the [legal age group property definitions](#legal-age-group-property-definitions) for further information. <br><br>Supports `$filter` (`eq`, `ne`, `not`, and `in`). |
-| assignedLicenses | [assignedLicense](assignedlicense.md) collection | The licenses that are assigned to the user, including inherited (group-based) licenses. <br><br>Not nullable. Supports `$filter` (`eq`, `not`, and counting empty collections). |
+| assignedLicenses | [assignedLicense](assignedlicense.md) collection | The licenses that are assigned to the user, including inherited (group-based) licenses. This property doesn't differentiate directly-assigned and inherited licenses. Use the **licenseAssignmentStates** property to identify the directly-assigned and inherited licenses. <br><br>Not nullable. Supports `$filter` (`eq`, `not`, and counting empty collections). |
| assignedPlans | [assignedPlan](assignedplan.md) collection | The plans that are assigned to the user. Read-only. Not nullable.<br><br>Supports `$filter` (`eq` and `not`). | | authorizationInfo | [authorizationInfo](../resources/authorizationinfo.md) | Identifiers that can be used to identify and authenticate a user in non-Azure AD environments. This property can be used to store identifiers for smartcard-based certificates that a user uses for access to on-premises Active Directory deployments or for federated access. It can also be used to store the Subject Alternate Name (SAN) that's associated with a Common Access Card (CAC). Nullable.<br><br>Supports `$filter` (`eq` and `startsWith`). | | birthday | DateTimeOffset | The birthday of the user. 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` <br><br>Returned only on `$select`. |
This resource supports:
| jobTitle | String | The user's job title. Maximum length is 128 characters. <br><br>Supports `$filter` (`eq`, `ne`, `not` , `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values).| | lastPasswordChangeDateTime | DateTimeOffset | The time when this Azure AD user last changed their password or when their password was created, , whichever date the latest action was performed. 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`. Read-only. <br><br>Returned only on `$select`. | | legalAgeGroupClassification | [legalAgeGroupClassification](#legalagegroupclassification-values) | Used by enterprise applications to determine the legal age group of the user. This property is read-only and calculated based on **ageGroup** and **consentProvidedForMinor** properties. Allowed values: `null`, `MinorWithOutParentalConsent`, `MinorWithParentalConsent`, `MinorNoParentalConsentRequired`, `NotAdult` and `Adult`. Refer to the [legal age group property definitions](#legal-age-group-property-definitions) for further information. <br><br>Returned only on `$select`. |
-| licenseAssignmentStates | [licenseAssignmentState](licenseassignmentstate.md) collection | State of license assignments for this user. Read-only. <br><br>Returned only on `$select`. |
+| licenseAssignmentStates | [licenseAssignmentState](licenseassignmentstate.md) collection | State of license assignments for this user. Also indicates licenses that are directly-assigned and those that the user has inherited through group memberships. Read-only. <br><br>Returned only on `$select`. |
| mail | String | The SMTP address for the user, for example, `admin@contoso.com`. Changes to this property will also update the user's **proxyAddresses** collection to include the value as an SMTP address. This property cannot contain accent characters. <br/> **NOTE:** We do not recommend updating this property for Azure AD B2C user profiles. Use the **otherMails** property instead. <br><br> Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, `endsWith`, and `eq` on `null` values). | | mailboxSettings | [mailboxSettings](mailboxsettings.md) | Settings for the primary mailbox of the signed-in user. You can [get](../api/user-get-mailboxsettings.md) or [update](../api/user-update-mailboxsettings.md) settings for sending automatic replies to incoming messages, locale, and time zone. For more information, see [User preferences for languages and regional formats](#user-preferences-for-languages-and-regional-formats). <br><br>Returned only on `$select`. | | mailNickname | String | The mail alias for the user. This property must be specified when a user is created. Maximum length is 64 characters. <br><br>Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values). |
v1.0 Accesspackage Delete Incompatibleaccesspackage https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/accesspackage-delete-incompatibleaccesspackage.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": "remove_incompatibleaccesspackage_from_accesspackage"
The following is an example of the request.
DELETE https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/accessPackages/73eb2497-3b88-4c0a-8bb3-68ba8162beff/incompatibleAccessPackages/c0a74b4d-2694-4d5d-a964-1bee4ff0aaf2/$ref ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response
v1.0 Accesspackage Delete Incompatiblegroup https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/accesspackage-delete-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": "remove_incompatiblegroup_from_accesspackage"
The following is an example of the request.
DELETE https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/accessPackages/73eb2497-3b88-4c0a-8bb3-68ba8162beff/incompatibleGroups/c0a74b4d-2694-4d5d-a964-1bee4ff0aaf2/$ref ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response
v1.0 Accesspackage List Accesspackagesincompatiblewith https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/accesspackage-list-accesspackagesincompatiblewith.md
If successful, this method returns a `200 OK` response code and a collection of
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_accesspackagesincompatiblewith"
The following is an example of the request.
GET https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/accessPackages/73eb2497-3b88-4c0a-8bb3-68ba8162beff/accessPackagesIncompatibleWith ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response
v1.0 Accesspackage List Incompatibleaccesspackages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/accesspackage-list-incompatibleaccesspackages.md
If successful, this method returns a `200 OK` response code and a collection of
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_incompatibleaccesspackages"
The following is an example of the request.
GET https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/accessPackages/73eb2497-3b88-4c0a-8bb3-68ba8162beff/incompatibleAccessPackages ```
+# [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 Accesspackage List Incompatiblegroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/accesspackage-list-incompatiblegroups.md
If successful, this method returns a `200 OK` response code and a collection of
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_incompatiblegroups"
The following is an example of the request.
GET https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/accessPackages/73eb2497-3b88-4c0a-8bb3-68ba8162beff/incompatibleGroups ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response
v1.0 Accesspackage Post Incompatibleaccesspackage https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/accesspackage-post-incompatibleaccesspackage.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_incompatibleaccesspackage_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
v1.0 Accesspackage Post Incompatiblegroup https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/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 Accesspackageassignment Additionalaccess https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/accesspackageassignment-additionalaccess.md
The following example gets the access package assignments for users who have ass
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "accesspackageassignment_additionalaccess"
The following example gets the access package assignments for users who have ass
GET https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/assignments/additionalAccess(accessPackageId='2506aef1-3929-4d24-a61e-7c8b83d95e6f',incompatibleAccessPackageId='d5d99728-8c0b-4ede-83d2-cf9b0e8dabfb')?$expand=target ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response > **Note:** The response object shown here might be shortened for readability. <!-- {
v1.0 Accesspackageassignment Reprocess https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/accesspackageassignment-reprocess.md
doc_type: "apiPageType"
Namespace: microsoft.graph
-In [Azure AD entitlement management](../resources/entitlementmanagement-overview.md), callers can automatically reevaluate and enforce an [accessPackageAssignment](../resources/accesspackageassignment.md) object of a userΓÇÖs assignments for a specific access package. The **assignmentState** of the access package must be `Delivered` for the administrator to reprocess the user's assignment. Only admins with the Access Package Assignment Manager role, or higher, in Azure AD entitlement management can perform this action.
+In [Azure AD entitlement management](../resources/entitlementmanagement-overview.md), callers can automatically reevaluate and enforce an [accessPackageAssignment](../resources/accesspackageassignment.md) object of a userΓÇÖs assignments for a specific access package. The **state** of the access package assignment must be `Delivered` for the administrator to reprocess the user's assignment. Only admins with the Access Package Assignment Manager role, or higher, in Azure AD entitlement management can perform this action.
## Permissions
v1.0 Accessreviewset Post Historydefinitions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/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)
+
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 Appcatalogs List Teamsapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/appcatalogs-list-teamsapps.md
GET https://graph.microsoft.com/v1.0/appCatalogs/teamsApps?$filter=distributionM
[!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 Attacksimulationroot Get Simulationautomations https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/attacksimulationroot-get-simulationautomations.md
GET https://graph.microsoft.com/v1.0/security/attackSimulation/simulationAutomat
[!INCLUDE [sample-code](../includes/snippets/go/get-simulationautomation-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-simulationautomation-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Attacksimulationroot List Simulationautomations https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/attacksimulationroot-list-simulationautomations.md
GET https://graph.microsoft.com/v1.0/security/attackSimulation/simulationAutomat
[!INCLUDE [sample-code](../includes/snippets/go/list-simulationautomation-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-simulationautomation-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Attacksimulationroot List Simulations https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/attacksimulationroot-list-simulations.md
GET https://graph.microsoft.com/v1.0/security/attackSimulation/simulations
[!INCLUDE [sample-code](../includes/snippets/go/list-simulation-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-simulation-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Authentication List Methods https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/authentication-list-methods.md
If successful, this method returns a `200 OK` response code and a collection of
The following is an example of the request.
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_methods"
+}-->
``` GET https://graph.microsoft.com/v1.0/me/authentication/methods ```
+# [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 Authenticationcontextclassreference Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/authenticationcontextclassreference-update.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/go/update-authenticationcontextclassreference-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/update-authenticationcontextclassreference-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Bookingbusiness Getstaffavailability https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/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 Channel Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/channel-get.md
GET https://graph.microsoft.com/v1.0/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 Getallmessages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/channel-getallmessages.md
GET https://graph.microsoft.com/v1.0/teams/01fe12e0-e720-44fd-8854-28c66d1bee40/
[!INCLUDE [sample-code](../includes/snippets/go/channel-getallchannelmessages-1-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/channel-getallchannelmessages-1-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Channel List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/channel-list.md
GET https://graph.microsoft.com/v1.0/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/v1.0/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/v1.0/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/v1.0/api/chat-get.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_group_chat", "sampleKeys": ["19:d0f51aeb0e8e43d0befb24be72b09ea7@thread.v2"] }-->
-```http
+```msgraph-interactive
GET https://graph.microsoft.com/v1.0/chats/19:b8577894a63548969c5c92bb9c80c5e1@thread.v2 ```
+# [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
#### Request The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_chat", "sampleKeys": ["8b081ef6-4792-4def-b2c9-c363a1bf41d5", "19:8b081ef6-4792-4def-b2c9-c363a1bf41d5_877192bd-9183-47d3-a74c-8aa0426716cf@unq.gbl.spaces"] }-->
-```http
+```msgraph-interactive
GET https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/chats/19:8b081ef6-4792-4def-b2c9-c363a1bf41d5_877192bd-9183-47d3-a74c-8aa0426716cf@unq.gbl.spaces ```
+# [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
#### Request The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_chat_withmembers", "sampleKeys": ["19:d0f51aeb0e8e43d0befb24be72b09ea7@thread.v2"] }-->
-```http
+```msgraph-interactive
GET https://graph.microsoft.com/v1.0/chats/19:b8577894a63548969c5c92bb9c80c5e1@thread.v2?$expand=members ```
+# [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
#### 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/v1.0/chats/19:meeting_ZDZlYTYxOWUtYzdlMi00ZmMxLWIxMTAtN2YzODZlZjAxYzI4@thread.v2 ```
+# [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
#### 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/v1.0/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)
++++ #### Response The following example shows the response.
v1.0 Chat Hideforuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/chat-hideforuser.md
If successful, this action returns a `204 No Content` response code.
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "chat_hideforuser",
Content-Type: application/json
} } ```+
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
+++
v1.0 Chat List Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/chat-list-messages.md
The following is an example of a request that lists the top two messages (`$top=
The following example shows the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_chat_messages_3",
The following example shows the request.
GET https://graph.microsoft.com/v1.0/chats/19:2da4c29f6d7041eca70b638b43d45437@thread.v2/messages?$top=2&$orderBy=createdDateTime desc ```
+# [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.
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_4",
The following example shows the request.
GET https://graph.microsoft.com/v1.0/chats/19:2da4c29f6d7041eca70b638b43d45437@thread.v2/messages?$top=2&$orderBy=lastModifiedDateTime desc&$filter=lastModifiedDateTime ge 2022-09-22T00:00:00.000Z and lastModifiedDateTime le 2022-09-24T00:00:00.000Z ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response The following example shows the response.
v1.0 Chat List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/chat-list.md
If successful, this method returns a `200 OK` response code and a collection of
Here is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_chats" }-->
-```http
+```msgraph-interactive
GET https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/chats ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response Here is an example of the response.
Content-type: application/json
Here is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_chats_expand_members" }-->
-```http
+```msgraph-interactive
GET https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/chats?$expand=members ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ #### Response Here is an example of the response.
Content-type: application/json
The following is an example of a request. **lastMessagePreview/createdDateTime** is passed to sort chats by the most to least recent chat messages. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_chats_orderby" }-->
-```http
+```msgraph-interactive
GET https://graph.microsoft.com/v1.0/chats?$orderBy=lastMessagePreview/createdDateTime desc ```
+# [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
The following example shows a request to list chats along with the preview of the last message sent in the chat. Comparing `createdDateTime` on the preview to `lastMessageReadDateTime` in `viewpoint` allows the caller to determine whether the user has read all messages in a chat. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_chats_expand_lastMessagePreview" }-->
-```http
+```msgraph-interactive
GET https://graph.microsoft.com/v1.0/chats?$expand=lastMessagePreview ```
+# [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 Chat Markchatreadforuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/chat-markchatreadforuser.md
If successful, this action returns a `204 No Content` response code.
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "chat_markchatreadforuser",
Content-length: 106
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++
v1.0 Chat Markchatunreadforuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/chat-markchatunreadforuser.md
If successful, this action returns a `204 No Content` response code.
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "chat_markchatunreadforuser",
Content-length: 158
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++
v1.0 Chat Unhideforuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/chat-unhideforuser.md
If successful, this action returns a `204 No Content` response code.
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "chat_unhideforuser",
Content-Type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response
v1.0 Chatmessage Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/chatmessage-get.md
GET https://graph.microsoft.com/v1.0/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/
[!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 Chatmessage Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/chatmessage-post.md
One of the following permissions is required to call this API. To learn more, in
|:|:--| | Delegated (work or school account) | ChannelMessage.Send, Group.ReadWrite.All** | | Delegated (personal Microsoft account) | Not supported. |
-| Application | Teamwork.Migrate.All, ChannelMessage.ReadWrite.All |
+| Application | Teamwork.Migrate.All |
> **Note**: Permissions marked with ** are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward.
Content-type: application/json
#### Request The following is an example of the request.
-> **Note:** The **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"));`. .NET SDK users do not need to perform the conversion to Base64 encoded bytes as the SDK handles it for you.
+**contentBytes** must be set to binary string Base64-encoded bytes. You can do this in C# by using `Convert.ToBase64String(File.ReadAllBytes("image.png"));`. Microsoft .NET SDK users do not need to perform the conversion to Base64 encoded bytes as the SDK handles it for you.
# [HTTP](#tab/http)
Content-type: application/json
#### Request The following is an example of the request.
-> **Note:** The **temporaryId** in the **hostedContents** collection is a random ID, but must be same across the **content** (in **attachments**) and **hostedContents** elements. (Notice the **temporaryId** set to **1** and the reference in content as `../hostedContents/1/$value`.)
+> **Note:** The **temporaryId** in the **hostedContents** collection is a random ID, but must be same across the **content** (in **attachments**) and **hostedContents** elements. (Notice the **temporaryId** set to `1` and the reference in content as `../hostedContents/1/$value`.)
-**contentBytes** must be set to binary string Base64-encoded bytes. You can do this in C# by using `Convert.ToBase64String(File.ReadAllBytes("image.png"));`. .NET SDK users do not need to perform the conversion to Base64 encoded bytes as the SDK handles it for you.
+**contentBytes** must be set to binary string Base64-encoded bytes. You can do this in C# by using `Convert.ToBase64String(File.ReadAllBytes("image.png"));`. Microsoft .NET SDK users do not need to perform the conversion to Base64 encoded bytes as the SDK handles it for you.
# [HTTP](#tab/http)
Content-type: application/json
#### Response
+The following is an example of the response.
+ <!-- { "blockType": "response", "truncated": true,
v1.0 Conditionalaccessroot List Templates https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/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/v1.0/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/v1.0/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/v1.0/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/v1.0/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/v1.0/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 Driveitem Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/driveitem-update.md
Last updated 09/10/2017
Title: Update a file or folder ms.localizationpriority: high ms.prod: "sharepoint"
-description: "Update the metadata for a DriveItem by ID or path."
+description: "Update the metadata for a driveItem by ID or path."
doc_type: apiPageType # Update DriveItem properties Namespace: microsoft.graph
-Update the metadata for a [DriveItem](../resources/driveitem.md) by ID or path.
+Update the metadata for a [driveItem](../resources/driveitem.md) by ID or [path](/graph/onedrive-addressing-driveitems#path-based-addressing).
You can also use update to [move an item](driveitem-move.md) to another parent by updating the item's **parentReference** property.
v1.0 Educationassignment Setupfeedbackresourcesfolder https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/educationassignment-setupfeedbackresourcesfolder.md
+
+ Title: "educationAssignment: setUpFeedbackResourcesFolder"
+description: "Create a SharePoint folder to upload feedback files for a given educationSubmission."
+ms.localizationpriority: medium
+++
+# educationAssignment: setUpFeedbackResourcesFolder
+
+Namespace: microsoft.graph
+
+Create a SharePoint folder to upload feedback files for a given [educationSubmission](../resources/educationsubmission.md).
+
+The teacher determines the resources to upload in the feedback resources folder of a submission.
+
+## 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) | EduAssignments.ReadBasic, EduAssignments.Read |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+```http
+POST /classes/{classId}/assignments/{assignmentId}/setUpFeedbackResourcesFolder
+```
+
+## Request headers
+| Header | Value |
+|:|:--|
+| Authorization | Bearer {token}. Required. |
+| Content-Type | application/json |
+
+## Request body
+In the request body, supply an empty JSON object `{}` for this method.
+
+## Response
+If successful, this method returns a `200 OK` response code and an [educationAssignment](../resources/educationassignment.md) object in the request body.
+
+## Example
+The following example shows how to call this API.
+
+### Request
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "sampleKeys": ["37d99af7-cfc5-4e3b-8566-f7d40e4a2070","a3cce0ba-2008-4c4d-bf62-079408562d96"],
+ "name": "educationassignment_setupfeedbackresourcesfolder"
+}-->
+```http
+POST https://graph.microsoft.com/v1.0/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignments/a3cce0ba-2008-4c4d-bf62-079408562d96/setUpFeedbackResourcesFolder
+Content-type: application/json
+
+{
+}
+```
+
+### Response
+
+The following is an example of the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationAssignment"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#educationAssignment",
+ "@odata.type": "#microsoft.graph.educationAssignment",
+ "classId": "37d99af7-cfc5-4e3b-8566-f7d40e4a2070",
+ "displayName": "Feedbackresources",
+ "closeDateTime": null,
+ "dueDateTime": "2022-05-07T06:59:00Z",
+ "assignDateTime": null,
+ "assignedDateTime": "2022-05-05T16:15:21.0569507Z",
+ "allowLateSubmissions": true,
+ "resourcesFolderUrl": null,
+ "feedbackResourcesFolderUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F8CNZWU38SarWxPyWM7jx/items/01VANVJQ7ONF5UOYTXZVEKCZE43FTQRH2S",
+ "createdDateTime": "2022-05-05T16:13:22.3915176Z",
+ "lastModifiedDateTime": "2022-05-05T17:42:58.8704181Z",
+ "allowStudentsToAddResourcesToSubmission": true,
+ "status": "assigned",
+ "notificationChannelUrl": 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%2237d99af7-cfc5-4e3b-8566-f7d40e4a2070%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%22a3cce0ba-2008-4c4d-bf62-079408562d96%5C%22%5D,%5C%22submissionId%5C%22%3Anull%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22assignment-viewer%5C%22%7D%22,%22channelId%22%3Anull%7D",
+ "addToCalendarAction": "none",
+ "addedStudentAction": "none",
+ "id": "a3cce0ba-2008-4c4d-bf62-079408562d96",
+ "grading": null,
+ "instructions": {
+ "content": "",
+ "contentType": "text"
+ },
+ "assignTo": {
+ "@odata.type": "#microsoft.graph.educationAssignmentClassRecipient"
+ },
+ "createdBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "AAAAAAAA-0123-4567-89AB-1B4BB48C3119",
+ "displayName": null
+ }
+ }
+}
+```
+
+<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
+2022-05-05 14:57:30 UTC -->
+<!--
+{
+ "type": "#page.annotation",
+ "description": "educationAssignment: setUpFeedbackResourcesFolder",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": [
+ ]
+}
+-->
v1.0 Educationfeedbackresourceoutcome Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/educationfeedbackresourceoutcome-delete.md
+
+ Title: "Delete educationFeedbackResourceOutcome"
+description: "Delete a feedback resource from a submission."
+
+ms.localizationpriority: medium
++
+# Delete educationFeedbackResourceOutcome
+
+Namespace: microsoft.graph
+
+Delete a [feedback resource](../resources/educationfeedbackresourceoutcome.md) from a submission. This can only be done by a teacher.
+
+## 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) | EduAssignments.ReadWriteBasic, EduAssignments.ReadWrite |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+```http
+DELETE /education/classes/{classId}/assignments/{assignmentId}/submissions/{submissionId}/outcomes/{outcomeId}
+```
+
+## Request headers
+| Header | Value |
+|:|:--|
+| 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. It does not return anything in the response body.
+
+## Example
+### Request
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "delete_educationfeedbackresourceoutcome"
+}-->
+```http
+DELETE https://graph.microsoft.com/v1.0/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignments/a3cce0ba-2008-4c4d-bf62-079408562d96/submissions/2185e6d7-2924-4ed1-dde1-269f89e29184/outcomes/8fb409c5-570b-4fe5-8473-d3666e61f3a0
+```
+
+### Response
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+} -->
+```http
+HTTP/1.1 204 No Content
+```
+
+<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
+2022-05-06 14:57:30 UTC -->
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Delete educationFeedbackResourceOutcome",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": [
+ ]
+}
+-->
v1.0 Educationfeedbackresourceoutcome Post Outcomes https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/educationfeedbackresourceoutcome-post-outcomes.md
+
+ Title: "Create educationFeedbackResourceOutcome"
+description: "Create a new feedback resource for a submission."
+ms.localizationpriority: medium
+++
+# Create educationFeedbackResourceOutcome
+
+Namespace: microsoft.graph
+
+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 isn't in that folder, the `POST` request will fail.
+
+> [!IMPORTANT]
+> Before you can upload an assignment feedback resource, you must [set up the feedback resources folder](../api/educationassignment-setupfeedbackresourcesfolder.md) for the [educationAssignment](../resources/educationassignment.md) to upload the files to.
+
+## 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) | EduAssignments.ReadWriteBasic, EduAssignments.ReadWrite |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Not supported. |
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+```http
+POST /education/classes/{classId}/assignments/{assignmentId}/submissions/{submissionId}/outcomes
+```
+
+## Request headers
+| Header | Value |
+|:|:--|
+| Authorization | Bearer {token}. Required. |
+| Content-Type | application/json |
+
+## Request body
+In the request body, supply a JSON representation of an [educationFeedbackResourceOutcome](../resources/educationfeedbackresourceoutcome.md) object.
+
+## Response
+If successful, this method returns a `201 Created` response code and an [educationFeedbackResourceOutcome](../resources/educationfeedbackresourceoutcome.md) object in the response body.
+
+This method returns a `400 Bad Request` when the submission has exceeded more than five feedback resources.
+
+## Example
+### Request
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "create_educationFeedbackResourceOutcome"
+}-->
+```http
+POST https://graph.microsoft.com/v1.0/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignments/a3cce0ba-2008-4c4d-bf62-079408562d96/submissions/2185e6d7-2924-4ed1-dde1-269f89e29184/outcomes
+Content-type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.educationFeedbackResourceOutcome",
+ "feedbackResource": {
+ "@odata.type": "#microsoft.graph.educationWordResource",
+ "displayName": "Document1.docx"
+ }
+}
+```
+
+### 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.educationFeedbackResourceOutcome"
+} -->
+```http
+HTTP/1.1 201 Created
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/assignments('a3cce0ba-2008-4c4d-bf62-079408562d96')/submissions('2185e6d7-2924-4ed1-dde1-269f89e29184')/outcomes/$entity",
+ "@odata.type": "#microsoft.graph.educationFeedbackResourceOutcome",
+ "lastModifiedDateTime": "2022-10-21T18:58:42.019513Z",
+ "id": "8c3d65c1-eacb-40f7-9360-7e47bb5b7d75",
+ "resourceStatus": "notPublished",
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
+ "displayName": null
+ }
+ },
+ "feedbackResource": {
+ "@odata.type": "#microsoft.graph.educationWordResource",
+ "displayName": "Document1.docx",
+ "createdDateTime": "2022-10-21T18:58:42.0195022Z",
+ "lastModifiedDateTime": "2022-10-21T18:58:42.019513Z",
+ "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F8CNZWU38SarWxPyWM7jx/items/01VANVJQ5X3ULNDOWTJJEYSIBXZIK42E5G",
+ "createdBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
+ "displayName": null
+ }
+ }
+ }
+}
+```
+
+## 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 -->
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Create educationFeedbackResourceOutcome",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": []
+}
+-->
v1.0 Educationrubric Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/educationrubric-get.md
The following is an example of the request.
GET https://graph.microsoft.com/v1.0/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 List Outcomes https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/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" doc_type: "apiPageType"
doc_type: "apiPageType"
Namespace: microsoft.graph
-Retrieve a list of [educationOutcome](../resources/educationoutcome.md) objects. There are three types of outcomes: **educationPointsOutcome**, **educationFeedbackOutcome**, and **educationRubricOutcome**.
+Retrieve a list of [educationOutcome](../resources/educationoutcome.md) objects. There are four types of outcomes: **educationPointsOutcome**, **educationFeedbackOutcome**, **educationRubricOutcome**, and **educationFeedbackResourceOutcome**.
A submission for a credit assignment (one that has no point value and no rubric) will have an [educationFeedbackOutcome](../resources/educationpointsoutcome.md). (It might also return an [educationPointsOutcome](../resources/educationpointsoutcome.md), but that outcome is ignored.)
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).
-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.
+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.
## Permissions
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-GET /education/classes/acdefc6b-2dc6-4e71-b1e9-6d9810ab1793/assignments/cf6005fc-9e13-44a2-a6ac-a53322006454/submissions/d1bee293-d8bb-48d4-af3e-c8cb0e3c7fe7/outcomes
+GET /education/classes/{classId}/assignments/{assignmentId}/submissions/{submissionId}/outcomes
``` ## Optional query parameters
-This method supports the `$top`,and `$select` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+This method supports the `$top`, `$filter`, and `$select` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
## Request headers
This method supports the `$top`,and `$select` OData query parameters to help cus
## 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 `200 OK` response code and a collection of
## Examples
-### Request
+### Example 1: Get all outcomes
-The following is an example of the request.
+The following example shows how to retrieve all outcomes.
+#### Request
+
+The following is an example of the request.
# [HTTP](#tab/http) <!-- {
GET https://graph.microsoft.com/v1.0/education/classes/acdefc6b-2dc6-4e71-b1e9-6
-### Response
+#### Response
The following is an example of the response.
Content-type: application/json
} ```
+### Example 2: Get outcomes filtered by outcome type
+
+The following example shows how to retrieve outcomes filtered by outcome type.
+
+#### Request
+
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_outcomes_by_type"
+}-->
+
+```msgraph-interactive
+GET https://graph.microsoft.com/v1.0/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignments/a3cce0ba-2008-4c4d-bf62-079408562d96/submissions/2185e6d7-2924-4ed1-dde1-269f89e29184/outcomes?$filter=isof('microsoft.graph.educationFeedbackResourceOutcome')
+```
+
+#### 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.educationOutcome",
+ "isCollection": true
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/assignments('a3cce0ba-2008-4c4d-bf62-079408562d96')/submissions('2185e6d7-2924-4ed1-dde1-269f89e29184')/outcomes",
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.educationFeedbackResourceOutcome",
+ "lastModifiedDateTime": "2022-05-06T00:52:12.8318457Z",
+ "id": "8fb409c5-570b-4fe5-8473-d3666e61f3a0",
+ "resourceStatus": "notPublished",
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
+ "displayName": null
+ }
+ },
+ "feedbackResource": {
+ "@odata.type": "#microsoft.graph.educationWordResource",
+ "displayName": "Document2.docx",
+ "createdDateTime": "2022-05-06T00:52:12.8318064Z",
+ "lastModifiedDateTime": "2022-05-06T00:52:12.8318457Z",
+ "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F8CNZWU38SarWxPyWM7jx/items/01VANVJQ26WF6K2W2IOFAKDITG4F5GWRH5",
+ "createdBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
+ "displayName": null
+ }
+ }
+ }
+ },
+ {
+ "@odata.type": "#microsoft.graph.educationFeedbackResourceOutcome",
+ "lastModifiedDateTime": "2022-05-06T00:52:17.3180275Z",
+ "id": "0710aeea-590d-46b4-9eb8-1c08b6549677",
+ "resourceStatus": "notPublished",
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
+ "displayName": null
+ }
+ },
+ "feedbackResource": {
+ "@odata.type": "#microsoft.graph.educationWordResource",
+ "displayName": "Document3.docx",
+ "createdDateTime": "2022-05-06T00:52:17.3180176Z",
+ "lastModifiedDateTime": "2022-05-06T00:52:17.3180275Z",
+ "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F8CNZWU38SarWxPyWM7jx/items/01VANVJQ563EMEMHRTBBH2SOZ4GDSNEUZK",
+ "createdBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
+ "displayName": null
+ }
+ }
+ }
+ }
+ ]
+}
+```
<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98 2019-02-04 14:57:30 UTC --> <!-- {
Content-type: application/json
"section": "documentation", "tocPath": "" }-->--
v1.0 Entitlementmanagement List Assignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/entitlementmanagement-list-assignments.md
If the user or app is assigned only to catalog-specific administrative roles, th
### Example scenarios for using query parameters - To return the target subject and access package, include `$expand=target,accessPackage`.-- To retrieve only delivered assignments, you can include a query `$filter=assignmentState eq 'Delivered'`.
+- To retrieve only delivered assignments, you can include a query `$filter=state eq 'Delivered'`.
- To retrieve only assignments for a particular user, you can include a query with assignments targeting the object ID of that user: `$expand=target&$filter=target/objectid+eq+'7deff43e-1f17-44ef-9e5f-d516b0ba11d4'`. - To retrieve only assignments for a particular user and a particular access package, you can include a query with assignments targeting that access package and the object ID of that user: `$expand=accessPackage,target&$filter=accessPackage/id eq '9bbe5f7d-f1e7-4eb1-a586-38cdf6f8b1ea' and target/objectid eq '7deff43e-1f17-44ef-9e5f-d516b0ba11d4'`.
v1.0 Group List Transitivemembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/group-list-transitivemembers.md
GET /groups/{id}/transitiveMembers
## Optional query parameters
-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 method supports the [OData query parameters](/graph/query-parameters) to help customize the response, including `$search`, `$count`, `$top`, 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.
v1.0 Participant Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/participant-get.md
GET https://graph.microsoft.com/v1.0/communications/calls/7531d31f-d10d-44de-802
[!INCLUDE [sample-code](../includes/snippets/go/get-participant-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-participant-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Plannerbucket List Tasks https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/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"
doc_type: apiPageType
Namespace: microsoft.graph
-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/v1.0/planner/buckets/{bucket-id}/tasks
-##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+### Response
+The following is an example of the response.
+> **Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
v1.0 Plannertask Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/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"
doc_type: apiPageType
Namespace: microsoft.graph
-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) <!-- { "blockType": "request",
- "name": "get_plannertask"
+ "name": "get_plannertask",
+ "sampleKeys": ["01gzSlKkIUSUl6DF_EilrmQAKDhh"]
}--> ```msgraph-interactive
-GET https://graph.microsoft.com/v1.0/planner/tasks/{task-id}
+GET https://graph.microsoft.com/v1.0/planner/tasks/01gzSlKkIUSUl6DF_EilrmQAKDhh
``` # [C#](#tab/csharp)
GET https://graph.microsoft.com/v1.0/planner/tasks/{task-id}
-##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+### Response
+The following is an example of the response.
+> **Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
v1.0 Presence Setpresence https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/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: * User-configured > app-configured (user-configured state overrides others)
-* Among app-configured: DoNotDisturb (currently not supported for set presence) > Busy > Available > Away
+* Among app-configured: 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 Reportroot Getm365appplatformusercounts https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/reportroot-getm365appplatformusercounts.md
The following is an example that outputs CSV.
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "reportroot_getM365AppPlatformUserCounts_csv"
The following is an example of the request.
GET https://graph.microsoft.com/v1.0/reports/getM365AppPlatformUserCounts(period='D7')?$format=text/csv ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
++++ #### Response The following is an example of the response.
The following is an example that returns JSON.
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "reportroot_getM365AppPlatformUserCounts_json"
The following is an example of the request.
GET https://graph.microsoft.com/v1.0/reports/getM365AppPlatformUserCounts(period='D7')?$format=application/json ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
++++ #### Response The following is an example of the response.
v1.0 Reportroot Getm365appusercounts https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/reportroot-getm365appusercounts.md
The following is an example that outputs CSV.
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "reportroot_getM365AppUserCounts_csv"
The following is an example of the request.
GET https://graph.microsoft.com/v1.0/reports/getM365AppUserCounts(period='D7')?$format=text/csv ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
++++ #### Response The following is an example of the response.
The following is an example that returns JSON.
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "reportroot_getM365AppUserCounts_json"
The following is an example of the request.
GET https://graph.microsoft.com/v1.0/reports/getM365AppUserCounts(period='D7')?$format=application/json ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
++++ #### Response The following is an example of the response.
v1.0 Reportroot Getm365appuserdetail https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/reportroot-getm365appuserdetail.md
The following is an example that outputs CSV.
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "reportroot_getM365AppUserCounDetail"
The following is an example of the request.
GET https://graph.microsoft.com/v1.0/reports/getM365AppUserDetail(period='D7')?$format=text/csv ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
++++ #### Response The following is an example of the response.
The following is an example that returns JSON.
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "reportroot_getM365AppUserCountDetail"
The following is an example of the request.
GET https://graph.microsoft.com/v1.0/reports/getM365AppUserDetail(period='D7')?$format=application/json ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
++++ #### Response The following is an example of the response.
v1.0 Securityreportsroot Getattacksimulationrepeatoffenders https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/securityreportsroot-getattacksimulationrepeatoffenders.md
GET https://graph.microsoft.com/v1.0/reports/security/getAttackSimulationRepeatO
[!INCLUDE [sample-code](../includes/snippets/go/securityreportsrootthisgetattacksimulationrepeatoffenders-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/securityreportsrootthisgetattacksimulationrepeatoffenders-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Securityreportsroot Getattacksimulationsimulationusercoverage https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/securityreportsroot-getattacksimulationsimulationusercoverage.md
GET https://graph.microsoft.com/v1.0/reports/security/getAttackSimulationSimulat
[!INCLUDE [sample-code](../includes/snippets/go/securityreportsrootthisgetattacksimulationsimulationusercoverage-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/securityreportsrootthisgetattacksimulationsimulationusercoverage-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Securityreportsroot Getattacksimulationtrainingusercoverage https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/securityreportsroot-getattacksimulationtrainingusercoverage.md
GET https://graph.microsoft.com/v1.0/reports/security/getAttackSimulationTrainin
[!INCLUDE [sample-code](../includes/snippets/go/securityreportsrootthisgetattacksimulationtrainingusercoverage-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/securityreportsrootthisgetattacksimulationtrainingusercoverage-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Simulationautomation List Runs https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/simulationautomation-list-runs.md
GET https://graph.microsoft.com/v1.0/security/attackSimulation/simulationAutomat
[!INCLUDE [sample-code](../includes/snippets/go/list-simulationautomationrun-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-simulationautomationrun-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Sites List Followed https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/sites-list-followed.md
Namespace: microsoft.graph
List the [sites](../resources/site.md) that have been followed by the signed in user.
+>**Note:** This API has a [known issue](/graph/known-issues#sites-and-lists-sharepoint) and might return incorrect results.
+ ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Team Put Schedule https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/team-put-schedule.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/go/team-put-schedule-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [PowerShell](#tab/powershell)
+ # [PHP](#tab/php) [!INCLUDE [sample-code](../includes/snippets/php/team-put-schedule-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Teamworktag Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/teamworktag-delete.md
If successful, this method returns a `204 No Content` response code.
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_teamworktag",
The following is an example of a request.
DELETE https://graph.microsoft.com/v1.0/teams/53c53217-fe77-4383-bc5a-ed4937a1aecd/tags/MjQzMmI1N2ItMGFiZC00M2RiLWFhN2ItMTZlYWRkMTE1ZDM0IyM3ZDg4M2Q4Yi1hMTc5LTRkZDctOTNiMy1hOGQzZGUxYTIxMmUjI3RhY29VSjN2RGk== ```
+# [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 Teamworktag Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/teamworktag-get.md
If successful, this method returns a `200 OK` response code and a [teamworkTag](
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_teamworktag",
The following is an example of a request.
GET https://graph.microsoft.com/v1.0/teams/53c53217-fe77-4383-bc5a-ed4937a1aecd/tags/MjQzMmI1N2ItMGFiZC00M2RiLWFhN2ItMTZlYWRkMTE1ZDM0IyM3ZDg4M2Q4Yi1hMTc5LTRkZDctOTNiMy1hOGQzZGUxYTIxMmUjI3RhY29VSjN2RGk== ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response
v1.0 Teamworktag List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/teamworktag-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_teamworktag",
The following is an example of a request.
GET https://graph.microsoft.com/v1.0/teams/53c53217-fe77-4383-bc5a-ed4937a1aecd/tags ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response
v1.0 Teamworktag Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/teamworktag-post.md
If successful, this method returns a `201 Created` response code and a [teamwork
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_teamworktag_from",
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 Teamworktag Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/teamworktag-update.md
If successful, this method returns a `200 OK` response code and an updated [team
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_teamworktag",
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 Teamworktagmember Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/teamworktagmember-delete.md
If successful, this method returns a `204 No Content` response code.
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_teamworktagmember",
The following is an example of a request.
DELETE https://graph.microsoft.com/v1.0/teams/53c53217-fe77-4383-bc5a-ed4937a1aecd/tags/MjQzMmI1N2ItMGFiZC00M2RiLWFhN2ItMTZlYWRkMTE1ZDM0IyM3ZDg4M2Q4Yi1hMTc5LTRkZDctOTNiMy1hOGQzZGUxYTIxMmUjI3RhY29VSjN2RGk==/members/MjQzMmI1N2ItMGFiZC00M2RiLWFhN2ItMTZlYWRkMTE1ZDM0IyNlYjY1M2Y5Mi04MzczLTRkZTYtYmZlYy01YjRkMjE2YjZhZGUjI2QzYjJiM2ViLWM0N2YtNDViOS05NWYyLWIyZjJlZjYyMTVjZQ== ```
+# [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 Teamworktagmember Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/teamworktagmember-get.md
If successful, this method returns a `200 OK` response code and a [teamworkTagMe
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_teamworktagmember",
The following is an example of a request.
GET https://graph.microsoft.com/v1.0/teams/53c53217-fe77-4383-bc5a-ed4937a1aecd/tags/MjQzMmI1N2ItMGFiZC00M2RiLWFhN2ItMTZlYWRkMTE1ZDM0IyM3ZDg4M2Q4Yi1hMTc5LTRkZDctOTNiMy1hOGQzZGUxYTIxMmUjI3RhY29VSjN2RGk==/members/MjQzMmI1N2ItMGFiZC00M2RiLWFhN2ItMTZlYWRkMTE1ZDM0IyNlYjY1M2Y5Mi04MzczLTRkZTYtYmZlYy01YjRkMjE2YjZhZGUjI2QzYjJiM2ViLWM0N2YtNDViOS05NWYyLWIyZjJlZjYyMTVjZQ== ```
+# [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 Teamworktagmember List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/teamworktagmember-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_teamworktagmember",
The following is an example of a request.
GET https://graph.microsoft.com/v1.0/teams/53c53217-fe77-4383-bc5a-ed4937a1aecd/tags/MjQzMmI1N2ItMGFiZC00M2RiLWFhN2ItMTZlYWRkMTE1ZDM0IyM3ZDg4M2Q4Yi1hMTc5LTRkZDctOTNiMy1hOGQzZGUxYTIxMmUjI3RhY29VSjN2RGk==/members ```
+# [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 Teamworktagmember Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/teamworktagmember-post.md
If successful, this method returns a `201 Created` response code and a [teamwork
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_teamworktagmember_from_",
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 User List People https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/user-list-people.md
Namespace: microsoft.graph
Retrieve a collection of [person](../resources/person.md) objects ordered by their relevance to the [user](../resources/user.md), which is determined by the user's communication and collaboration patterns, and business relationships.
-You can get this information via the People API. For examples, see the [Examples](#examples) section and the article [Get relevant information about people](/graph/people-example).
+You can get this information via the People API. For examples, see the [Examples](#examples) section and the article [Use the People API to get information about the people most relevant to you](/graph/people-insights-overview).
## Permissions
GET /users/{id | userPrincipalName}/people
## Optional query parameters
-This method supports the [OData query parameters](/graph/query-parameters) to help customize the response, as shown in the examples in the article [Get relevant information about people](/graph/people-example).
+This method supports the [OData query parameters](/graph/query-parameters) to help customize the response.
|Name|Value|Description| |:|:--|:-| |$filter|string|Limits the response to only those people whose record contains the specified criteria.| |$orderby|string|By default the people in the response are sorted by their relevance to your query. You can change the order of the people in the response using the *$orderby* parameter.|
-|$search|string|Search for people by name or alias. Supports Fuzzy matching. Parameter only works for searching the signed-in user's relevant people, not for searching people relevant to other users. Also supports the `topic` keyword to find people based on topics extracted from e-mail conversations with that person. See the *Perform a fuzzy search* section at [Get relevant information about people](/graph/people-example#perform-a-fuzzy-search) for information and examples. |
+|$search|string|Search for people by name or alias. Supports Fuzzy matching. Parameter only works for searching the signed-in user's relevant people, not for searching people relevant to other users. Also supports the `topic` keyword to find people based on topics extracted from e-mail conversations with that person. For information and examples, see the *Perform a fuzzy search* section at [Use the People API to get information about the people most relevant to you](/graph/people-insights-overview#perform-a-fuzzy-search). |
|$select|string|Comma-separated list of properties to include in the response. For optimal performance, only select the subset of properties needed.| |$skip|int|Skip the first n results, useful for paging. This is not supported when using *$search*.| |$top|int|Number of results to be returned.|
If successful, this method returns a `200 OK` response code and a collection of
## Examples
-#### Request
+### Request
The following is an example of the request.
GET https://graph.microsoft.com/v1.0/me/people
-#### Response
+### Response
The following is an example of the response.
Content-type: application/json
} ```
-For more examples, see the article [Get relevant information about people](/graph/people-example).
+## See also
+- For details about the People API and more examples, see [Use the People API to get information about the people most relevant to you](/graph/people-insights-overview).
<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC -->
v1.0 X509certificateauthenticationmethodconfiguration Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/x509certificateauthenticationmethodconfiguration-delete.md
If successful, this method returns a `204 No Content` response code.
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_x509certificateauthenticationmethodconfiguration"
If successful, this method returns a `204 No Content` response code.
DELETE https://graph.microsoft.com/v1.0/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/x509Certificate ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response <!-- { "blockType": "response"
v1.0 X509certificateauthenticationmethodconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/x509certificateauthenticationmethodconfiguration-get.md
If successful, this method returns a `200 OK` response code and a [x509Certifica
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_x509certificateauthenticationmethodconfiguration"
If successful, this method returns a `200 OK` response code and a [x509Certifica
GET https://graph.microsoft.com/v1.0/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/x509Certificate ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response The following response object shows an x509CertificateAuthenticationMethodConfiguration with its default configuration. >**Note:** The response object shown here might be shortened for readability.
v1.0 X509certificateauthenticationmethodconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/x509certificateauthenticationmethodconfiguration-update.md
The following is an example of an update request with the following settings:
+ Defines multi-factor authentication as requirement. + Configures the binding rules for the strong authentication method against the rule type. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_x509certificateauthenticationmethodconfiguration"
Content-Type: application/json
} ```
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ ### Response <!-- { "blockType": "response"
v1.0 Educationassignment https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/educationassignment.md
When an **assignment** is created, it is in a Draft state. Students can't see th
The assignment APIs are exposed in the class namespace.
+Inherits from [entity](../resources/entity.md).
+ ## Methods | Method | Return Type |Description|
The assignment APIs are exposed in the class namespace.
|[Delete](../api/educationassignment-delete.md) | None |Delete an **educationAssignment** object. | |[Publish](../api/educationassignment-publish.md)|[educationAssignment](educationassignment.md)|Change the state of an **educationAssignment** object from draft to published.| |[Set up assignment resources folder](../api/educationassignment-setupresourcesfolder.md)| string| Create a SharePoint folder (under pre-defined location) to upload files as assignment resources.|
+|[Set up assignment feedback resources folder](../api/educationassignment-setupfeedbackresourcesfolder.md)|[educationAssignment](../resources/educationassignment.md)|Create a SharePoint folder to upload feedback files for a given [educationSubmission](../resources/educationsubmission.md).|
|[List resources](../api/educationassignment-list-resources.md) |[educationAssignmentResource](educationassignmentresource.md) collection| Get an **educationAssignmentResource** object collection.| |[List submissions](../api/educationassignment-list-submissions.md) |[educationSubmission](educationsubmission.md) collection| Get an **educationSubmission** object collection.| |[List categories](../api/educationassignment-list-categories.md) |[educationCategory](educationcategory.md) collection| Get an **educationCategory** object collection.|
The assignment APIs are exposed in the class namespace.
## Properties | Property | Type |Description| |:|:--|:-|
-|id|String| Read-only.|
|addedStudentAction|String|Optional field to control the **assignment** behavior for students who are added after the **assignment** is published. If not specified, defaults to `none` value. Currently supports only two values: `none` or `assignIfOpen`.| |addToCalendarAction| educationAddToCalendarOptions|Optional field to control the **assignment** behavior for adding **assignments** to students' and teachers' calendars when the **assignment** is published. The possible values are: `none`, `studentsAndPublisher`, `studentsAndTeamOwners`, `unknownFutureValue`, and `studentsOnly`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value(s) in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `studentsOnly`. The default value is `none`.| |allowLateSubmissions|Boolean| Identifies whether students can submit after the due date. If this property isn't specified during create, it defaults to true. |
The assignment APIs are exposed in the class namespace.
|createdDateTime|DateTimeOffset|Moment when the **assignment** 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`| |displayName|String|Name of the **assignment**.| |dueDateTime|DateTimeOffset|Date when the students **assignment** is due. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`|
+|feedbackResourcesFolderUrl|String|Folder URL where all the feedback file resources for this **assignment** are stored.|
|grading|[educationAssignmentGradeType](educationassignmentgradetype.md)|How the **assignment** will be graded. |
+|id|String| The unique identifier for the **assignment**. Inherited from [entity](../resources/entity.md). Read-only.|
|instructions|[itemBody](itembody.md)| Instructions for the assignment. This along with the display name tell the student what to do. | |lastModifiedBy|[identitySet](identityset.md)| Who last modified the **assignment**. | |lastModifiedDateTime|DateTimeOffset|Moment when the **assignment** was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`|
The following is a JSON representation of the resource.
```json {
- "id": "String (identifier)",
- "addedStudentAction": "none",
- "addToCalendarAction": "string",
- "allowLateSubmissions": true,
- "allowStudentsToAddResourcesToSubmission": true,
+ "addedStudentAction": "String",
+ "addToCalendarAction": "String",
+ "allowLateSubmissions": "Boolean",
+ "allowStudentsToAddResourcesToSubmission": "Boolean",
"assignDateTime": "String (timestamp)", "assignTo": {"@odata.type": "microsoft.graph.educationAssignmentRecipient"}, "assignedDateTime": "String (timestamp)",
The following is a JSON representation of the resource.
"createdDateTime": "String (timestamp)", "displayName": "String", "dueDateTime": "String (timestamp)",
+ "feedbackResourcesFolderUrl": "String",
"grading": {"@odata.type": "microsoft.graph.educationAssignmentGradeType"},
+ "id": "String (identifier)",
"instructions": {"@odata.type": "microsoft.graph.itemBody"}, "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"}, "lastModifiedDateTime": "String (timestamp)",
- "notificationChannelUrl": "string",
- "status": "string",
- "webUrl": "string",
- "resourcesFolderUrl": "string"
+ "notificationChannelUrl": "String",
+ "status": "String",
+ "webUrl": "String",
+ "resourcesFolderUrl": "String"
} ```
v1.0 Educationfeedbackoutcome https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/educationfeedbackoutcome.md
doc_type: "resourcePageType"
Namespace: microsoft.graph
-Represents feedback on an [educationOutcome](educationoutcome.md) object in the form of text.
+Represents feedback on an [educationOutcome](educationoutcome.md) object in the form of text.
## Methods
The following is a JSON representation of the resource.
"section": "documentation", "tocPath": "" }-->-
v1.0 Educationfeedbackresourceoutcome https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/educationfeedbackresourceoutcome.md
+
+ Title: "educationFeedbackResourceOutcome resource type"
+description: "Represents feedback on an educationOutcome object in the form of a document."
+ms.localizationpriority: medium
+++
+# educationFeedbackResourceOutcome resource type
+
+Namespace: microsoft.graph
+
+Represents feedback on an [educationOutcome](../resources/educationoutcome.md) object in the form of a document.
+
+Inherits from [educationOutcome](../resources/educationoutcome.md).
+
+## Methods
+
+| Method | Return Type | Description |
+|:-|:|:|
+| [Create educationFeedbackResourceOutcome](../api/educationfeedbackresourceoutcome-post-outcomes.md) | [educationOutcome](../resources/educationoutcome.md) | Create a new [feedback resource](../resources/educationfeedbackresourceoutcome.md) for a submission. |
+| [Delete educationFeedbackResourceOutcome](../api/educationfeedbackresourceoutcome-delete.md) | None | Delete a [feedback resource](../resources/educationfeedbackresourceoutcome.md) from a submission. |
+
+## Properties
+
+| Property | Type | Description |
+|:-|:|:|
+|feedbackResource|[educationResource](../resources/educationresource.md)|The actual feedback resource.|
+|id|String|Unique identifier for the **educationFeedbackResourceOutcome**. Inherited from [entity](../resources/entity.md).|
+|lastModifiedBy|[identitySet](../resources/identityset.md)|The individual who updated the resource. Inherited from [educationOutcome](../resources/educationoutcome.md).|
+|lastModifiedDateTime|DateTimeOffset|The moment in time when the resource was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2021 is `2021-01-01T00:00:00Z`. Inherited from [educationOutcome](../resources/educationoutcome.md).|
+|resourceStatus|educationFeedbackResourceOutcomeStatus|The status of the feedback resource. The possible values are: `notPublished`, `pendingPublish`, `published`, `failedPublish`, `unknownFutureValue`.|
+
+## Relationships
+
+None.
+
+## JSON representation
+
+The following is a JSON representation of the resource.
+
+<!-- {
+ "blockType": "resource",
+ "optionalProperties": [
+
+ ],
+ "@odata.type": "microsoft.graph.educationFeedbackResourceOutcome",
+ "keyProperty": "id"
+}-->
+
+```json
+{
+ "feedbackResource": {"@odata.type": "microsoft.graph.educationResource"},
+ "id": "String (identifier)",
+ "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
+ "lastModifiedDateTime": "String (timestamp)",
+ "resourceStatus": {"@odata.type": "microsoft.graph.educationFeedbackResourceOutcomeStatus"}
+}
+```
+
+<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
+2022-05-05 14:57:30 UTC -->
+<!-- {
+ "type": "#page.annotation",
+ "description": "educationFeedbackResourceOutcome resource",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": ""
+}-->
v1.0 Educationoutcome https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/educationoutcome.md
Title: "educationOutcome resource type"
-description: "The result of grading an assignment."
+description: "Represents a base class for the result of grading an assignment."
ms.localizationpriority: medium ms.prod: "education"
doc_type: "resourcePageType"
Namespace: microsoft.graph
-The result of grading an assignment.
+Represents a base class for the result of grading an assignment. The derived types are [educationFeedbackOutcome](educationfeedbackoutcome.md), [educationPointsOutcome](educationpointsoutcome.md), [educationRubricOutcome](educationrubricoutcome.md), and [educationFeedbackResourceOutcome](educationfeedbackresourceoutcome.md).
-This is a base class; the derived types are [educationFeedbackOutcome](educationfeedbackoutcome.md), [educationPointsOutcome](educationpointsoutcome.md), and [educationRubricOutcome](educationrubricoutcome.md).
+Inherits from [entity](../resources/entity.md).
## Methods | Method | Return Type | Description | |:-|:|:|
-| [Update educationOutcome](../api/educationoutcome-update.md) | [educationOutcome](educationoutcome.md) | Update educationOutcome object. |
+| [Update educationOutcome](../api/educationoutcome-update.md) | [educationOutcome](educationoutcome.md) | Update the **educationOutcome** object. |
## Properties | Property | Type |Description| |:|:--|:-|
-|id|String|Read-only.|
+|id|String|Unique identifier for the **educationOutcome** object. Inherited from [entity](../resources/entity.md). Read-only.|
|lastModifiedBy|[identitySet](identityset.md)|The individual who updated the resource.|
-|lastModifiedDateTime|DateTimeOffset|Moment in time when the resource was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2021 is `2021-01-01T00:00:00Z`.|
+|lastModifiedDateTime|DateTimeOffset|The moment in time when the resource was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2021 is `2021-01-01T00:00:00Z`.|
## Relationships
-None
+None.
## JSON representation
v1.0 Enums https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/enums.md
Namespace: microsoft.graph
|reviewer| |unknownFutureValue|
+### educationFeedbackResourceOutcomeStatus values
+
+|Member|
+|:|
+|notPublished|
+|pendingPublish|
+|published|
+|failedPublish|
+|unknownFutureValue|
+ ### externalEmailOtpState values |Member|
v1.0 Group https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/group.md
This resource supports:
| [List deleted groups](../api/directory-deleteditems-list.md) | [directoryObject](directoryobject.md) collection | Retrieve the groups deleted in the tenant in the last 30 days. | | [List deleted groups owned by user](../api/directory-deleteditems-getuserownedobjects.md) | [directoryObject](directoryobject.md) collection | Retrieve the groups deleted in the tenant in the last 30 days and that are owned by a user. | | [Get deleted group](../api/directory-deleteditems-get.md) | [directoryObject](directoryobject.md) collection | Retrieve a deleted group by ID. |
-| [Restore deleted group](../api/directory-deleteditems-delete.md) | [directoryObject](directoryobject.md) collection | Restore a group deleted in the tenant in the last 30 days. |
-| [Permanently delete group](../api/directory-deleteditems-restore.md) | [directoryObject](directoryobject.md) collection | Permanently delete a deleted group from the tenant. |
+| [Restore deleted group](../api/directory-deleteditems-restore.md) | [directoryObject](directoryobject.md) collection | Restore a group deleted in the tenant in the last 30 days. |
+| [Permanently delete group](../api/directory-deleteditems-delete.md) | [directoryObject](directoryobject.md) collection | Permanently delete a deleted group from the tenant. |
| [checkMemberGroups](../api/directoryobject-checkmembergroups.md) | String collection | Check for membership in a list of groups. The function is transitive. | | [getMemberGroups](../api/directoryobject-getmembergroups.md) | String collection | Return all the groups that the group is a member of. The function is transitive. | | [checkMemberObjects](../api/directoryobject-checkmemberobjects.md) | String collection | Check for membership in a list of group, directory role, or administrative unit objects. The function is transitive. |
v1.0 Invitationparticipantinfo https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/invitationparticipantinfo.md
This resource is used to represent the entity that is being invited to a group c
| identity | [identitySet](identityset.md) | The [identitySet](identityset.md) associated with this invitation. | | participantId | String | Optional. The ID of the target participant. | | replacesCallId | String | Optional. The call which the target identity is currently a part of. For peer-to-peer case, the call will be dropped once the participant is added successfully. |
+| removeFromDefaultAudioRoutingGroup | Boolean | Optional. Whether to remove them from the main mixer. |
+| hidden | Boolean | Optional. Whether to hide the participant from the roster. |
## JSON representation
The following is a JSON representation of the resource.
{ "identity": {"@odata.type": "#microsoft.graph.identitySet"}, "participantId": "String",
- "replacesCallId": "String"
+ "replacesCallId": "String",
+ "removeFromDefaultAudioRoutingGroup": "Boolean",
+ "hidden": "Boolean"
} ```
v1.0 Licenseassignmentstate https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/licenseassignmentstate.md
The **licenseAssignmentStates** property of the [user](user.md) entity is a coll
## Properties | Property | Type |Description| |:|:--|:-|
-|assignedByGroup|string|The id of the group that assigns this license. If the assignment is a direct-assigned license, this field will be Null. Read-Only.|
-|disabledPlans|Collection(String)|The service plans that are disabled in this assignment. Read-Only.|
+|assignedByGroup|String|Indicates whether the license is directly-assigned or inherited from a group. If directly-assigned, this field is `null`; if inherited through a group membership, this field contains the ID of the group. Read-Only.|
+|disabledPlans|String collection|The service plans that are disabled in this assignment. Read-Only.|
|error|String|License assignment failure error. If the license is assigned successfully, this field will be Null. Read-Only. The possible values are `CountViolation`, `MutuallyExclusiveViolation`, `DependencyViolation`, `ProhibitedInUsageLocationViolation`, `UniquenessViolation`, and `Other`. For more information on how to identify and resolve license assignment errors see [here](/azure/active-directory/users-groups-roles/licensing-groups-resolve-problems).| |lastUpdatedDateTime|DateTimeOffset|The timestamp when the state of the license assignment was last updated.| |skuId|String|The unique identifier for the SKU. Read-Only.|
v1.0 Plannerassignedtotaskboardtaskformat https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/plannerassignedtotaskboardtaskformat.md
Title: "plannerAssignedToTaskBoardTaskFormat resource type"
-description: "The **plannerAssignedToTaskBoardTaskFormat** resource represents the information used to render a task correctly in the AssignedTo view of the Task Board (a view organized by users to whom tasks are assigned to). Each task will have one **plannerAssignedToTaskBoardTaskFormat** object associated with it."
+description: "Represents the information used to render a task correctly in the AssignedTo view of the Task Board (a view organized by users to whom tasks are assigned to)."
ms.localizationpriority: medium ms.prod: "planner"
doc_type: resourcePageType
Namespace: microsoft.graph
-The **plannerAssignedToTaskBoardTaskFormat** resource represents the information used to render a task correctly in the AssignedTo view of the Task Board (a view organized by users to whom tasks are assigned to). Each [task](plannertask.md) will have one **plannerAssignedToTaskBoardTaskFormat** object associated with it.
+Represents the information used to render a task correctly in the **AssignedTo** view of the task board (a view organized by users to whom tasks are assigned to). Each [task](plannertask.md) will have one **plannerAssignedToTaskBoardTaskFormat** object associated with it.
## Methods
The **plannerAssignedToTaskBoardTaskFormat** resource represents the information
## Properties | Property | Type |Description| |:|:--|:-|
-|id|String| Read-only. ID of the resource. It is 28 characters long and case-sensitive. [Format validation](planner-identifiers-disclaimer.md) is done on the service.|
+|id|String| ID of the resource. It is 28 characters long and case-sensitive. [Format validation](planner-identifiers-disclaimer.md) is done on the service. Read-only.|
|orderHintsByAssignee|[plannerOrderHintsByAssignee](plannerorderhintsbyassignee.md)|Dictionary of hints used to order tasks on the AssignedTo view of the Task Board. The key of each entry is one of the users the task is assigned to and the value is the order hint. The format of each value is defined as outlined [here](planner-order-hint-format.md).| |unassignedOrderHint|String|Hint value used to order the task on the AssignedTo view of the Task Board when the task is not assigned to anyone, or if the orderHintsByAssignee dictionary does not provide an order hint for the user the task is assigned to. The format is defined as outlined [here](planner-order-hint-format.md).| ## Relationships
-None
-
+None.
## JSON representation
-Here is a JSON representation of the resource.
+The following is a JSON representation of the resource.
<!--{ "blockType": "resource",
Here is a JSON representation of the resource.
"orderHintsByAssignee": {"@odata.type": "microsoft.graph.plannerOrderHintsByAssignee"}, "unassignedOrderHint": "String" }- ``` <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
v1.0 Riskyuserhistoryitem https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/riskyuserhistoryitem.md
Title: "riskyUserHistoryItem resource type"
-description: "risky user history item"
+description: "Represents the risk history of an Azure Active Directory (Azure AD) user as determined by Azure AD Identity Protection."
ms.localizationpriority: medium ms.prod: "identity-and-sign-in"
doc_type: resourcePageType
Namespace: microsoft.graph
-Represents the risk history of an Azure AD user as determined by Azure AD Identity Protection.
+Represents the risk history of an Azure Active Directory (Azure AD) user as determined by Azure AD Identity Protection.
Inherits from [riskyUser](../resources/riskyuser.md).
Inherits from [riskyUser](../resources/riskyuser.md).
|Property|Type|Description| |:|:|:| |activity|[riskUserActivity](../resources/riskuseractivity.md)|The activity related to user risk level change.|
-|id|String|Inherited from [entity](../resources/entity.md)|
-|initiatedBy|String|The id of actor that does the operation.|
-|isDeleted|Boolean| Inherited from [riskyUser](../resources/riskyuser.md)|
-|isProcessing|Boolean| Inherited from [riskyUser](../resources/riskyuser.md)|
-|riskDetail|riskDetail|Inherited from [riskyUser](../resources/riskyuser.md). Possible values are: `none`, `adminGeneratedTemporaryPassword`, `userPerformedSecuredPasswordChange`, `userPerformedSecuredPasswordReset`, `adminConfirmedSigninSafe`, `aiConfirmedSigninSafe`, `userPassedMFADrivenByRiskBasedPolicy`, `adminDismissedAllRiskForUser`, `adminConfirmedSigninCompromised`, `hidden`, `adminConfirmedUserCompromised`, `unknownFutureValue`.|
-|riskLastUpdatedDateTime|DateTimeOffset|Inherited from [riskyUser](../resources/riskyuser.md)|
-|riskLevel|riskLevel|Inherited from [riskyUser](../resources/riskyuser.md). Possible values are: `low`, `medium`, `high`, `hidden`, `none`, `unknownFutureValue`.|
-|riskState|riskState|Inherited from [riskyUser](../resources/riskyuser.md). Possible values are: `none`, `confirmedSafe`, `remediated`, `dismissed`, `atRisk`, `confirmedCompromised`, `unknownFutureValue`.|
-|userDisplayName|String|Inherited from [riskyUser](../resources/riskyuser.md)|
-|userId|String|The id of the user.|
-|userPrincipalName|String|Risky user principal name. Inherited from [riskyUser](../resources/riskyuser.md)|
+|id|String|The unique identifier for the **riskyUserHistoryItem** object. Inherited from [entity](../resources/entity.md).|
+|initiatedBy|String|The ID of actor that does the operation.|
+|isDeleted|Boolean|Indicates whether the user is deleted. Inherited from [riskyUser](../resources/riskyuser.md).|
+|isProcessing|Boolean|Indicates whether a user's risky state is being processed by the backend. Inherited from [riskyUser](../resources/riskyuser.md).|
+|riskDetail|riskDetail|Details of the detected risk. Inherited from [riskyUser](../resources/riskyuser.md). Possible values are: `none`, `adminGeneratedTemporaryPassword`, `userPerformedSecuredPasswordChange`, `userPerformedSecuredPasswordReset`, `adminConfirmedSigninSafe`, `aiConfirmedSigninSafe`, `userPassedMFADrivenByRiskBasedPolicy`, `adminDismissedAllRiskForUser`, `adminConfirmedSigninCompromised`, `hidden`, `adminConfirmedUserCompromised`, `unknownFutureValue`.|
+|riskLastUpdatedDateTime|DateTimeOffset|The date and time when the risky user was last updated. The DateTimeOffset 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`. Inherited from [riskyUser](../resources/riskyuser.md).|
+|riskLevel|riskLevel|Level of the detected risky user. Inherited from [riskyUser](../resources/riskyuser.md). Possible values are: `low`, `medium`, `high`, `hidden`, `none`, `unknownFutureValue`.|
+|riskState|riskState|State of the user's risk. Inherited from [riskyUser](../resources/riskyuser.md). Possible values are: `none`, `confirmedSafe`, `remediated`, `dismissed`, `atRisk`, `confirmedCompromised`, `unknownFutureValue`.|
+|userDisplayName|String|Risky user display name. Inherited from [riskyUser](../resources/riskyuser.md).|
+|userId|String|The ID of the user.|
+|userPrincipalName|String|Risky user principal name. Inherited from [riskyUser](../resources/riskyuser.md).|
## Relationships |Relationship|Type|Description| |:|:|:|
-|history|[riskyUserHistoryItem](../resources/riskyuserhistoryitem.md) collection| Inherited from [riskyUser](../resources/riskyuser.md)|
+|history|[riskyUserHistoryItem](../resources/riskyuserhistoryitem.md) collection| The activity related to user risk level change. Inherited from [riskyUser](../resources/riskyuser.md).|
## JSON representation The following is a JSON representation of the resource.
v1.0 Shift https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/shift.md
Represents a unit of scheduled work in a [schedule](schedule.md).
## Properties |Name |Type |Description | |--||-|
-| id |`string` |ID of the **shift**.|
-| userId |`string` |ID of the user assigned to the **shift**. Required. |
-| schedulingGroupId |`string` |ID of the scheduling group the **shift** is part of. Required. |
-| sharedShift |[shiftItem](shiftitem.md) |The shared version of this **shift** that is viewable by both employees and managers. Required. |
+| createdDateTime |DateTimeOffset |The timestamp on which this **shift** was first 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`. |
| draftShift |[shiftItem](shiftitem.md) |The draft version of this **shift** that is viewable by managers. Required. |
-| createdDateTime |`DateTimeOffset` |The timestamp on which this **shift** was first 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`. |
-| lastModifiedDateTime |`DateTimeOffset` |The timestamp on which this **shift** was last updated. 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`. |
+| id |String |ID of the **shift**.|
| lastModifiedBy | [identitySet](identityset.md) |The identity that last updated this **shift**.|
+| lastModifiedDateTime |DateTimeOffset |The timestamp on which this **shift** was last updated. 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`. |
+| schedulingGroupId |String |ID of the scheduling group the **shift** is part of. Required. |
+| sharedShift |[shiftItem](shiftitem.md) |The shared version of this **shift** that is viewable by both employees and managers. Required. |
+| userId |String |ID of the user assigned to the **shift**. Required. |
## JSON representation
The following is a JSON representation of the resource.
```json {
- "id": "SHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8",
- "createdDateTime": "2019-03-14T04:32:51.451Z",
- "lastModifiedDateTime": "2019-03-14T05:32:51.451Z",
- "userId": "c5d0c76b-80c4-481c-be50-923cd8d680a1",
- "schedulingGroupId": "TAG_228940ed-ff84-4e25-b129-1b395cf78be0",
- "lastModifiedBy": {"@odata.type":"microsoft.graph.identitySet"},
- "sharedShift": {"@odata.type":"microsoft.graph.shiftItem"},
- "draftShift": {"@odata.type":"microsoft.graph.shiftItem"}
+ "createdDateTime": "DateTimeOffset",
+ "draftShift": { "@odata.type": "microsoft.graph.shiftItem" },
+ "id": "String",
+ "lastModifiedBy": { "@odata.type": "microsoft.graph.identitySet" },
+ "lastModifiedDateTime": "DateTimeOffset",
+ "schedulingGroupId": "String",
+ "sharedShift": { "@odata.type": "microsoft.graph.shiftItem" },
+ "userId": "String"
} ``` - <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!--
v1.0 User https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/user.md
This resource supports:
|aboutMe|String|A freeform text entry field for the user to describe themselves. Returned only on `$select`.| |accountEnabled|Boolean| `true` if the account is enabled; otherwise, `false`. This property is required when a user is created. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `not`, and `in`). | |ageGroup|[ageGroup](#agegroup-values)|Sets the age group of the user. Allowed values: `null`, `Minor`, `NotAdult` and `Adult`. Refer to the [legal age group property definitions](#legal-age-group-property-definitions) for further information. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `not`, and `in`).|
-|assignedLicenses|[assignedLicense](assignedlicense.md) collection|The licenses that are assigned to the user, including inherited (group-based) licenses. Not nullable. Returned only on `$select`. Supports `$filter` (`eq`, `not`, and counting empty collections). |
+|assignedLicenses|[assignedLicense](assignedlicense.md) collection|The licenses that are assigned to the user, including inherited (group-based) licenses. This property doesn't differentiate directly-assigned and inherited licenses. Use the **licenseAssignmentStates** property to identify the directly-assigned and inherited licenses. Not nullable. Returned only on `$select`. Supports `$filter` (`eq`, `not`, and counting empty collections). |
|assignedPlans|[assignedPlan](assignedplan.md) collection|The plans that are assigned to the user. Read-only. Not nullable. <br><br>Returned only on `$select`. Supports `$filter` (`eq` and `not`). | |birthday|DateTimeOffset|The birthday of the user. 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`. <br><br>Returned only on `$select`.| |businessPhones|String collection|The telephone numbers for the user. NOTE: Although this is a string collection, only one number can be set for this property. Read-only for users synced from on-premises directory. <br><br>Returned by default. Supports `$filter` (`eq`, `not`, `ge`, `le`, `startsWith`).|
This resource supports:
|jobTitle|String|The user's job title. Maximum length is 128 characters. <br><br>Returned by default. Supports `$filter` (`eq`, `ne`, `not` , `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values).| |lastPasswordChangeDateTime| DateTimeOffset | The time when this Azure AD user last changed their password or when their password was created, whichever date the latest action was performed. The date and time information uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. <br><br>Returned only on `$select`.| |legalAgeGroupClassification|[legalAgeGroupClassification](#legalagegroupclassification-values)| Used by enterprise applications to determine the legal age group of the user. This property is read-only and calculated based on **ageGroup** and **consentProvidedForMinor** properties. Allowed values: `null`, `MinorWithOutParentalConsent`, `MinorWithParentalConsent`, `MinorNoParentalConsentRequired`, `NotAdult` and `Adult`. Refer to the [legal age group property definitions](#legal-age-group-property-definitions) for further information. <br><br>Returned only on `$select`.|
-|licenseAssignmentStates|[licenseAssignmentState](licenseassignmentstate.md) collection|State of license assignments for this user. Read-only. <br><br>Returned only on `$select`.|
+|licenseAssignmentStates|[licenseAssignmentState](licenseassignmentstate.md) collection|State of license assignments for this user. Also indicates licenses that are directly-assigned and those that the user has inherited through group memberships. Read-only. <br><br>Returned only on `$select`.|
|mail|String|The SMTP address for the user, for example, `jeff@contoso.onmicrosoft.com`. Changes to this property will also update the user's **proxyAddresses** collection to include the value as an SMTP address. This property cannot contain accent characters. <br/> **NOTE:** We do not recommend updating this property for Azure AD B2C user profiles. Use the **otherMails** property instead. <br><br>Returned by default. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, `endsWith`, and `eq` on `null` values).| |mailboxSettings|[mailboxSettings](mailboxsettings.md)|Settings for the primary mailbox of the signed-in user. You can [get](../api/user-get-mailboxsettings.md) or [update](../api/user-update-mailboxsettings.md) settings for sending automatic replies to incoming messages, locale and time zone. <br><br>Returned only on `$select`.| |mailNickname|String|The mail alias for the user. This property must be specified when a user is created. Maximum length is 64 characters. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values).|
v1.0 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/toc.yml a/api-reference/v1.0/toc.yml
items:
href: api/educationassignment-delete.md - name: Set up assignment resources folder href: api/educationassignment-setupresourcesfolder.md
+ - name: Set up assignment feedback resources folder
+ href: api/educationassignment-setupfeedbackresourcesfolder.md
- name: Publish assignment href: api/educationassignment-publish.md - name: List assignment resources
items:
href: api/educationsubmission-list-resources.md - name: Add submission resource href: api/educationsubmission-post-resources.md
+ - name: Add submission feedback resource outcome
+ href: api/educationfeedbackresourceoutcome-post-outcomes.md
- name: Get submission resource href: api/educationsubmissionresource-get.md - name: Delete submission resource href: api/educationsubmissionresource-delete.md
+ - name: Delete feedback resource outcome
+ href: api/educationfeedbackresourceoutcome-delete.md
- name: Get submission href: api/educationsubmission-get.md - name: Set up submission resources folder