Service | Microsoft Docs article | Related commit history on GitHub | Change details |
---|---|---|---|
v1.0 | Accesspackage Movetocatalog | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackage-movetocatalog.md | + + Title: "accessPackage: moveToCatalog" +description: "Allows callers to move an access package from one catalog to the another." ++ms.localizationpriority: medium +++# accessPackage: moveToCatalog +Namespace: microsoft.graph +++In [Azure AD entitlement management](../resources/entitlementmanagement-overview.md), this action moves the [accessPackage](../resources/accesspackage.md) to a specified target [accessPackageCatalog](../resources/accesspackagecatalog.md). The resources in the access package must be present in the target catalog. ++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)| EntitlementManagement.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|EntitlementManagement.ReadWrite.All| ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /identityGovernance/entitlementManagement/accessPackages/{accessPackageId}/moveToCatalog +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the parameters. ++The following table shows the parameters that can be used with this action. ++|Parameter|Type|Description| +|:|:|:| +|catalogId|String|ID of the catalog to which the access package will be moved.| ++++## Response ++If successful, this action returns a `200 OK` response code. ++## Examples ++### Request +The following is an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "accesspackagethis.movetocatalog" +} +--> +``` http +POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackages/3089f957-4bfe-405d-96c0-9a7ef30c01d6/moveToCatalog +Content-Type: application/json ++{ + "catalogId": "3301434b-99bd-46be-923b-d762c30c8e8b" +} +``` ++# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PowerShell](#tab/powershell) ++# [PHP](#tab/php) ++++++### Response +The following is an example of the response. ++<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 200 OK +``` + |
v1.0 | Accesspackage Post Incompatiblegroup | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackage-post-incompatiblegroup.md | If successful, this method returns a `204 No Content` response code. It does not The following is an example of the request. ++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "add_incompatiblegroup_to_accesspackage" Content-type: application/json } ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PowerShell](#tab/powershell) ++# [PHP](#tab/php) ++++ ### Response The following is an example of the response. |
v1.0 | Accessreviewset Post Historydefinitions | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accessreviewset-post-historydefinitions.md | The following table shows the required properties used to create an [accessRevie |reviewHistoryPeriodStartDateTime | DateTimeOffset | A timestamp. Reviews starting on or after this date will be included in the fetched history data. Only required if **scheduleSettings** is not defined. | |reviewHistoryPeriodEndDateTime | DateTimeOffset | A timestamp. Reviews starting on or before this date will be included in the fetched history data. Only required if **scheduleSettings** is not defined. | |scopes|[accessReviewQueryScope](../resources/accessreviewqueryscope.md) collection| Used to filter which reviews are included in the fetched history data. Fetches reviews whose scope matches with this provided scope. Required. <br> For more, see [Supported scope queries for accessReviewHistoryDefinition](#supported-scope-queries-for-accessreviewhistorydefinition). |-| scheduleSettings |[accessReviewHistoryScheduleSettings](../resources/accessReviewHistoryScheduleSettings.md)| The settings for a recurring access review history definition series. Only required if **reviewHistoryPeriodStartDateTime** or **reviewHistoryPeriodEndDateTime** are not defined. Not supported yet.| +| scheduleSettings |[accessReviewHistoryScheduleSettings](../resources/accessReviewHistoryScheduleSettings.md)| **Not supported yet.** The settings for a recurring access review history definition series. Only required if **reviewHistoryPeriodStartDateTime** or **reviewHistoryPeriodEndDateTime** are not defined. | ### Supported scope queries for accessReviewHistoryDefinition Content-Type: application/json "notReviewed", "notNotified" ],- "scheduleSettings": { - "reportRange": "P1M", - "recurrence": { - "pattern": { - "type": "monthly", - "interval": 1 - }, - "range": { - "type": "noEnd", - "startDate": "2018-08-03T21:02:30.667Z", - "count": 0 - } - } - }, + "reviewHistoryPeriodStartDateTime": "2021-01-01T00:00:00Z", + "reviewHistoryPeriodEndDateTime": "2021-04-30T23:59:59Z", "scopes": [ { "@odata.type": "#microsoft.graph.accessReviewQueryScope", Content-Type: application/json } ``` +# [C#](#tab/csharp) + # [JavaScript](#tab/javascript) [!INCLUDE [sample-code](../includes/snippets/javascript/create-accessreviewhistorydefinition-from--javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/powershell/create-accessreviewhistorydefinition-from--powershell-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PHP](#tab/php) + ### Response Content-Type: application/json "@odata.type": "#microsoft.graph.accessReviewHistoryDefinition", "id": "b2cb022f-b7e1-40f3-9854-c65a40861c38", "displayName": "Last quarter's group reviews April 2021",- "scheduleSettings": { - "reportRange": "P1M", - "recurrence": { - "pattern": { - "type": "monthly", - "interval": 1 - }, - "range": { - "type": "noEnd", - "startDate": "2018-08-03T21:02:30.667Z", - "count": 0 - } - } - }, + "reviewHistoryPeriodStartDateTime": "2021-01-01T00:00:00Z", + "reviewHistoryPeriodEndDateTime": "2021-04-30T23:59:59Z", "decisions": [ "approve", "deny", |
v1.0 | Administrativeunit Delta | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/administrativeunit-delta.md | One of the following permissions is required to call this API. To learn more, in |:--|:| |Delegated (work or school account) | AdministrativeUnit.Read.All, Directory.Read.All, AdministrativeUnit.ReadWrite.All, Directory.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |-|administrativeunit | AdministrativeUnit.Read.All, Directory.Read.All, AdministrativeUnit.ReadWrite.All, Directory.ReadWrite.All | +|Application | AdministrativeUnit.Read.All, Directory.Read.All, AdministrativeUnit.ReadWrite.All, Directory.ReadWrite.All | ## HTTP request GET /administrativeUnits/delta ## Query parameters -Tracking changes incurs a round of one or more **delta** function calls. If you use any query parameter -(other than `$deltatoken` and `$skiptoken`), you must specify -it in the initial **delta** request. Microsoft Graph automatically encodes any specified parameters -into the token portion of the `@odata.nextLink` or `@odata.deltaLink` URL provided in the response. -You only need to specify any query parameters once up front. -In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL from the previous response. That URL already +Tracking changes incurs a round of one or more **delta** function calls. If you use any query parameter +(other than `$deltatoken` and `$skiptoken`), you must specify +it in the initial **delta** request. Microsoft Graph automatically encodes any specified parameters +into the token portion of the `@odata.nextLink` or `@odata.deltaLink` URL provided in the response. +You only need to specify any query parameters once up front. +In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL from the previous response. That URL already includes the encoded parameters. | Query parameter | Type |Description| includes the encoded parameters. This method supports the following OData query parameters to help customize the response: -- You can use a `$select` query parameter as in any GET request to specify only the properties your need for best performance. The -**id** property is always returned. +- You can use a `$select` query parameter as in any GET request to specify only the properties your need for best performance. The +**id** property is always returned. - There is limited support for `$filter`: * The only supported `$filter` expression is for tracking changes for specific resources, by their ID: `$filter=id+eq+{value}` or `$filter=id+eq+{value1}+or+id+eq+{value2}`. The number of IDs you can specify is limited by the maximum URL length. Do not supply a request body for this method. ## Response -If successful, this method returns `200 OK` response code and an [administrativeUnit](../resources/administrativeunit.md) collection object in the response body. The response also includes a `@odata.nextLink` URL or a `@odata.deltaLink` URL. +If successful, this method returns `200 OK` response code and an [administrativeUnit](../resources/administrativeunit.md) collection object in the response body. The response also includes a `@odata.nextLink` URL or a `@odata.deltaLink` URL. - If a `@odata.nextLink` URL is returned, there are additional pages of data to be retrieved in the session. The **administrativeUnit** continues making requests using the `@odata.nextLink` URL until a `@odata.deltaLink` URL is included in the response. GET https://graph.microsoft.com/beta/administrativeUnits/delta ### Response >**Note:** The response object shown here might be shortened for readability.-<!-- { +<!-- { "blockType": "response", "truncated": true, "@odata.type": "microsoft.graph.administrativeUnit",- "isCollection": true -} --> + "isCollection": true +} --> ```http HTTP/1.1 200 OK Content-type: application/json |
v1.0 | Agreement List Acceptances | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/agreement-list-acceptances.md | GET /identityGovernance/termsOfUse/agreements/{agreementsId}/acceptances ``` ## Optional query parameters-This method the `$select` and `$filter` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). +This method supports the `$select` and `$filter` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ## Request headers |Name|Description| |
v1.0 | Application Delete | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-delete.md | One of the following permissions is required to call this API. To learn more, in |Permission type | Permissions (from least to most privileged) | |:--|:|-|Delegated (work or school account) | Application.ReadWrite.All, Directory.ReadWrite.All | +|Delegated (work or school account) | Application.ReadWrite.All | |Delegated (personal Microsoft account) | Application.ReadWrite.All |-|Application | Application.ReadWrite.OwnedBy, Application.ReadWrite.All, Directory.ReadWrite.All | +|Application | Application.ReadWrite.OwnedBy, Application.ReadWrite.All| ## HTTP request Replace `{applicationObjectId}` with the **id** for the application object, also referred to as the **Object ID** in the Azure portal. |
v1.0 | Application Post Applications | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-post-applications.md | One of the following permissions is required to call this API. To learn more, in |Permission type | Permissions (from least to most privileged) | |:--|:|-|Delegated (work or school account) | Application.ReadWrite.All, Directory.ReadWrite.All | +|Delegated (work or school account) | Application.ReadWrite.All | |Delegated (personal Microsoft account) | Application.ReadWrite.All |-|Application | Application.ReadWrite.OwnedBy, Application.ReadWrite.All, Directory.ReadWrite.All | +|Application | Application.ReadWrite.OwnedBy, Application.ReadWrite.All | ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Application Post Onlinemeetings | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-post-onlinemeetings.md | In the request body, supply a JSON representation of an [onlineMeeting](../resou > [!CAUTION] >-> Assigning the `presenter` or `coorganizer` role to users who are not registered in Azure Active Directory is not currently supported. For details, see [Known issues](/graph/known-issues#presenter-role-cannot-be-assigned-to-non-azure-ad-participants) for more details. +> Assigning the `presenter` or `coorganizer` role to users who are not registered in Azure Active Directory is not currently supported. ## Response If successful, this method returns a `201 Created` response code and an [onlineMeeting](../resources/onlinemeeting.md) object in the response body. |
v1.0 | Application Update | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-update.md | One of the following permissions is required to call this API. To learn more, in |Permission type | Permissions (from least to most privileged) | |:--|:|-|Delegated (work or school account) | Application.ReadWrite.All, Directory.ReadWrite.All | +|Delegated (work or school account) | Application.ReadWrite.All | |Delegated (personal Microsoft account) | Application.ReadWrite.All |-|Application | Application.ReadWrite.OwnedBy, Application.ReadWrite.All, Directory.ReadWrite.All | +|Application | Application.ReadWrite.OwnedBy, Application.ReadWrite.All | ## HTTP request Replace `{applicationObjectId}` with the **id** for the application object, also referred to as the **Object ID** in the Azure portal. |
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 | Bitlocker List Recoverykeys | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bitlocker-list-recoverykeys.md | This operation does not return the **key** property. For information about how t ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). -|Permission type|Permissions (from most to least privileged)| +|Permission type|Permissions (from least to most privileged)| |:|:| |Delegated (work or school account)|BitLockerKey.ReadBasic.All, BitLockerKey.Read.All|-|Delegated (personal Microsoft account)|Not supported| -|Application|Not supported| +|Delegated (personal Microsoft account)|Not supported.| +|Application|Not supported.| -For delegated permissions to allow apps to get BitLockerRecoveryKey resources on behalf of the signed-in user, the user must be the registered owner of the device that the BitLocker recovery key was originally backed up from, or the calling user must be in one of the following directory roles: +For delegated permissions to allow apps to get **bitLockerRecoveryKey** resources on behalf of the signed-in user, the user must be the registered owner of the device that the BitLocker recovery key was originally backed up from, or the calling user must be in one of the following directory roles: * Global administrator * Cloud device administrator To get a list of BitLocker keys within the tenant: GET /informationProtection/bitlocker/recoveryKeys ``` -To get a list of BitLocker keys within the tenant filtered by the **device id**: +To get a list of BitLocker keys within the tenant filtered by the **deviceId**: <!-- { "blockType": "ignored" GET /informationProtection/bitlocker/recoveryKeys?$filter=deviceId eq '{deviceId ``` ## Optional query parameters-This method supports the `$filter` OData query parameter to filter results by the **device id** the key was most recently backed up to. This method does not support the `$top` filter. For details, see [Example 2](#example-2). For general information, see [OData query parameters](/graph/query-parameters). +This method supports the `$filter` OData query parameter to filter results by the **deviceId** the key was most recently backed up to. This method does not support the `$top` filter. For details, see [Example 2](#example-2-retrieve-a-list-of-bitlocker-keys-filtered-by-deviceid). For general information, see [OData query parameters](/graph/query-parameters). The response might also contain an `odata.nextLink`, which you can use to page through the result set. For details, see [Paging Microsoft Graph data](/graph/paging). If successful, this method returns a `200 OK` response code and a collection of ## Examples -### Example 1 -Retrieve a list of BitLocker keys in the tenant. +### Example 1: Retrieve a list of BitLocker keys in the tenant #### Request The following is an example of the request. Content-Type: application/json ] } ```-### Example 2 -Retrieve a list of BitLocker keys filtered by **device id**. +### Example 2: Retrieve a list of BitLocker keys filtered by **deviceId** #### Request The following is an example of the request. |
v1.0 | Bitlockerrecoverykey Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bitlockerrecoverykey-get.md | By default, this operation does not return the **key** property that represents ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). -|Permission type|Permissions (from most to least privileged)| +|Permission type|Permissions (from least to most privileged)| |:|:| |Delegated (work or school account)|BitLockerKey.ReadBasic.All, BitLockerKey.Read.All|-|Delegated (personal Microsoft account)|Not supported| -|Application|Not supported| +|Delegated (personal Microsoft account)|Not supported.| +|Application|Not supported.| ->**Note:** For delegated permissions to allow apps to get BitLockerRecoveryKey resources on behalf of the signed-in user, the tenant administrator must have assigned the user one of the following roles, or the user must be the **registered owner** of the device that the BitLocker key was originally backed up from: +>**Note:** For delegated permissions to allow apps to get **bitLockerRecoveryKey** resources on behalf of the signed-in user, the tenant administrator must have assigned the user one of the following roles, or the user must be the **registered owner** of the device that the BitLocker key was originally backed up from: * Global administrator * Cloud device administrator * Helpdesk administrator GET /informationProtection/bitlocker/recoveryKeys/{bitlockeryRecoveryKeyId}?$sel ``` ## Optional query parameters-This method supports the `$select` OData query parameter to return the **key** property. For details, see [Example 2](#example-2). For general information, see [OData query parameters](/graph/query-parameters). +This method supports the `$select` OData query parameter to return the **key** property. For details, see [Example 2](#example-2-get-the-bitlocker-key-with-the-key-property-by-specifying-the-key-id). For general information, see [OData query parameters](/graph/query-parameters). ## Request headers |Name|Description| If successful, this method returns a `200 OK` response code and a [bitlockerReco ## Examples -### Example 1 -Get the BitLocker key by specifying the **key id**. This example does not return the **key** property. +### Example 1: Get the BitLocker key by specifying the key **id** #### Request-The following is an example of the request. +The following is an example of the request. This example does not return the **key** property. <!-- { "blockType": "request", ocp-client-version: "1.2" #### Response The following is an example of the response. -**Note:** The response object shown here might be shortened for readability. +>**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", "truncated": true, Content-type: application/json } ``` -### Example 2 -Get the BitLocker key with the **key** property by specifying the **key id**. +### Example 2: Get the BitLocker key with the **key** property by specifying the key **id** #### Request The following is an example of the request. ocp-client-version: "1.2" #### Response The following is an example of the response. -**Note:** The response object shown here might be shortened for readability. +>**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", "truncated": true, |
v1.0 | Bookingbusiness Getstaffavailability | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bookingbusiness-getstaffavailability.md | Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/jav)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [Go](#tab/go) ++# [PowerShell](#tab/powershell) ++# [PHP](#tab/php) + |
v1.0 | Browsersharedcookie Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersharedcookie-get.md | + + Title: "Get browserSharedCookie" +description: "Get a session cookie that can be shared between a Microsoft Edge process and an Internet Explorer process, while using Internet Explorer mode." ++ms.localizationpriority: medium +++# Get browserSharedCookie +Namespace: microsoft.graph +++Get a [session cookie](../resources/browsersharedcookie.md) that can be shared between a Microsoft Edge process and an Internet Explorer process, while using [Internet Explorer mode](/deployedge/edge-ie-mode). ++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All| ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sharedCookies/{browserSharedCookieId} +``` ++## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Do not supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [browserSharedCookie](../resources/browsersharedcookie.md) object in the response body. ++## Examples ++### Request +The following is an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_browsersharedcookie", + "sampleKeys": ["147713b8-4df2-4717-93a3-bfb1ebb54881", "07f4030f-45ff-4ad1-9277-3b8f6ee74141"] +} +--> +``` http +GET https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/147713b8-4df2-4717-93a3-bfb1ebb54881/sharedCookies/07f4030f-45ff-4ad1-9277-3b8f6ee74141 +``` ++# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PHP](#tab/php) ++++++### Response +The following is an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.browserSharedCookie" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "status": "pendingEdit", + "id": "07f4030f-45ff-4ad1-9277-3b8f6ee74141", + "hostOrDomain": "www.microsoft.com", + "sourceEnvironment": "microsoftEdge", + "displayName": "Microsoft Cookie", + "path": "/", + "hostOnly": true, + "comment": "A cookie for microsoft.com", + "lastModifiedDateTime": "2022-06-29T11:32:39.6732721-04:00", + "createdDateTime": "2022-06-29T11:32:39.673272-04:00", + "lastModifiedBy": { + "user": { + "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c", + "displayName": "Joe Smith" + }, + "application": null + }, + "history": [ + { + "publishedDateTime": "2022-06-29T14:51:23.8662592Z", + "hostOrDomain": "www.microsoft.com", + "comment": "A cookie for InternetExplorer11", + "displayName": "Microsoft Cookie", + "sourceEnvironment": "internetExplorer11", + "hostOnly": true, + "lastModifiedBy": { + "user": { + "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c", + "displayName": "Joe Smith" + }, + "application": null + } + } + ] +} +``` + |
v1.0 | Browsersharedcookie Update | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersharedcookie-update.md | + + Title: "Update browserSharedCookie" +description: "Update the properties of a browserSharedCookie object." ++ms.localizationpriority: medium +++# Update browserSharedCookie +Namespace: microsoft.graph +++Update the properties of a [browserSharedCookie](../resources/browsersharedcookie.md) object. ++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|BrowserSiteLists.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|BrowserSiteLists.ReadWrite.All| ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sharedCookies/{browserSharedCookieId} +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body ++++|Property|Type|Description| +|:|:|:| +|comment|String|The comment of the cookie.| +|displayName|String|The name of the cookie.| +|hostOnly|Boolean|Determines whether a cookie is a host-only or domain cookie.| +|hostOrDomain|String|The URL of the cookie.| +|path|String|The path of the cookie.| +|sourceEnvironment|browserSharedCookieSourceEnvironment|Specifies how the cookies are shared between Microsoft Edge and Internet Explorer. The possible values are: `microsoftEdge`, `internetExplorer11`, `both`, `unknownFutureValue`.| +++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request +The following is an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "update_browsersharedcookie", + "sampleKeys": ["20579923-e6c8-425a-b728-47f43c10bc05", "972a5778-df43-45fd-9c2a-5dd944c7a1ce"] +} +--> +``` http +PATCH https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/20579923-e6c8-425a-b728-47f43c10bc05/sharedCookies/972a5778-df43-45fd-9c2a-5dd944c7a1ce +Content-Type: application/json +Content-length: 349 ++{ + "hostOrDomain": "www.microsoft.com", + "sourceEnvironment": "microsoftEdge", + "displayName": "Microsoft Cookie", + "path": "/", + "hostOnly": true, + "comment": "Updating source environment." +} +``` ++# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PHP](#tab/php) ++++++### Response +The following is an example of the response. +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Browsersite Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersite-get.md | + + Title: "Get browserSite" +description: "Get a browserSite that resides on a site list." ++ms.localizationpriority: medium +++# Get browserSite +Namespace: microsoft.graph +++Get a [browserSite](../resources/browsersite.md) that resides on a [browserSiteList](../resources/browsersitelist.md). ++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All| ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sites/{browserSiteId} +``` ++## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Do not supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [browserSite](../resources/browsersite.md) object in the response body. ++## Examples ++### Request +The following is an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_browsersite", + "sampleKeys": ["20579923-e6c8-425a-b728-47f43c10bc05", "a22cbc85-d5d2-4e61-8414-42e6704c36f7"] +} +--> +``` http +GET https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/20579923-e6c8-425a-b728-47f43c10bc05/sites/a22cbc85-d5d2-4e61-8414-42e6704c36f7 +``` ++# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PHP](#tab/php) ++++++### Response +The following is an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.browserSite" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "status": "pendingEdit", + "id": "a22cbc85-d5d2-4e61-8414-42e6704c36f7", + "webUrl": "www.microsoft.com", + "targetEnvironment": "microsoftEdge", + "mergeType": "default", + "compatibilityMode": "default", + "allowRedirect": false, + "comment": "Updating to Edge.", + "lastModifiedDateTime": "2022-06-29T15:44:27.2154899Z", + "createdDateTime": "2022-06-29T14:51:23.8662595Z", + "deletedDateTime": null, + "lastModifiedBy": { + "user": { + "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c", + "displayName": "Joe Smith" + }, + "application": null + }, + "history": [ + { + "publishedDateTime": "2022-06-29T14:51:23.8662592Z", + "allowRedirect": true, + "comment": "A site that opens in InternetExplorer11", + "compatibilityMode": "default", + "targetEnvironment": "internetExplorer11", + "mergeType": "default", + "lastModifiedBy": { + "user": { + "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c", + "displayName": "Joe Smith" + }, + "application": null + } + } + ] +} +``` + |
v1.0 | Browsersite Update | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersite-update.md | + + Title: "Update browserSite" +description: "Update the properties of a browserSite object." ++ms.localizationpriority: medium +++# Update browserSite +Namespace: microsoft.graph +++Update the properties of a [browserSite](../resources/browsersite.md) object. ++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|BrowserSiteLists.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|BrowserSiteLists.ReadWrite.All| ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sites/{browserSiteId} +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +++|Property|Type|Description| +|:|:|:| +|allowRedirect|Boolean|Controls the behavior of redirected sites. If `true`, indicates that the site will open in Internet Explorer 11 or Microsoft Edge even if the site is navigated to as part of a HTTP or meta refresh redirection chain.| +|comment|String|The comment for the site.| +|compatibilityMode|browserSiteCompatibilityMode|Controls what compatibility setting is used for specific sites or domains. The possible values are: `default`, `internetExplorer8Enterprise`, `internetExplorer7Enterprise`, `internetExplorer11`, `internetExplorer10`, `internetExplorer9`, `internetExplorer8`, `internetExplorer7`, `internetExplorer5`, `unknownFutureValue`.| +|mergeType|browserSiteMergeType|The merge type of the site. The possible values are: `noMerge`, `default`, `unknownFutureValue`.| +|targetEnvironment|browserSiteTargetEnvironment|The target environment that the site should open in. The possible values are: `internetExplorerMode`, `internetExplorer11`, `microsoftEdge`, `configurable`, `none`, `unknownFutureValue`.<br /><br />Prior to June 15, 2022, the `internetExplorer11` option would allow opening a site in the Internet Explorer 11 (IE11) desktop application. Following the retirement of IE11 on June 15, 2022, the `internetExplorer11` option will no longer open an IE11 window and will instead behave the same as the `internetExplorerMode` option.| +|webUrl|String|The URL of the site.| ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request +The following is an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "update_browsersite", + "sampleKeys": ["972a5778-df43-45fd-9c2a-5dd944c7a1ce", "7cf831d2-8a9b-4826-b120-911566f6fd6a"] +} +--> +``` http +PATCH https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/972a5778-df43-45fd-9c2a-5dd944c7a1ce/sites/7cf831d2-8a9b-4826-b120-911566f6fd6a +Content-Type: application/json +Content-length: 387 ++{ + "webUrl": "www.microsoft.com", + "targetEnvironment": "microsoftEdge", + "mergeType": "default", + "compatibilityMode": "default", + "allowRedirect": false, + "comment": "Updating to Edge." +} +``` ++# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PHP](#tab/php) ++++++### Response +The following is an example of the response. +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Browsersitelist Delete Sharedcookies | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-delete-sharedcookies.md | + + Title: "Delete browserSharedCookie" +description: "Delete a browserSharedCookie from a browserSiteList." ++ms.localizationpriority: medium +++# Delete browserSharedCookie +Namespace: microsoft.graph +++Delete a [browserSharedCookie](../resources/browsersharedcookie.md) from a [browserSiteList](../resources/browsersitelist.md). ++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|BrowserSiteLists.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|BrowserSiteLists.ReadWrite.All| ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +DELETE /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sharedCookies/{browserSharedCookieId} +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Do not supply a request body for this method. ++## Response ++If the shared cookie was not previously published, then this method returns a `204 No Content` response code on a successful delete. If the shared cookie was previously published, then this method returns a `200 OK` response code and a [browserSiteList](../resources/browsersitelist.md) object in the response body with the status as `pendingDelete`. You must publish (for example, via the [browserSiteList: publish](../api/browsersitelist-publish.md) API) the shared cookie to fully remove it from the site list. ++## Examples ++### Example 1: Delete a shared cookie that was not previously published ++#### Request +The following is an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "delete_browsersharedcookie", + "@odata.type": "microsoft.graph.browserSharedCookie", + "sampleKeys": ["7cf831d2-8a9b-4826-b120-911566f6fd6a", "07b4cc32-237f-4a1a-9d7f-531efc26220e"] +} +--> +``` http +DELETE https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/7cf831d2-8a9b-4826-b120-911566f6fd6a/sharedCookies/07b4cc32-237f-4a1a-9d7f-531efc26220e +``` ++# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PHP](#tab/php) ++++++#### Response +The following is an example of the response. +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` ++### Example 2: Delete a shared cookie that was previously published ++#### Request +The following is an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "delete_browsersharedcookie", + "sampleKeys": ["7cf831d2-8a9b-4826-b120-911566f6fd6a", "07f4030f-45ff-4ad1-9277-3b8f6ee74141"] +} +--> +``` http +DELETE https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/7cf831d2-8a9b-4826-b120-911566f6fd6a/sharedCookies/07f4030f-45ff-4ad1-9277-3b8f6ee74141 +``` ++# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PHP](#tab/php) ++++++#### Response +The following is an example of the response where the **status** has changed to `pendingDelete` but the shared cookie is still published. You must publish the shared cookie to fully remove it from the site list. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.browserSharedCookie" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "status": "pendingDelete", + "id": "07f4030f-45ff-4ad1-9277-3b8f6ee74141", + "hostOrDomain": "www.microsoft.com", + "sourceEnvironment": "internetExplorer11", + "displayName": "Microsoft Cookie", + "path": "/", + "hostOnly": true, + "comment": "A cookie for microsoft.com", + "lastModifiedDateTime": "2022-06-29T11:38:39.6732721-04:00", + "createdDateTime": "2022-06-29T11:32:39.673272-04:00", + "deletedDateTime": "2022-06-29T11:38:39.673272-04:00", + "lastModifiedBy": { + "user": { + "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c", + "displayName": "Joe Smith" + }, + "application": null + }, + "history": [] +} +``` |
v1.0 | Browsersitelist Delete Sites | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-delete-sites.md | + + Title: "Delete browserSite" +description: "Delete a browserSite from a browserSiteList." ++ms.localizationpriority: medium +++# Delete browserSite +Namespace: microsoft.graph +++Delete a [browserSite](../resources/browsersite.md) from a [browserSiteList](../resources/browsersitelist.md). ++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|BrowserSiteLists.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|BrowserSiteLists.ReadWrite.All| ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +DELETE /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sites/{browserSiteId} +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Do not supply a request body for this method. ++## Response ++If the site was not previously published, then this method returns a `204 No Content` response code on a successful delete. If the site was previously published, then this method returns a `200 OK` response code and a [browserSiteList](../resources/browsersitelist.md) object in the response body with the status as `pendingDelete`. You must publish (for example, via the [browserSiteList: publish](../api/browsersitelist-publish.md) API) the site to fully remove it from the site list. ++## Examples ++### Example 1: Delete a site that was not previously published ++#### Request +The following is an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "delete_browsersite", + "sampleKeys": ["07f4030f-45ff-4ad1-9277-3b8f6ee74141", "a22cbc85-d5d2-4e61-8414-42e6704c36f7"] +} +--> +``` http +DELETE https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/07f4030f-45ff-4ad1-9277-3b8f6ee74141/sites/a22cbc85-d5d2-4e61-8414-42e6704c36f7 +``` ++# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PHP](#tab/php) ++++++#### Response +The following is an example of the response. +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` ++### Example 2: Delete a site that was previously published ++#### Request +The following is an example of a request. +<!-- { + "blockType": "request", + "name": "delete_browsersite", + "sampleKeys": ["07f4030f-45ff-4ad1-9277-3b8f6ee74141", "a22cbc85-d5d2-4e61-8414-42e6704c36f7"] +} +--> +``` http +DELETE https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/07f4030f-45ff-4ad1-9277-3b8f6ee74141/sites/a22cbc85-d5d2-4e61-8414-42e6704c36f7 +``` +++#### Response +The following is an example of the response where the status has changed to `pendingDelete` but the site is still published. You must publish the site to fully remove it from the site list. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.browserSite" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "status": "pendingDelete", + "id": "a22cbc85-d5d2-4e61-8414-42e6704c36f7", + "webUrl": "www.microsoft.com", + "targetEnvironment": "microsoftEdge", + "mergeType": "default", + "compatibilityMode": "default", + "allowRedirect": false, + "comment": "Site for Microsoft Edge", + "lastModifiedDateTime": "2022-06-29T15:44:27.2154899Z", + "createdDateTime": "2022-06-29T14:51:23.8662595Z", + "createdDateTime": "2022-06-29T14:55:23.8662595Z", + "lastModifiedBy": { + "user": { + "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c", + "displayName": "Joe Smith" + }, + "application": null + }, + "history": [] +} +``` |
v1.0 | Browsersitelist Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-get.md | + + Title: "Get browserSiteList" +description: "Get a browserSiteList that contains browserSite and browserSharedCookie resources." ++ms.localizationpriority: medium +++# Get browserSiteList +Namespace: microsoft.graph +++Get a [browserSiteList](../resources/browsersitelist.md) that contains [browserSite](../resources/browsersite.md) and [browserSharedCookie](../resources/browsersharedcookie.md) resources. ++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All| ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /admin/edge/internetExplorerMode/siteLists/{browserSiteListId} +``` ++## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Do not supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a [browserSiteList](../resources/browsersitelist.md) object in the response body. ++## Examples ++### Request +The following is an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "get_browsersitelist", + "sampleKeys": ["e370d818-f650-5ab1-499e-5915e83f4573"] +} +--> +``` http +GET https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/e370d818-f650-5ab1-499e-5915e83f4573 +``` ++# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PHP](#tab/php) ++++++### Response +The following is an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.browserSiteList" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.browserSiteList", + "id": "e370d818-f650-5ab1-499e-5915e83f4573", + "description": "Production site list for devices", + "lastModifiedBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Joe Smith" + }, + "application": null + }, + "lastModifiedDateTime": "2016-03-21T20:01:37Z", + "displayName": "Production Site List A", + "publishedBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Joe Smith" + }, + "application": null + }, + "publishedDateTime": "2016-03-21T20:01:37Z", + "status": "published", + "revision": "1.0" +} +``` + |
v1.0 | Browsersitelist List Sharedcookies | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-list-sharedcookies.md | + + Title: "List browserSharedCookies" +description: "Get a list of the browserSharedCookie objects and their properties." ++ms.localizationpriority: medium +++# List browserSharedCookies +Namespace: microsoft.graph +++Get a list of the [browserSharedCookie](../resources/browsersharedcookie.md) objects and their properties. ++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All| ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sharedCookies +``` ++## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Do not supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a collection of [browserSharedCookie](../resources/browsersharedcookie.md) objects in the response body. ++## Examples ++### Request +The following is an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "list_browsersharedcookie", + "sampleKeys": ["e370d818-f650-5ab1-499e-5915e83f4573"] +} +--> +``` http +GET https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/e370d818-f650-5ab1-499e-5915e83f4573/sharedCookies +``` ++# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PHP](#tab/php) ++++++### Response +The following is an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.browserSharedCookie", + "isCollection": true +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "status": "published", + "id": "07f4030f-45ff-4ad1-9277-3b8f6ee74141", + "hostOrDomain": "www.microsoft.com", + "sourceEnvironment": "internetExplorer11", + "displayName": "Microsoft Cookie", + "path": "/", + "hostOnly": true, + "comment": "A cookie for microsoft.com", + "lastModifiedDateTime": "2022-06-29T11:32:39.6732721-04:00", + "createdDateTime": "2022-06-29T11:32:39.673272-04:00", + "lastModifiedBy": { + "user": { + "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c", + "displayName": "Joe Smith" + }, + "application": null + }, + "history": [] + } + ] +} +``` + |
v1.0 | Browsersitelist List Sites | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-list-sites.md | + + Title: "List browserSites" +description: "Get a list of the browserSite objects and their properties." ++ms.localizationpriority: medium +++# List browserSites +Namespace: microsoft.graph +++Get a list of the [browserSite](../resources/browsersite.md) objects and their properties. ++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All| ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sites +``` ++## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Do not supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a collection of [browserSite](../resources/browsersite.md) objects in the response body. ++## Examples ++### Request +The following is an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "list_browsersite", + "sampleKeys": ["e370d818-f650-5ab1-499e-5915e83f4573"] +} +--> +``` http +GET https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/e370d818-f650-5ab1-499e-5915e83f4573/sites +``` ++# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PHP](#tab/php) ++++++### Response +The following is an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.browserSite", + "isCollection": true +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "status": "pendingEdit", + "id": "a22cbc85-d5d2-4e61-8414-42e6704c36f7", + "webUrl": "www.microsoft.com", + "targetEnvironment": "microsoftEdge", + "mergeType": "default", + "compatibilityMode": "default", + "allowRedirect": false, + "comment": "Updating to Edge.", + "lastModifiedDateTime": "2022-06-29T15:44:27.2154899Z", + "createdDateTime": "2022-06-29T14:51:23.8662595Z", + "deletedDateTime": null, + "lastModifiedBy": { + "user": { + "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c", + "displayName": "Joe Smith" + }, + "application": null + }, + "history": [ + { + "publishedDateTime": "2022-06-29T14:51:23.8662592Z", + "allowRedirect": true, + "comment": "A site that opens in InternetExplorer11", + "compatibilityMode": "default", + "targetEnvironment": "internetExplorer11", + "mergeType": "default", + "lastModifiedBy": { + "user": { + "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c", + "displayName": "Joe Smith" + }, + "application": null + } + } + ] + } + ] +} +``` + |
v1.0 | Browsersitelist Post Sharedcookies | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-post-sharedcookies.md | + + Title: "Create browserSharedCookie" +description: "Create a new browserSharedCookie object in a browserSiteList." ++ms.localizationpriority: medium +++# Create browserSharedCookie +Namespace: microsoft.graph +++Create a new [browserSharedCookie](../resources/browsersharedcookie.md) object in a [browserSiteList](../resources/browsersitelist.md). ++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|BrowserSiteLists.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|BrowserSiteLists.ReadWrite.All| ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sharedCookies +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the [browserSharedCookie](../resources/browsersharedcookie.md) object. ++You can specify the following properties when you create a **browserSharedCookie**. ++|Property|Type|Description| +|:|:|:| +|comment|String|The comment of the cookie. Required.| +|displayName|String|The name of the cookie. Required.| +|hostOnly|Boolean|Determines whether a cookie is a host-only or domain cookie. Required.| +|hostOrDomain|String|The URL of the cookie. Required.| +|path|String|The path of the cookie. Required.| +|sourceEnvironment|browserSharedCookieSourceEnvironment|Specifies how the cookies are shared between Microsoft Edge and Internet Explorer. The possible values are: `microsoftEdge`, `internetExplorer11`, `both`, `unknownFutureValue`. Required.| ++## Response ++If successful, this method returns a `201 Created` response code and a [browserSharedCookie](../resources/browsersharedcookie.md) object in the response body. ++## Examples ++### Request +The following is an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_browsersharedcookie", + "sampleKeys": ["e370d818-f650-5ab1-499e-5915e83f4573"] +} +--> +``` http +POST https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/e370d818-f650-5ab1-499e-5915e83f4573/sharedCookies +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.browserSharedCookie", + "hostOrDomain": "www.microsoft.com", + "sourceEnvironment": "InternetExplorer11", + "displayName": "Microsoft Cookie", + "hostOnly": true, + "comment": "A cookie for microsoft.com", + "path": "/" +} +``` ++# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PHP](#tab/php) ++++++### Response +The following is an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.browserSharedCookie" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "status": "pendingAdd", + "id": "07f4030f-45ff-4ad1-9277-3b8f6ee74141", + "hostOrDomain": "www.microsoft.com", + "sourceEnvironment": "internetExplorer11", + "displayName": "Microsoft Cookie", + "path": "/", + "hostOnly": true, + "comment": "A cookie for microsoft.com", + "lastModifiedDateTime": "2022-06-29T15:32:39.6732721Z", + "createdDateTime": "2022-06-29T15:32:39.673272Z", + "deletedDateTime": null, + "lastModifiedBy": { + "user": { + "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c", + "displayName": "Joe Smith" + }, + "application": null + }, + "history": [] +} +``` + |
v1.0 | Browsersitelist Post Sites | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-post-sites.md | + + Title: "Create browserSite" +description: "Create a new browserSite object in a browserSiteList." ++ms.localizationpriority: medium +++# Create browserSite +Namespace: microsoft.graph +++Create a new [browserSite](../resources/browsersite.md) object in a [browserSiteList](../resources/browsersitelist.md). ++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|BrowserSiteLists.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|BrowserSiteLists.ReadWrite.All| ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/sites +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the [browserSite](../resources/browsersite.md) object. ++You can specify the following properties when you create a **browserSite**. ++|Property|Type|Description| +|:|:|:| +|allowRedirect|Boolean|Controls the behavior of redirected sites. If `true`, indicates that the site will open in Internet Explorer 11 or Microsoft Edge even if the site is navigated to as part of a HTTP or meta refresh redirection chain. Required.| +|comment|String|The comment for the site. Required| +|compatibilityMode|browserSiteCompatibilityMode|Controls what compatibility setting is used for specific sites or domains. The possible values are: `default`, `internetExplorer8Enterprise`, `internetExplorer7Enterprise`, `internetExplorer11`, `internetExplorer10`, `internetExplorer9`, `internetExplorer8`, `internetExplorer7`, `internetExplorer5`, `unknownFutureValue`. Required.| +|mergeType|browserSiteMergeType|The merge type of the site. The possible values are: `noMerge`, `default`, `unknownFutureValue`. Required.| +|targetEnvironment|browserSiteTargetEnvironment|The target environment that the site should open in. The possible values are: `internetExplorerMode`, `internetExplorer11`, `microsoftEdge`, `configurable`, `none`, `unknownFutureValue`. Required.<br /><br />Prior to June 15, 2022, the `internetExplorer11` option would allow opening a site in the Internet Explorer 11 (IE11) desktop application. Following the retirement of IE11 on June 15, 2022, the `internetExplorer11` option will no longer open an IE11 window and will instead behave the same as the `internetExplorerMode` option.| +|webUrl|String|The URL of the site. Required.| +++## Response ++If successful, this method returns a `201 Created` response code and a [browserSite](../resources/browsersite.md) object in the response body. ++## Examples ++### Request +The following is an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_browsersite", + "sampleKeys": ["e370d818-f650-5ab1-499e-5915e83f4573"] +} +--> +``` http +POST https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/e370d818-f650-5ab1-499e-5915e83f4573/sites +Content-Type: application/json +Content-length: 387 ++{ + "@odata.type": "#microsoft.graph.browserSite", + "webUrl": "www.microsoft.com", + "targetEnvironment": "InternetExplorer11", + "comment": "A site that opens in InternetExplorer11", + "mergeType": "default", + "compatibilityMode": "default", + "allowRedirect": true +} +``` ++# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PHP](#tab/php) ++++++### Response +The following is an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.browserSite" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "status": "pendingAdd", + "id": "a22cbc85-d5d2-4e61-8414-42e6704c36f7", + "webUrl": "www.microsoft.com", + "targetEnvironment": "internetExplorer11", + "mergeType": "default", + "compatibilityMode": "default", + "allowRedirect": true, + "comment": "A site that opens in InternetExplorer11", + "lastModifiedDateTime": "2022-06-29T14:51:23.8662592Z", + "createdDateTime": "2022-06-29T14:51:23.8662595Z", + "deletedDateTime": null, + "lastModifiedBy": { + "user": { + "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c", + "displayName": "Joe Smith" + }, + "application": null + }, + "history": [] +} +``` + |
v1.0 | Browsersitelist Publish | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-publish.md | + + Title: "browserSiteList: publish" +description: "Publish the specified browserSiteList for devices to download." ++ms.localizationpriority: medium +++# browserSiteList: publish +Namespace: microsoft.graph +++Publish the specified [browserSiteList](../resources/browsersitelist.md) for devices to download. ++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|BrowserSiteLists.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|BrowserSiteLists.ReadWrite.All| ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /admin/edge/internetExplorerMode/siteLists/{browserSiteListId}/publish +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| +++## Request body ++In the request body, omit both sites and share cookies to publish the entire site list. Optionally, you can publish specific sites and shared cookies by specifying a collection of IDs. +++|Property|Type|Description| +|:|:|:| +|revision|String|The revision of the site list to publish. Required.| +|sharedCookies|[browserSharedCookie](../resources/browsersharedcookie.md) collection|The collection of shared cookies to publish. Optional. Only requires the shared cookie ID. All other fields are ignored.| +|sites|[browserSite](../resources/browsersite.md) collection|The collection of sites to publish. Optional. Only requires the site ID. All other fields are ignored.| +++## Response ++If successful, this action returns a `200 OK` response code and a [browserSiteList](../resources/browsersitelist.md) in the response body. ++## Examples ++### Example 1: Publish all sites and shared cookies ++#### Request ++The following is an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "browsersitelist_publish", + "sampleKeys": ["36ba61eb-c492-4283-a38b-963a1dbb2f69"] +} +--> +``` http +POST https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/36ba61eb-c492-4283-a38b-963a1dbb2f69/publish +Content-Type: application/json ++{ + "revision": "1.0" +} +``` ++# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PHP](#tab/php) ++++++#### Response +The following is an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.browserSiteList" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.browserSiteList", + "id": "36ba61eb-c492-4283-a38b-963a1dbb2f69", + "revision": "1.0", + "displayName": "Product Site List A", + "description": "A production site list for team A", + "lastModifiedDateTime": "2022-06-28T19:29:52.8752365Z", + "publishedDateTime": "2022-06-28T19:29:52.8752365Z", + "status": "published", + "lastModifiedBy": { + "user": { + "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c", + "displayName": "Joe Smith" + }, + "application": null + }, + "publishedBy": { + "user": { + "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c", + "displayName": "Joe Smith" + }, + "application": null + } +} +``` ++### Example 2: Publish specific sites and shared cookies ++#### Request ++The following is an example of a request. +<!-- { + "blockType": "request", + "name": "browsersitelist_publish", + "sampleKeys": ["36ba61eb-c492-4283-a38b-963a1dbb2f69"] +} +--> +``` http +POST https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/36ba61eb-c492-4283-a38b-963a1dbb2f69/publish +Content-Type: application/json ++{ + "revision": "1.0", + "sites": [ + { + "id": "53e5f971-fc7b-4cd3-a1bf-34d7c0416882" + }, + { + "id": "2e27cc86-3662-447e-b751-274fb9f869ea" + } + ], + "sharedCookies": [ + { + "id": "7f639835-23ab-4793-b1e6-1a06fad127a2" + } + ] +} +``` +++#### Response +The following is an example of the response. The **status** will show `pending` if the request contains sites or shared cookies that you have not published yet. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.browserSiteList" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.browserSiteList", + "id": "36ba61eb-c492-4283-a38b-963a1dbb2f69", + "revision": "1.0", + "displayName": "Product Site List A", + "description": "A production site list for team A", + "lastModifiedDateTime": "2022-06-28T19:29:52.8752365Z", + "publishedDateTime": "2022-06-28T19:29:52.8752365Z", + "status": "pending", + "lastModifiedBy": { + "user": { + "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c", + "displayName": "Joe Smith" + }, + "application": null + }, + "publishedBy": { + "user": { + "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c", + "displayName": "Joe Smith" + }, + "application": null + } +} +``` |
v1.0 | Browsersitelist Update | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/browsersitelist-update.md | + + Title: "Update browserSiteList" +description: "Update the properties of a browserSiteList object." ++ms.localizationpriority: medium +++# Update browserSiteList +Namespace: microsoft.graph +++Update the properties of a [browserSiteList](../resources/browsersitelist.md) object. ++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|BrowserSiteLists.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|BrowserSiteLists.ReadWrite.All| ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /admin/edge/internetExplorerMode/siteLists/{browserSiteListId} +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +++|Property|Type|Description| +|:|:|:| +|description|String|Description for the site list.| +|displayName|String|Display name of this site list.| ++++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request +The following is an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "update_browsersitelist", + "sampleKeys": ["36ba61eb-c492-4283-a38b-963a1dbb2f69"] +} +--> +``` http +PATCH https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/36ba61eb-c492-4283-a38b-963a1dbb2f69 +Content-Type: application/json +Content-length: 283 ++{ + "displayName": "Production Site List A", + "description": "Production site list for team A" +} +``` ++# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PHP](#tab/php) ++++++### Response +The following is an example of the response. +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Call Addlargegalleryview | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/call-addlargegalleryview.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Add the large gallery view to a call. +Add the large gallery view to a call. ++For details about how to identify a large gallery view participant in a roster so that you can retrieve the relevant data to subscribe to the video feed, see [Identify large gallery view participants in a roster](https://learn.microsoft.com/en-us/graph/cloud-communications-identifylargegalleryview). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Channel Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-get.md | GET https://graph.microsoft.com/beta/teams/893075dd-2487-4122-925f-022c42e20265/ [!INCLUDE [sample-code](../includes/snippets/go/get-channel-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [PHP](#tab/php) [!INCLUDE [sample-code](../includes/snippets/php/get-channel-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Channel List | 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 Sendactivitynotification | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-sendactivitynotification.md | The following table shows the parameters that can be used with this action. |chainId|Int64|Optional. Used to override a previous notification. Use the same `chainId` in subsequent requests to override the previous notification.| |previewText|[itemBody](../resources/itembody.md)|Preview text for the notification. Microsoft Teams will only show first 150 characters.| |templateParameters|[keyValuePair](../resources/keyvaluepair.md) collection|Values for template variables defined in the activity feed entry corresponding to `activityType` in [Teams app manifest](/microsoftteams/platform/overview).|-|recipient|[teamworkNotificationRecipient](../resources/teamworknotificationrecipient.md)|Recipient of the notification. See also [aadUserNotificationRecipient](../resources/aadusernotificationrecipient.md) and [chatMembersNotificationRecipient](../resources/chatmembersnotificationrecipient.md). | +|recipient|[teamworkNotificationRecipient](../resources/teamworknotificationrecipient.md)|Recipient of the notification. For more details, see [aadUserNotificationRecipient](../resources/aadusernotificationrecipient.md) and [chatMembersNotificationRecipient](../resources/chatmembersnotificationrecipient.md). | The following resources are supported when setting the `source` value of the **topic** property to `entityURL`: HTTP/1.1 204 No Content ### Example 5: Notify the chat members about a task created in a chat -The following example shows how you can send an activity feed notification to all chat members. This example is similar to previous examples. However, in this case, the `recipient` is a [chatMembersNotificationRecipient](../resources/chatmembersnotificationrecipient.md). Note that the `chatId` specified in the `recipient` must match the `chatId` specified in the request URL. +The following example shows how you can send an activity feed notification to all chat members. This example is similar to previous examples. However, in this case, the **recipient** is a [chatMembersNotificationRecipient](../resources/chatmembersnotificationrecipient.md). Note that the **chatId** specified in the **recipient** must match the **chatId** specified in the request URL. #### Request The following example shows the request. # [HTTP](#tab/http) <!-- { "blockType": "request",- "name": "chat_sendactivitynotification_4", + "name": "chat_sendactivitynotification_5", "sampleKeys": ["19:1c3af46e9e0f4a5293343c8813c47619@thread.v2"] } --> Content-Type: application/json ``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Chat Unhideforuser | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-unhideforuser.md | Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/javascript/chat-unhideforuser-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] -# [Java](#tab/java) - # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/chat-unhideforuser-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Chatmessage 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`.) +> **Notes:** +> * The **temporaryId** in the **hostedContents** collection is a random ID, but must be same across the **content** (in **attachments**) and **hostedContents** elements. (Notice the **temporaryId** set to `1` and the reference in content as `../hostedContents/1/$value`.). +> * The maximum possible size of hosted content is 4 MB. -**contentBytes** must be set to binary string Base64-encoded bytes. You can do this in C# by using `Convert.ToBase64String(File.ReadAllBytes("image.png"));` +**contentBytes** must be set to binary string Base64-encoded bytes. You can do this in C# by using `Convert.ToBase64String(File.ReadAllBytes("image.png"));`. # [HTTP](#tab/http) Content-type: application/json #### Response +The following is an example of the response. + <!-- { "blockType": "response", "truncated": true, Content-type: application/json } ``` -### 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 | Cloudpconpremisesconnection Delete | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpconpremisesconnection-delete.md | Delete a specific [cloudPcOnPremisesConnection](../resources/cloudpconpremisesco When you delete an Azure network connection, permissions to the service are removed from the specified Azure resources. -You cannot delete an Azure network connection when it's in use, as indicated by the `inUse` property. +You cannot delete an Azure network connection when it's in use, as indicated by the **inUse** property. ## Permissions If successful, this method returns a `204 No Content` response code. ### Request +The following is an example of a request. # [HTTP](#tab/http) <!-- { DELETE https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/onPremi ### Response +The following is an example of the response. + <!-- { "blockType": "response", "truncated": true |
v1.0 | Cloudpcreports Getdailyaggregatedremoteconnectionreports | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcreports-getdailyaggregatedremoteconnectionreports.md | If successful, this action returns a `200 OK` response code and a Stream in the ### Request The following is an example of a request.++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "cloudpcreportsthis.getdailyaggregatedremoteconnectionreports" Content-length: 199 } ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PowerShell](#tab/powershell) ++# [PHP](#tab/php) ++++ ### Response The following is an example of the response |
v1.0 | Cloudpcreports Getrealtimeremoteconnectionlatency | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcreports-getrealtimeremoteconnectionlatency.md | If successful, this function returns a `200 OK` response code and a Stream in th ### Request The following is an example of a request.++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "cloudpcreportsthis.getrealtimeremoteconnectionlatency" The following is an example of a request. GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/reports/getRealTimeRemoteConnectionLatency(cloudPcId='f5ff445f-7488-40f8-8ab9-ee784a9fffff') ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++++ ### Response The following is an example of the response |
v1.0 | Cloudpcreports Getrealtimeremoteconnectionstatus | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcreports-getrealtimeremoteconnectionstatus.md | If successful, this function returns a `200 OK` response code and a Stream in th ### Request The following is an example of a request.++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "cloudpcreportsthis.getrealtimeremoteconnectionstatus" The following is an example of a request. GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/reports/getRealTimeRemoteConnectionStatus(cloudPcId='f5ff445f-7488-40f8-8ab9-ee784a9fffff') ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++++ ### Response The following is an example of the response |
v1.0 | Cloudpcreports Getremoteconnectionhistoricalreports | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcreports-getremoteconnectionhistoricalreports.md | If successful, this action returns a `200 OK` response code and a Stream in the ### Request The following is an example of a request.++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "cloudpcreportsthis.getremoteconnectionhistoricalreports" Content-length: 199 } ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PowerShell](#tab/powershell) ++# [PHP](#tab/php) ++++ ### Response The following is an example of the response |
v1.0 | Cloudpcreports Gettotalaggregatedremoteconnectionreports | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcreports-gettotalaggregatedremoteconnectionreports.md | If successful, this action returns a `200 OK` response code and a Stream in the ### Request The following is an example of a request.++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "cloudpcreportsthis.gettotalaggregatedremoteconnectionreports" Content-length: 199 } ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PowerShell](#tab/powershell) ++# [PHP](#tab/php) ++++ ### Response The following is an example of the response |
v1.0 | Cloudpcreports Post Exportjobs | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcreports-post-exportjobs.md | If successful, this method returns a `201 Created` response code and a [cloudPcE ### Request The following is an example of a request.++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "create_cloudpcexportjob_from_" Content-length: 315 } ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PowerShell](#tab/powershell) ++# [PHP](#tab/php) ++++ ### Response The following is an example of the response |
v1.0 | Conditionalaccessroot List Templates | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/conditionalaccessroot-list-templates.md | If successful, this method returns a `200 OK` response code and a collection of #### Request The following is an example of a request.++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "list_conditionalaccesstemplate" The following is an example of a request. GET https://graph.microsoft.com/beta/identity/conditionalAccess/templates ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PowerShell](#tab/powershell) ++# [PHP](#tab/php) ++++ #### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability. Content-Type: application/json #### Request The following is an example of a request.++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "list_conditionalaccesstemplate_select" The following is an example of a request. GET https://graph.microsoft.com/beta/identity/conditionalAccess/templates?$select=name,description,id,scenarios&$filter=scenarios has 'secureFoundation' ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PowerShell](#tab/powershell) ++# [PHP](#tab/php) ++++ #### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability. Content-Type: application/json } ] }-``` +``` |
v1.0 | Conditionalaccesstemplate Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/conditionalaccesstemplate-get.md | If successful, this method returns a `200 OK` response code and a [conditionalAc #### Request The following is an example of a request.++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_conditionalaccesstemplate" The following is an example of a request. GET https://graph.microsoft.com/beta/identity/conditionalAccess/templates/c7503427-338e-4c5e-902d-abe252abfb43 ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PowerShell](#tab/powershell) ++# [PHP](#tab/php) ++++ #### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability. Content-Type: application/json #### Request The following is an example of a request.++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_conditionalaccesstemplate_select" The following is an example of a request. GET https://graph.microsoft.com/beta/identity/conditionalAccess/templates/c7503427-338e-4c5e-902d-abe252abfb43?$select=details ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PowerShell](#tab/powershell) ++# [PHP](#tab/php) ++++ #### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability. Content-Type: application/json } } }-``` +``` |
v1.0 | Devicemanagement Alertrecord Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrecord-get.md | If successful, this method returns a `200 OK` response code and an [microsoft.gr The following is an example of a request. ++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_alertrecord" The following is an example of a request. GET https://graph.microsoft.com/beta/deviceManagement/monitoring/alertRecords/6c46a7ba-e78a-45e5-a81c-179ab8fd3e8e ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PHP](#tab/php) ++++ ### Response The following is an example of the response. |
v1.0 | Devicemanagement Alertrecord Getportalnotifications | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrecord-getportalnotifications.md | If successful, this function returns a `200 OK` response code and a collection o The following is an example of a request. ++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "alertrecordthis.getportalnotifications" The following is an example of a request. GET https://graph.microsoft.com/beta/deviceManagement/monitoring/alertRecords/getPortalNotifications ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PowerShell](#tab/powershell) ++# [PHP](#tab/php) ++++ ### Response The following is an example of the response. |
v1.0 | Devicemanagement Alertrecord List | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrecord-list.md | If successful, this method returns a `200 OK` response code and a collection of The following is an example of a request. ++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "list_alertrecord" The following is an example of a request. GET https://graph.microsoft.com/beta/deviceManagement/monitoring/alertRecords ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PHP](#tab/php) ++++ ### Response The following is an example of the response. |
v1.0 | Devicemanagement Alertrecord Setportalnotificationassent | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrecord-setportalnotificationassent.md | If successful, this action returns a `204 No Content` response code. The following is an example of a request. ++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "alertrecordthis.setportalnotificationassent" The following is an example of a request. POST https://graph.microsoft.com/beta/deviceManagement/monitoring/alertRecords/6c46a7ba-e78a-45e5-a81c-179ab8fd3e8e/setPortalNotificationAsSent ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PowerShell](#tab/powershell) ++# [PHP](#tab/php) ++++ ### Response The following is an example of the response. |
v1.0 | Devicemanagement Alertrule Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrule-get.md | If successful, this method returns a `200 OK` response code and an [microsoft.gr The following is an example of a request. ++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_alertrule" The following is an example of a request. GET https://graph.microsoft.com/beta/deviceManagement/monitoring/alertRules/30070507-6514-443b-8fa5-06979cedacdf ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PHP](#tab/php) ++++ ### Response The following is an example of the response. |
v1.0 | Devicemanagement Alertrule List | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrule-list.md | If successful, this method returns a `200 OK` response code and a collection of The following is an example of a request. ++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "list_alertrule" The following is an example of a request. GET https://graph.microsoft.com/beta/deviceManagement/monitoring/alertRules ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PHP](#tab/php) ++++ ### Response The following is an example of the response. |
v1.0 | Devicemanagement Alertrule Post | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrule-post.md | If successful, this method returns a `201 Created` response code and an [microso The following is an example of a request. ++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "post_alertrule" Content-Type: application/json } ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PHP](#tab/php) ++++ ### Response The following is an example of the response. |
v1.0 | Devicemanagement Alertrule Update | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrule-update.md | If successful, this method returns a `200 OK` response code and an updated [micr The following is an example of a request. ++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "update_alertrule" Content-Type: application/json } ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PHP](#tab/php) ++++ ### Response The following is an example of the response. |
v1.0 | Directory Deleteditems Delete | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/directory-deleteditems-delete.md | Namespace: microsoft.graph Permanently delete a recently deleted [application](../resources/application.md), [group](../resources/group.md), [servicePrincipal](../resources/serviceprincipal.md), or [user](../resources/user.md) object from [deleted items](../resources/directory.md). After an item is permanently deleted, it **cannot** be restored. +Administrative units **cannot** be permanently deleted by using the **deletedItems** API. Soft-deleted administrative units will be permanently deleted 30 days after initial deletion unless they are restored. + ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Directory Deleteditems Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/directory-deleteditems-get.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Retrieve the properties of a recently deleted [application](../resources/application.md), [group](../resources/group.md), [servicePrincipal](../resources/serviceprincipal.md), or [user](../resources/user.md) object from [deleted items](../resources/directory.md). +Retrieve the properties of a recently deleted [application](../resources/application.md), [group](../resources/group.md), [servicePrincipal](../resources/serviceprincipal.md), [administrative unit](../resources/administrativeunit.md), or [user](../resources/user.md) object from [deleted items](../resources/directory.md). >**Note:** Deleted security groups are deleted permanently and can't be retrieved through this API. One of the following permissions is required to call this API. To learn more, in |Delegated (personal Microsoft account) | Not supported. | |Application | Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | +### For administrative units: ++|Permission type | Permissions (from least to most privileged) | +|:--|:| +|Delegated (work or school account) | AdministrativeUnit.Read.All, AdministrativeUnit.ReadWrite.All | +|Delegated (personal Microsoft account) | Not supported. | +|Application | AdministrativeUnit.Read.All, AdministrativeUnit.ReadWrite.All | + ## HTTP request <!-- { "blockType": "ignored" } --> ```http |
v1.0 | Directory Deleteditems List | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/directory-deleteditems-list.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Retrieve a list of recently deleted directory objects. Currently, deleted items functionality is only supported for the [application](../resources/application.md), [servicePrincipal](../resources/serviceprincipal.md), [group](../resources/group.md), and [user](../resources/user.md) resources. +Retrieve a list of recently deleted directory objects. Currently, deleted items functionality is only supported for the [application](../resources/application.md), [servicePrincipal](../resources/serviceprincipal.md), [group](../resources/group.md), [administrative unit](../resources/administrativeunit.md), and [user](../resources/user.md) resources. >**Note:** Deleted security groups are deleted permanently and can't be retrieved through this API. One of the following permissions is required to call this API. To learn more, in |Delegated (personal Microsoft account) | Not supported. | |Application | Group.Read.All, Group.ReadWrite.All, Directory.Read.All | +### For administrative units: ++|Permission type | Permissions (from least to most privileged) | +|:--|:| +|Delegated (work or school account) | AdministrativeUnit.Read.All, AdministrativeUnit.ReadWrite.All | +|Delegated (personal Microsoft account) | Not supported. | +|Application | AdministrativeUnit.Read.All, AdministrativeUnit.ReadWrite.All | + ## HTTP request <!-- { "blockType": "ignored" } --> ```http GET /directory/deleteditems/microsoft.graph.application GET /directory/deleteditems/microsoft.graph.servicePrincipal GET /directory/deleteditems/microsoft.graph.group GET /directory/deletedItems/microsoft.graph.user+GET /directory/deletedItems/microsoft.graph.administrativeUnit ``` -This API currently supports retrieving object types of applications (`microsoft.graph.application`), servicePrincipals (`microsoft.graph.serviceprincipal`), groups (`microsoft.graph.group`), or users (`microsoft.graph.user`) from deleted items. The OData cast type is a required part of the URI and calling `GET /directory/deleteditems` without a type is **not** supported. +The OData cast type is a required part of the URI and calling `GET /directory/deleteditems` without a type is **not** supported. ## Optional query parameters |
v1.0 | Directory Deleteditems Restore | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/directory-deleteditems-restore.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Restore a recently deleted [application](../resources/application.md), [group](../resources/group.md), [servicePrincipal](../resources/serviceprincipal.md), or [user](../resources/user.md) object from [deleted items](../resources/directory.md). If an item was accidentally deleted, you can fully restore the item. This is not applicable to security groups, which are deleted permanently. +Restore a recently deleted [application](../resources/application.md), [group](../resources/group.md), [servicePrincipal](../resources/serviceprincipal.md), [administrative unit](../resources/administrativeunit.md), or [user](../resources/user.md) object from [deleted items](../resources/directory.md). If an item was accidentally deleted, you can fully restore the item. This is not applicable to security groups, which are deleted permanently. A recently deleted item will remain available for up to 30 days. After 30 days, the item is permanently deleted. The calling app must be assigned one of the following [Azure AD roles](/azure/ac |Delegated (personal Microsoft account) | Not supported. | |Application | Group.ReadWrite.All | +### For administrative units: ++|Permission type | Permissions (from least to most privileged) | +|:--|:| +|Delegated (work or school account) | AdministrativeUnit.ReadWrite.All | +|Delegated (personal Microsoft account) | Not supported. | +|Application | AdministrativeUnit.ReadWrite.All | + ## HTTP request <!-- { "blockType": "ignored" } --> ```http |
v1.0 | Driveitem Createuploadsession | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/driveitem-createuploadsession.md | Alternatively, you can defer final creation of the file in the destination until POST /drives/{driveId}/items/{itemId}/createUploadSession POST /groups/{groupId}/drive/items/{itemId}/createUploadSession POST /me/drive/items/{itemId}/createUploadSession+POST /me/drive/items/{itemId}:/{fileName}:/createUploadSession POST /sites/{siteId}/drive/items/{itemId}/createUploadSession POST /users/{userId}/drive/items/{itemId}/createUploadSession ``` |
v1.0 | Ediscovery Legalhold Update | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/ediscovery-legalhold-update.md | In the request body, supply the values for relevant fields that should be update |Property|Type|Description| |:|:|:|-|contentQuery|String|KQL query that specifies content to be held in the specified locations. For more information about KQL in eDiscovery, see [Keyword queries and search conditions for Content Search and eDiscovery](/microsoft-365/compliance/keyword-queries-and-search-conditions). To hold all content in the specified locations, leave **contentQuery** blank. | |description|String| The legal hold description. | |displayName|String| The display name of the legal hold. | |isEnabled|Boolean|Indicates whether the hold is enabled and actively holding content. | |
v1.0 | Educationassignment List Submissions | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignment-list-submissions.md | The following is an example of the request. # [HTTP](#tab/http) <!-- { "blockType": "request",- "sampleKeys": ["f4a941ff-9da6-4707-ba5b-0eae93cad0b4","3c77de7f-539b-49e1-9c96-1274f2f0ee3b"], + "sampleKeys": ["2003c52e-807a-4186-9b49-60c573095461","2be08d97-b140-4eec-8cbd-88238d571060"], "name": "get_submissions" }--> ```msgraph-interactive-GET https://graph.microsoft.com/beta/education/classes/f4a941ff-9da6-4707-ba5b-0eae93cad0b4/assignments/3c77de7f-539b-49e1-9c96-1274f2f0ee3b/submissions +GET https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions ``` # [C#](#tab/csharp) Content-type: application/json Content-length: 873 {+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions", "value": [ {- "status": "working", + "status": "returned", "submittedDateTime": null, "unsubmittedDateTime": null,- "returnedDateTime": null, - "resourcesFolderUrl": "https://graph.microsoft.com/beta/drives/b!DPA6q59Tw0mtgmyXRUmrQRqBZTesG-lMkl1cBmvvMeUEWrOk89nKRpUEr4ZhNYBc/items/016XPCQEDJCE5LX4OXABF37QSORAK5WKQD", - "id": "4af73d2b-6b9c-493f-0688-979087bed39b", + "returnedDateTime": "2022-04-13T05:11:50.756165Z", + "reassignedDateTime": null, + "resourcesFolderUrl": null, + "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D", + "id": "d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a", "recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226" + "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a" }, "submittedBy": { "application": null, "device": null, "user": {- "id": "80cefd93-8d88-40e2-b5d3-67898383e226", + "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a", "displayName": null } }, Content-length: 873 } }, "returnedBy": {+ "application": null, + "device": null, + "user": { + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", + "displayName": null + } + }, + "reassignedBy": { "application": null, "device": null, "user": { The following is an example of the request. "name": "get_submissions_expand" }--> ```msgraph-interactive-GET https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/efcdf80b-a5de-42ac-8579-e40b0223d48b/submissions?$expand=outcomes +GET https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions?$expand=outcomes ``` # [C#](#tab/csharp) Content-type: application/json Content-length: 4492 {- "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('72a7baec-c3e9-4213-a850-f62de0adad5f')/assignments('efcdf80b-a5de-42ac-8579-e40b0223d48b')/submissions(outcomes())", + "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions(outcomes())", "value": [ { "status": "returned", "submittedDateTime": null, "unsubmittedDateTime": null,- "returnedDateTime": "2021-10-13T15:57:00.0349869Z", + "returnedDateTime": "2022-04-13T05:11:50.756165Z", "reassignedDateTime": null, "resourcesFolderUrl": null,- "id": "9bc724ee-d314-1ec5-725d-5f81228e85a6", + "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D", + "id": "d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a", "recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226" + "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a" }, "submittedBy": { "application": null, "device": null, "user": {- "id": "80cefd93-8d88-40e2-b5d3-67898383e226", + "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a", "displayName": null } }, Content-length: 4492 "application": null, "device": null, "user": {- "id": "f3a5344e-dbde-48b0-be24-b5b62a243836", + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", "displayName": null } }, Content-length: 4492 "displayName": null } },+ "outcomes@odata.context": "https://canary.graph.microsoft.com/testprodbetaeduasg_local_submissions-deeplink/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions('d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a')/outcomes", "outcomes": [ { "@odata.type": "#microsoft.graph.educationFeedbackOutcome", Content-length: 4492 "lastModifiedBy": null, "points": null, "publishedPoints": null- }, - { - "@odata.type": "#microsoft.graph.educationRubricOutcome", - "lastModifiedDateTime": "2021-10-13T15:57:00.0076092Z", - "id": "65a46d78-1a2b-4a7e-bcf8-78a22ac2611b", - "lastModifiedBy": { - "application": null, - "device": null, - "user": { - "id": null, - "displayName": null - } - }, - "rubricQualityFeedback": [ - { - "qualityId": "f4c7b781-4c0c-4113-a5fb-c0885b7ab510", - "feedback": null - } - ], - "rubricQualitySelectedLevels": [ - { - "qualityId": "f4c7b781-4c0c-4113-a5fb-c0885b7ab510", - "columnId": "ef99fe68-b6f8-4f67-a13b-9a81c1724788" - } - ], - "publishedRubricQualityFeedback": [ - { - "qualityId": "f4c7b781-4c0c-4113-a5fb-c0885b7ab510", - "feedback": null - } - ], - "publishedRubricQualitySelectedLevels": [ - { - "qualityId": "f4c7b781-4c0c-4113-a5fb-c0885b7ab510", - "columnId": "ef99fe68-b6f8-4f67-a13b-9a81c1724788" - } - ] } ] } The following is an example of the request. "name": "get_submissions_prefer" }--> ```msgraph-interactive-GET https://graph.microsoft.com/beta/education/classes/59069eb2-2a09-4d90-bb19-2089cc69d613/assignments/80da1069-a635-4913-813f-d775a5470a8f/submissions +GET https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions Prefer: include-unknown-enum-members ``` Content-type: application/json Content-length: 4492 {- "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('59069eb2-2a09-4d90-bb19-2089cc69d613')/assignments('80da1069-a635-4913-813f-d775a5470a8f')/submissions", + "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions", "value": [ {- "status": "working", + "status": "returned", "submittedDateTime": null, "unsubmittedDateTime": null,- "returnedDateTime": null, + "returnedDateTime": "2022-04-13T05:11:50.756165Z", "reassignedDateTime": null, "resourcesFolderUrl": null,- "id": "f51a6687-a4a3-a8d9-ac4a-6ff81c5a8da7", + "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D", + "id": "d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a", "recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",- "userId": "0ca0dd79-57eb-4903-97dc-88c769dd2a3d" + "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a" }, "submittedBy": { "application": null, "device": null, "user": {- "id": "0ca0dd79-57eb-4903-97dc-88c769dd2a3d", + "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a", "displayName": null } }, Content-length: 4492 "application": null, "device": null, "user": {- "id": null, + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", "displayName": null } }, Content-length: 4492 }, { "status": "reassigned",- "submittedDateTime": "2021-11-10T00:57:17.0495233Z", + "submittedDateTime": "2022-04-13T05:10:00.4660243Z", "unsubmittedDateTime": null,- "returnedDateTime": null, - "reassignedDateTime": "2021-11-10T01:03:25.7812455Z", + "returnedDateTime": "2022-04-13T05:12:14.6531582Z", + "reassignedDateTime": null, "resourcesFolderUrl": null,- "id": "869369de-3e5a-89eb-6f2d-83cd88f860b5", + "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22efbecaf4-6956-4a76-6e10-b901e4de91c5%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D", + "id": "efbecaf4-6956-4a76-6e10-b901e4de91c5", "recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",- "userId": "723e2402-f503-4825-a4d5-5143fbe6f53d" + "userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1" }, "submittedBy": { "application": null, "device": null, "user": {- "id": "723e2402-f503-4825-a4d5-5143fbe6f53d", + "id": "51cf5a99-d234-4e43-96de-cd65df14bfa1", "displayName": null } }, Content-length: 4492 "application": null, "device": null, "user": {- "id": null, + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", "displayName": null } }, Content-length: 4492 "application": null, "device": null, "user": {- "id": "afc58f1f-7c9e-4770-a448-e53ba43463a5", + "id": null, "displayName": null } } |
v1.0 | Educationassignment Setupfeedbackresourcesfolder | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignment-setupfeedbackresourcesfolder.md | Content-type: application/json ### Response+ The following is an example of the response. +>**Note:** The response object shown here might be shortened for readability. + <!-- { "blockType": "response", "truncated": true, |
v1.0 | Educationfeedbackresourceoutcome Delete | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationfeedbackresourceoutcome-delete.md | Title: "Delete educationFeedbackResourceOutcome" -description: "Delete a feedback resource from a submission. This can only be done by a teacher." +description: "Delete a feedback resource from a submission." ms.localizationpriority: medium ms.prod: "education" DELETE /education/classes/{classId}/assignments/{assignmentId}/submissions/{subm | Authorization | Bearer {token}. Required. | ## Request body-Don't supply a request body for this method. +Do not supply a request body for this method. ## Response If successful, this method returns a `204 No Content` response code. It does not return anything in the response body. |
v1.0 | Educationfeedbackresourceoutcome Post Outcomes | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationfeedbackresourceoutcome-post-outcomes.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Create a new [feedback resource](../resources/educationfeedbackresourceoutcome.md) for a submission. --Only a teacher can perform this operation. +Create a new [feedback resource](../resources/educationfeedbackresourceoutcome.md) for a submission. Only a teacher can perform this operation. To create a new file-based resource, upload the file to the feedback resources folder associated with the assignment. If the file doesn't exist or is not in that folder, the `POST` request will fail. Content-type: application/json } } }- ``` +## See also ++To upload an existing file, see [Upload feedback files for education submissions](/graph/education-upload-feedback-resource-overview). + <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2022-05-06 14:57:30 UTC --> <!-- |
v1.0 | Educationrubric Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationrubric-get.md | The following is an example of the request. GET https://graph.microsoft.com/beta/education/me/rubrics/bf040af7-a5ff-4abe-a8c8-1bdc532344c2 ``` -## Optional query parameters --This method supports the `$select` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). - # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-educationrubric-csharp-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Educationsubmission Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-get.md | The following is an example of the request. "name": "get_educationsubmission" }--> ```msgraph-interactive-GET https://graph.microsoft.com/beta/education/classes/59069eb2-2a09-4d90-bb19-2089cc69d613/assignments/80da1069-a635-4913-813f-d775a5470a8f/submissions/869369de-3e5a-89eb-6f2d-83cd88f860b5 +GET https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions/d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a ``` # [C#](#tab/csharp) Content-type: application/json Content-length: 712 {- "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('59069eb2-2a09-4d90-bb19-2089cc69d613')/assignments('80da1069-a635-4913-813f-d775a5470a8f')/submissions/$entity", + "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions/$entity", "status": "returned",- "submittedDateTime": "2021-11-10T00:57:17.0495233Z", + "submittedDateTime": null, "unsubmittedDateTime": null,- "returnedDateTime": "2021-11-10T01:03:25.7812455Z", - "reassignedDateTime": "2021-11-10T01:03:25.7812455Z", + "returnedDateTime": "2022-04-13T05:11:50.756165Z", + "reassignedDateTime": null, "resourcesFolderUrl": null,- "id": "869369de-3e5a-89eb-6f2d-83cd88f860b5", + "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D", + "id": "d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a", "recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",- "userId": "723e2402-f503-4825-a4d5-5143fbe6f53d" + "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a" }, "submittedBy": { "application": null, "device": null, "user": {- "id": "723e2402-f503-4825-a4d5-5143fbe6f53d", + "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a", "displayName": null } }, Content-length: 712 "application": null, "device": null, "user": {- "id": "afc58f1f-7c9e-4770-a448-e53ba43463a5", + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", "displayName": null } }, Content-length: 712 "application": null, "device": null, "user": {- "id": "afc58f1f-7c9e-4770-a448-e53ba43463a5", + "id": null, "displayName": null } } The following is an example of the request. "name": "get_educationsubmission_prefer" }--> ```msgraph-interactive-GET https://graph.microsoft.com/beta/education/classes/59069eb2-2a09-4d90-bb19-2089cc69d613/assignments/80da1069-a635-4913-813f-d775a5470a8f/submissions/869369de-3e5a-89eb-6f2d-83cd88f860b5 +GET https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions/efbecaf4-6956-4a76-6e10-b901e4de91c5 Prefer: include-unknown-enum-members ``` Content-type: application/json Content-length: 712 {- "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('59069eb2-2a09-4d90-bb19-2089cc69d613')/assignments('80da1069-a635-4913-813f-d775a5470a8f')/submissions/$entity", + "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('2003c52e-807a-4186-9b49-60c573095461')/assignments('2be08d97-b140-4eec-8cbd-88238d571060')/submissions/$entity", "status": "reassigned",- "submittedDateTime": "2021-11-10T00:57:17.0495233Z", + "submittedDateTime": "2022-04-13T05:10:00.4660243Z", "unsubmittedDateTime": null,- "returnedDateTime": null, - "reassignedDateTime": "2021-11-10T01:03:25.7812455Z", + "returnedDateTime": "2022-04-13T05:12:14.6531582Z", + "reassignedDateTime": "2022-04-13T05:12:14.6531582Z", "resourcesFolderUrl": null,- "id": "869369de-3e5a-89eb-6f2d-83cd88f860b5", + "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22efbecaf4-6956-4a76-6e10-b901e4de91c5%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D", + "id": "efbecaf4-6956-4a76-6e10-b901e4de91c5", "recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",- "userId": "723e2402-f503-4825-a4d5-5143fbe6f53d" + "userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1" }, "submittedBy": { "application": null, "device": null, "user": {- "id": "723e2402-f503-4825-a4d5-5143fbe6f53d", + "id": "51cf5a99-d234-4e43-96de-cd65df14bfa1", "displayName": null } }, Content-length: 712 "application": null, "device": null, "user": {- "id": null, + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", "displayName": null } }, Content-length: 712 "application": null, "device": null, "user": {- "id": "afc58f1f-7c9e-4770-a448-e53ba43463a5", + "id": null, "displayName": null } } The following is an example of the request. "name": "get_submission_expand" }--> ```msgraph-interactive-GET https://graph.microsoft.com/beta/education/classes/59069eb2-2a09-4d90-bb19-2089cc69d613/assignments/80da1069-a635-4913-813f-d775a5470a8f/submissions/869369de-3e5a-89eb-6f2d-83cd88f860b5?$expand=* +GET https://graph.microsoft.com/beta/education/classes/a86a5c30-0437-49d6-9c6b-b1ce0d8d5574/assignments/95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f/submissions/e1a0240e-f3af-f039-63e7-09c3cbf8d176?$expand=* ``` # [C#](#tab/csharp) Content-type: application/json Content-length: 4492 {- "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('59069eb2-2a09-4d90-bb19-2089cc69d613')/assignments('80da1069-a635-4913-813f-d775a5470a8f')/submissions(outcomes(),resources(),submittedResources())/$entity", + "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('a86a5c30-0437-49d6-9c6b-b1ce0d8d5574')/assignments('95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f')/submissions(outcomes(),resources(),submittedResources())/$entity", "status": "returned",- "submittedDateTime": "2021-11-10T00:57:17.0495233Z", + "submittedDateTime": "2022-10-24T21:03:53.3664034Z", "unsubmittedDateTime": null,- "returnedDateTime": "2021-11-10T01:03:25.7812455Z", - "reassignedDateTime": "2021-11-10T01:03:25.7812455Z", + "returnedDateTime": "2022-10-24T21:04:42.7101616Z", + "reassignedDateTime": null, "resourcesFolderUrl": null,- "id": "869369de-3e5a-89eb-6f2d-83cd88f860b5", + "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%22a86a5c30-0437-49d6-9c6b-b1ce0d8d5574%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%2295da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22e1a0240e-f3af-f039-63e7-09c3cbf8d176%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D", + "id": "e1a0240e-f3af-f039-63e7-09c3cbf8d176", "recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",- "userId": "723e2402-f503-4825-a4d5-5143fbe6f53d" + "userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1" }, "submittedBy": { "application": null, "device": null, "user": {- "id": "723e2402-f503-4825-a4d5-5143fbe6f53d", + "id": "51cf5a99-d234-4e43-96de-cd65df14bfa1", "displayName": null } }, Content-length: 4492 "application": null, "device": null, "user": {- "id": "afc58f1f-7c9e-4770-a448-e53ba43463a5", + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", "displayName": null } }, Content-length: 4492 "application": null, "device": null, "user": {- "id": "afc58f1f-7c9e-4770-a448-e53ba43463a5", + "id": null, "displayName": null } },+ "outcomes@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('a86a5c30-0437-49d6-9c6b-b1ce0d8d5574')/assignments('95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f')/submissions('e1a0240e-f3af-f039-63e7-09c3cbf8d176')/outcomes", "outcomes": [ { "@odata.type": "#microsoft.graph.educationFeedbackOutcome",- "lastModifiedDateTime": null, + "lastModifiedDateTime": "2022-10-24T21:04:42.3073523Z", "id": "ca05367a-b292-42d5-aff7-5d279feeace8",- "lastModifiedBy": null, - "feedback": null, - "publishedFeedback": null + "lastModifiedBy": { + "application": null, + "device": null, + "user": { + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", + "displayName": null + } + }, + "feedback": { + "feedbackDateTime": "2022-10-24T21:04:42.3073523Z", + "text": { + "content": "New feedback!", + "contentType": "text" + }, + "feedbackBy": { + "application": null, + "device": null, + "user": { + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", + "displayName": null + } + } + }, + "publishedFeedback": { + "feedbackDateTime": "2022-10-24T21:04:25.2783852Z", + "text": { + "content": "Feedback", + "contentType": "text" + }, + "feedbackBy": { + "application": null, + "device": null, + "user": { + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", + "displayName": null + } + } + } }, { "@odata.type": "#microsoft.graph.educationPointsOutcome",- "lastModifiedDateTime": null, + "lastModifiedDateTime": "2022-10-24T21:04:42.7101541Z", "id": "ea1351f6-ba33-4940-b2cb-6a7254af2dc8",- "lastModifiedBy": null, - "points": null, - "publishedPoints": null + "lastModifiedBy": { + "application": null, + "device": null, + "user": { + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", + "displayName": null + } + }, + "points": { + "gradedDateTime": "2022-10-24T21:04:42.7101541Z", + "points": 456, + "gradedBy": { + "application": null, + "device": null, + "user": { + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", + "displayName": null + } + } + }, + "publishedPoints": { + "gradedDateTime": "2022-10-24T21:04:25.6308301Z", + "points": 123, + "gradedBy": { + "application": null, + "device": null, + "user": { + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", + "displayName": null + } + } + } }, { "@odata.type": "#microsoft.graph.educationRubricOutcome",- "lastModifiedDateTime": "2021-11-10T01:03:25.7712076Z", + "lastModifiedDateTime": "2022-10-24T21:04:26.5833776Z", "id": "65a46d78-1a2b-4a7e-bcf8-78a22ac2611b", "lastModifiedBy": { "application": null, Content-length: 4492 }, "rubricQualityFeedback": [ {- "qualityId": "a660004a-608d-4cd2-a6dc-4f43812444ee", + "qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c", "feedback": null }, {- "qualityId": "2c5ae75d-d347-426b-be2c-cfc81a6f0b32", - "feedback": null + "qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b", + "feedback": { + "content": "Needs improvement", + "contentType": "text" + } }, {- "qualityId": "32fdea06-5cbb-4881-9093-96e59f59b8b8", - "feedback": null - }, - { - "qualityId": "66137bd8-b9c2-40e1-a360-40b7ee75eaef", + "qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de", "feedback": null } ], "rubricQualitySelectedLevels": [ {- "qualityId": "a660004a-608d-4cd2-a6dc-4f43812444ee", + "qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c", "columnId": null }, {- "qualityId": "2c5ae75d-d347-426b-be2c-cfc81a6f0b32", - "columnId": null + "qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b", + "columnId": "0f9823a2-174c-4ce0-8f12-e298c291f29b" }, {- "qualityId": "32fdea06-5cbb-4881-9093-96e59f59b8b8", - "columnId": null - }, - { - "qualityId": "66137bd8-b9c2-40e1-a360-40b7ee75eaef", + "qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de", "columnId": null } ], "publishedRubricQualityFeedback": [ {- "qualityId": "a660004a-608d-4cd2-a6dc-4f43812444ee", - "feedback": null - }, - { - "qualityId": "2c5ae75d-d347-426b-be2c-cfc81a6f0b32", + "qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c", "feedback": null }, {- "qualityId": "32fdea06-5cbb-4881-9093-96e59f59b8b8", - "feedback": null + "qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b", + "feedback": { + "content": "Needs improvement", + "contentType": "text" + } }, {- "qualityId": "66137bd8-b9c2-40e1-a360-40b7ee75eaef", + "qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de", "feedback": null } ], "publishedRubricQualitySelectedLevels": [ {- "qualityId": "a660004a-608d-4cd2-a6dc-4f43812444ee", + "qualityId": "050f420d-ef93-46fe-a7c0-bf8b24769f5c", "columnId": null }, {- "qualityId": "2c5ae75d-d347-426b-be2c-cfc81a6f0b32", - "columnId": null - }, - { - "qualityId": "32fdea06-5cbb-4881-9093-96e59f59b8b8", - "columnId": null + "qualityId": "9bd9fda3-e013-44a5-b373-dfec8b4da80b", + "columnId": "0f9823a2-174c-4ce0-8f12-e298c291f29b" }, {- "qualityId": "66137bd8-b9c2-40e1-a360-40b7ee75eaef", + "qualityId": "c5e07099-4e18-47de-9e71-27504d4e71de", "columnId": null } ] } ],+ "resources@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('a86a5c30-0437-49d6-9c6b-b1ce0d8d5574')/assignments('95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f')/submissions('e1a0240e-f3af-f039-63e7-09c3cbf8d176')/resources", "resources": [],+ "submittedResources@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('a86a5c30-0437-49d6-9c6b-b1ce0d8d5574')/assignments('95da4fd3-2f3a-48d2-a1ea-08eb16e2ae9f')/submissions('e1a0240e-f3af-f039-63e7-09c3cbf8d176')/submittedResources", "submittedResources": [] } ``` |
v1.0 | Educationsubmission List Outcomes | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-list-outcomes.md | Title: "List outcomes" -description: "Retrieve a list of educationoutcome objects." +description: "Retrieve a list of educationOutcome objects." ms.localizationpriority: medium ms.prod: "education" A submission for a points assignment (one that has a point value assigned) will A submission for an assignment with an attached rubric, if the rubric is a credit rubric (no points), will have an [educationFeedbackOutcome](../resources/educationpointsoutcome.md) and an [educationRubricOutcome](../resources/educationrubricoutcome.md). (It might also return an [educationPointsOutcome](../resources/educationpointsoutcome.md), but that outcome is ignored.) -A submission for an assignment with an attached rubric, if the rubric is a points rubric, will have an [educationFeedbackOutcome](../resources/educationpointsoutcome.md), an [educationPointsOutcome](../resources/educationpointsoutcome.md, and an [educationRubricOutcome](../resources/educationrubricoutcome.md). +A submission for an assignment with an attached rubric, if the rubric is a points rubric, will have an [educationFeedbackOutcome](../resources/educationpointsoutcome.md), an [educationPointsOutcome](../resources/educationpointsoutcome.md), and an [educationRubricOutcome](../resources/educationrubricoutcome.md). A submission for a feedback resource will have an [educationFeedbackResourceOutcome](../resources/educationfeedbackresourceoutcome.md). -All outcome types have a regular and a published property appropriate to that type of outcome; for example, **points** and **publishedPoints**, **feedback** and **publishedFeedback**. The regular property is the most recent value updated by the teacher; the published property is the most recent value returned to the student. +All outcome types have a regular and a published property appropriate to that type of outcome; for example, **points** and **publishedPoints**, **feedback** and **publishedFeedback**. The regular property is the most recent value updated by the teacher; the published property is the most recent value returned to the student. ## Permissions One of the following permissions is required to call this API. To learn more, in <!-- { "blockType": "ignored" } --> ```http-GET /education/classes/{id}/assignments/{id}/submissions/{id}/outcomes +GET /education/classes/{classId}/assignments/{assignmentId}/submissions/{submissionId}/outcomes ``` ## Optional query parameters |
v1.0 | Educationsubmission Reassign | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-reassign.md | The following is an example of the request. }--> ```http-POST /education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/7192332b-e904-4891-81e2-356242ab1858/submissions/02bb5de1-7205-2a25-fe33-f99cf53de1c4/reassign +POST https://graph.microsoft.com/beta/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/assignments/db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a/submissions/4bca096a-7de3-8675-5e86-2fa149923860/reassign ``` # [C#](#tab/csharp) HTTP/1.1 200 OK "@odata.context": "https://graph.microsoft.com/beta/$metadata#educationSubmission", "@odata.type": "#microsoft.graph.educationSubmission", "status": "returned",- "submittedDateTime": "2021-09-07T14:54:46.1606962Z", - "unsubmittedDateTime": "2021-09-07T14:41:18.9512645Z", - "returnedDateTime": "2021-09-07T21:38:40.5254847Z", - "reassignedDateTime": "2021-09-07T21:38:40.5254847Z", + "submittedDateTime": "2022-10-19T23:32:49.3314767Z", + "unsubmittedDateTime": null, + "returnedDateTime": "2022-10-19T23:32:58.1079737Z", + "reassignedDateTime": "2022-10-19T23:32:58.1079737Z", "resourcesFolderUrl": null,- "id": "02bb5de1-7205-2a25-fe33-f99cf53de1c4", + "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%22bf1f1963-05f6-4cba-903c-5892b4ce3bd7%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%22db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%224bca096a-7de3-8675-5e86-2fa149923860%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D", + "id": "4bca096a-7de3-8675-5e86-2fa149923860", "recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226" + "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a" }, "submittedBy": { "application": null, "device": null, "user": {- "id": "80cefd93-8d88-40e2-b5d3-67898383e226", + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", "displayName": null } }, HTTP/1.1 200 OK "application": null, "device": null, "user": {- "id": "80cefd93-8d88-40e2-b5d3-67898383e226", + "id": null, "displayName": null } }, HTTP/1.1 200 OK "application": null, "device": null, "user": {- "id": "f3a5344e-dbde-48b0-be24-b5b62a243836", + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", "displayName": null } }, HTTP/1.1 200 OK "application": null, "device": null, "user": {- "id": "f3a5344e-dbde-48b0-be24-b5b62a243836", + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", "displayName": null } } The following is an example of the request. }--> ```http-POST /education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/7192332b-e904-4891-81e2-356242ab1858/submissions/02bb5de1-7205-2a25-fe33-f99cf53de1c4/reassign +POST https://graph.microsoft.com/beta/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/assignments/db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a/submissions/b9dab587-5fcc-30ae-f7fa-41a47fb89972/reassign Prefer: include-unknown-enum-members ``` HTTP/1.1 200 OK "@odata.context": "https://graph.microsoft.com/beta/$metadata#educationSubmission", "@odata.type": "#microsoft.graph.educationSubmission", "status": "reassigned",- "submittedDateTime": "2021-09-07T21:44:41.8377109Z", - "unsubmittedDateTime": "2021-09-07T14:41:18.9512645Z", + "submittedDateTime": "2022-10-19T23:34:34.5246354Z", + "unsubmittedDateTime": null, "returnedDateTime": null,- "reassignedDateTime": "2021-09-07T21:45:42.9027726Z", + "reassignedDateTime": "2022-10-19T23:35:07.2786612Z", "resourcesFolderUrl": null,- "id": "02bb5de1-7205-2a25-fe33-f99cf53de1c4", + "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%22bf1f1963-05f6-4cba-903c-5892b4ce3bd7%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%22db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22b9dab587-5fcc-30ae-f7fa-41a47fb89972%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D", + "id": "b9dab587-5fcc-30ae-f7fa-41a47fb89972", "recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226" + "userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1" }, "submittedBy": { "application": null, "device": null, "user": {- "id": "80cefd93-8d88-40e2-b5d3-67898383e226", + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", "displayName": null } }, HTTP/1.1 200 OK "application": null, "device": null, "user": {- "id": "80cefd93-8d88-40e2-b5d3-67898383e226", + "id": null, "displayName": null } }, HTTP/1.1 200 OK "application": null, "device": null, "user": {- "id": "f3a5344e-dbde-48b0-be24-b5b62a243836", + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", "displayName": null } } |
v1.0 | Educationsubmission Return | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-return.md | The following is an example of the request. }--> ```http-POST https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/7192332b-e904-4891-81e2-356242ab1858/submissions/022fb52d-1278-d21f-e827-2221a6a3e516/return +POST https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions/d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a/return ``` # [C#](#tab/csharp) HTTP/1.1 200 Ok "@odata.context": "https://graph.microsoft.com/beta/$metadata#educationSubmission", "@odata.type": "#microsoft.graph.educationSubmission", "status": "returned",- "submittedDateTime": "2021-09-03T18:20:11.2167718Z", + "submittedDateTime": null, "unsubmittedDateTime": null,- "returnedDateTime": "2021-09-03T19:01:45.6526389Z", - "resourcesFolderUrl": "https://graph.microsoft.com/beta/drives/b!OPmUsPgnBUiMIXMxWcj3neC1xck6I5NIsnFxfrLdmXodJYOAkI7rTLhw7ME_e42J/items/01QTY63RKYRQDN3FDQWNA24OCLHBD5C2SH", - "id": "022fb52d-1278-d21f-e827-2221a6a3e516", + "returnedDateTime": "2022-10-19T23:00:30.9243194Z", + "reassignedDateTime": null, + "resourcesFolderUrl": null, + "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D", + "id": "d9c09b6e-a84d-139a-1b9d-0fbb0ab0de4a", "recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226" + "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a" }, "submittedBy": { "application": null, "device": null, "user": {- "id": "80cefd93-8d88-40e2-b5d3-67898383e226", + "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a", "displayName": null } }, HTTP/1.1 200 Ok "application": null, "device": null, "user": {- "id": "f3a5344e-dbde-48b0-be24-b5b62a243836", + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", + "displayName": null + } + }, + "reassignedBy": { + "application": null, + "device": null, + "user": { + "id": null, "displayName": null } } |
v1.0 | Educationsubmission Submit | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-submit.md | The following is an example of the request. }--> ```http-POST https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/7192332b-e904-4891-81e2-356242ab1858/submissions/02bb5de1-7205-2a25-fe33-f99cf53de1c4/submit +POST https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/2be08d97-b140-4eec-8cbd-88238d571060/submissions/efbecaf4-6956-4a76-6e10-b901e4de91c5/submit ``` # [C#](#tab/csharp) HTTP/1.1 200 Ok "@odata.context": "https://graph.microsoft.com/beta/$metadata#educationSubmission", "@odata.type": "#microsoft.graph.educationSubmission", "status": "submitted",- "submittedDateTime": "2021-09-07T14:54:46.1606962Z", - "unsubmittedDateTime": "2021-09-07T14:41:18.9512645Z", - "returnedDateTime": null, + "submittedDateTime": "2022-10-19T23:02:20.4995757Z", + "unsubmittedDateTime": null, + "returnedDateTime": "2022-04-13T05:12:14.6531582Z", + "reassignedDateTime": null, "resourcesFolderUrl": null,- "id": "02bb5de1-7205-2a25-fe33-f99cf53de1c4", + "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%222be08d97-b140-4eec-8cbd-88238d571060%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%22efbecaf4-6956-4a76-6e10-b901e4de91c5%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D", + "id": "efbecaf4-6956-4a76-6e10-b901e4de91c5", "recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226" + "userId": "51cf5a99-d234-4e43-96de-cd65df14bfa1" }, "submittedBy": { "application": null, "device": null, "user": {- "id": "80cefd93-8d88-40e2-b5d3-67898383e226", + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", "displayName": null } }, HTTP/1.1 200 Ok "application": null, "device": null, "user": {- "id": "80cefd93-8d88-40e2-b5d3-67898383e226", + "id": null, "displayName": null } }, "returnedBy": {+ "application": null, + "device": null, + "user": { + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", + "displayName": null + } + }, + "reassignedBy": { "application": null, "device": null, "user": { |
v1.0 | Educationsubmission Unsubmit | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-unsubmit.md | The following is an example of the request. }--> ```http-POST https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/7192332b-e904-4891-81e2-356242ab1858/submissions/02bb5de1-7205-2a25-fe33-f99cf53de1c4/unsubmit +POST https://graph.microsoft.com/beta/education/classes/2003c52e-807a-4186-9b49-60c573095461/assignments/7242e03e-048c-437b-8810-3e89b285a362/submissions/3cea5cf6-55dc-d6c7-2f5b-3b5cd2e79c3a/unsubmit ``` # [C#](#tab/csharp) HTTP/1.1 200 Ok "@odata.type": "#microsoft.graph.educationSubmission", "status": "returned", "submittedDateTime": null,- "unsubmittedDateTime": "2021-09-07T14:41:18.9512645Z", - "returnedDateTime": null, + "unsubmittedDateTime": "2022-10-19T23:14:41.2934772Z", + "returnedDateTime": "2022-04-13T02:09:15.7223872Z", + "reassignedDateTime": null, "resourcesFolderUrl": null,- "id": "02bb5de1-7205-2a25-fe33-f99cf53de1c4", + "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%222003c52e-807a-4186-9b49-60c573095461%5C%22,%5C%22displayName%5C%22%3Anull,%5C%22assignmentIds%5C%22%3A%5B%5C%227242e03e-048c-437b-8810-3e89b285a362%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%223cea5cf6-55dc-d6c7-2f5b-3b5cd2e79c3a%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22%7D%22,%22channelId%22%3Anull%7D", + "id": "3cea5cf6-55dc-d6c7-2f5b-3b5cd2e79c3a", "recipient": { "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",- "userId": "80cefd93-8d88-40e2-b5d3-67898383e226" + "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a" }, "submittedBy": { "application": null, "device": null, "user": {- "id": "80cefd93-8d88-40e2-b5d3-67898383e226", + "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a", "displayName": null } }, HTTP/1.1 200 Ok "application": null, "device": null, "user": {- "id": "80cefd93-8d88-40e2-b5d3-67898383e226", + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", "displayName": null } }, "returnedBy": {+ "application": null, + "device": null, + "user": { + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", + "displayName": null + } + }, + "reassignedBy": { "application": null, "device": null, "user": { |
v1.0 | Educationsynchronizationprofile Post | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsynchronizationprofile-post.md | Title: "Create an educationSynchronizationProfile" -description: "Create a request for a new school data synchronization profile in the tenant. Query the status to get the status of the profile. " +description: "Create a request for a new school data synchronization profile in the tenant." ms.localizationpriority: medium ms.prod: "education" POST /education/synchronizationProfiles In the request body, supply a JSON representation of the [educationSynchronizationProfile](../resources/educationsynchronizationprofile.md) object. ## Response-If successful, this method returns a `202, Accepted` response code and an [educationSynchronizationProfile](../resources/educationsynchronizationprofile.md) object in the response body. +If successful, this method returns a `202 Accepted` response code and an [educationSynchronizationProfile](../resources/educationsynchronizationprofile.md) object in the response body. ## Example-##### Request +### Request The following is an example of the request. <!-- { "blockType": "ignored", Content-type: application/json { "displayName": "Test Profile", "dataProvider": {- "@odata.type": "#Microsoft.Education.DataSync.educationCsvDataProvider", + "@odata.type": "#microsoft.graph.educationCsvDataProvider", "customizations": { "student": { "optionalPropertiesToSync": [ Content-type: application/json } }, "identitySynchronizationConfiguration": {- "@odata.type": "#Microsoft.Education.DataSync.educationIdentityCreationConfiguration", + "@odata.type": "#microsoft.graph.educationIdentityCreationConfiguration", "userDomains": [ { "appliesTo": "student", Content-type: application/json } ``` -##### Response +### Response The following is an example of the response. >**Note:** The response object shown here might be shortened for readability. |
v1.0 | Emailauthenticationmethodconfiguration Delete | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/emailauthenticationmethodconfiguration-delete.md | One of the following permissions is required to call this API. To learn more, in |:|:| |Delegated (work or school account)|Policy.ReadWrite.AuthenticationMethod| |Delegated (personal Microsoft account)|Not supported.|-|Application|Not supported.| +|Application|Policy.ReadWrite.AuthenticationMethod| For delegated scenarios, the administrator needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles): |
v1.0 | Emailauthenticationmethodconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/emailauthenticationmethodconfiguration-get.md | One of the following permissions is required to call this API. To learn more, in |Permission type|Permissions (from least to most privileged)| |:|:|-|Delegated (work or school account)|Policy.ReadWrite.AuthenticationMethod| +|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.AuthenticationMethod| |Delegated (personal Microsoft account)|Not supported.|-|Application|Not supported.| +|Application|Policy.Read.All, Policy.ReadWrite.AuthenticationMethod| For delegated scenarios, the administrator needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles): |
v1.0 | Emailauthenticationmethodconfiguration Update | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/emailauthenticationmethodconfiguration-update.md | One of the following permissions is required to call this API. To learn more, in |:|:| |Delegated (work or school account)|Policy.ReadWrite.AuthenticationMethod| |Delegated (personal Microsoft account)|Not supported.|-|Application|Not supported.| +|Application|Policy.ReadWrite.AuthenticationMethod| For delegated scenarios, the administrator needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles): |
v1.0 | Fido2authenticationmethodconfiguration Delete | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/fido2authenticationmethodconfiguration-delete.md | One of the following permissions is required to call this API. To learn more, in |:|:| |Delegated (work or school account)|Policy.ReadWrite.AuthenticationMethod| |Delegated (personal Microsoft account)|Not supported.|-|Application|Not supported.| +|Application|Policy.ReadWrite.AuthenticationMethod| For delegated scenarios, the administrator needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles): |
v1.0 | Fido2authenticationmethodconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/fido2authenticationmethodconfiguration-get.md | One of the following permissions is required to call this API. To learn more, in |Permission type|Permissions (from least to most privileged)| |:|:|-|Delegated (work or school account)|Policy.ReadWrite.AuthenticationMethod| +|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.AuthenticationMethod| |Delegated (personal Microsoft account)|Not supported.|-|Application|Not supported.| +|Application|Policy.Read.All, Policy.ReadWrite.AuthenticationMethod| For delegated scenarios, the administrator needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles): |
v1.0 | Fido2authenticationmethodconfiguration Update | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/fido2authenticationmethodconfiguration-update.md | One of the following permissions is required to call this API. To learn more, in |:|:| |Delegated (work or school account)|Policy.ReadWrite.AuthenticationMethod| |Delegated (personal Microsoft account)|Not supported.|-|Application|Not supported.| +|Application|Policy.ReadWrite.AuthenticationMethod| For delegated scenarios, the administrator needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles): |
v1.0 | Group List Transitivememberof | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/group-list-transitivememberof.md | One of the following permissions is required to call this API. To learn more, in | Permission type | Permissions (from least to most privileged) | | :- | : |-| Delegated (work or school account) | Directory.Read.All, Directory.ReadWrite.All | +| Delegated (work or school account) | GroupMember.Read.All, Group.Read.All, Directory.Read.All, Directory.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported. | | Application | Directory.Read.All, Directory.ReadWrite.All | |
v1.0 | Group List Transitivemembers | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/group-list-transitivemembers.md | GET /groups/{id}/transitiveMembers This method supports the [OData query parameters](/graph/query-parameters) to help customize the response, including `$search`, `$count`, and `$filter`. You can use `$search` on the **displayName** and **description** properties. When items are added or updated for this resource, they are specially indexed for use with the `$count` and `$search` query parameters. There can be a slight delay between when an item is added or updated and when it is available in the index. +This API returns up to 100 member objects by default. The maximum page size that you can request through the `$top` query parameter is 999 objects. + To filter the results on the OData type, such as `microsoft.graph.user` or `microsoft.graph.group`, you must use the [advanced query parameters](/graph/aad-advanced-queries). That is, the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string. ## Request headers |
v1.0 | Group List | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/group-list.md | GET /groups ## Optional query parameters -This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$search`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. The default and maximum page sizes are 100 and 999 group objects respectively. Some queries are supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). +This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$search`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. `$skip` isn't supported. The default and maximum page sizes are 100 and 999 group objects respectively. Some queries are supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). To list only Microsoft 365 groups (aka unified groups), apply a filter on **groupTypes**: ConsistencyLevel: eventual [!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 | Group Post Approleassignments | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/group-post-approleassignments.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Use this API to assign an app role to a group. All direct members of the group will be considered assigned. To grant an app role assignment to a group, you need three identifiers: +Use this API to assign an app role to a security group. All direct members of the group will be considered assigned. Security groups with dynamic memberships are supported. To grant an app role assignment to a group, you need three identifiers: - **principalId**: The ID of the **group** to which you are assigning the app role. - **resourceId**: The ID of the resource **servicePrincipal** that has defined the app role. |
v1.0 | Identitygovernance Deleteditemcontainer Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-deleteditemcontainer-get.md | Content-Type: application/json The following is an example of a request. ++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "lifecycleworkflows_get_deleteditemcontainer_select" The following is an example of a request. GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/deletedItems/workflows/952b23c5-cc25-48c9-8848-95da4dd9dc6d?$select=id,category,displayName,description,version,executionConditions ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PowerShell](#tab/powershell) ++# [PHP](#tab/php) ++++ #### Response The following is an example of the response Content-Type: application/json "tasks@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/deletedItems/workflows('952b23c5-cc25-48c9-8848-95da4dd9dc6d')/tasks", "tasks": [] }-``` +``` |
v1.0 | Identitygovernance Lifecycleworkflowscontainer List Deleteditems | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-lifecycleworkflowscontainer-list-deleteditems.md | Content-Type: application/json The following is an example of a request. ++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "lifecycleworkflows_list_deleteditemcontainer_select" The following is an example of a request. GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/deletedItems/workflows?$select=id,category,displayName,description,version&$filter=category eq 'leaver' ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PowerShell](#tab/powershell) ++# [PHP](#tab/php) ++++ #### Response The following is an example of the response Content-Type: application/json } ] }-``` +``` |
v1.0 | Identitygovernance Lifecycleworkflowscontainer List Taskdefinitions | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-lifecycleworkflowscontainer-list-taskdefinitions.md | GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/taskD ``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) |
v1.0 | Identitygovernance Run Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-run-get.md | Content-Type: application/json The following is an example of a request. ++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "lifecycleworkflows_get_workflow_run" The following is an example of a request. GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/runs/e65e08a0-d68d-41dc-915b-8c4019af5cc2?$select=id,failedTasksCount,failedUsersCount,processingStatus,totalTasksCount,totalUnprocessedTasksCount,totalUsersCount ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PowerShell](#tab/powershell) ++# [PHP](#tab/php) ++++ #### Response Content-Type: application/json "totalUsersCount": 1, "totalUnprocessedTasksCount": 0 }-``` +``` |
v1.0 | Identitygovernance Run List Taskprocessingresults | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-run-list-taskprocessingresults.md | Content-Type: application/json The following is an example of a request. ++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "lifecycleworkflows_list_run_taskprocessingresult_select" The following is an example of a request. GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/runs/e65e08a0-d68d-41dc-915b-8c4019af5cc2/userProcessingResults/40efc576-840f-47d0-ab95-5abca800f8a2//taskProcessingResults?$select=id,failureReason,processingStatus,subject,task ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PowerShell](#tab/powershell) ++# [PHP](#tab/php) ++++ #### Response The following is an example of the response Content-Type: application/json } ] }-``` +``` |
v1.0 | Identitygovernance Run List Userprocessingresults | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-run-list-userprocessingresults.md | Content-Type: application/json The following is an example of a request. ++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "lifecycleworkflows_get_run_taskprocessingresult_select" The following is an example of a request. GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/runs/e65e08a0-d68d-41dc-915b-8c4019af5cc2/userProcessingResults?$select=id,failedTasksCount,processingStatus,totalTasksCount,totalUnprocessedTasksCount,subject ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PowerShell](#tab/powershell) ++# [PHP](#tab/php) ++++ #### Response The following is an example of the response Content-Type: application/json } ] }-``` +``` |
v1.0 | Identitygovernance Taskreport List Taskprocessingresults | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-taskreport-list-taskprocessingresults.md | Content-Type: application/json The following is an example of a request. ++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "lifecycleworkflows_list_taskreport_taskprocessingresult_select" The following is an example of a request. GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/taskReports/443c7611-45df-48c0-bf5e-dc6068c402f0/taskProcessingResults?$select=id,failureReason,processingStatus,subject,task ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PowerShell](#tab/powershell) ++# [PHP](#tab/php) ++++ #### Response The following is an example of the response Content-Type: application/json } ] }-``` +``` |
v1.0 | Identitygovernance Userprocessingresult Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-userprocessingresult-get.md | Content-Type: application/json The following is an example of a request. ++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "lifecycleworkflows_get_run_userprocessingresult" The following is an example of a request. GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/runs/e65e08a0-d68d-41dc-915b-8c4019af5cc2/userProcessingResults/40efc576-840f-47d0-ab95-5abca800f8a2?$select=id,failedTasksCount,processingStatus,totalTasksCount,totalUnprocessedTasksCount,subject ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PowerShell](#tab/powershell) ++# [PHP](#tab/php) ++++ #### Response The following is an example of the response |
v1.0 | Identitygovernance Userprocessingresult List Taskprocessingresults | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-userprocessingresult-list-taskprocessingresults.md | Content-Type: application/json The following is an example of a request. ++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "lifecycleworkflows_list_workflow_userprocessingresult_taskprocessingresult_select" The following is an example of a request. GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/userProcessingResults/40efc576-840f-47d0-ab95-5abca800f8a2/taskProcessingResults?$select=id,processingStatus,failureReason,subject,task ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PowerShell](#tab/powershell) ++# [PHP](#tab/php) ++++ #### Response Content-Type: application/json } ] }-``` +``` |
v1.0 | Identitygovernance Userprocessingresult Summary | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-userprocessingresult-summary.md | The following is an example of the response <!-- { "blockType": "response", "truncated": true,- "@odata.type": "microsoft.graph.identityGovernance.usersProcessingSummary" + "@odata.type": "microsoft.graph.identityGovernance.userSummary" } --> ``` http |
v1.0 | Identitygovernance Workflow List Runs | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-workflow-list-runs.md | Content-Type: application/json The following is an example of a request. ++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "lifecycleworkflows_list_run_select" The following is an example of a request. GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/runs?$select=id,failedTasksCount,failedUsersCount,processingStatus,totalTasksCount,totalUnprocessedTasksCount,totalUsersCount,id ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PowerShell](#tab/powershell) ++# [PHP](#tab/php) ++++ #### Response The following is an example of the response Content-Type: application/json } ] }-``` +``` |
v1.0 | Identitygovernance Workflow List Taskreports | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-workflow-list-taskreports.md | Content-Type: application/json The following is an example of a request. ++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "lifecycleworkflows_list_taskreport_select" The following is an example of a request. GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/taskReports?$select=id,failedUsersCount,processingStatus,successfulUsersCount,totalUsersCount,unprocessedUsersCount,taskDefinition,taskProcessingResults ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PowerShell](#tab/powershell) ++# [PHP](#tab/php) ++++ #### Response The following is an example of the response Content-Type: application/json } ] }-``` +``` |
v1.0 | Identitygovernance Workflow List Userprocessingresults | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-workflow-list-userprocessingresults.md | Content-Type: application/json The following is an example of a request. ++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "lifecycleworkflows_list_userprocessingresult_select" The following is an example of a request. GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/156ce798-1eb6-4e0a-8515-e79f54d04390/userProcessingResults?$select=id,failedTasksCount,processingStatus,totalTasksCount,totalUnprocessedTasksCount,workflowExecutionType,subject ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PowerShell](#tab/powershell) ++# [PHP](#tab/php) ++++ #### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability. Content-Type: application/json } ] }-``` +``` |
v1.0 | Identitygovernance Workflow List Versions | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-workflow-list-versions.md | Content-Type: application/json The following is an example of a request. ++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "lifecycleworkflows_list_workflowversion_select" The following is an example of a request. GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/versions?$select=category,displayName,versionNumber ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PowerShell](#tab/powershell) ++# [PHP](#tab/php) ++++ #### Response <!-- { Content-Type: application/json } ] }-``` +``` |
v1.0 | Identitygovernance Workflowversion Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-workflowversion-get.md | Content-Type: application/json The following is an example of a request. ++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "lifecycleworkflows_get_workflowversion_select" The following is an example of a request. GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/versions/2?$select=category,displayName,versionNumber,executionConditions&$expand=tasks ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PowerShell](#tab/powershell) ++# [PHP](#tab/php) ++++ #### Response <!-- { "blockType": "response", Content-Type: application/json } ] }-``` +``` |
v1.0 | Internetexplorermode Delete Sitelists | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/internetexplorermode-delete-sitelists.md | + + Title: "Delete browserSiteList" +description: "Delete a browserSiteList object." ++ms.localizationpriority: medium +++# Delete browserSiteList +Namespace: microsoft.graph +++Delete a [browserSiteList](../resources/browsersitelist.md) object. ++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|BrowserSiteLists.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|BrowserSiteLists.ReadWrite.All| ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +DELETE /admin/edge/internetExplorerMode/siteLists/{browserSiteListId} +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Do not supply a request body for this method. ++## Response ++If successful, this method returns a `204 No Content` response code. ++## Examples ++### Request +The following is an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "delete_browsersitelist", + "sampleKeys": ["36ba61eb-c492-4283-a38b-963a1dbb2f69"] +} +--> +``` http +DELETE https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists/36ba61eb-c492-4283-a38b-963a1dbb2f69 +``` ++# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PHP](#tab/php) ++++++### Response +The following is an example of the response. +<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Internetexplorermode List Sitelists | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/internetexplorermode-list-sitelists.md | + + Title: "List browserSiteLists" +description: "Get a list of the browserSiteList objects and their properties." ++ms.localizationpriority: medium +++# List browserSiteLists +Namespace: microsoft.graph +++Get a list of the [browserSiteList](../resources/browsersitelist.md) objects and their properties. ++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|BrowserSiteLists.Read.All, BrowserSiteLists.ReadWrite.All| ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /admin/edge/internetExplorerMode/siteLists +``` ++## Optional query parameters +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Do not supply a request body for this method. ++## Response ++If successful, this method returns a `200 OK` response code and a collection of [browserSiteList](../resources/browsersitelist.md) objects in the response body. ++## Examples ++### Request +The following is an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "list_browsersitelist" +} +--> +``` http +GET https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists +``` ++# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PHP](#tab/php) ++++++### Response +The following is an example of the response +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.browserSiteList", + "isCollection": true +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "@odata.type": "#microsoft.graph.browserSiteList", + "id": "e370d818-f650-5ab1-499e-5915e83f4573", + "description": "Production site list for devices", + "lastModifiedBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Joe Smith" + }, + "application": null + }, + "lastModifiedDateTime": "2016-03-21T20:01:37Z", + "displayName": "Production Site List A", + "publishedBy": { + "user": { + "id": "efee1b77-fb3b-4f65-99d6-274c11914d12", + "displayName": "Joe Smith" + }, + "application": null + }, + "publishedDateTime": "2016-03-21T20:01:37Z", + "status": "published", + "revision": "1.0" + } + ] +} +``` + |
v1.0 | Internetexplorermode Post Sitelists | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/internetexplorermode-post-sitelists.md | + + Title: "Create browserSiteList" +description: "Create a new browserSiteList object to support Internet Explorer mode." ++ms.localizationpriority: medium +++# Create browserSiteList +Namespace: microsoft.graph +++Create a new [browserSiteList](../resources/browsersitelist.md) object to support [Internet Explorer mode](/deployedge/edge-ie-mode). ++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|BrowserSiteLists.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|BrowserSiteLists.ReadWrite.All| ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /admin/edge/internetExplorerMode/siteLists +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| ++## Request body +In the request body, supply a JSON representation of the [browserSiteList](../resources/browsersitelist.md) object. ++You can specify the following properties when you create a **browserSiteList**. ++|Property|Type|Description| +|:|:|:| +|description|String|Description for the site list. Required.| +|displayName|String|Display name of the site list. Required.| +++## Response ++If successful, this method returns a `201 Created` response code and a [browserSiteList](../resources/browsersitelist.md) object in the response body. ++## Examples ++### Request +The following is an example of a request. ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "create_browsersitelist_from_" +} +--> +``` http +POST https://graph.microsoft.com/beta/admin/edge/internetExplorerMode/siteLists +Content-Type: application/json +Content-length: 283 ++{ + "displayName": "Production Site List A", + "description": "Production site list for team A" +} +``` ++# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PHP](#tab/php) ++++++### Response +The following is an example of the response. +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.browserSiteList" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.browserSiteList", + "id": "36ba61eb-c492-4283-a38b-963a1dbb2f69", + "revision": "", + "displayName": "Production Site List A", + "description": "Production site list for team A", + "lastModifiedDateTime": "2022-06-28T18:05:05.9569126Z", + "publishedDateTime": null, + "status": "draft", + "lastModifiedBy": { + "user": { + "id": "f6ff107e-bc40-4918-a432-8d7b60030a7c", + "displayName": "Joe Smith" + }, + "application": null + }, + "publishedBy": null +} +``` + |
v1.0 | Intune Apps Ioslobapp Create | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-ioslobapp-create.md | The following table shows the properties that are required when you create the i |expirationDateTime|DateTimeOffset|The expiration time.| |versionNumber|String|The version number of iOS Line of Business (LoB) app.| |buildNumber|String|The build number of iOS Line of Business (LoB) app.|-|identityVersion|String|The identity version.| +|identityVersion|String|The identity version. This property is being deprecated in 2211(November 2022)| |
v1.0 | Intune Apps Ioslobapp Update | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-ioslobapp-update.md | The following table shows the properties that are required when you create the [ |expirationDateTime|DateTimeOffset|The expiration time.| |versionNumber|String|The version number of iOS Line of Business (LoB) app.| |buildNumber|String|The build number of iOS Line of Business (LoB) app.|-|identityVersion|String|The identity version.| +|identityVersion|String|The identity version. This property is being deprecated in 2211(November 2022)| |
v1.0 | Intune Apps Macoslobapp Create | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macoslobapp-create.md | The following table shows the properties that are required when you create the m |committedContentVersion|String|The internal committed content version. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |fileName|String|The name of the main Lob application file. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |size|Int64|The total size, including all uploaded files. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)|-|bundleId|String|The bundle id.| -|minimumSupportedOperatingSystem|[macOSMinimumOperatingSystem](../resources/intune-apps-macosminimumoperatingsystem.md)|The value for the minimum applicable operating system.| -|buildNumber|String|The build number of MacOS Line of Business (LoB) app.| -|versionNumber|String|The version number of MacOS Line of Business (LoB) app.| -|childApps|[macOSLobChildApp](../resources/intune-apps-macoslobchildapp.md) collection|The app list in this bundle package| -|identityVersion|String|The identity version.| -|md5HashChunkSize|Int32|The chunk size for MD5 hash| -|md5Hash|String collection|The MD5 hash codes| -|ignoreVersionDetection|Boolean|A boolean to control whether the app's version will be used to detect the app after it is installed on a device. Set this to true for macOS Line of Business (LoB) apps that use a self update feature.| -|installAsManaged|Boolean|A boolean to control whether the app will be installed as managed (requires macOS 11.0 and other PKG restrictions).| +|bundleId|String|The primary bundleId of the package.| +|minimumSupportedOperatingSystem|[macOSMinimumOperatingSystem](../resources/intune-apps-macosminimumoperatingsystem.md)|ComplexType macOSMinimumOperatingSystem that indicates the minimum operating system applicable for the application.| +|buildNumber|String|The build number of the package. This should match the package CFBundleShortVersionString of the .pkg file.| +|versionNumber|String|The version number of the package. This should match the package CFBundleVersion in the packageinfo file.| +|childApps|[macOSLobChildApp](../resources/intune-apps-macoslobchildapp.md) collection|List of ComplexType macOSLobChildApp objects. Represents the apps expected to be installed by the package.| +|identityVersion|String|The identity version. This property is being deprecated in 2211(November 2022).| +|md5HashChunkSize|Int32|The chunk size for MD5 hash. This is '0' or empty if the package was uploaded directly. If the Intune App Wrapping Tool is used to create a .intunemac, this value can be found inside the Detection.xml file.| +|md5Hash|String collection|The MD5 hash codes. This is empty if the package was uploaded directly. If the Intune App Wrapping Tool is used to create a .intunemac, this value can be found inside the Detection.xml file.| +|ignoreVersionDetection|Boolean|When TRUE, indicates that the app's version will NOT be used to detect if the app is installed on a device. When FALSE, indicates that the app's version will be used to detect if the app is installed on a device. Set this to true for apps that use a self update feature.| +|installAsManaged|Boolean|When TRUE, indicates that the app will be installed as managed (requires macOS 11.0 and other managed package restrictions). When FALSE, indicates that the app will be installed as unmanaged.| |
v1.0 | Intune Apps Macoslobapp Update | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macoslobapp-update.md | The following table shows the properties that are required when you create the [ |committedContentVersion|String|The internal committed content version. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |fileName|String|The name of the main Lob application file. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)| |size|Int64|The total size, including all uploaded files. Inherited from [mobileLobApp](../resources/intune-apps-mobilelobapp.md)|-|bundleId|String|The bundle id.| -|minimumSupportedOperatingSystem|[macOSMinimumOperatingSystem](../resources/intune-apps-macosminimumoperatingsystem.md)|The value for the minimum applicable operating system.| -|buildNumber|String|The build number of MacOS Line of Business (LoB) app.| -|versionNumber|String|The version number of MacOS Line of Business (LoB) app.| -|childApps|[macOSLobChildApp](../resources/intune-apps-macoslobchildapp.md) collection|The app list in this bundle package| -|identityVersion|String|The identity version.| -|md5HashChunkSize|Int32|The chunk size for MD5 hash| -|md5Hash|String collection|The MD5 hash codes| -|ignoreVersionDetection|Boolean|A boolean to control whether the app's version will be used to detect the app after it is installed on a device. Set this to true for macOS Line of Business (LoB) apps that use a self update feature.| -|installAsManaged|Boolean|A boolean to control whether the app will be installed as managed (requires macOS 11.0 and other PKG restrictions).| +|bundleId|String|The primary bundleId of the package.| +|minimumSupportedOperatingSystem|[macOSMinimumOperatingSystem](../resources/intune-apps-macosminimumoperatingsystem.md)|ComplexType macOSMinimumOperatingSystem that indicates the minimum operating system applicable for the application.| +|buildNumber|String|The build number of the package. This should match the package CFBundleShortVersionString of the .pkg file.| +|versionNumber|String|The version number of the package. This should match the package CFBundleVersion in the packageinfo file.| +|childApps|[macOSLobChildApp](../resources/intune-apps-macoslobchildapp.md) collection|List of ComplexType macOSLobChildApp objects. Represents the apps expected to be installed by the package.| +|identityVersion|String|The identity version. This property is being deprecated in 2211(November 2022).| +|md5HashChunkSize|Int32|The chunk size for MD5 hash. This is '0' or empty if the package was uploaded directly. If the Intune App Wrapping Tool is used to create a .intunemac, this value can be found inside the Detection.xml file.| +|md5Hash|String collection|The MD5 hash codes. This is empty if the package was uploaded directly. If the Intune App Wrapping Tool is used to create a .intunemac, this value can be found inside the Detection.xml file.| +|ignoreVersionDetection|Boolean|When TRUE, indicates that the app's version will NOT be used to detect if the app is installed on a device. When FALSE, indicates that the app's version will be used to detect if the app is installed on a device. Set this to true for apps that use a self update feature.| +|installAsManaged|Boolean|When TRUE, indicates that the app will be installed as managed (requires macOS 11.0 and other managed package restrictions). When FALSE, indicates that the app will be installed as unmanaged.| |
v1.0 | Intune Apps Macosmicrosoftdefenderapp Create | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmicrosoftdefenderapp-create.md | + + Title: "Create macOSMicrosoftDefenderApp" +description: "Create a new macOSMicrosoftDefenderApp object." ++localization_priority: Normal +++# Create macOSMicrosoftDefenderApp ++Namespace: microsoft.graph ++> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. ++> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. ++Create a new [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object. ++## Prerequisites +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|DeviceManagementApps.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|DeviceManagementApps.ReadWrite.All| ++## HTTP Request +<!-- { + "blockType": "ignored" +} +--> +``` http +POST /deviceAppManagement/mobileApps +``` ++## Request headers +|Header|Value| +|:|:| +|Authorization|Bearer <token> 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 <token> 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 <token> 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 <token> 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 <token> 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 <token> 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 <token> 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 <token> 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 <token> 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 <token> 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 <token> 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 <token> 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 <token> 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 <token> 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 <token> 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 <token> 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 <token> 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 <token> 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 | Microsoftauthenticatorauthenticationmethodconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/microsoftauthenticatorauthenticationmethodconfiguration-get.md | One of the following permissions is required to call this API. To learn more, in |Permission type|Permissions (from least to most privileged)| |:|:|-|Delegated (work or school account)|Policy.ReadWrite.AuthenticationMethod| +|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.AuthenticationMethod| |Delegated (personal Microsoft account)|Not supported.|-|Application|Policy.ReadWrite.AuthenticationMethod| +|Application|Policy.Read.All, Policy.ReadWrite.AuthenticationMethod| For delegated scenarios, the administrator needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles): |
v1.0 | Oauth2permissiongrant Delta | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/oauth2permissiongrant-delta.md | One of the following permissions is required to call this API. To learn more, in |:--|:| |Delegated (work or school account) | Directory.Read.All, Directory.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |-|oauth2permissiongrant | Directory.Read.All, DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All | +|Application | Directory.Read.All, DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All | ## HTTP request GET /oauth2PermissionGrants/delta ## Query parameters -Tracking changes incurs a round of one or more **delta** function calls. If you use any query parameter -(other than `$deltatoken` and `$skiptoken`), you must specify -it in the initial **delta** request. Microsoft Graph automatically encodes any specified parameters -into the token portion of the `@odata.nextLink` or `@odata.deltaLink` URL provided in the response. -You only need to specify any query parameters once up front. -In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL from the previous response. That URL already +Tracking changes incurs a round of one or more **delta** function calls. If you use any query parameter +(other than `$deltatoken` and `$skiptoken`), you must specify +it in the initial **delta** request. Microsoft Graph automatically encodes any specified parameters +into the token portion of the `@odata.nextLink` or `@odata.deltaLink` URL provided in the response. +You only need to specify any query parameters once up front. +In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL from the previous response. That URL already includes the encoded parameters. | Query parameter | Type |Description| GET https://graph.microsoft.com/beta/oauth2PermissionGrants/delta ### Response >**Note:** The response object shown here might be shortened for readability.-<!-- { +<!-- { "blockType": "response", "truncated": true, "@odata.type": "microsoft.graph.oAuth2PermissionGrant",- "isCollection": true -} --> + "isCollection": true +} --> ```http HTTP/1.1 200 OK Content-type: application/json |
v1.0 | Onlinemeeting Delete | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/onlinemeeting-delete.md | Delete an [onlineMeeting](../resources/onlinemeeting.md) object. | Permission type | Permissions (from least to most privileged) | | :- | : | | Delegated (work or school account) | OnlineMeetings.ReadWrite |-| Delegated (personal Microsoft account) | Not Supported. | -| Application | OnlineMeetings.ReadWrite.All* | +| Delegated (personal Microsoft account) | Not supported. | +| Application | OnlineMeetings.ReadWrite.All* | To use application permission for this API, tenant administrators must create an [application access policy](/graph/cloud-communication-online-meeting-application-access-policy) and grant it to a user to authorize the app configured in the policy to delete online meetings on behalf of that user (with user ID specified in the request path). ## HTTP request -To delete an onlineMeeting using meeting ID with delegated (`/me`) and app (`/users/{userId}`) permission: +To delete an **onlineMeeting** using the meeting ID with delegated (`/me`) and app (`/users/{userId}`) permission: <!-- { "blockType": "ignored" } --> ```http DELETE https://graph.microsoft.com/beta/me/onlineMeetings/{meetingId} DELETE https://graph.microsoft.com/beta/users/{userId}/onlineMeetings/{meetingId ``` > [!NOTE]-> - `userId` is the object ID of a user in [Azure user management portal](https://portal.azure.com/#blade/Microsoft_AAD_IAM/UsersManagementMenuBlade). For more details, see [application access policy](/graph/cloud-communication-online-meeting-application-access-policy). +> - `userId` is the object ID of a user in [Azure user management portal](https://portal.azure.com/#blade/Microsoft_AAD_IAM/UsersManagementMenuBlade). For more details, see [Configure application access to online meetings](/graph/cloud-communication-online-meeting-application-access-policy). > - `meetingId` is the **id** of an [onlineMeeting](../resources/onlinemeeting.md) object. ## Request headers DELETE https://graph.microsoft.com/beta/me/onlineMeetings/550fae72-d251-43ec-868 ### Response +The following example shows the response. + <!-- { "blockType": "response", "truncated": true |
v1.0 | Organization Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/organization-get.md | Content-type: application/json "country": null, "countryLetterCode": "NL", "createdDateTime": "2021-08-02T10:30:06Z",+ "defaultUsageLocation": "String", "displayName": "Contoso", "isMultipleDataLocationsForServicesEnabled": null, "marketingNotificationEmails": [], |
v1.0 | Organization List | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/organization-list.md | Content-type: application/json "country": null, "countryLetterCode": "NL", "createdDateTime": "2021-08-02T10:30:06Z",+ "defaultUsageLocation": "String", "displayName": "Contoso", "isMultipleDataLocationsForServicesEnabled": null, "marketingNotificationEmails": [], |
v1.0 | Planner Post Buckets | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/planner-post-buckets.md | Title: "Create plannerBucket" -description: "Use this API to create a new **plannerBucket**." +description: "Create a new plannerBucket object." ms.localizationpriority: medium ms.prod: "planner" Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Use this API to create a new **plannerBucket**. +Create a new [plannerBucket](../resources/plannerbucket.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). One of the following permissions is required to call this API. To learn more, in <!-- { "blockType": "ignored" } --> ```http POST /planner/buckets- ``` ## Request headers | Name | Description| POST /planner/buckets | Authorization | Bearer {token}. Required. | ## Request body-In the request body, supply a JSON representation of [plannerBucket](../resources/plannerbucket.md) object. +In the request body, supply a JSON representation of the [plannerBucket](../resources/plannerbucket.md) object. ## Response -If successful, this method returns `201 Created` response code and [plannerBucket](../resources/plannerbucket.md) object in the response body. +If successful, this method returns `201 Created` response code and a [plannerBucket](../resources/plannerbucket.md) object in the response body. This method can return any of the [HTTP status codes](/graph/errors). The most common errors that apps should handle for this method are the 400, 403 and 404 responses. For more information about these errors, see [Common Planner error conditions](../resources/planner-overview.md#common-planner-error-conditions). ## Example-##### Request -Here is an example of the request. +### Request +The following is an example of the request. # [HTTP](#tab/http) <!-- { Content-type: application/json -In the request body, supply a JSON representation of [plannerBucket](../resources/plannerbucket.md) object. -##### Response -Here is an example of the response. Note: The response object shown here might be shortened for readability. +### Response +The following is an example of the response. +>**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", "truncated": true, |
v1.0 | Plannerbucket List Tasks | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/plannerbucket-list-tasks.md | Title: "List tasks" -description: "Retrieve a list of **plannerTask** objects associated to a plannerBucket object." +description: "Retrieve a list of plannerTask objects associated to a plannerBucket object." ms.localizationpriority: medium ms.prod: "planner" Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Retrieve a list of **plannerTask** objects associated to a [plannerBucket](../resources/plannerbucket.md) object. +Retrieve a list of [plannerTask](../resources/plannertask.md) objects associated to a [plannerBucket](../resources/plannerbucket.md) object. + ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). Do not supply a request body for this method. ## Response -If successful, this method returns a `200 OK` response code and collection of [plannerTask](../resources/plannertask.md) objects in the response body. +If successful, this method returns a `200 OK` response code and a collection of [plannerTask](../resources/plannertask.md) objects in the response body. This method can return any of the [HTTP status codes](/graph/errors). The most common errors that apps should handle for this method are the 403 and 404 responses. For more information about these errors, see [Common Planner error conditions](../resources/planner-overview.md#common-planner-error-conditions). ## Example-##### Request -Here is an example of the request. +### Request +The following is an example of the request. # [HTTP](#tab/http) <!-- { GET https://graph.microsoft.com/beta/planner/buckets/gcrYAaAkgU2EQUvpkNNXLGQAGTt -##### Response -Here is an example of the response. Note: The response object shown here might be shortened for readability. +### Response +The following is an example of the response. +>**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", "truncated": true, |
v1.0 | Plannerroster Delete | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/plannerroster-delete.md | If successful, this method returns a `204 No Content` response code. ### Request +The following is an example of a request. + # [HTTP](#tab/http) <!-- { "blockType": "request", DELETE https://graph.microsoft.com/beta/planner/rosters/5ba84f7a-aa11-4a51-a298- ### Response++The following is an example of the response. + <!-- { "blockType": "response", "truncated": true |
v1.0 | Plannertask Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/plannertask-get.md | Title: "Get plannerTask" -description: "Retrieve the properties and relationships of **plannertask** object." +description: "Retrieve the properties and relationships of plannerTask object." ms.localizationpriority: medium ms.prod: "planner" Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Retrieve the properties and relationships of **plannertask** object. +Retrieve the properties and relationships of [plannerTask](../resources/plannertask.md) object. + ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). Do not supply a request body for this method. ## Response -If successful, this method returns a `200 OK` response code and [plannerTask](../resources/plannertask.md) object in the response body. +If successful, this method returns a `200 OK` response code and a [plannerTask](../resources/plannertask.md) object in the response body. This method can return any of the [HTTP status codes](/graph/errors). The most common errors that apps should handle for this method are the 403 and 404 responses. For more information about these errors, see [Common Planner error conditions](../resources/planner-overview.md#common-planner-error-conditions). ## Example-##### Request -Here is an example of the request. +### Request +The following is an example of the request. # [HTTP](#tab/http) <!-- { GET https://graph.microsoft.com/beta/planner/tasks/01gzSlKkIUSUl6DF_EilrmQAKDhh -##### Response -Here is an example of the response. Note: The response object shown here might be shortened for readability. +### Response +The following is an example of the response. +>**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", "truncated": true, |
v1.0 | Presence Setpresence | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/presence-setpresence.md | Similarly, an application can have its own presence session for a user and be ab The following is the precedence for how session states are aggregated, with "A > B" representing A having precedence over B: * User-preferred state > session-level states (user-preferred state overrides session-level states)-* Among session-level states: DoNotDisturb (currently not supported for **setPresence**) > Busy > Available > Away +* Among session-level states: DoNotDisturb > Busy > Available > Away ### Timeout, expiration, and keep alive A presence session may **time out** and **expire**, so the application needs to call this API before the **timeout**, to maintain the state for the session; or before the **expiration**, to keep the session alive. In the request body, provide a JSON object with the following parameters. Supported combinations of `availability` and `activity` are: -| availability | activity | Description | -| :-- | :- | :- | -| Available | Available | Updates the presence session as Available. | -| Busy | InACall | Updates the presence session as Busy, InACall. | -| Busy | InAConferenceCall | Updates the presence session as Busy, InAConferenceCall. | -| Away | Away | Updates the presence session as Away. | +| availability | activity | Description | +| :-- | :- | :-- | +| Available | Available | Updates the presence session as Available. | +| Busy | InACall | Updates the presence session as Busy, InACall. | +| Busy | InAConferenceCall | Updates the presence session as Busy, InAConferenceCall. | +| Away | Away | Updates the presence session as Away. | +| DoNotDisturb | Presenting | Updates the presence session as DoNotDisturb, Presenting. | ## Response If successful, this method returns a `200 OK` response code. |
v1.0 | Print List Recentshares | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/print-list-recentshares.md | If successful, this method returns a `200 OK` response code and a collection of ### Request The following is an example of the request. ++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_recentprintershares" The following is an example of the request. GET https://graph.microsoft.com/beta/me/print/recentPrinterShares ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++++ ### Response The following is an example of the response. >**Note:** The response object shown here might be shortened for readability. |
v1.0 | Rbacapplication List Roleassignmentschedulerequests | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/rbacapplication-list-roleassignmentschedulerequests.md | One of the following permissions is required to call this API. To learn more, in | :- | : | | Delegated (work or school account) | RoleAssignmentSchedule.Read.Directory, RoleManagement.Read.Directory, RoleManagement.Read.All, RoleAssignmentSchedule.ReadWrite.Directory, RoleManagement.ReadWrite.Directory | | Delegated (personal Microsoft account) | Not supported |-| Application | RoleManagement.Read.Directory, RoleManagement.ReadWrite.Directory | +| Application | RoleManagement.ReadWrite.Directory | ## HTTP request |
v1.0 | Rbacapplication List Roleeligibilityschedulerequests | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/rbacapplication-list-roleeligibilityschedulerequests.md | One of the following permissions is required to call this API. To learn more, in |:|:| |Delegated (work or school account)|RoleEligibilitySchedule.Read.Directory, RoleManagement.Read.Directory, RoleManagement.Read.All, RoleEligibilitySchedule.ReadWrite.Directory, RoleManagement.ReadWrite.Directory | |Delegated (personal Microsoft account)|Not supported|-|Application|RoleManagement.Read.Directory, RoleManagement.ReadWrite.Directory | +|Application|RoleManagement.ReadWrite.Directory | ## HTTP request |
v1.0 | Search Bookmark Update | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/search-bookmark-update.md | PATCH /search/bookmarks/{bookmarksId} |Content-Type|application/json. Required.| ## Request body-In the request body, supply a JSON representation of the [bookmark](../resources/search-bookmark.md) object. Supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed. ++ >**Note:** Updates to collection properties will update the entire collection. Any updates to a collection, such as keywords or categories, will replace the collection entirely. |Property|Type|Description| |:|:|:|-|displayName|String|Bookmark name displayed in search results. Inherited from [searchAnswer](../resources/search-searchAnswer.md).| -|description|String|Bookmark description shown on search results page. Inherited from [searchAnswer](../resources/search-searchAnswer.md).| -|webUrl|String|Bookmark URL link. When users click this bookmark in search results, they will go to this URL. Inherited from [searchAnswer](../resources/search-searchAnswer.md).| -|categories|String collection|Categories commonly used to describe this bookmark. For example, IT and HR.| -|availabilityStartDateTime|DateTimeOffset|Timestamp of when the bookmark will start to appear as a search result. Set as `null` for always available.| |availabilityEndDateTime|DateTimeOffset|Timestamp of when the bookmark will stop to appear as a search result. Set as `null` for always available.|+|availabilityStartDateTime|DateTimeOffset|Timestamp of when the bookmark will start to appear as a search result. Set as `null` for always available.| +|categories|String collection|Categories commonly used to describe this bookmark. For example, IT and HR.| +|description|String|Bookmark description shown on search results page. Inherited from [searchAnswer](../resources/search-searchAnswer.md).| +|displayName|String|Bookmark name displayed in search results. Inherited from [searchAnswer](../resources/search-searchAnswer.md).| +|groupIds|String collection|List of security groups able to view this bookmark.| +|keywords|[microsoft.graph.search.answerKeyword](../resources/search-answerKeyword.md)|Keywords that trigger this bookmark to appear in search results.| |languageTags|String collection|List of countries or regions able to view this bookmark.| |platforms|microsoft.graph.devicePlatformType collection|List of devices and operating systems able to view this bookmark. Possible values are: `unknown`, `android`, `androidForWork`, `ios`, `macOS`, `windowsPhone81`, `windowsPhone81AndLater`, `windows10AndLater`, `androidWorkProfile`, `androidASOP`.|-|targetedVariations|[microsoft.graph.search.answerVariant](../resources/search-answerVariant.md) collection|Variations of a bookmark for different countries or devices. Use when you need to show different content to users based on their device, country/region, or both. The date and group settings will apply to all variations.| |powerAppIds|String collection|List of Power Apps associated with this bookmark. If users add existing Power Apps to a bookmark, they can complete tasks, such as to enter vacation time or to report expenses on the search results page.|-|keywords|[microsoft.graph.search.answerKeyword](../resources/search-answerKeyword.md)|Keywords that trigger this bookmark to appear in search results.| |state|microsoft.graph.search.answerState|State of the bookmark. Possible values are: `published`, `draft`, `excluded`, or `unknownFutureValue`.|-|groupIds|String collection|List of security groups able to view this bookmark.| --+|targetedVariations|[microsoft.graph.search.answerVariant](../resources/search-answerVariant.md) collection|Variations of a bookmark for different countries or devices. Use when you need to show different content to users based on their device, country/region, or both. The date and group settings will apply to all variations.| +|webUrl|String|Bookmark URL link. When users click this bookmark in search results, they will go to this URL. Inherited from [searchAnswer](../resources/search-searchAnswer.md).| ## Response If successful, this method returns a `204 No Content` response code. ### Request +The following is an example of a request. + # [HTTP](#tab/http) <!-- { "blockType": "request", Content-Type: application/json { "description": "Book a fancy vacation in Tuscany or browse museums in Florence." }- ``` # [C#](#tab/csharp) Content-Type: application/json ### Response++The following is an example of the response. + <!-- { "blockType": "response", "truncated": true |
v1.0 | Security Alert Post Comments | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-alert-post-comments.md | If successful, this method returns a `200 OK` response code and an updated list ### Request The following is an example of a request. ++# [HTTP](#tab/http) <!-- { "blockType": "request", "sampleKeys": ["da637865765418431569_-773071023"], Content-Type: application/json } ``` +# [JavaScript](#tab/javascript) ++++ ### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability. |
v1.0 | Security Ediscoverycase Post Legalholds | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoverycase-post-legalholds.md | You can specify the following properties when you create an **ediscoveryHoldPoli |:|:|:| |displayName|String|The display name of the legal hold policy. Required.| |description|String|The description of the legal hold policy. Optional.|-|contentQuery|String|The content query of the legal hold policy. Optional.| ## Response Content-Type: application/json { "displayname": "My legalHold with sources", "description": "Created from Graph API",- "contentQuery": "Bazooka", "userSources@odata.bind": [ { "@odata.type": "microsoft.graph.security.userSource", Content-Type: application/json "@odata.context": "https://graph.microsoft.com/beta/$metadata#security/cases/ediscoveryCases('b0073e4e-4184-41c6-9eb7-8c8cc3e2288b')/legalHolds/$entity", "isEnabled": true, "errors": [],- "contentQuery": "Bazooka", "description": "Created from Graph API", "createdDateTime": "2022-05-23T03:54:11.1Z", "lastModifiedDateTime": "2022-05-23T03:54:11.1Z", |
v1.0 | Security Ediscoveryholdpolicy Update | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-ediscoveryholdpolicy-update.md | PATCH /security/cases/ediscoveryCases/{ediscoveryCaseId}/legalHolds/{ediscoveryH |Property|Type|Description| |:|:|:| |description|String|The description of the legal hold policy. Optional.|-|contentQuery|String|The content query of the legal hold policy. Optional.| ## Response PATCH https://graph.microsoft.com/beta/security/cases/ediscoveryCases/b0073e4e-4 { "description": "updated description",- "contentQuery": "bazooka bazooka" } ``` |
v1.0 | Security Incident Post Comments | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-incident-post-comments.md | If successful, this method returns a `200 OK` response code and an updated list ### Request The following is an example of a request. ++# [HTTP](#tab/http) <!-- { "blockType": "request", "sampleKeys": ["3962396"], Content-Type: application/json } ``` +# [JavaScript](#tab/javascript) ++++ ### Response The following is an example of the response >**Note:** The response object shown here might be shortened for readability. |
v1.0 | Security Security Runhuntingquery | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/security-security-runhuntingquery.md | POST /security/runHuntingQuery ## Request body -In the request body, provide a JSON object for the parameter, `query`. +In the request body, provide a JSON object for the parameter, `Query`. | Parameter | Type |Description| |:|:--|:-|-|query|String|The hunting query in Kusto Query Language (KQL). For more information on KQL syntax, see [KQL quick reference](/azure/data-explorer/kql-quick-reference).| +|Query|String|The hunting query in Kusto Query Language (KQL). For more information on KQL syntax, see [KQL quick reference](/azure/data-explorer/kql-quick-reference).| ## Response This example specifies a KQL query which does the following: - Sorts the output by the `Timestamp` value. - Limits the output to 2 records (2 rows). ++# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "security_runhuntingquery" This example specifies a KQL query which does the following: POST https://graph.microsoft.com/beta/security/runHuntingQuery {- "query":"DeviceProcessEvents | where InitiatingProcessFileName =~ \"powershell.exe\" | project Timestamp, FileName, InitiatingProcessFileName | order by Timestamp desc | limit 2" + "Query": "DeviceProcessEvents | where InitiatingProcessFileName =~ \"powershell.exe\" | project Timestamp, FileName, InitiatingProcessFileName | order by Timestamp desc | limit 2" } ``` +# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) ++# [Go](#tab/go) ++# [PHP](#tab/php) ++++ ### Response >**Note:** The response object shown here might be shortened for readability. Content-type: application/json } ] }-``` +``` |
v1.0 | Serviceprincipal Addkey | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/serviceprincipal-addkey.md | ServicePrincipals that donΓÇÖt have any existing valid certificates (i.e.: no ce ## HTTP request +You can address the service principal using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal. <!-- { "blockType": "ignored" } --> ```http POST /servicePrincipals/{id}/addKey+POST /servicePrincipals(appId='{appId}')/addKey ``` ## Request headers |
v1.0 | Serviceprincipal Addpassword | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/serviceprincipal-addpassword.md | One of the following permissions is required to call this API. To learn more, in ## HTTP request +You can address the service principal using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal. <!-- { "blockType": "ignored" } --> ```http POST /servicePrincipals/{id}/addPassword+POST /servicePrincipals(appId='{appId}')/addPassword ``` ## Request headers |
v1.0 | Serviceprincipal Addtokensigningcertificate | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/serviceprincipal-addtokensigningcertificate.md | The **passwordCredential** is used to open the PFX file (private key). It and th ## HTTP request +You can address the service principal using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal. <!-- { "blockType": "ignored" } --> ```http POST /servicePrincipals/{id}/addTokenSigningCertificate+POST /servicePrincipals(appId='{appId}')/addTokenSigningCertificate ``` ## Request body |
v1.0 | Serviceprincipal Createpasswordsinglesignoncredentials | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/serviceprincipal-createpasswordsinglesignoncredentials.md | One of the following permissions is required to call this API. To learn more, in <!-- { "blockType": "ignored" } --> +You can address the service principal using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal. ```http POST /servicePrincipals/{id}/createPasswordSingleSignOnCredentials+POST /servicePrincipals(appId='{appId}')/createPasswordSingleSignOnCredentials ``` ## Request headers |
v1.0 | Serviceprincipal Delete Claimsmappingpolicies | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/serviceprincipal-delete-claimsmappingpolicies.md | One of the following permissions is required to call this API. To learn more, in ## HTTP request +You can address the service principal using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal. <!-- { "blockType": "ignored" } --> ```http DELETE /servicePrincipals/{id}/claimsMappingPolicies/{id}/$ref+DELETE /servicePrincipals(appId='{appId}')/claimsMappingPolicies/{id}/$ref ``` ## Request headers |
v1.0 | Serviceprincipal Delete Delegatedpermissionclassifications | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/serviceprincipal-delete-delegatedpermissionclassifications.md | One of the following permissions is required to call this API. To learn more, in ## HTTP request +You can address the service principal using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal. <!-- { "blockType": "ignored" } --> ```http DELETE /servicePrincipals/{id}/delegatedPermissionClassifications/{id}+DELETE /servicePrincipals(appId='{appId}')/delegatedPermissionClassifications/{id} ``` ## Request headers |
v1.0 | Serviceprincipal Delete Homerealmdiscoverypolicies | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/serviceprincipal-delete-homerealmdiscoverypolicies.md | One of the following permissions is required to call this API. To learn more, in ## HTTP request +You can address the service principal using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal. <!-- { "blockType": "ignored" } --> ```http-DELETE /servicePrincipals/{servicePrincipalId}/homeRealmDiscoveryPolicies/{policyId}/$ref +DELETE /servicePrincipals/{id}/homeRealmDiscoveryPolicies/{policyId}/$ref +DELETE /servicePrincipals(appId='{appId}')/homeRealmDiscoveryPolicies/{policyId}/$ref ``` ## Request headers |
v1.0 | Serviceprincipal Delete | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/serviceprincipal-delete.md | One of the following permissions is required to call this API. To learn more, in |Application | Application.ReadWrite.OwnedBy, Application.ReadWrite.All, Directory.ReadWrite.All | ## HTTP request++You can address the service principal using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal. <!-- { "blockType": "ignored" } --> ```http DELETE /servicePrincipals/{id}+DELETE /servicePrincipals(appId='{appId}') ``` ## Request headers | Name | Description| |
v1.0 | Serviceprincipal Deletepasswordsinglesignoncredentials | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/serviceprincipal-deletepasswordsinglesignoncredentials.md | One of the following permissions is required to call this API. To learn more, in ## HTTP request +You can address the service principal using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal. <!-- { "blockType": "ignored" } --> ```http POST /servicePrincipals/{id}/deletePasswordSingleSignOnCredentials+POST /servicePrincipals(appId='{appId}')/deletePasswordSingleSignOnCredentials ``` ## Request headers |
v1.0 | Serviceprincipal Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/serviceprincipal-get.md | One of the following permissions is required to call this API. To learn more, in > A service principal can retrieve its own application and service principal details without being granted any application permissions. ## HTTP request++You can address the service principal using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal. <!-- { "blockType": "ignored" } --> ```http GET /servicePrincipals/{id}+GET /servicePrincipals(appId='{appId}') ``` ## Optional query parameters 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 | Serviceprincipal Getpasswordsinglesignoncredentials | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/serviceprincipal-getpasswordsinglesignoncredentials.md | One of the following permissions is required to call this API. To learn more, in ## HTTP request +You can address the service principal using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal. <!-- { "blockType": "ignored" } --> ```http POST /servicePrincipals/{id}/getPasswordSingleSignOnCredentials+POST /servicePrincipals(appId='{appId}')/getPasswordSingleSignOnCredentials ``` ## Request headers |
v1.0 | Serviceprincipal Post Approleassignedto | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/serviceprincipal-post-approleassignedto.md | One of the following permissions is required to call this API. To learn more, in ## HTTP request +You can address the service principal using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal. <!-- { "blockType": "ignored" } --> ```http POST /servicePrincipals/{id}/appRoleAssignedTo+POST /servicePrincipals(appId='{appId}')/appRoleAssignedTo + ``` ## Request headers |
v1.0 | Serviceprincipal Post Approleassignments | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/serviceprincipal-post-approleassignments.md | One of the following permissions is required to call this API. To learn more, in ## HTTP request +You can address the service principal using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal. <!-- { "blockType": "ignored" } --> ```http POST /servicePrincipals/{id}/appRoleAssignments+POST /servicePrincipals(appId='{appId}')/appRoleAssignments + ``` > [!NOTE] |
v1.0 | Serviceprincipal Post Claimsmappingpolicies | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/serviceprincipal-post-claimsmappingpolicies.md | One of the following permissions is required to call this API. To learn more, in ## HTTP request +You can address the service principal using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal. <!-- { "blockType": "ignored" } --> ```http POST /servicePrincipals/{id}/claimsMappingPolicies/$ref+POST /servicePrincipals(appId='{appId}')/claimsMappingPolicies/$ref + ``` ## Request headers |
v1.0 | Serviceprincipal Post Delegatedpermissionclassifications | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/serviceprincipal-post-delegatedpermissionclassifications.md | One of the following permissions is required to call this API. To learn more, in ## HTTP request +You can address the service principal using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal. <!-- { "blockType": "ignored" } --> ```http POST /servicePrincipals/{id}/delegatedPermissionClassifications+POST /servicePrincipals(appId='{appId}')/delegatedPermissionClassifications + ``` ## Request headers |
v1.0 | Serviceprincipal Post Homerealmdiscoverypolicies | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/serviceprincipal-post-homerealmdiscoverypolicies.md | One of the following permissions is required to call this API. To learn more, in ## HTTP request +You can address the service principal using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal. <!-- { "blockType": "ignored" } --> ```http POST /servicePrincipals/{id}/homeRealmDiscoveryPolicies/$ref+POST /servicePrincipals(appId='{appId}')/homeRealmDiscoveryPolicies/$ref ``` ## Request headers |
v1.0 | Serviceprincipal Post Owners | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/serviceprincipal-post-owners.md | One of the following permissions is required to call this API. To learn more, in |Application | Application.ReadWrite.OwnedBy and Directory.Read.All, Application.ReadWrite.All and Directory.Read.All, Application.ReadWrite.OwnedBy and Directory.ReadWrite.All, Application.ReadWrite.All and Directory.ReadWrite.All | ## HTTP request++You can address the service principal using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal. <!-- { "blockType": "ignored" } --> ```http POST /servicePrincipals/{id}/owners/$ref-+POST /servicePrincipals(appId='{appId}')/owners/$ref ``` ## Request headers | Name | Description| |
v1.0 | Serviceprincipal Removekey | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/serviceprincipal-removekey.md | As part of the request validation for this method, a proof of possession of an e ## HTTP request +You can address the service principal using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal. <!-- { "blockType": "ignored" } --> ```http POST /serviceprincipals/{id}/removeKey+POST /serviceprincipals(appId='{appId}')/removeKey ``` ## Request headers |
v1.0 | Serviceprincipal Removepassword | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/serviceprincipal-removepassword.md | One of the following permissions is required to call this API. To learn more, in ## HTTP request +You can address the service principal using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal. <!-- { "blockType": "ignored" } --> ```http POST /servicePrincipals/{id}/removePassword+POST /servicePrincipals(appId='{appId}')/removePassword ``` ## Request headers |
v1.0 | Serviceprincipal Update | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/serviceprincipal-update.md | One of the following permissions is required to call this API. To learn more, in |Application | Application.ReadWrite.OwnedBy, Application.ReadWrite.All, Directory.ReadWrite.All | ## HTTP request+You can address the service principal using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal. <!-- { "blockType": "ignored" } --> ```http PATCH /servicePrincipals/{id}+PATCH /servicePrincipals(appId='{appId}') ``` ## Request headers | Name | Description| |
v1.0 | Serviceprincipal Updatepasswordsinglesignoncredentials | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/serviceprincipal-updatepasswordsinglesignoncredentials.md | One of the following permissions is required to call this API. To learn more, in ## HTTP request +You can address the service principal using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in the Azure portal. <!-- { "blockType": "ignored" } --> ```http POST /servicePrincipals/{id}/updatePasswordSingleSignOnCredentials+POST /servicePrincipals(appId='{appId}')/updatePasswordSingleSignOnCredentials ``` ## Request headers |
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 | Smsauthenticationmethodconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/smsauthenticationmethodconfiguration-get.md | One of the following permissions is required to call this API. To learn more, in |Permission type|Permissions (from least to most privileged)| |:|:|-|Delegated (work or school account)|Policy.ReadWrite.AuthenticationMethod| +|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.AuthenticationMethod| |Delegated (personal Microsoft account)|Not supported.|-|Application|Policy.ReadWrite.AuthenticationMethod| +|Application|Policy.Read.All, Policy.ReadWrite.AuthenticationMethod| For delegated scenarios, the administrator needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles): |
v1.0 | 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 Installedapps | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/team-post-installedapps.md | Namespace: microsoft.graph Install an [app](../resources/teamsapp.md) to the specified [team](../resources/team.md). -> **Note:** Currently, this operation does not support installation of apps that require resource-specific consent permissions. For details, see [Known issues](/graph/known-issues#Installation-of-apps-that-require-resource-specific-consent-permissions-is-not-supported). +> **Note:** Currently, this operation does not support installation of apps that require resource-specific consent permissions. For details, see [Known issues](/graph/known-issues#installation-of-apps-that-require-resource-specific-consent-permissions-is-not-supported). ## Permissions |
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 | Team Sendactivitynotification | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/team-sendactivitynotification.md | The following table shows the parameters that can be used with this action. |chainId|Int64|Optional. Used to override a previous notification. Use the same `chainId` in subsequent requests to override the previous notification.| |previewText|[itemBody](../resources/itembody.md)|Preview text for the notification. Microsoft Teams will only show first 150 characters.| |templateParameters|[keyValuePair](../resources/keyvaluepair.md) collection|Values for template variables defined in the activity feed entry corresponding to `activityType` in [Teams app manifest](/microsoftteams/platform/overview).|-|recipient|[teamworkNotificationRecipient](../resources/teamworknotificationrecipient.md)|Recipient of the notification. See also [aadUserNotificationRecipient](../resources/aadusernotificationrecipient.md), [teamMembersNotificationRecipient](../resources/teammembersnotificationrecipient.md), and [channelMembersNotificationRecipient](../resources/channelmembersnotificationrecipient.md). | +|recipient|[teamworkNotificationRecipient](../resources/teamworknotificationrecipient.md)|Recipient of the notification. For more details, see [aadUserNotificationRecipient](../resources/aadusernotificationrecipient.md), [channelMembersNotificationRecipient](../resources/channelmembersnotificationrecipient.md), and [teamMembersNotificationRecipient](../resources/teammembersnotificationrecipient.md). | The following resources are supported when setting the `source` value of the **topic** property to `entityUrl`: HTTP/1.1 204 No Content ### Example 5: Notify the team members about pending finance approval requests -This example shows how you can send an activity feed notification to all team members. This example is similar to previous examples. However, in this case, the `recipient` is a [teamMembersNotificationRecipient](../resources/teammembersnotificationrecipient.md). Note that the `teamId` specified in the `recipient` must match the `teamId` specified in the request URL. +The following example shows how you can send an activity feed notification to all team members. This example is similar to previous examples. However, in this case, the **recipient** is a [teamMembersNotificationRecipient](../resources/teammembersnotificationrecipient.md). Note that the **teamId** specified in the **recipient** must match the **teamId** specified in the request URL. > **Note:** The ability to send notifications to all team members is limited to teams with 10,000 members or less. If the team exceeds 10,000 members, none of the team members will receive a notification. #### Request +The following example shows the request. + # [HTTP](#tab/http) <!-- { "blockType": "request", Content-Type: application/json #### Response++The following example shows the response. + <!-- { "blockType": "response", "truncated": false HTTP/1.1 204 No Content ### Example 6: Notify the channel members about pending finance approval requests -This example shows how you can send an activity feed notification to all channel members. This example is similar to the previous example. However, in this case, the `recipient` is a [channelMembersNotificationRecipient](../resources/channelmembersnotificationrecipient.md). Note that the `teamId` specified in the `recipient` must match the `teamId` specified in the request URL. +The following example shows how you can send an activity feed notification to all channel members. This example is similar to the previous example. However, in this case, the **recipient** is a [channelMembersNotificationRecipient](../resources/channelmembersnotificationrecipient.md). Note that the **teamId** specified in the **recipient** must match the **teamId** specified in the request URL. #### Request +The following example shows the request. + # [HTTP](#tab/http) <!-- { "blockType": "request",- "name": "team_sendactivitynotification_5" + "name": "team_sendactivitynotification_6" } --> Content-Type: application/json ``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] #### Response++The following example shows the response. + <!-- { "blockType": "response", "truncated": false |
v1.0 | Temporaryaccesspassauthenticationmethodconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/temporaryaccesspassauthenticationmethodconfiguration-get.md | One of the following permissions is required to call this API. To learn more, in |Permission type|Permissions (from least to most privileged)| |:|:|-|Delegated (work or school account)|Policy.ReadWrite.AuthenticationMethod| +|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.AuthenticationMethod| |Delegated (personal Microsoft account)|Not supported.|-|Application|Policy.ReadWrite.AuthenticationMethod| +|Application|Policy.Read.All, Policy.ReadWrite.AuthenticationMethod| For delegated scenarios, the administrator needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles): GET https://graph.microsoft.com/beta/policies/authenticationMethodsPolicy/authen [!INCLUDE [sample-code](../includes/snippets/go/get-temporaryaccesspassauthenticationmethodconfiguration-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-temporaryaccesspassauthenticationmethodconfiguration-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Unifiedroleassignmentschedulerequest Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroleassignmentschedulerequest-get.md | One of the following permissions is required to call this API. To learn more, in |:|:| |Delegated (work or school account)|RoleAssignmentSchedule.Read.Directory, RoleManagement.Read.Directory, RoleManagement.Read.All, RoleAssignmentSchedule.ReadWrite.Directory, RoleManagement.ReadWrite.Directory| |Delegated (personal Microsoft account)|Not supported|-|Application|RoleManagement.Read.Directory, RoleManagement.ReadWrite.Directory| +|Application|RoleManagement.ReadWrite.Directory| ## HTTP request |
v1.0 | Unifiedroledefinition Assignedprincipals | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroledefinition-assignedprincipals.md | + + Title: "unifiedRoleDefinition: assignedPrincipals" +description: "Get the list of security principals (users, groups, and service principals) directly or transitively assigned to a specific role for different scopes." ++ms.localizationpriority: medium +++# unifiedRoleDefinition: assignedPrincipals +Namespace: microsoft.graph +++Get the list of security principals (users, groups, and service principals) that are assigned to a specific role for different scopes either directly or transitively. You can use the `$count` query parameter to also get the count. ++To list the direct and transitive role assignments for a specific principal, use the [List transitiveRoleAssignments](rbacapplication-list-transitiveroleassignments.md) API. ++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|RoleManagement.Read.Directory, Directory.Read.All, RoleManagement.ReadWrite.Directory| +|Delegated (personal Microsoft account)|Not supported.| +|Application|RoleManagement.Read.Directory, Directory.Read.All, RoleManagement.ReadWrite.Directory| ++If the caller does not have the permission to read properties for some of the objects included in the result set, the response will follow the [limited information returned for inaccessible member objects](/graph/permissions-reference#limited-information-returned-for-inaccessible-member-objects) pattern. ++To read the properties that may require permissions for the object, grant the permissions to retrieve information about the object. For more information, see permissions for [users](user-list.md#permissions), [groups](group-list.md#permissions), and [service principals](serviceprincipal-list.md#permissions). +++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /roleManagement/directory/roleDefinitions/{unifiedRoleDefinitionId}/assignedPrincipals +``` ++## Function parameters +In the request URL, provide the following query parameters with values. +The following table shows the parameters that can be used with this function. ++|Parameter|Type|Description| +|:|:|:| +|transitive|Boolean|Indicates whether to include principals assigned through group membership (direct or transitive). `false` by default.| +|directoryScopeType|String|The directory scope to get assigned principals for. Supported values are `tenant`, `administrativeUnit`, and `resource`.| +|directoryScopeId|String|ID of the directory scope to get assigned principals for. By default, all scopes are considered.| ++You can also combine all the supported function parameters in one request for fine-grained results. ++### Example query patterns for directoryScopeType ++|Scope|Query|Supported for| +|:|:|:| +|All scopes|`/assignedPrincipals(transitive={true | false})`|All roles| +|Tenant scope|`/assignedPrincipals(directoryScopeType='tenant', transitive={true | false})`|All roles| +|All administrative unit scopes|`/assignedPrincipals(directoryScopeType='administrativeUnit', transitive={true | false})`|Directory roles| +|Specific administrative unit scope|`/assignedPrincipals(directoryScopeType='administrativeUnit', directoryScopeId ='{roleDefinitionId | templateId}', transitive={true | false})`|Directory roles| +|All resource scopes|`/assignedPrincipals(directoryScopeType='resource', transitive={true | false})`|Directory roles| +|Specific resource scope|`/assignedPrincipals(directoryScopeType='resource', directoryScopeId ='{roleDefinitionId | templateId}', transitive={true | false})`|Directory roles| ++## Optional query parameters ++This method supports the `$count`, `$select`, `$filter`, and `$orderBy` OData query parameters to help customize the response. You can also filter by the type of object using OData casting. For example, `/assignedPrincipals(transitive=false)/microsoft.graph.user` and `/assignedPrincipals(transitive=true)/microsoft.graph.servicePrincipal/$count`. For general information, see [OData query parameters](/graph/query-parameters). ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| +|ConsistencyLevel|eventual. Required. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).| ++## Request body +Do not supply a request body for this method. ++## Response ++If successful, this function returns a `200 OK` response code and a [directoryObject](../resources/directoryobject.md) collection in the response body. ++## Examples ++For the examples in this section, consider the following role assignment scenario. A user named User1 has both direct and transitive role assignments as follows: ++| User | Group | Role | Scope | +| :: | :: | :: | :: | +| User1<br/>`6c62e70d-f5f5-4b9d-9eea-ed517ed9341f` | | Role1 | Scope1 | +| User1<br/>`6c62e70d-f5f5-4b9d-9eea-ed517ed9341f` | | Role1 | Scope2 | +| | Group1<br/>`86b38db7-6e8b-4ad2-b2aa-ced7f09486c1`<br/>(User1 is a member) | Role1 | Scope1 | +| | Group2<br/>`182351a6-d974-4d18-88ae-8a148da44cd2`<br/>(User1 is a member) | Role1 | Scope1 | +| | Group3<br/>`b93d5379-a464-4db5-b8e1-694910f1e11e`<br/>(User2 is a member)<br/>(User3 is a member) | Role1 | Scope3 | +++ User1 is assigned the Role1 role directly at Scope1 scope.++ User1 is assigned the Role1 role directly at Scope2 scope.++ User1 is member of the Group1 group and Group1 is assigned the Role1 role at Scope1 scope.++ User1 is member of the Group2 group and Group2 is assigned the Role1 role at Scope1 scope.++ User2 is member of the Group3 group and Group3 is assigned the Role1 role at Scope3 scope.++ User3 is member of the Group3 group and Group3 is assigned the Role1 role at Scope3 scope.++### Example 1: Get a count of direct and transitive assigned principals for all scopes ++#### Request ++<!-- { + "blockType": "ignored", + "name": "unifiedroledefinition_assignedprincipals_count" +} +--> +```http +GET https://graph.microsoft.com/beta/roleManagement/directory/roleDefinitions/644ef478-e28f-4e28-b9dc-3fdde9aa0b1f/assignedPrincipals(transitive=true)/$count +``` ++#### Response ++The above request will return a count of 6 representing the following role assignments: ++ Two direct role assignments to User1 at Scope1 and Scope2++ Two transitive role assignments to User1 through Group1 and Group2++ Two transitive role assignments to User 2 and User3 through Group3.++<!-- { + "blockType": "response" +} --> +```http +HTTP/1.1 200 OK +Content-type: text/plain ++6 +``` ++Using the same scenario, the following examples show the counts that will be returned for each query pattern: ++| Example | Count | +| | | +| `/assignedPrincipals(transitive=false)/$count` | 4<br/>(User1, Group1, Group2, Group3) | +| `/assignedPrincipals(transitive=false)/microsoft.graph.user/$count` | 1<br/>(User1) | +| `/assignedPrincipals(transitive=true)/microsoft.graph.user/$count` | 3<br/>(User1, User2, User3) | +| `/assignedPrincipals(transitive=false)/microsoft.graph.group/$count` | 3<br/>(Group1, Group2, Group3) | +| `/assignedPrincipals(transitive=true)/microsoft.graph.group/$count` | 3<br/>(Group1, Group2, Group3) | ++### Example 2: Get directly assigned principals for a specific administrative unit scope and directory role ++#### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "unifiedroledefinition_assignedprincipals_scope_role" +} +--> +``` http +GET https://graph.microsoft.com/beta/roleManagement/directory/roleDefinitions/644ef478-e28f-4e28-b9dc-3fdde9aa0b1f/assignedPrincipals(directoryScopeType='administrativeUnit', directoryScopeId ='d0c2e067-9ae9-4dbf-a280-51a51c46f432') +``` ++# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) +++++#### Response +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.directoryObject)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#directoryObjects", + "value": [ + { + "@odata.type": "#microsoft.graph.user", + "id": "6c62e70d-f5f5-4b9d-9eea-ed517ed9341f" + } + ] +} +``` ++### Example 3: Get directly assigned principals for all scopes ++#### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "unifiedroledefinition_assignedprincipals_allscopes" +} +--> +``` http +GET https://graph.microsoft.com/beta/roleManagement/directory/roleDefinitions/644ef478-e28f-4e28-b9dc-3fdde9aa0b1f/assignedPrincipals +``` ++# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) +++++#### Response +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.directoryObject)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#directoryObjects", + "value": [ + { + "@odata.type": "#microsoft.graph.user", + "id": "6c62e70d-f5f5-4b9d-9eea-ed517ed9341f", + "displayName": null, + "userPrincipalName": null + }, + { + "@odata.type": "#microsoft.graph.group", + "id": "86b38db7-6e8b-4ad2-b2aa-ced7f09486c1", + "displayName": "Group1" + }, + { + "@odata.type": "#microsoft.graph.group", + "id": "182351a6-d974-4d18-88ae-8a148da44cd2", + "displayName": "Group2" + }, + { + "@odata.type": "#microsoft.graph.group", + "id": "b93d5379-a464-4db5-b8e1-694910f1e11e", + "displayName": "Group3" + } + ] +} +``` ++### Example 4: Get directly assigned users only for a tenant-wide scope ++#### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "unifiedroledefinition_assignedprincipals_scope" +} +--> +``` http +GET https://graph.microsoft.com/beta/roleManagement/directory/roleDefinitions/644ef478-e28f-4e28-b9dc-3fdde9aa0b1f/assignedPrincipals(directoryScopeType='tenant')/microsoft.graph.user +``` ++# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) +++++#### Response +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.directoryObject)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#users", + "value": [ + { + "id": "6c62e70d-f5f5-4b9d-9eea-ed517ed9341f", + "displayName": null, + "userPrincipalName": null + } + ] +} +``` ++### Example 5: Get directly assigned principals and inline count ++The following example gets the directly assigned principals and displays an inline count. ++#### Request ++# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "unifiedroledefinition_assignedprincipals_minimumpermission_count" +} +--> +``` http +GET https://graph.microsoft.com/beta/roleManagement/directory/roleDefinitions/644ef478-e28f-4e28-b9dc-3fdde9aa0b1f/assignedPrincipals?$count=true +``` ++# [C#](#tab/csharp) ++# [JavaScript](#tab/javascript) ++# [Java](#tab/java) +++++#### Response +>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.directoryObject)" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#directoryObjects", + "@odata.count": 4, + "value": [ + { + "@odata.type": "#microsoft.graph.user", + "id": "6c62e70d-f5f5-4b9d-9eea-ed517ed9341f", + "displayName": null, + "userPrincipalName": null + }, + { + "@odata.type": "#microsoft.graph.group", + "id": "86b38db7-6e8b-4ad2-b2aa-ced7f09486c1", + "displayName": "Group1" + }, + { + "@odata.type": "#microsoft.graph.group", + "id": "182351a6-d974-4d18-88ae-8a148da44cd2", + "displayName": "Group2" + }, + { + "@odata.type": "#microsoft.graph.group", + "id": "b93d5379-a464-4db5-b8e1-694910f1e11e", + "displayName": "Group3" + } + ] +} +``` |
v1.0 | Unifiedroleeligibilityschedulerequest Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroleeligibilityschedulerequest-get.md | One of the following permissions is required to call this API. To learn more, in |:|:| |Delegated (work or school account)|RoleEligibilitySchedule.Read.Directory, RoleManagement.Read.Directory, RoleManagement.Read.All, RoleEligibilitySchedule.ReadWrite.Directory, RoleManagement.ReadWrite.Directory | |Delegated (personal Microsoft account)|Not supported|-|Application|RoleManagement.Read.Directory, RoleManagement.ReadWrite.Directory| +|Application|oleManagement.ReadWrite.Directory| ## HTTP request |
v1.0 | User List Agreementacceptances | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/user-list-agreementacceptances.md | One of the following permissions is required to call this API. To learn more, in ```http GET /me/agreementAcceptances -# where the id or userPrincipalName is the signed-in user's - GET /users/{id | userPrincipalName}/agreementAcceptances ```-<!-- + ## Optional query parameters-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. >+This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response. + ## Request headers | Name |Description| |
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 | User List | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/user-list.md | One of the following permissions is required to call this API. To learn more, in |Delegated (personal Microsoft account) | Not supported. | |Application | User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | -Guest users cannot call this API. For more information about the permissions for member and guest users, see [What are the default user permissions in Azure Active Directory?](/azure/active-directory/fundamentals/users-default-permissions#member-and-guest-users) +Guest users cannot call this API. For more information about the permissions for member and guest users, see [What are the default user permissions in Azure Active Directory?](/azure/active-directory/fundamentals/users-default-permissions?context=graph/context#member-and-guest-users) ## HTTP request GET /users This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$search`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. `$skip` isn't supported. The default and maximum page sizes are 100 and 999 user objects respectively. Some queries are supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). The `$count` and `$search` parameters are currently not available in Azure AD B2C tenants. -Extension properties also support query parameters as follows: --| Extension type | Comments | -||-| -| onPremisesExtensionAttributes 1-15 | Returned only with `$select`. Supports `$filter` (`eq`, `ne`, and `eq` on `null` values). | -| Schema extensions | Returned only with `$select`. Supports `$filter` (`eq`, `ne`, and `eq` on `null` values). | -| Open extensions | Returned only with `$expand`, that is, `users?$expand=extensions`. | -| Directory extensions | Returned only with `$select`. Supports `$filter` (`eq`, `ne`, and `eq` on `null` values). | +[Extension properties](/graph/extensibility-overview) also support query parameters, in some cases, only with advanced query parameters. For more information, see [support for `$filter` by extension properties](/graph/aad-advanced-queries#:~:text=The%20following%20table%20shows%20support%20for%20%24filter%20by%20extension%20properties%20on%20the%20user%20object.). Certain properties cannot be returned within a user collection. The following properties are only supported when [retrieving a single user](./user-get.md): **aboutMe**, **birthday**, **hireDate**, **interests**, **mySite**, **pastProjects**, **preferredName**, **responsibilities**, **schools**, **skills**, **mailboxSettings**. |
v1.0 | User Revokesigninsessions | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/user-revokesigninsessions.md | If the application attempts to redeem a delegated access token for this user by >[!NOTE] >After calling **revokeSignInSessions**, there might be a small delay of a few minutes before tokens are revoked.+> +>This API doesn't revoke sign-in sessions for external users, because external users sign in through their home tenant. ## Permissions |
v1.0 | User Update | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/user-update.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Update the properties of a [user](../resources/user.md) object. Not all properties can be updated by Member or Guest users with their default permissions without Administrator roles. [Compare member and guest default permissions](/azure/active-directory/fundamentals/users-default-permissions#compare-member-and-guest-default-permissions) to see properties they can manage. +Update the properties of a [user](../resources/user.md) object. Not all properties can be updated by Member or Guest users with their default permissions without Administrator roles. [Compare member and guest default permissions](/azure/active-directory/fundamentals/users-default-permissions?context=graph/context#compare-member-and-guest-default-permissions) to see properties they can manage. ## Permissions One of the following pefrmissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
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 | X509certificateauthenticationmethodconfiguration Delete | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/x509certificateauthenticationmethodconfiguration-delete.md | One of the following permissions is required to call this API. To learn more, in |:|:| |Delegated (work or school account)|Policy.ReadWrite.AuthenticationMethod| |Delegated (personal Microsoft account)|Not supported.|-|Application|Not supported.| +|Application|Policy.ReadWrite.AuthenticationMethod| For delegated scenarios, the administrator needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles): |
v1.0 | X509certificateauthenticationmethodconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/x509certificateauthenticationmethodconfiguration-get.md | One of the following permissions is required to call this API. To learn more, in |Permission type|Permissions (from least to most privileged)| |:|:|-|Delegated (work or school account)|Policy.ReadWrite.AuthenticationMethod| +|Delegated (work or school account)|Policy.Read.All, Policy.ReadWrite.AuthenticationMethod| |Delegated (personal Microsoft account)|Not supported.|-|Application|Not supported.| +|Application|Policy.Read.All, Policy.ReadWrite.AuthenticationMethod| For delegated scenarios, the administrator needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles): |
v1.0 | X509certificateauthenticationmethodconfiguration Update | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/x509certificateauthenticationmethodconfiguration-update.md | One of the following permissions is required to call this API. To learn more, in |:|:| |Delegated (work or school account)|Policy.ReadWrite.AuthenticationMethod| |Delegated (personal Microsoft account)|Not supported.|-|Application|Not supported.| +|Application|Policy.ReadWrite.AuthenticationMethod| For delegated scenarios, the administrator needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles): |
v1.0 | Accesspackage | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/accesspackage.md | To assign a user to an access package, [create an accessPackageAssignmentRequest | [List accessPackagesIncompatibleWith](../api/accesspackage-list-accesspackagesincompatiblewith.md) | [accessPackage](accesspackage.md) collection | Retrieve a list of the **accesspackage** objects which list this access package as incompatible. | |[filterByCurrentUser](../api/accesspackage-filterbycurrentuser.md)|[accessPackage](../resources/accesspackage.md) collection|Retrieve the list of **accessPackage** objects filtered on the signed-in user.| | [getApplicablePolicyRequirements](../api/accesspackage-getapplicablepolicyrequirements.md) | [accessPackageAssignmentRequestRequirements](../resources/accesspackageassignmentrequestrequirements.md) collection | Retrieve a list of **accessPackageAssignmentRequestRequirement** objects with request requirements. |+| [moveToCatalog](../api/accesspackage-movetocatalog.md) | None | Move an access package to a different catalog.| ## Properties |
v1.0 | Admin | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/admin.md | None. ## Relationships |Relationship|Type|Description| |:|:|:|+| edge | [edge](edge.md) | A container for Microsoft Edge resources. Read-only. | | reportSettings |[microsoft.graph.adminReportSettings](../resources/adminreportsettings.md)|A container for administrative resources to manage reports.| | serviceAnnouncement | [serviceAnnouncement](serviceannouncement.md) | A container for service communications resources. Read-only. | | sharepoint |[microsoft.graph.tenantAdmin.sharepoint](../resources/tenantadmin-sharepoint.md)|A container for administrative resources to manage tenant-level settings for SharePoint and OneDrive.| |
v1.0 | Agreementacceptance | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/agreementacceptance.md | Represents the current status of a user's response to a company's customizable t |agreementFileId|String|ID of the agreement file accepted by the user.| |agreementId|String|ID of the agreement.| |deviceDisplayName|String|The display name of the device used for accepting the agreement.|-|deviceId|String|The unique identifier of the device used for accepting the agreement.| +|deviceId|String|The unique identifier of the device used for accepting the agreement. Supports `$filter` (`eq`) and `eq` for `null` values.| |deviceOSType|String|The operating system used for accepting the agreement.|-|deviceOSVersion|String|The operating system version of the device used for accepting the agreement. | -|expirationDateTime|DateTimeOffset|The expiration date time of the acceptance. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`| -|id|String| Read-only.| -|recordedDateTime|DateTimeOffset|The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`| +|deviceOSVersion|String|The operating system version of the device used for accepting the agreement.| +|expirationDateTime|DateTimeOffset|The expiration date time of the acceptance. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Supports `$filter` (`eq`, `ge`, `le`) and `eq` for `null` values.| +|id|String| The identifier of the agreement acceptance. Read-only. Supports `$filter` (`eq`).| +|recordedDateTime|DateTimeOffset|The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Supports `$filter` (`eq`) and `eq` for `null` values.| |state|string| Possible values are: `accepted`, `declined`. Supports `$filter` (`eq`).| |userDisplayName|String|Display name of the user when the acceptance was recorded.| |userEmail|String|Email of the user when the acceptance was recorded.|-|userId|String|ID of the user who accepted the agreement.| +|userId|String|ID of the user who accepted the agreement. Supports `$filter` (`eq`).| |userPrincipalName|String|UPN of the user when the acceptance was recorded.| ## Relationships |
v1.0 | Application | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/application.md | This resource supports: | publicClient | [publicClientApplication](publicclientapplication.md) | Specifies settings for installed clients such as desktop or mobile devices. | | publisherDomain | String | The verified publisher domain for the application. Read-only. Supports `$filter` (`eq`, `ne`, `ge`, `le`, `startsWith`).| | requestSignatureVerification | [requestSignatureVerification](requestsignatureverification.md)| Specifies whether this application requires Azure AD to verify the signed authentication requests.|-| requiredResourceAccess |[requiredResourceAccess](requiredresourceaccess.md) collection| Specifies the resources that the application needs to access. This property also specifies the set of delegated permissions and application roles that it needs for each of those resources. This configuration of access to the required resources drives the consent experience. No more than 50 resource services (APIs) can be configured. Beginning mid-October 2021, the total number of required permissions must not exceed 400. Not nullable. <br><br>Supports `$filter` (`eq`, `not`, `ge`, `le`).| +| requiredResourceAccess |[requiredResourceAccess](requiredresourceaccess.md) collection| Specifies the resources that the application needs to access. This property also specifies the set of delegated permissions and application roles that it needs for each of those resources. This configuration of access to the required resources drives the consent experience. <br/><br/>No more than 50 resource services (APIs) can be configured. Beginning mid-October 2021, the total number of required permissions must not exceed 400. For more information, see [Limits on requested permissions per app](#limits-on-requested-permissions-per-app). Not nullable. <br><br>Supports `$filter` (`eq`, `not`, `ge`, `le`).| | samlMetadataUrl | String | The URL where the service exposes SAML metadata for federation. This property is valid only for single-tenant applications. Nullable. | | serviceManagementReference | String | References application or service contact information from a Service or Asset Management database. Nullable. |-| signInAudience | String | Specifies the Microsoft accounts that are supported for the current application. The possible values are: `AzureADMyOrg`, `AzureADMultipleOrgs`, `AzureADandPersonalMicrosoftAccount` (default), and `PersonalMicrosoftAccount`. See more in the [table below](#signinaudience-values). <br><br>Supports `$filter` (`eq`, `ne`, `not`).| +| signInAudience | String | Specifies the Microsoft accounts that are supported for the current application. The possible values are: `AzureADMyOrg`, `AzureADMultipleOrgs`, `AzureADandPersonalMicrosoftAccount` (default), and `PersonalMicrosoftAccount`. See more in the [table](#signinaudience-values). <br/><br/>The value of this object also limits the number of permissions an app can request. For more information, see [Limits on requested permissions per app](#limits-on-requested-permissions-per-app). <br><br>Supports `$filter` (`eq`, `ne`, `not`).| +| servicePrincipalLockConfiguration | [servicePrincipalLockConfiguration](servicePrincipalLockConfiguration.md) | Specifies whether sensitive properties of a multi-tenant application should be locked for editing after the application is provisioned in a tenant. Nullable. `null` by default. | | spa | [spaApplication](../resources/spaapplication.md) | Specifies settings for a single-page application, including sign out URLs and redirect URIs for authorization codes and access tokens. | | tags |String collection| Custom strings that can be used to categorize and identify the application. Not nullable.<br><br>Supports `$filter` (`eq`, `not`, `ge`, `le`, `startsWith`).| | tokenEncryptionKeyId |Guid|Specifies the keyId of a public key from the keyCredentials collection. When configured, Azure AD encrypts all the tokens it emits by using the key this property points to. The application code that receives the encrypted token must use the matching private key to decrypt the token before it can be used for the signed-in user.| This resource supports: |AzureADandPersonalMicrosoftAccount|Users with a personal Microsoft account, or a work or school account in any organizationΓÇÖs Azure AD tenant. For authenticating users with Azure AD B2C user flows, use `AzureADandPersonalMicrosoftAccount`. This value allows for the widest set of user identities including local accounts and user identities from Microsoft, Facebook, Google, Twitter, or any OpenID Connect provider. This is the default value for the **signInAudience** property.| |PersonalMicrosoftAccount|Users with a personal Microsoft account only.| +### Limits on requested permissions per app ++ ## Relationships | Relationship | Type | Description | The following is a JSON representation of the resource. "publisherDomain": "String", "requestSignatureVerification": {"@odata.type": "microsoft.graph.requestSignatureVerification"}, "requiredResourceAccess": [{"@odata.type": "microsoft.graph.requiredResourceAccess"}],+ "servicePrincipalLockConfiguration": {"@odata.type": "microsoft.graph.servicePrincipalLockConfiguration"}, "serviceManagementReference": "String", "signInAudience": "String", "spa": {"@odata.type": "microsoft.graph.spaApplication"}, |
v1.0 | Approleassignment | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/approleassignment.md | An app role assignment where the assigned principal is a service principal is an |:|:--|:-| | id | String | A unique identifier for the **appRoleAssignment** key. Not nullable. Read-only. | | creationTimestamp | DateTimeOffset | The time when the app role 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`. Read-only. |-| principalId | Guid | The unique identifier (**id**) for the [user](user.md), [group](group.md), or [service principal](serviceprincipal.md) being granted the app role. Required on create. | +| principalId | Guid | The unique identifier (**id**) for the [user](user.md), [security group](group.md), or [service principal](serviceprincipal.md) being granted the app role. Security groups with dynamic memberships are supported. Required on create. | | principalType | String | The type of the assigned principal. This can either be `User`, `Group`, or `ServicePrincipal`. Read-only. | | principalDisplayName | String |The display name of the user, group, or service principal that was granted the app role assignment. Read-only. Supports `$filter` (`eq` and `startswith`). | | resourceId | Guid |The unique identifier (**id**) for the resource [service principal](serviceprincipal.md) for which the assignment is made. Required on create. Supports `$filter` (`eq` only). | Here is a JSON representation of the resource } ``` +## See also +++ [Grant or revoke app roles using Microsoft Graph](/graph/permissions-grant-via-msgraph?pivots=grant-application-permissions)+ <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!-- |
v1.0 | Browser Edge Api Overview | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/browser-edge-api-overview.md | + + Title: "Use the Edge API in Microsoft Graph" +description: "The Edge API in Microsoft Graph lets apps manage administrator tasks for organizations." ++ms.localizationpriority: medium +++# Use the Edge API in Microsoft Graph ++The Edge API in Microsoft Graph lets apps manage administrator tasks for organizations. With proper authorization, an app can get access to an organization's browser site lists for Internet Explorer (IE) mode that reside in the cloud, allowing administrators to manage the same data available in the [Microsoft 365 admin center](https://admin.microsoft.com/). After configuring the appropriate permissions, your app can create browser site lists, add browser sites and shared cookies, and publish the site lists for Microsoft Edge to download. ++## Authorization ++To call the Edge API in Microsoft Graph, your app needs to acquire an access token. For details about access tokens, see [Get access tokens to call Microsoft Graph](/graph/auth/). Your app also needs the appropriate permissions. For more information, see [Browser management permissions](/graph/permissions-reference#browser-management-permissions). ++## Common use cases ++The Edge API provides methods and actions that support some administrator's tasks in the Microsoft 365 admin center. The following describes common use cases of the API that manages site lists for IE mode. ++| Use cases | REST resources | See also | +|:-|:|:| +| Create, read, update, delete, and publish browser site lists | [browserSiteList](../resources/browsersitelist.md) | [Methods of browserSiteList](../resources/browsersitelist.md#methods) | +| Modify the browser sites on a browser site list | [browserSite](../resources/browsersite.md) | [Methods of browserSite](../resources/browsersite.md#methods) | +| Modify the browser shared cookies on a browser site list | [browserSharedCookie](../resources/browsersharedcookie.md) | [Methods of browserSharedCookie](../resources/browsersharedcookie.md#methods) | ++## What's new +Find out about the [latest new features and updates](/graph/whats-new-overview) for this API set. ++## Next steps +The Edge API in Microsoft Graph can streamline the way you manage your site lists for IE mode. To learn more: ++- Drill down on the methods and properties of the resources most helpful to your scenario. +- Try the API in the [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer). ++Need more ideas? See [how some of our partners are using Microsoft Graph](https://developer.microsoft.com/graph/partners). |
v1.0 | Browsersharedcookie | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/browsersharedcookie.md | + + Title: "browserSharedCookie resource type" +description: "Represents a session cookie for Internet Explorer mode that resides on a site list." ++ms.localizationpriority: medium +++# browserSharedCookie resource type ++Namespace: microsoft.graph +++Represents a session cookie for [Internet Explorer mode](/deployedge/edge-ie-mode) that resides on a [site list](../resources/browsersitelist.md). Microsoft Edge and Internet Explorer processes use [shared session cookies](../resources/browsersharedcookie.md) to allow a streamlined experience when performing tasks such as authentication. For more details, see [Cookie sharing between Microsoft Edge and Internet Explorer](/deployedge/edge-ie-mode-add-guidance-cookieshare). ++## Methods +|Method|Return type|Description| +|:|:|:| +|[List browserSharedCookies](../api/browsersitelist-list-sharedcookies.md)|[browserSharedCookie](../resources/browsersharedcookie.md) collection|Get a list of the [browserSharedCookie](../resources/browsersharedcookie.md) objects and their properties.| +|[Create browserSharedCookie](../api/browsersitelist-post-sharedcookies.md)|[browserSharedCookie](../resources/browsersharedcookie.md)|Create a new [browserSharedCookie](../resources/browsersharedcookie.md) object in a [browserSiteList](../resources/browsersitelist.md).| +|[Get browserSharedCookie](../api/browsersharedcookie-get.md)|[browserSharedCookie](../resources/browsersharedcookie.md)|Get a [session cookie](../resources/browsersharedcookie.md) that can be shared between a Microsoft Edge process and an Internet Explorer process, while using [Internet Explorer mode](/deployedge/edge-ie-mode).| +|[Update browserSharedCookie](../api/browsersharedcookie-update.md)|None|Update the properties of a [browserSharedCookie](../resources/browsersharedcookie.md) object.| +|[Delete browserSharedCookie](../api/browsersitelist-delete-sharedcookies.md)|None|Delete a [browserSharedCookie](../resources/browsersharedcookie.md) from a [browserSiteList](../resources/browsersitelist.md).| ++## Properties +|Property|Type|Description| +|:|:|:| +|comment|String|The comment for the shared cookie.| +|createdDateTime|DateTimeOffset|The date and time when the shared cookie was created.| +|deletedDateTime|DateTimeOffset|The date and time when the shared cookie was deleted.| +|displayName|String|The name of the cookie.| +|history|[browserSharedCookieHistory](../resources/browsersharedcookiehistory.md) collection|The history of modifications applied to the cookie.| +|hostOnly|Boolean|Controls whether a cookie is a host-only or domain cookie.| +|hostOrDomain|String|The URL of the cookie.| +|id|String|The unique identifier for the cookie.| +|lastModifiedBy|[identitySet](../resources/identityset.md)|The user who last modified the cookie.| +|lastModifiedDateTime|DateTimeOffset|The date and time when the cookie was last modified.| +|path|String|The path of the cookie.| +|sourceEnvironment|browserSharedCookieSourceEnvironment|Specifies how the cookies are shared between Microsoft Edge and Internet Explorer. The possible values are: `microsoftEdge`, `internetExplorer11`, `both`, `unknownFutureValue`.| +|status|browserSharedCookieStatus|The status of the cookie. The possible values are: `published`, `pendingAdd`, `pendingEdit`, `pendingDelete`, `unknownFutureValue`.| ++## Relationships +None. ++## JSON representation +The following is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.browserSharedCookie", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.browserSharedCookie", + "comment": "String", + "createdDateTime": "String (timestamp)", + "deletedDateTime": "String (timestamp)", + "displayName": "String", + "history": [ + { + "@odata.type": "microsoft.graph.browserSharedCookieHistory" + } + ], + "hostOnly": "Boolean", + "hostOrDomain": "String", + "id": "String (identifier)", + "lastModifiedBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "lastModifiedDateTime": "String (timestamp)", + "path": "String", + "sourceEnvironment": "String", + "status": "String" +} +``` + |
v1.0 | Browsersharedcookiehistory | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/browsersharedcookiehistory.md | + + Title: "browserSharedCookieHistory resource type" +description: "Represents the history of modifications applied to a browserSharedCookie." ++ms.localizationpriority: medium +++# browserSharedCookieHistory resource type ++Namespace: microsoft.graph +++Represents the history of modifications applied to a [browserSharedCookie](../resources/browsersharedcookie.md). ++## Properties +|Property|Type|Description| +|:|:|:| +|comment|String|The comment for the shared cookie.| +|displayName|String|The name of the cookie.| +|hostOnly|Boolean|Controls whether a cookie is a host-only or domain cookie.| +|hostOrDomain|String|The URL of the cookie.| +|lastModifiedBy|[identitySet](../resources/identityset.md)|The user who last modified the cookie.| +|path|String|The path of the cookie.| +|publishedDateTime|DateTimeOffset|The date and time when the cookie was last published.| +|sourceEnvironment|browserSharedCookieSourceEnvironment|Specifies how the cookies are shared between Microsoft Edge and Internet Explorer. The possible values are: `microsoftEdge`, `internetExplorer11`, `both`, `unknownFutureValue`.| ++## Relationships +None. ++## JSON representation +The following is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.browserSharedCookieHistory" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.browserSharedCookieHistory", + "comment": "String", + "displayName": "String", + "hostOnly": "Boolean", + "hostOrDomain": "String", + "lastModifiedBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "path": "String", + "publishedDateTime": "String (timestamp)", + "sourceEnvironment": "String" +} +``` + |
v1.0 | Browsersite | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/browsersite.md | + + Title: "browserSite resource type" +description: "Represents a site to use in Internet Explorer mode that resides on a site list." ++ms.localizationpriority: medium +++# browserSite resource type ++Namespace: microsoft.graph +++Represents a site to use in [Internet Explorer mode](/deployedge/edge-ie-mode) that resides on a [site list](../resources/browsersitelist.md). ++## Methods +|Method|Return type|Description| +|:|:|:| +|[List browserSites](../api/browsersitelist-list-sites.md)|[browserSite](../resources/browsersite.md) collection|Get a list of the [browserSite](../resources/browsersite.md) objects and their properties.| +|[Create browserSite](../api/browsersitelist-post-sites.md)|[browserSite](../resources/browsersite.md)|Create a new [browserSite](../resources/browsersite.md) object in a [browserSiteList](../resources/browsersitelist.md).| +|[Get browserSite](../api/browsersite-get.md)|[browserSite](../resources/browsersite.md)|Get a [browserSite](../resources/browsersite.md) that resides on a [browserSiteList](../resources/browsersitelist.md).| +|[Update browserSite](../api/browsersite-update.md)|None|Update the properties of a [browserSite](../resources/browsersite.md) object.| +|[Delete browserSite](../api/browsersitelist-delete-sites.md)|None|Delete a [browserSite](../resources/browsersite.md) from a [browserSiteList](../resources/browsersitelist.md).| ++## Properties +|Property|Type|Description| +|:|:|:| +|allowRedirect|Boolean|Controls the behavior of redirected sites. If `true`, indicates that the site will open in Internet Explorer 11 or Microsoft Edge even if the site is navigated to as part of a HTTP or meta refresh redirection chain.| +|comment|String|The comment for the site.| +|compatibilityMode|browserSiteCompatibilityMode|Controls what compatibility setting is used for specific sites or domains. The possible values are: `default`, `internetExplorer8Enterprise`, `internetExplorer7Enterprise`, `internetExplorer11`, `internetExplorer10`, `internetExplorer9`, `internetExplorer8`, `internetExplorer7`, `internetExplorer5`, `unknownFutureValue`.| +|createdDateTime|DateTimeOffset|The date and time when the site was created.| +|deletedDateTime|DateTimeOffset|The date and time when the site was deleted.| +|history|[browserSiteHistory](../resources/browsersitehistory.md) collection|The history of modifications applied to the site.| +|id|String|The unique identifier for the site.| +|lastModifiedBy|[identitySet](../resources/identityset.md)|The user who last modified the site.| +|lastModifiedDateTime|DateTimeOffset|The date and time when the site was last modified.| +|mergeType|browserSiteMergeType|The merge type of the site. The possible values are: `noMerge`, `default`, `unknownFutureValue`.| +|status|browserSiteStatus|Indicates the status of the site. The possible values are: `published`, `pendingAdd`, `pendingEdit`, `pendingDelete`, `unknownFutureValue`.| +|targetEnvironment|browserSiteTargetEnvironment|The target environment that the site should open in. The possible values are: `internetExplorerMode`, `internetExplorer11`, `microsoftEdge`, `configurable`, `none`, `unknownFutureValue`.<br /><br />Prior to June 15, 2022, the `internetExplorer11` option would allow opening a site in the Internet Explorer 11 (IE11) desktop application. Following the retirement of IE11 on June 15, 2022, the `internetExplorer11` option will no longer open an IE11 window and will instead behave the same as the `internetExplorerMode` option.| +|webUrl|String|The URL of the site.| ++## Relationships +None. ++## JSON representation +The following is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.browserSite", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.browserSite", + "allowRedirect": "Boolean", + "comment": "String", + "compatibilityMode": "String", + "createdDateTime": "String (timestamp)", + "deletedDateTime": "String (timestamp)", + "history": [ + { + "@odata.type": "microsoft.graph.browserSiteHistory" + } + ], + "id": "String (identifier)", + "lastModifiedBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "lastModifiedDateTime": "String (timestamp)", + "mergeType": "String", + "status": "String", + "targetEnvironment": "String", + "webUrl": "String" +} +``` ++## See also ++- [Internet Explorer mode (IE mode)](https://www.microsoft.com/edge/business/ie-mode) +- [What is Internet Explorer (IE) mode?](/deployedge/edge-ie-mode) +- [Cloud Site List Management for Internet Explorer (IE) mode](/deployedge/edge-ie-mode-cloud-site-list-mgmt) |
v1.0 | Browsersitehistory | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/browsersitehistory.md | + + Title: "browserSiteHistory resource type" +description: "Represents the history of modifications applied to a browserSite." ++ms.localizationpriority: medium +++# browserSiteHistory resource type ++Namespace: microsoft.graph +++The history of modifications applied to a [browserSite](../resources/browsersite.md). ++## Properties +|Property|Type|Description| +|:|:|:| +|allowRedirect|Boolean|Controls the behavior of redirected sites. If `true`, indicates that the site will open in Internet Explorer 11 or Microsoft Edge even if the site is navigated to as part of a HTTP or meta refresh redirection chain.| +|comment|String|The comment for the site.| +|compatibilityMode|browserSiteCompatibilityMode|Controls what compatibility setting is used for specific sites or domains. The possible values are: `default`, `internetExplorer8Enterprise`, `internetExplorer7Enterprise`, `internetExplorer11`, `internetExplorer10`, `internetExplorer9`, `internetExplorer8`, `internetExplorer7`, `internetExplorer5`, `unknownFutureValue`.| +|lastModifiedBy|[identitySet](../resources/identityset.md)|The user who last modified the site.| +|mergeType|browserSiteMergeType|The merge type of the site. The possible values are: `noMerge`, `default`, `unknownFutureValue`.| +|publishedDateTime|DateTimeOffset|The date and time when the site was last published.| +|targetEnvironment|browserSiteTargetEnvironment|The target environment that the site should open in. The possible values are: `internetExplorerMode`, `internetExplorer11`, `microsoftEdge`, `configurable`, `none`, `unknownFutureValue`.<br /><br />Prior to June 15, 2022, the `internetExplorer11` option would allow opening a site in the Internet Explorer 11 (IE11) desktop application. Following the retirement of IE11 on June 15, 2022, the `internetExplorer11` option will no longer open an IE11 window and will instead behave the same as the `internetExplorerMode` option.| ++## Relationships +None. ++## JSON representation +The following is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.browserSiteHistory" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.browserSiteHistory", + "allowRedirect": "Boolean", + "comment": "String", + "compatibilityMode": "String", + "lastModifiedBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "mergeType": "String", + "publishedDateTime": "String (timestamp)", + "targetEnvironment": "String" +} +``` + |
v1.0 | Browsersitelist | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/browsersitelist.md | + + Title: "browserSiteList resource type" +description: "Represents an enterprise site list in a compliant cloud location that specifies sites to be opened in Internet Explorer mode." ++ms.localizationpriority: medium +++# browserSiteList resource type ++Namespace: microsoft.graph +++Represents an enterprise site list in a compliant cloud location that specifies sites to be opened in [Internet Explorer mode](/deployedge/edge-ie-mode). The site list contains one or more [browserSite](../resources/browsersite.md) and [browserSharedCookie](../resources/browsersharedcookie.md) resources. ++## Methods +|Method|Return type|Description| +|:|:|:| +|[List browserSiteLists](../api/internetexplorermode-list-sitelists.md)|[browserSiteList](../resources/browsersitelist.md) collection|Get a list of the [browserSiteList](../resources/browsersitelist.md) objects and their properties.| +|[Create browserSiteList](../api/internetexplorermode-post-sitelists.md)|[browserSiteList](../resources/browsersitelist.md)|Create a new [browserSiteList](../resources/browsersitelist.md) object to support [Internet Explorer mode](/deployedge/edge-ie-mode).| +|[Get browserSiteList](../api/browsersitelist-get.md)|[browserSiteList](../resources/browsersitelist.md)|Get a [browserSiteList](../resources/browsersitelist.md) that contains [browserSite](../resources/browsersite.md) and [browserSharedCookie](../resources/browsersharedcookie.md) resources.| +|[Update browserSiteList](../api/browsersitelist-update.md)|None|Update the properties of a [browserSiteList](../resources/browsersitelist.md) object.| +|[Delete browserSiteList](../api/internetexplorermode-delete-sitelists.md)|None|Delete a [browserSiteList](../resources/browsersitelist.md) object.| +|[Publish a browserSiteList](../api/browsersitelist-publish.md)|[browserSiteList](../resources/browsersitelist.md)|Publish the specified [browserSiteList](../resources/browsersitelist.md) for devices to download.| ++## Properties +|Property|Type|Description| +|:|:|:| +|description|String|The description of the site list.| +|displayName|String|The name of the site list.| +|id|String|The unique identifier for the site list.| +|lastModifiedBy|[identitySet](../resources/identityset.md)|The user who last modified the site list.| +|lastModifiedDateTime|DateTimeOffset|The date and time when the site list was last modified.| +|publishedBy|[identitySet](../resources/identityset.md)|The user who published the site list.| +|publishedDateTime|DateTimeOffset|The date and time when the site list was published.| +|revision|String|The current revision of the site list.| +|status|browserSiteListStatus|The current status of the site list. The possible values are: `draft`, `published`, `pending`, `unknownFutureValue`.| ++## Relationships +|Relationship|Type|Description| +|:|:|:| +|sharedCookies|[browserSharedCookie](../resources/browsersharedcookie.md) collection|A collection of shared cookies defined for the site list.| +|sites|[browserSite](../resources/browsersite.md) collection|A collection of sites defined for the site list.| ++## JSON representation +The following is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.browserSiteList", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.browserSiteList", + "description": "String", + "displayName": "String", + "id": "String (identifier)", + "lastModifiedBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "lastModifiedDateTime": "String (timestamp)", + "publishedBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "publishedDateTime": "String (timestamp)", + "revision": "String", + "status": "String" +} +``` ++## See also ++- [Internet Explorer mode (IE mode)](https://www.microsoft.com/edge/business/ie-mode) +- [What is Internet Explorer (IE) mode?](/deployedge/edge-ie-mode) +- [Cloud Site List Management for Internet Explorer (IE) mode](/deployedge/edge-ie-mode-cloud-site-list-mgmt) |
v1.0 | Channelmembersnotificationrecipient | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/channelmembersnotificationrecipient.md | Title: "channelMembersNotificationRecipient resource type" -description: Represents the recipient of a notification sent in a Microsoft Teams activity feed. The recipient consists of the channel members. -+description: "Represents the recipient (channel members) of a notification sent in a Microsoft Teams activity feed." + ms.localizationpriority: medium doc_type: resourcePageType Represents the recipient of a notification sent in a Microsoft Teams activity fe Inherits from [teamworkNotificationRecipient](teamworknotificationrecipient.md). ## Properties-| Property | Type | Description | -| :-- | :-- | :-- | -| teamId | String | The team's identifier under which the channel resides. | -| channelId | String | The channel's identifier. | +| Property | Type | Description | +|:-|:-|:-| +| channelId | String | The unique identifier for the channel whose members should receive the notification. | +| teamId | String | The unique identifier for the team under which the channel resides. | ## Relationships None. The following is a JSON representation of the resource. ``` json { "@odata.type": "#microsoft.graph.channelMembersNotificationRecipient",- "teamId": "String", - "channelId": "String" + "channelId": "String", + "teamId": "String" } ``` |
v1.0 | Chatmembersnotificationrecipient | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/chatmembersnotificationrecipient.md | Title: "chatMembersNotificationRecipient resource type" -description: Represents the recipient of a notification sent in a Microsoft Teams activity feed. The recipient consists of the chat members. -+description: "Represents the recipient (chat members) of a notification sent in a Microsoft Teams activity feed." + ms.localizationpriority: medium doc_type: resourcePageType Represents the recipient of a notification sent in a Microsoft Teams activity fe Inherits from [teamworkNotificationRecipient](teamworknotificationrecipient.md). ## Properties-|Property|Type|Description| -|:|:|:| -|chatId|String|The chat's identifier.| +| Property | Type | Description | +|:|:-|:--| +| chatId | String | The unique identifier for the chat whose members should receive the notifications. | ## Relationships None. The following is a JSON representation of the resource. "chatId": "String" } ```- |
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 | Complianceapioverview | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/complianceapioverview.md | eDiscovery in Microsoft 365 provides an end-to-end workflow to preserve, collect Explore the [Microsoft 365 eDiscovery APIs](ediscovery-ediscoveryapioverview.md). -## Subject rights request --Microsoft Priva Subject Rights Requests provides powerful capabilities to help you handle requests from people seeking to manage their personal data within your organization. These requests are sometimes also referred to as data subject requests (DSRs), data subject access requests (DSARs), or consumer rights requests. Microsoft Priva empowers personnel responsible for fulfilling subject rights requests to easily identify data subjects and find their personal information among your organizationΓÇÖs data in Exchange, SharePoint, OneDrive, and Teams. Learn more about [Priva Subject Rights Requests](/microsoft-365/compliance/privacy-management-subject-rights-requests). --Explore the [subject rights request APIs](subjectrightsrequest-subjectrightsrequestapioverview.md). - ## Records management (preview) Records management in Microsoft Purview provides the ability to manage regulatory, legal, and business-critical records across corporate data. It helps organizations manage retention and deletion of data to meet their legal obligations and compliance regulations, and increases efficiency by enabling the regular disposition of items that no longer have to be retained. For more details, see [Microsoft Purview records management](/microsoft-365/comp The records management API is defined in the OData subnamespace, microsoft.graph.security. Explore the [Microsoft Purview records management APIs](security-recordsManagement-overview.md). +## Subject rights request ++Microsoft Priva Subject Rights Requests provides powerful capabilities to help you handle requests from people seeking to manage their personal data within your organization. These requests are sometimes also referred to as data subject requests (DSRs), data subject access requests (DSARs), or consumer rights requests. Microsoft Priva empowers personnel responsible for fulfilling subject rights requests to easily identify data subjects and find their personal information among your organizationΓÇÖs data in Exchange, SharePoint, OneDrive, and Teams. Learn more about [Priva Subject Rights Requests](/microsoft-365/compliance/privacy-management-subject-rights-requests). ++Explore the [subject rights request APIs](subjectrightsrequest-subjectrightsrequestapioverview.md). + <!-- ## Labels |
v1.0 | Conditionalaccessapplications | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/conditionalaccessapplications.md | Represents the applications and user actions included in and excluded from the c |:-- |:- |:-- | | includeApplications | String collection | Can be one of the following: <li> The list of client IDs (**appId**) the policy applies to, unless explicitly excluded (in **excludeApplications**) <li> `All` <li> `Office365` - For the list of apps included in `Office365`, see [Conditional Access target apps: Office 365](/azure/active-directory/conditional-access/concept-conditional-access-cloud-apps) | | excludeApplications | String collection | Can be one of the following: <li> The list of client IDs (**appId**) explicitly excluded from the policy.<li> `Office365` - For the list of apps included in `Office365`, see [Conditional Access target apps: Office 365](/azure/active-directory/conditional-access/concept-conditional-access-cloud-apps) |+| applicationFilter | [conditionalAccessFilter](conditionalaccessfilter.md) | Filter that defines the dynamic-application-syntax rule to include/exclude cloud applications. A filter can use custom security attributes to include/exclude applications. | | includeUserActions | String collection | User actions to include. Supported values are `urn:user:registersecurityinfo` and `urn:user:registerdevice` | | includeAuthenticationContextClassReferences | String collection | Authentication context class references include. Supported values are `c1` through `c25`. | The following is a JSON representation of the resource. "optionalProperties": [ "includeApplications", "excludeApplications",+ "applicationFilter", "includeUserActions" ], "@odata.type": "microsoft.graph.conditionalAccessApplications" The following is a JSON representation of the resource. { "includeApplications": ["String"], "excludeApplications": ["String"],+ "applicationFilter": {"@odata.type": "microsoft.graph.conditionalAccessFilter"}, "includeUserActions": ["String"] } ``` |
v1.0 | Conditionalaccessclientapplications | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/conditionalaccessclientapplications.md | Represents client applications (service principals and workload identities) incl |:|:|:| |excludeServicePrincipals|String collection|Service principal IDs excluded from the policy scope.| |includeServicePrincipals|String collection|Service principal IDs included in the policy scope, or `ServicePrincipalsInMyTenant`. |+|servicePrincipalFilter | [conditionalAccessFilter](conditionalaccessfilter.md) | Filter that defines the dynamic-servicePrincipal-syntax rule to include/exclude service principals. A filter can use custom security attributes to include/exclude service principals. | ## Relationships None. The following is a JSON representation of the resource. ], "excludeServicePrincipals": [ "String"- ] + ], + "servicePrincipalFilter": {"@odata.type": "microsoft.graph.conditionalAccessFilter"}, } ``` |
v1.0 | Edge | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/edge.md | + + Title: "edge resource type" +description: "Represents an entity that acts as a container for Microsoft Edge functionalities." ++ms.localizationpriority: medium +++# edge resource type ++Namespace: microsoft.graph +++Represents an entity that acts as a container for Microsoft Edge functionalities. +++## Properties ++None. ++## Relationships +|Relationship|Type|Description| +|:|:|:| +|internetExplorerMode|[internetExplorerMode](../resources/internetexplorermode.md)|A container for [Internet Explorer mode](/deployedge/edge-ie-mode) resources.| ++## JSON representation +The following is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.edge", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.edge" +} +``` + |
v1.0 | Educationassignment | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/educationassignment.md | When an **assignment** is created, it is in a Draft state. Students can't see th The **assignment** APIs are exposed in the class namespace. +Inherits from [entity](../resources/entity.md). + ## Methods | Method | Return Type |Description| The **assignment** APIs are exposed in the class namespace. ## Properties | Property | Type |Description| |:|:--|:-|-|id|String| Read-only.| |addedStudentAction|String|Optional field to control the **assignment** behavior for students who are added after the **assignment** is published. If not specified, defaults to `none` value. Currently supports only two values: `none` or `assignIfOpen`.| |addToCalendarAction| educationAddToCalendarOptions|Optional field to control the **assignment** behavior for adding **assignments** to students' and teachers' calendars when the **assignment** is published. The possible values are: `none`, `studentsAndPublisher`, `studentsAndTeamOwners`, `unknownFutureValue`, and `studentsOnly`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value(s) in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `studentsOnly`. The default value is `none`.| |allowLateSubmissions|Boolean| Identifies whether students can submit after the due date. If this property is not specified during create, it defaults to true. | The **assignment** APIs are exposed in the class namespace. |dueDateTime|DateTimeOffset|Date when the students **assignment** is due. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`| |feedbackResourcesFolderUrl|String|Folder URL where all the feedback file resources for this **assignment** are stored.| |grading|[educationAssignmentGradeType](educationassignmentgradetype.md)|How the **assignment** will be graded. |+|id|String| The unique identifier for the **assignment**. Inherited from [entity](../resources/entity.md). Read-only.| |instructions|[itemBody](itembody.md)| Instructions for the **assignment**. This along with the display name tell the student what to do. | |lastModifiedBy|[identitySet](identityset.md)| Who last modified the **assignment**. | |lastModifiedDateTime|DateTimeOffset|Moment when the **assignment** was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`| The following is a JSON representation of the resource. ```json {- "id": "String (identifier)", - "addedStudentAction": "none", - "addToCalendarAction": "string", - "allowLateSubmissions": true, - "allowStudentsToAddResourcesToSubmission": true, + "addedStudentAction": "String", + "addToCalendarAction": "String", + "allowLateSubmissions": "Boolean", + "allowStudentsToAddResourcesToSubmission": "Boolean", "assignDateTime": "String (timestamp)", "assignTo": {"@odata.type": "microsoft.graph.educationAssignmentRecipient"}, "assignedDateTime": "String (timestamp)", The following is a JSON representation of the resource. "createdDateTime": "String (timestamp)", "displayName": "String", "dueDateTime": "String (timestamp)",+ "feedbackResourcesFolderUrl": "String", "grading": {"@odata.type": "microsoft.graph.educationAssignmentGradeType"},+ "id": "String (identifier)", "instructions": {"@odata.type": "microsoft.graph.itemBody"}, "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"}, "lastModifiedDateTime": "String (timestamp)",- "notificationChannelUrl": "string", - "status": "string", - "webUrl": "string", - "resourcesFolderUrl": "string" + "notificationChannelUrl": "String", + "status": "String", + "webUrl": "String", + "resourcesFolderUrl": "String" } ``` |