Updates from: 02/05/2023 05:29:14
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Accesspackageassignmentrequest Cancel https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/accesspackageassignmentrequest-cancel.md
The following is an example of the response.
} --> ```http
-HTTP/1.1 204 No Content
+HTTP/1.1 200 Status OK
```
v1.0 Administrativeunit Post Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/administrativeunit-post-members.md
POST /administrativeUnits/{id}/members
In the request body, provide the `id` of a [user](../resources/user.md), [group](../resources/group.md), [device](../resources/device.md), or [directoryObject](../resources/directoryobject.md) to be added. ### Creating a new group
-The following table shows the properties of the [group](../resources/group.md) resource to specify when you create a group in the administrative unit.
+The following table shows the properties of the [group](../resources/group.md) resource to specify when you create a group in the administrative unit.
| Property | Type | Description| |:|:--|:-|
The following table shows the properties of the [group](../resources/group.md) r
If successful, adding an existing object (using `$ref`) returns `204 No Content` response code. It does not return anything in the response body.
-When creating a new group (without `$ref`), this method returns a `201 Created` response code and a [group](../resources/group.md) object in the response body. The response includes only the default properties of the group.
+When creating a new group (without `$ref`), this method returns a `201 Created` response code and a [group](../resources/group.md) object in the response body. The response includes only the default properties of the group. You must supply the `"@odata.type" : "#microsoft.graph.group"` line in the request body to explicitly identify the new member as a group. A request body without the correct @odata.type returns a `400 Bad Request` error message.
## Examples ### Example 1: Add an existing user or group
HTTP/1.1 204 No Content
``` ### Example 2: Create a new group
-The following example creates a new group in the administrative unit.
+The following example creates a new group in the administrative unit. You must supply the `"@odata.type" : "#microsoft.graph.group"` line in the request body to explicitly identify the new member as a group. A request body without the correct @odata.type returns a `400 Bad Request` error message.
#### Request The following is an example of the request.
The following is an example of the request.
``` http POST https://graph.microsoft.com/beta/administrativeUnits/{id}/members Content-type: application/json
-Content-length: 244
{
- "@odata.type": "#Microsoft.Graph.Group",
+ "@odata.type": "#microsoft.graph.group",
"description": "Self help community for golf", "displayName": "Golf Assist", "groupTypes": [
v1.0 Adminwindowsupdates List Deploymentaudiences https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminwindowsupdates-list-deploymentaudiences.md
+
+ Title: "List deploymentAudiences"
+description: "Get a list of deploymentAudience objects and their properties."
+
+ms.localizationpriority: medium
++
+# List deploymentAudiences
+Namespace: microsoft.graph
++
+Get a list of [deploymentAudience](../resources/windowsupdates-deploymentaudience.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)|WindowsUpdates.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|WindowsUpdates.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/windows/updates/deploymentAudiences
+```
+
+## 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 [microsoft.graph.windowsUpdates.deployment](../resources/windowsupdates-deployment.md) objects in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "list_deployment"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/admin/windows/updates/deploymentAudiences
+```
++
+### 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": "Collection(microsoft.graph.windowsUpdates.deployment)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.windowsUpdates.deploymentAudience",
+ "id": "eacc9a79-884b-a728-91f7-9f3630aa9542",
+ }
+ ]
+}
+```
v1.0 Adminwindowsupdates List Deployments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminwindowsupdates-list-deployments.md
+
+ Title: "List deployments"
+description: "Get a list of deployment objects and their properties."
+
+ms.localizationpriority: medium
++
+# List deployments
+Namespace: microsoft.graph
++
+Get a list of [deployment](../resources/windowsupdates-deployment.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)|WindowsUpdates.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|WindowsUpdates.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/windows/updates/deployments
+```
+
+## Optional query parameters
+This method supports some of the [OData query parameters](/graph/query-parameters) to help customize the response, including `$count`, `$filter`, `$orderBy`, `$select`, `$skip`, and `$top`.
+
+## 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 [deployment](../resources/windowsupdates-deployment.md) objects in the response body.
+
+## Examples
+
+### Request
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "list_deployment"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/admin/windows/updates/deployments
+```
+
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
+++++
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.windowsUpdates.deployment)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.windowsUpdates.deployment",
+ "id": "b5171742-1742-b517-4217-17b5421717b5",
+ "state": {
+ "@odata.type": "microsoft.graph.windowsUpdates.deploymentState"
+ },
+ "content": {
+ "@odata.type": "microsoft.graph.windowsUpdates.deployableContent"
+ },
+ "settings": {
+ "@odata.type": "microsoft.graph.windowsUpdates.deploymentSettings"
+ },
+ "createdDateTime": "String (timestamp)",
+ "lastModifiedDateTime": "String (timestamp)"
+ }
+ ]
+}
+```
+
v1.0 Adminwindowsupdates List Resourceconnections Operationalinsightsconnection https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminwindowsupdates-list-resourceconnections-operationalinsightsconnection.md
+
+ Title: "List operationalInsightsConnections"
+description: "Get a list of the operationalInsightsConnection objects and their properties."
+
+ms.localizationpriority: medium
++
+# List operationalInsightsConnections
+Namespace: microsoft.graph
++
+Get a list of the [operationalInsightsConnection](../resources/windowsupdates-operationalinsightsconnection.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)|WindowsUpdates.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|WindowsUpdates.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/windows/updates/resourceConnections/microsoft.graph.windowsUpdates.operationalInsightsConnection
+```
+
+## 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 [operationalInsightsConnection](../resources/windowsupdates-operationalinsightsconnection.md) objects in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "list_operationalinsightsconnection"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/admin/windows/updates/resourceConnections/microsoft.graph.windowsUpdates.operationalInsightsConnection
+```
+
+# [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.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.windowsUpdates.operationalInsightsConnection",
+ "isCollection": true
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.windowsUpdates.operationalInsightsConnection",
+ "id": "fbb71b85-4173-0bf6-d2bc-ee7921b80cb0",
+ "state": "connected",
+ "azureSubscriptionId": "322ec614-e9c2-4cd5-a55c-5711fdecf02e",
+ "azureResourceGroupName": "target-resource-group",
+ "workspaceName": "my-workspace"
+ }
+ ]
+}
+```
+
v1.0 Adminwindowsupdates List Resourceconnections https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminwindowsupdates-list-resourceconnections.md
+
+ Title: "List resourceConnections"
+description: "Get a list of the resourceConnection objects and their properties."
+
+ms.localizationpriority: medium
++
+# List resourceConnections
+Namespace: microsoft.graph
++
+Get a list of the [resourceConnection](../resources/windowsupdates-resourceconnection.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)|WindowsUpdates.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|WindowsUpdates.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/windows/updates/resourceConnections
+```
+
+## 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 [resourceConnection](../resources/windowsupdates-resourceconnection.md) objects in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "list_resourceconnection"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/admin/windows/updates/resourceConnections
+```
+
+# [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.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.windowsUpdates.resourceConnection",
+ "isCollection": true
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.windowsUpdates.resourceConnection",
+ "id": "85fbecb2-e407-34e9-9298-4d587857795d",
+ "state": "connected"
+ }
+ ]
+}
+```
+
v1.0 Adminwindowsupdates List Updatableassets Azureaddevice https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminwindowsupdates-list-updatableassets-azureaddevice.md
+
+ Title: "List azureADDevice resources"
+description: "Get a list of azureADDevice objects and their properties."
+
+ms.localizationpriority: medium
++
+# List azureADDevice resources
+Namespace: microsoft.graph
++
+Get a list of [azureADDevice](../resources/windowsupdates-azureaddevice.md) objects and their properties.
+
+This operation filters on the fully qualified resource type, `microsoft.graph.windowsUpdates.azureADDevice`, which inherits from [updatableAsset](../resources/windowsupdates-updatableasset.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)|WindowsUpdates.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|WindowsUpdates.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/windows/updates/updatableAssets/microsoft.graph.windowsUpdates.azureADDevice
+```
+
+## Optional query parameters
+This method supports some of the [OData query parameters](/graph/query-parameters) to help customize the response, including `$count`, `$filter`, `$orderBy`, `$select`, `$skip`, and `$top`.
+
+To use a query parameter on a property that is not inherited from [updatableAsset](../resources/windowsupdates-updatableasset.md), include the full resource type. For example, to select the **errors** property, use `$select=microsoft.graph.windowsUpdates.azureADDevice/errors`.
+
+## 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 [azureADDevice](../resources/windowsupdates-azureaddevice.md) objects in the response body.
+
+## Examples
+
+### Request
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "list_azureaddevice"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/admin/windows/updates/updatableAssets/microsoft.graph.windowsUpdates.azureADDevice
+```
+
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.windowsUpdates.azureADDevice)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
+ "id": "983f03cd-03cd-983f-cd03-3f98cd033f98",
+ "errors": [],
+ "enrollments": [
+ {
+ "@odata.type": "microsoft.graph.windowsUpdates.updateManagementEnrollment",
+ "updateCategory": "feature"
+ }
+ ]
+ },
+ {
+ "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
+ "id": "90b91efa-6d46-42cd-ad4d-381831773a85",
+ "errors": [],
+ "enrollments": []
+ },
+ {
+ "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
+ "id": "0ee3eb63-caf3-44ce-9769-b83188cc683d",
+ "errors": [
+ {
+ "@odata.type": "microsoft.graph.windowsUpdates.azureADDeviceRegistrationError"
+ }
+ ],
+ "enrollments": []
+ }
+ ]
+}
+```
+
v1.0 Adminwindowsupdates List Updatableassets Updatableassetgroup https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminwindowsupdates-list-updatableassets-updatableassetgroup.md
+
+ Title: "List updatableAssetGroup resources"
+description: "Get a list of updatableAssetGroup objects and their properties."
+
+ms.localizationpriority: medium
++
+# List updatableAssetGroup resources
+Namespace: microsoft.graph
++
+Get a list of [updatableAssetGroup](../resources/windowsupdates-updatableassetgroup.md) objects and their properties.
+
+This operation filters on the fully qualified resource type, `microsoft.graph.windowsUpdates.updatableAssetGroup`, which inherits from [updatableAsset](../resources/windowsupdates-updatableasset.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)|WindowsUpdates.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|WindowsUpdates.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/windows/updates/updatableAssets/microsoft.graph.windowsUpdates.updatableAssetGroup
+```
+
+## Optional query parameters
+This method supports some of the [OData query parameters](/graph/query-parameters) to help customize the response, including `$count`, `$filter`, `$orderBy`, `$select`, `$skip`, and `$top`.
+
+## 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 [updatableAssetGroup](../resources/windowsupdates-updatableassetgroup.md) objects in the response body.
+
+## Examples
+
+### Request
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "list_updatableassetgroup"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/admin/windows/updates/updatableAssets/microsoft.graph.windowsUpdates.updatableAssetGroup
+```
+
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
+++++
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.windowsUpdates.updatableAssetGroup)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.windowsUpdates.updatableAssetGroup",
+ "id": "5c55730b-730b-5c55-0b73-555c0b73555c"
+ },
+ {
+ "@odata.type": "#microsoft.graph.windowsUpdates.updatableAssetGroup",
+ "id": "deb43c16-77ff-465d-aa79-366a107a6c7a"
+ },
+ {
+ "@odata.type": "#microsoft.graph.windowsUpdates.updatableAssetGroup",
+ "id": "312643e6-b805-419f-bdf7-1a104dd6c8b9"
+ }
+ ]
+}
+```
+
v1.0 Adminwindowsupdates List Updatableassets https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminwindowsupdates-list-updatableassets.md
+
+ Title: "List updatableAssets"
+description: "Get a list of updatableAsset objects and their properties."
+
+ms.localizationpriority: medium
++
+# List updatableAssets
+Namespace: microsoft.graph
++
+Get a list of [updatableAsset](../resources/windowsupdates-updatableasset.md) objects and their properties.
+
+Listing updatable assets returns **updatableAsset** resources of the following derived types: [azureADDevice](../resources/windowsupdates-azureADDevice.md) and [updatableAssetGroup](../resources/windowsupdates-updatableassetGroup.md).
+
+Use [list azureADDevice resources](adminwindowsupdates-list-updatableassets-azureaddevice.md) or [list updatableAssetGroup resources](adminwindowsupdates-list-updatableassets-updatableassetgroup.md) to filter and get resources of only one of the derived types.
+
+## 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)|WindowsUpdates.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|WindowsUpdates.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/windows/updates/updatableAssets
+```
+
+## Optional query parameters
+This method supports some of the [OData query parameters](/graph/query-parameters) to help customize the response, including `$count`, `$filter`, `$orderBy`, `$select`, `$skip`, and `$top`.
+
+To use a query parameter on a property that is not inherited from [updatableAsset](../resources/windowsupdates-updatableasset.md), include the full resource type for the property. For example, to apply `$select` on the **errors** property of [azureADDevice](../resources/windowsupdates-azureaddevice.md), use `$select=microsoft.graph.windowsUpdates.azureADDevice/errors`.
+
+## 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 [updatableAsset](../resources/windowsupdates-updatableasset.md) objects in the response body.
+
+## Examples
+
+### Request
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "list_updatableasset_fromupdates"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/admin/windows/updates/updatableAssets
+```
+
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
+++++
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.windowsUpdates.updatableAsset)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
+ "id": "983f03cd-03cd-983f-cd03-3f98cd033f98",
+ "errors": [],
+ "enrollments": [
+ {
+ "@odata.type": "microsoft.graph.windowsUpdates.updateManagementEnrollment",
+ "updateCategory": "feature"
+ }
+ ]
+ }
+ ]
+}
+```
+
v1.0 Adminwindowsupdates List Updatepolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminwindowsupdates-list-updatepolicies.md
+
+ Title: "List updatePolicies"
+description: "Get a list of updatePolicy objects and their properties."
+
+ms.localizationpriority: medium
++
+# List updatePolicy
+Namespace: microsoft.graph
++
+Get a list of [updatePolicy](../resources/windowsupdates-updatepolicy.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)|WindowsUpdates.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|WindowsUpdates.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /admin/windows/updates/updatePolicies
+```
+
+## 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 [microsoft.graph.windowsUpdates.updatePolicy](../resources/windowsupdates-updatepolicy.md) objects in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "list_updatepolicy"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/admin/windows/updates/updatePolicies
+```
+
+### 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": "Collection(microsoft.graph.windowsUpdates.updatePolicy)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.windowsUpdates.updatePolicy",
+ "id": "a7aa99c1-34a2-850c-5223-7816fde70713",
+ "audience": {
+ "@odata.id": "deploymentAudiences/1"
+ },
+ "complianceChanges": [
+ {
+ "@odata.type": "#microsoft.graph.windowsUpdates.contentApproval"
+ }
+ ],
+ "complianceChangeRules": [
+ {
+ "@odata.type": "#microsoft.graph.windowsUpdates.contentApprovalRule",
+ "contentFilter": {
+ "@odata.type": "#microsoft.graph.windowsUpdates.driverUpdateFilter"
+ },
+ "durationBeforeDeploymentStart": "P7D",
+ "createdDateTime": "2020-06-09T10:00:00Z",
+ "lastEvaluatedDateTime": "2020-06-09T10:00:00Z",
+ "lastModifiedDateTime": "2020-06-09T10:00:00Z"
+ }
+ ],
+ "deploymentSettings": {
+ "@odata.type": "microsoft.graph.windowsUpdates.deploymentSettings",
+ "schedule": {
+ "gradualRollout": {
+ "@odata.type": "#microsoft.graph.windowsUpdates.rateDrivenRolloutSettings",
+ "durationBetweenOffers": "P1D",
+ "devicePerOffer": 1000
+ }
+ }
+ }
+ }
+ ]
+}
+```
v1.0 Adminwindowsupdates Post Deploymentaudiences https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminwindowsupdates-post-deploymentaudiences.md
+
+ Title: "Create deploymentAudience"
+description: "Create a new deploymentAudience object."
+
+ms.localizationpriority: medium
++
+# Create deploymentAudience
+Namespace: microsoft.graph
++
+Create a new [deploymentAudience](../resources/windowsupdates-deploymentaudience.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)|WindowsUpdates.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|WindowsUpdates.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /admin/windows/updates/deploymentAudiences
+```
+
+## 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 [deploymentAudience](../resources/windowsupdates-deploymentaudience.md) object.
+
+You can specify the following properties when you create a **deploymentAudience**.
+
+|Property|Type|Description|
+|:|:|:|
+
+## Response
+
+If successful, this method returns a `201 Created` response code and a [microsoft.graph.windowsUpdates.deploymentAudience](../resources/windowsupdates-deploymentaudience.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "create_deploymentaudience_from_"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/admin/windows/updates/deploymentAudiences
+Content-Type: application/json
+Content-length: 4
+
+{
+}
+```
+
+### 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.windowsUpdates.deploymentAudience"
+}
+-->
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.windowsUpdates.deploymentAudience",
+ "id": "7f960f66-b6ed-6d54-f24a-9b1021a1d17f",
+}
+```
v1.0 Adminwindowsupdates Post Deployments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminwindowsupdates-post-deployments.md
+
+ Title: "Create deployment"
+description: "Create a new deployment object."
+
+ms.localizationpriority: medium
++
+# Create deployment
+Namespace: microsoft.graph
++
+Create a new [deployment](../resources/windowsupdates-deployment.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)|WindowsUpdates.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|WindowsUpdates.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /admin/windows/updates/deployments
+```
+
+## 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 [deployment](../resources/windowsupdates-deployment.md) object.
+
+The following table shows the properties that are required when you create the [deployment](../resources/windowsupdates-deployment.md).
+
+|Property|Type|Description|
+|:|:|:|
+|audience|[microsoft.graph.windowsUpdates.deploymentAudience](../resources/windowsupdates-deploymentaudience.md)|Specifies the audience to target.|
+|content|[microsoft.graph.windowsUpdates.deployableContent](../resources/windowsupdates-deployablecontent.md)|Specifies what content to deploy. Deployable content should be provided as one of the following derived types: [catalogContent](../resources/windowsupdates-catalogcontent.md).|
+
+## Response
+
+If successful, this method returns a `201 Created` response code and a [deployment](../resources/windowsupdates-deployment.md) object in the response body.
+
+## Example
+
+### Request
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "create_deployment_from_"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/admin/windows/updates/deployments
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.windowsUpdates.deployment",
+ "content": {
+ "@odata.type": "#microsoft.graph.windowsUpdates.catalogContent",
+ "catalogEntry": {
+ "@odata.type": "#microsoft.graph.windowsUpdates.featureUpdateCatalogEntry",
+ "id": "f341705b-0b15-4ce3-aaf2-6a1681d78606"
+ }
+ },
+ "settings": {
+ "@odata.type": "microsoft.graph.windowsUpdates.deploymentSettings",
+ "schedule": {
+ "gradualRollout": {
+ "@odata.type": "#microsoft.graph.windowsUpdates.rateDrivenRolloutSettings",
+ "durationBetweenOffers": "P7D",
+ "devicePerOffer": 100
+ }
+ },
+ "monitoring": {
+ "monitoringRules": [
+ {
+ "signal": "rollback",
+ "threshold": 5,
+ "action": "pauseDeployment"
+ }
+ ]
+ }
+ }
+}
+
+```
+
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
+++
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.windowsUpdates.deployment"
+}
+-->
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.windowsUpdates.deployment",
+ "id": "b5171742-1742-b517-4217-17b5421717b5",
+ "createdDateTime": "2023-01-26T05:08:38.118213Z",
+ "lastModifiedDateTime": "2023-01-26T05:08:38Z",
+ "state": {
+ "value": "offering",
+ "reasons": [],
+ "requestedValue": "none",
+ },
+ "content": {
+ "@odata.type": "microsoft.graph.windowsUpdates.catalogContent",
+ },
+ "settings": {
+ "@odata.type": "microsoft.graph.windowsUpdates.deploymentSettings",
+ "schedule": {
+ "gradualRollout": {
+ "@odata.type": "#microsoft.graph.windowsUpdates.rateDrivenRolloutSettings",
+ "durationBetweenOffers": "P1D",
+ "devicePerOffer": 1000
+ }
+ },
+ "monitoring": {
+ "monitoringRules": [
+ {
+ "@odata.type": "#microsoft.graph.windowsUpdates.monitoringRule",
+ "signal": "rollback",
+ "threshold": 5,
+ "action": "pauseDeployment"
+ }
+ ]
+ },
+ "userExperience": null,
+ "safeguard": null
+ },
+}
+```
v1.0 Adminwindowsupdates Post Resourceconnections Operationalinsightsconnection https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminwindowsupdates-post-resourceconnections-operationalinsightsconnection.md
+
+ Title: "Create operationalInsightsConnection"
+description: "Create a new operationalInsightsConnection object."
+
+ms.localizationpriority: medium
++
+# Create operationalInsightsConnection
+Namespace: microsoft.graph
++
+Create a new [operationalInsightsConnection](../resources/windowsupdates-operationalinsightsconnection.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)|WindowsUpdates.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|WindowsUpdates.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /admin/windows/updates/resourceConnections
+```
+
+## 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 [operationalInsightsConnection](../resources/windowsupdates-operationalinsightsconnection.md) object.
+
+You must specify the following properties when you create an **operationalInsightsConnection**.
+
+|Property|Type|Description|
+|:|:|:|
+|azureResourceGroupName|String|The name of the Azure resource group that contains the Log Analytics workspace.|
+|azureSubscriptionId|String|The Azure subscription ID that contains the Log Analytics workspace.|
+|workspaceName|String|The name of the Log Analytics workspace.|
+
+## Response
+
+If successful, this method returns a `201 Created` response code and an [operationalInsightsConnection](../resources/windowsupdates-operationalinsightsconnection.md) object in the response body.
+
+The following errors are possible:
+
+|Response Code|Message|
+|:|:|
+|`400 Bad Request`|The specified workspace was not able to be linked. Verify that the key properties are correct.|
+|`403 Forbidden`|The specified workspace was not able to be linked. Verify that the Azure subscription is active.|
+|`409 Conflict`|The specified resource already exists.|
+
+## Examples
+
+### Request
+The following is an example of a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "create_operationalInsightsConnection_from_"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/admin/windows/updates/resourceConnections
+Content-Type: application/json
+Content-length: 97
+
+{
+ "@odata.type": "#microsoft.graph.windowsUpdates.operationalInsightsConnection",
+ "azureSubscriptionId": "322ec614-e9c2-4cd5-a55c-5711fdecf02e",
+ "azureResourceGroupName": "target-resource-group",
+ "workspaceName": "my-workspace"
+}
+```
+
+# [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.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.windowsUpdates.operationalInsightsConnection"
+}
+-->
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.windowsUpdates.operationalInsightsConnection",
+ "id": "85fbecb2-e407-34e9-9298-4d587857795d",
+ "azureSubscriptionId": "322ec614-e9c2-4cd5-a55c-5711fdecf02e",
+ "azureResourceGroupName": "target-resource-group",
+ "workspaceName": "my-workspace",
+ "state": "connected"
+}
+```
v1.0 Adminwindowsupdates Post Updatableassets Updatableassetgroup https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminwindowsupdates-post-updatableassets-updatableassetgroup.md
+
+ Title: "Create updatableAssetGroup"
+description: "Create a new updatableAssetGroup object."
+
+ms.localizationpriority: medium
++
+# Create updatableAssetGroup
+Namespace: microsoft.graph
++
+Create a new [updatableAssetGroup](../resources/windowsupdates-updatableassetgroup.md) object.
+
+The **updatableAssetGroup** resource inherits from [updatableAsset](../resources/windowsupdates-updatableasset.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)|WindowsUpdates.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|WindowsUpdates.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /admin/windows/updates/updatableAssets
+```
+
+## 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 [updatableAssetGroup](../resources/windowsupdates-updatableassetgroup.md) object.
+
+No properties are required.
++
+## Response
+
+If successful, this method returns a `201 Created` response code and an [updatableAssetGroup](../resources/windowsupdates-updatableassetgroup.md) object in the response body.
+
+## Examples
+
+### Request
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "create_updatableassetgroup_from_"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/admin/windows/updates/updatableAssets
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.windowsUpdates.updatableAssetGroup"
+}
+```
+
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
+++++
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.windowsUpdates.updatableAssetGroup"
+}
+-->
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.windowsUpdates.updatableAssetGroup",
+ "id": "5c55730b-730b-5c55-0b73-555c0b73555c"
+}
+```
+
v1.0 Adminwindowsupdates Post Updatepolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/adminwindowsupdates-post-updatepolicies.md
+
+ Title: "Create updatePolicy"
+description: "Create a new updatePolicy object."
+
+ms.localizationpriority: medium
++
+# Create updatePolicy
+Namespace: microsoft.graph
++
+Create a new [updatePolicy](../resources/windowsupdates-updatepolicy.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)|WindowsUpdates.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|WindowsUpdates.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /admin/windows/updates/updatePolicies
+```
+
+## 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 [updatePolicy](../resources/windowsupdates-updatepolicy.md) object.
+
+You can specify the following properties when you create an **updatePolicy**.
+
+|Property|Type|Description|
+|:|:|:|
+|audience|[microsoft.graph.windowsUpdates.deploymentAudience](../resources/windowsupdates-deploymentaudience.md)|Specifies the audience to target.|
+|complianceChanges|[microsoft.graph.windowsUpdates.complianceChange](../resources/windowsupdates-compliancechange.md) collection|Compliance changes like content approvals which result in the automatic creation of deployments using the **audience** and **deploymentSettings** of the policy.|
+|complianceChangeRules|[microsoft.graph.windowsUpdates.complianceChangeRule](../resources/windowsupdates-compliancechangerule.md) collection|Rules for governing the automatic creation of compliance changes.|
+|deploymentSettings|[microsoft.graph.windowsUpdates.deploymentSettings](../resources/windowsupdates-deploymentsettings.md)|Settings for governing how to deploy **content**.|
+
+## Response
+
+If successful, this method returns a `201 Created` response code and an [microsoft.graph.windowsUpdates.updatePolicy](../resources/windowsupdates-updatepolicy.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "create_updatepolicy_from_"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/admin/windows/updates/updatePolicies
+Content-Type: application/json
+Content-length: 835
+
+{
+ "@odata.type": "#microsoft.graph.windowsUpdates.updatePolicy",
+ "audience": {
+ "id": "8c4eb1eb-d7a3-4633-8e2f-f926e82df08e"
+ },
+ "complianceChanges": [
+ {
+ "@odata.type": "#microsoft.graph.windowsUpdates.contentApproval"
+ }
+ ],
+ "complianceChangeRules": [
+ {
+ "@odata.type": "#microsoft.graph.windowsUpdates.contentApprovalRule",
+ "contentFilter": {
+ "@odata.type": "#microsoft.graph.windowsUpdates.driverUpdateFilter"
+ },
+ "durationBeforeDeploymentStart": "P7D"
+ }
+ ],
+ "deploymentSettings": {
+ "@odata.type": "microsoft.graph.windowsUpdates.deploymentSettings",
+ "schedule": {
+ "gradualRollout": {
+ "@odata.type": "#microsoft.graph.windowsUpdates.rateDrivenRolloutSettings",
+ "durationBetweenOffers": "P1D",
+ "devicePerOffer": 1000
+ }
+ }
+ }
+}
+```
+
+### 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.windowsUpdates.updatePolicy"
+}
+-->
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#admin/windows/updates/updatePolicies/$entity",
+ "id": "1b35b81b-f839-4951-882a-1fbfc6446409",
+ "createdDateTime": "String (timestamp)",
+ "autoEnrollmentUpdateCategories": [],
+ "complianceChangeRules": [
+ {
+ "@odata.type": "#microsoft.graph.windowsUpdates.contentApprovalRule",
+ "createdDateTime": "String (timestamp)",
+ "lastEvaluatedDateTime": "String (timestamp)",
+ "lastModifiedDateTime": "String (timestamp)",
+ "durationBeforeDeploymentStart": "P7D",
+ "contentFilter": {
+ "@odata.type": "#microsoft.graph.windowsUpdates.driverUpdateFilter"
+ }
+ }
+ ],
+ "deploymentSettings": {
+ "monitoring": null,
+ "contentApplicability": null,
+ "userExperience": null,
+ "expedite": null,
+ "schedule": {
+ "startDateTime": "String (timestamp)",
+ "gradualRollout": {
+ "@odata.type": "#microsoft.graph.windowsUpdates.rateDrivenRolloutSettings",
+ "durationBetweenOffers": "P1D",
+ "devicesPerOffer": 0
+ }
+ }
+ }
+}
+```
v1.0 Appcatalogs List Teamsapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/appcatalogs-list-teamsapps.md
Namespace: microsoft.graph
List [apps](../resources/teamsapp.md) from the Microsoft Teams app catalog. This includes apps from the Microsoft Teams store, as well as apps from your organization's app catalog (the tenant app catalog). To get apps from your organization's app catalog only, specify `organization` as the **distributionMethod** in the request.
-> [!NOTE]
-> The `id` of a **teamsApp** resource is generated by the server and is not the same as the `id` specified in a Teams app manifest. The `id` provided by the developer as part of the Teams app manifest is stamped as the `externalId` in the **teamsApp** resource.
+> [!NOTE]
+> In general, the **id** of a **teamsApp** resource is generated by the server. It is not the same as the **id** specified in a Teams app manifest, unless its **distributionMethod** is `store`. For other cases, the **id** provided by the developer as part of the Teams app manifest is stamped as the **externalId** in the **teamsApp** resource.
## Permissions
The following example lists all applications that are specific to your tenant.
#### Request
+The following is an example of a request.
# [HTTP](#tab/http) <!-- {
GET https://graph.microsoft.com/beta/appCatalogs/teamsApps?$filter=distributionM
#### Response
+The following is an example of the response.
+ <!-- { "blockType": "response", "@odata.type": "microsoft.graph.teamsApp",
Content-Type: application/json
{ "id": "b1c5353a-7aca-41b3-830f-27d5218fe0e5", "externalId": "f31b1263-ba99-435a-a679-911d24850d7c",
- "name": "Test App",
- "version": "1.0.1",
- "distributionMethod": "Organization"
+ "displayName": "Test App",
+ "distributionMethod": "organization"
} ] }
The following example lists applications with a given ID.
#### Request
+The following is an example of a request.
# [HTTP](#tab/http) <!-- {
The following example lists applications with a given ID.
}--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/appCatalogs/teamsApps?$filter=id%20eq%20'b1c5353a-7aca-41b3-830f-27d5218fe0e5'
+GET https://graph.microsoft.com/beta/appCatalogs/teamsApps?$filter=id eq 'b1c5353a-7aca-41b3-830f-27d5218fe0e5'
``` # [C#](#tab/csharp)
GET https://graph.microsoft.com/beta/appCatalogs/teamsApps?$filter=id%20eq%20'b1
#### Response
+The following is an example of the response.
+ <!-- { "blockType": "response", "name": "list_teamsapp_filter_id",
Content-Type: application/json
{ "id": "b1c5353a-7aca-41b3-830f-27d5218fe0e5", "externalId": "f31b1263-ba99-435a-a679-911d24850d7c",
- "name": "Test App",
- "version": "1.0.1",
- "distributionMethod": "Organization"
+ "displayName": "Test App",
+ "distributionMethod": "organization"
} ] } ``` ### Example 3: Find application based on the Teams app manifest ID
-The following example lists applications that match the 'id' specified in the Teams app manifest. In the example, the manifest ID of the Teams app is 'cf1ba4c7-f94e-4d80-ba90-5594b641a8ee'.
+The following example lists applications that match the **id** specified in the Teams app manifest. In the example, the manifest ID of the Teams app is `cf1ba4c7-f94e-4d80-ba90-5594b641a8ee`.
#### Request
+The following is an example of a request.
# [HTTP](#tab/http) <!-- {
GET https://graph.microsoft.com/beta/appCatalogs/teamsApps?$filter=externalId e
#### Response
+The following is an example of the response.
+ <!-- { "blockType": "response", "name": "list_teamsapp_filter_externalid",
Content-Type: application/json
### Example 4: List applications with a given ID, and return the submission review state
-The following example lists applications with a given ID, and expands **appDefinitions** to return the **publishingState**, which reflects the app's submission review state. `Submitted` means the review is pending, `published` means the app was approved by the admin, and `rejected` means the app was rejected by the admin.
+The following example lists applications with a given ID, and expands **appDefinitions** to return the **publishingState**, which reflects the submission review state of the app. `Submitted` means the review is pending, `published` means the app was approved by the admin, and `rejected` means the app was rejected by the admin.
#### Request
+The following is an example of a request.
# [HTTP](#tab/http) <!-- {
GET https://graph.microsoft.com/beta/appCatalogs/teamsApps?$filter=id eq '876df
#### Response
+The following is an example of the response.
+ <!-- { "blockType": "response", "name": "list_teamsapp_with_filter_expand_appdefinitions",
Content-Type: application/json
{ "id": "876df28f-2e78-423b-94a5-44181bd0e225", "externalId": "f31b1263-ba99-435a-a679-911d24850d7c",
- "name": "Test App",
- "version": "1.0.1",
- "distributionMethod": "Organization",
+ "displayName": "Test App",
+ "distributionMethod": "organization",
"appDefinitions": [ { "id": "NGQyMGNiNDUtZWViYS00ZTEyLWE3YzktMGQ0NDgzYjYxNzU2IyMxLjAuMA==",
The following example lists only those apps in the catalog that contain a bot.
#### Request
+The following is an example of a request.
# [HTTP](#tab/http) <!-- {
GET https://graph.microsoft.com/beta/appCatalogs/teamsApps?$expand=appDefinitio
#### Response
+The following is an example of the response.
+ <!-- { "blockType": "response", "name": "list_teamsapp_with_bots",
The following example lists only those apps that can be installed in the persona
#### Request
+The following is an example of a request.
# [HTTP](#tab/http) <!-- {
GET https://graph.microsoft.com/beta/appCatalogs/teamsApps?$expand=appDefinitio
- #### Response
+The following is an example of the response.
+ <!-- { "blockType": "response", "name": "list_teamsapp_in_personal_scope",
v1.0 Application Post Calls https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-post-calls.md
Content-Type: application/json
] } ```
+>**Note:** Call establishing/established notifications may arrive out of order.
#### Notification - established
Content-Type: application/json
] } ```
+>**Note:** Call establishing/established notifications may arrive out of order.
#### Notification - content sharing started
Content-Type: application/json
} ```
+>**Note:** Call establishing/established notifications may arrive out of order.
#### Notification - established
Content-Type: application/json
] } ```
+>**Note:** Call establishing/established notifications may arrive out of order.
#### Notification - roster
v1.0 Application Post Onlinemeetings https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-post-onlinemeetings.md
The following is an example of the response.
} ```
-<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
-2015-10-25 14:57:30 UTC -->
-<!--
-{
- "type": "#page.annotation",
- "description": "Create onlineMeeting",
- "keywords": "",
- "section": "documentation",
- "tocPath": "",
- "suppressions": [
- ]
-}
>- ### Example 3: Create an online meeting that requires a passcode The following example shows how to add a passcode to a meeting. The passcode is used when you join a meeting with a **joinMeetingId**. For more details, see [joinMeetingIdSettings](../resources/joinmeetingidsettings.md).+ #### Request The following is an example of a request. >**Note:** The passcode is automatically generated and a custom passcode is not supported. +
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "create-online-meeting-with-passcode"
+}-->
+ ```http POST https://graph.microsoft.com/beta/me/onlineMeetings Content-Type: application/json
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.
The following is an example of the response.
>**Note:** The response object shown here might be shortened for readability. <!-- {
- "blockType": "example",
+ "blockType": "response",
"truncated": true, "@odata.type": "microsoft.graph.onlineMeeting" } -->
Content-Type: application/json
### Example 4: Create an online meeting that does not require a passcode When **isPasscodeRequired** is set to `false` or when **joinMeetingIdSettings** is not specified in the request, the generated online meeting will not have a passcode.+ #### Request The following is an example of a request. +
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "create-online-meeting-without-passcode"
+}-->
+ ```http POST https://graph.microsoft.com/beta/me/onlineMeetings Content-Type: application/json
Content-Type: application/json
} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++ or ```http
The following is an example of the response.
>**Note:** The response object shown here might be shortened for readability. <!-- {
- "blockType": "example",
+ "blockType": "response",
"truncated": true, "@odata.type": "microsoft.graph.onlineMeeting" } -->
Content-Type: application/json
} } ```+
+<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
+2015-10-25 14:57:30 UTC -->
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Create onlineMeeting",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": [
+ ]
+}
+-->
v1.0 Application Setverifiedpublisher https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-setverifiedpublisher.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/go/application-setverifiedpublisher-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/application-setverifiedpublisher-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Attacksimulationroot Create Simulation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/attacksimulationroot-create-simulation.md
+
+ Title: "Create simulation"
+description: "Create an attack simulation campaign for a tenant."
+
+ms.localizationpriority: medium
++
+# Create simulation
+
+Namespace: microsoft.graph
++
+Create an attack simulation campaign for a tenant.
+
+## 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) | AttackSimulation.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | AttackSimulation.ReadWrite.All |
+
+## HTTP request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+```http
+POST /security/attackSimulation/simulations
+```
+
+## Request headers
+
+|Header |Value |
+||-|
+|Authorization |Bearer {token}. Required.|
+|Content-Type |application/json |
+
+## Request body
+
+In the request body, supply a JSON representation of a [simulation](../resources/simulation.md) object.
+
+The following table shows the properties that are required when you create the simulation.
+
+| Property | Type | Description |
+|:-|:|:|
+|attackTechnique|[simulationAttackTechnique](../resources/simulation.md#simulationattacktechnique-values)|The social engineering technique used in the attack simulation and training campaign. Supports `$filter` and `$orderby`. Possible values are: `unknown`, `credentialHarvesting`, `attachmentMalware`, `driveByUrl`, `linkInAttachment`, `linkToMalwareFile`, `unknownFutureValue`. For more information on the types of social engineering attack techniques, see [simulations](/microsoft-365/security/office-365-security/attack-simulation-training-get-started?view=o365-worldwide&preserve-view=true#simulations).|
+|attackType|[simulationAttackType](../resources/simulation.md#simulationattacktype-values)|Attack type of the attack simulation and training campaign. Supports `$filter` and `$orderby`. Possible values are: `unknown`, `social`, `cloud`, `endpoint`, `unknownFutureValue`.|
+|completionDateTime|DateTimeOffset|Date and time of completion of the attack simulation and training campaign. Supports `$filter` and `$orderby`.|
+|createdBy|[emailIdentity](../resources/emailidentity.md)|Identity of the user who created the attack simulation and training campaign.|
+|createdDateTime|DateTimeOffset|Date and time of creation of the attack simulation and training campaign.|
+|displayName|String|Display name of the attack simulation and training campaign. Supports `$filter` and `$orderby`.|
+|durationInDays|Int32|Simulation duration in days.|
+|includedAccountTarget|[accountTargetContent](../resources/accounttargetcontent.md)|Users targeted in the simulation.|
+|lastModifiedBy|[emailIdentity](../resources/emailidentity.md)|Identity of the user who most recently modified the attack simulation and training campaign.|
+|launchDateTime|DateTimeOffset|Date and time of the launch/start of the attack simulation and training campaign. Supports `$filter` and `$orderby`.|
+|payloadDeliveryPlatform|payloadDeliveryPlatform|Method of delivery of the phishing payload used in the attack simulation and training campaign. Possible values are: `unknown`, `sms`, `email`, `teams`, `unknownFutureValue`.|
+|status|[simulationStatus](../resources/simulation.md#simulationstatus-values)|Status of the attack simulation and training campaign. Supports `$filter` and `$orderby`. Possible values are: `unknown`, `draft`, `running`, `scheduled`, `succeeded`, `failed`, `cancelled`, `excluded`, `unknownFutureValue`.|
+
+## Response
+
+If successful, this method returns a `202 Accepted` response code and a tracking header named `location` in the response.
+
+## Examples
+
+### Request
+
+The following is an example of a request.
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "create_simulation"
+}
+-->
+```http
+POST https://graph.microsoft.com/beta/security/attackSimulation/simulations
+Content-type: application/json
+
+{
+ "displayName": "Graph Simulation",
+ "payloadDeliveryPlatform": "email",
+ "payload@odata.bind":"https://graph.microsoft.com/beta/security/attacksimulation/payloads/12345678-9abc-def0-123456789a",
+ "durationInDays": 7,
+ "attackTechnique": "credentialHarvesting",
+ "attackType": "social",
+ "status": "scheduled",
+ "completionDateTime": "2022-09-16T06:13:08.4297612Z",
+ "launchDateTime": "2022-09-05T06:13:08.4297612Z",
+ "includedAccountTarget": {
+ "@odata.type": "#microsoft.graph.addressBookAccountTargetContent",
+ "type" : "addressBook",
+ "accountTargetEmails" : [
+ "john@contoso.com"
+ ]
+ },
+}
+```
+
+# [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.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+
+```http
+HTTP/1.1 202 Accepted
+```
v1.0 Attacksimulationroot Delete Simulation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/attacksimulationroot-delete-simulation.md
+
+ Title: "Delete simulation"
+description: "Delete an attack simulation campaign for a tenant."
+
+ms.localizationpriority: medium
++
+# Delete simulation
+
+Namespace: microsoft.graph
++
+Delete an attack simulation campaign for a tenant.
+
+## 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) | AttackSimulation.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | AttackSimulation.ReadWrite.All |
+
+## HTTP request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+```http
+DELETE /security/attackSimulation/simulations/{simulationId}
+```
+
+## Request headers
+
+|Header |Value |
+||-|
+|Authorization |Bearer {token}. Required.|
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code in the response.
+
+## Examples
+
+### Request
+
+The following is an example of a request.
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "delete_simulation",
+ "sampleKeys": ["2f5548d1-0dd8-4cc8-9de0-e0d6ec7ea3dc"]
+}
+-->
+```http
+DELETE https://graph.microsoft.com/beta/security/attackSimulation/simulations/2f5548d1-0dd8-4cc8-9de0-e0d6ec7ea3dc
+```
+
+# [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 204 No Content
+```
v1.0 Attacksimulationroot Get Excludedaccounttarget https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/attacksimulationroot-get-excludedaccounttarget.md
+
+ Title: "Get excludedAccountTarget"
+description: "Get excluded account targets (users) for an attack simulation campaign for a tenant."
+
+ms.localizationpriority: medium
++
+# Get excludedAccountTarget
+
+Namespace: microsoft.graph
++
+Get excluded account targets (users) for an attack simulation campaign for a tenant.
+
+## 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) | AttackSimulation.Read.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | AttackSimulation.Read.All |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /security/attackSimulation/simulations/{simulationId}/excludedaccounttarget
+```
+
+## 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 an [accountTargetContent](../resources/accounttargetcontent.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of a request.
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_excludedaccounttarget",
+ "sampleKeys": ["f1b13829-3829-f1b1-2938-b1f12938b1a"]
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/security/attackSimulation/simulations/f1b13829-3829-f1b1-2938-b1f12938b1a/excludedAccountTarget
+```
+
+# [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.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.accountTargetContent"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.addressbookaccounttargetcontent",
+ "type" : "addressBook",
+ "accountTargetEmails" : [
+ "john@contoso.com"
+ ]
+}
+```
v1.0 Attacksimulationroot Get Includedaccounttarget https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/attacksimulationroot-get-includedaccounttarget.md
+
+ Title: "Get includedAccountTarget"
+description: "Get included account targets (users) for an attack simulation campaign for a tenant."
+
+ms.localizationpriority: medium
++
+# Get includedAccountTarget
+
+Namespace: microsoft.graph
++
+Get included account targets (users) for an attack simulation campaign for a tenant.
+
+## 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) | AttackSimulation.Read.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | AttackSimulation.Read.All |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /security/attackSimulation/simulations/{simulationId}/includedaccounttarget
+```
+
+## 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 an [accountTargetContent](../resources/accounttargetcontent.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of a request.
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_includedaccounttarget",
+ "sampleKeys": ["f1b13829-3829-f1b1-2938-b1f12938b1a"]
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/security/attackSimulation/simulations/f1b13829-3829-f1b1-2938-b1f12938b1a/includedAccountTarget
+```
+
+# [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.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.accountTargetContent"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.addressbookaccounttargetcontent",
+ "type" : "addressBook",
+ "accountTargetEmails" : [
+ "john@contoso.com"
+ ]
+}
+```
v1.0 Attacksimulationroot Get Operation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/attacksimulationroot-get-operation.md
+
+ Title: "Get attackSimulationOperation"
+description: "Get an attack simulation operation to track a long-running operation request for a tenant."
+
+ms.localizationpriority: medium
++
+# Get attackSimulationOperation
+
+Namespace: microsoft.graph
++
+Get an attack simulation operation to track a long-running operation request for a tenant.
+
+## 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) | AttackSimulation.Read.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | AttackSimulation.Read.All |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /security/attackSimulation/operations/{operationsId}
+```
+
+## 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 an [attackSimulationOperation](../resources/attacksimulationoperation.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of a request.
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_attackSimulationOperation",
+ "sampleKeys": ["f1b13829-3829-f1b1-2938-b1f12938b1a"]
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/security/attackSimulation/operations/f1b13829-3829-f1b1-2938-b1f12938b1a
+```
+
+# [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.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.attackSimulationOperation"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "id": "2f5548d1-0dd8-4cc8-9de0-e0d6ec7ea3dc",
+ "tenantId": "2f5548d1-0dd8-4cc8-9de0-e0d6ec7ea3ss",
+ "statusDetail": "Creating new simulation",
+ "createdDateTime": "2022-01-12T05:27:18.7957961Z",
+ "lastActionDateTime": "2022-01-12T05:27:18.7957961Z",
+ "type": "createSimulation",
+ "status": "notStarted",
+ "percentageCompleted": 0
+}
+```
v1.0 Attacksimulationroot Get Payload https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/attacksimulationroot-get-payload.md
+
+ Title: "Get payload"
+description: "Get an attack simulation campaign payload for a tenant."
+
+ms.localizationpriority: medium
++
+# Get payload
+
+Namespace: microsoft.graph
++
+Get an attack simulation campaign payload for a tenant.
+
+## 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) | AttackSimulation.Read.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | AttackSimulation.Read.All |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /security/attackSimulation/payloads/{payloadId}
+```
+
+## Optional query parameters
+
+This method supports the `$count`, `$filter`, `$orderby`, `$skipToken`, `$top`, and `$select` [OData query parameters](/graph/query-parameters) to help customize the response. You can use the `$filter` and `$orderby` query parameters on the **attackTechnique**, **attackType**, **completionDateTime**, **displayName**, **isAutomated**, **launchDateTime**, and **status** properties.
+
+If the result set spans multiple pages, the response body contains an `@odata.nextLink` that you can use to page through the result set.
+
+The following are examples of their use:
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /security/attackSimulation/payloads/{payloadId}?$count=true
+GET /security/attackSimulation/payloads/{payloadId}?$filter={property} eq '{property-value}'
+GET /security/attackSimulation/payloads/{payloadId}?$filter={property} eq '{property-value}'&$top=5
+GET /security/attackSimulation/payloads/{payloadId}?$orderby={property}
+GET /security/attackSimulation/payloads/{payloadId}?$skipToken={skipToken}
+GET /security/attackSimulation/payloads/{payloadId}?$top=1
+GET /security/attackSimulation/payloads/{payloadId}?$select={property}
+```
+
+## 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 [payload](../resources/payload.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_payload",
+ "sampleKeys": ["f1b13829-3829-f1b1-2938-b1f12938b1a"]
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/security/attackSimulation/payload/f1b13829-3829-f1b1-2938-b1f12938b1a
+```
+
+### 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.payload"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#security/attackSimulation/payloads/2f5548d1-0dd8-4cc8-9de0-e0d6ec7ea3dc",
+ "id": "2f5548d1-0dd8-4cc8-9de0-e0d6ec7ea3dc",
+ "name": "AttackSimTest Payload",
+ "description": "AttackSim Test Payload",
+ "simulationAttackType": "social",
+ "platform": "email",
+ "isAutomated": null,
+ "status": "draft",
+ "source": "tenant",
+ "language": "en",
+ "predictedCompromiseRate": 20.0,
+ "complexity": "medium",
+ "attackTechnique": "credentialHarvesting",
+ "createdBy": {
+ "email": "faiza@contoso.com",
+ "id": "121212",
+ "displayName": "Faiza"
+ },
+ "createdDateTime": "2022-01-12T03:15:01.5906699Z",
+ "lastModifiedBy": {
+ "email": "faiza@contoso.com",
+ "id": "121212",
+ "displayName": "Faiza"
+ },
+ "lastModifiedDateTime": "2021-10-07T12:23:18.8157586Z",
+ "theme": "personalizedOffer",
+ "brand": "microsoft",
+ "industry": "IT",
+ "isCurrentEvent": false,
+ "isControversial": false,
+ "detail" : null,
+ "payloadTags": []
+}
+```
v1.0 Attacksimulationroot Get Payloadsdetails https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/attacksimulationroot-get-payloadsdetails.md
+
+ Title: "Get payloadDetail"
+description: "Get an attack simulation campaign payload detail for a tenant."
+
+ms.localizationpriority: medium
++
+# Get payloadDetail
+
+Namespace: microsoft.graph
++
+Get an attack simulation campaign payload detail for a tenant.
+
+## 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) | AttackSimulation.Read.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | AttackSimulation.Read.All |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /security/attackSimulation/payloads/{payloadId}/detail
+```
+
+## Optional query parameters
+
+This method supports the `$count`, `$filter`, `$orderby`, `$skipToken`, `$top`, and `$select` [OData query parameters](/graph/query-parameters) to help customize the response. You can use the `$filter` and `$orderby` query parameters on the **attackTechnique**, **attackType**, **completionDateTime**, **displayName**, **isAutomated**, **launchDateTime**, and **status** properties.
+
+If the result set spans multiple pages, the response body contains an `@odata.nextLink` that you can use to page through the result set.
+
+The following are examples of their use:
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /security/attackSimulation/payloads/{payloadId}/detail?$count=true
+GET /security/attackSimulation/payloads/{payloadId}/detail?$filter={property} eq '{property-value}'
+GET /security/attackSimulation/payloads/{payloadId}/detail?$filter={property} eq '{property-value}'&$top=5
+GET /security/attackSimulation/payloads/{payloadId}/detail?$orderby={property}
+GET /security/attackSimulation/payloads/{payloadId}/detail?$skipToken={skipToken}
+GET /security/attackSimulation/payloads/{payloadId}/detail?$top=1
+GET /security/attackSimulation/payloads/{payloadId}/detail?$select={property}
+```
+
+## 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 [payloadDetail](../resources/payloaddetail.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_payloadDetail",
+ "sampleKeys": ["f1b13829-3829-f1b1-2938-b1f12938b1a"]
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/security/attackSimulation/payload/f1b13829-3829-f1b1-2938-b1f12938b1a/detail
+```
+
+### 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.payloadDetail"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#security/attackSimulation/payloads/2f5548d1-0dd8-4cc8-9de0-e0d6ec7ea3dc/detail",
+ "fromName": "faiza",
+ "fromEmail": "faiza@contoso.com",
+ "addIsExternalSender": false,
+ "subject": "Payload Detail",
+ "content": "<meta http-equiv=\"Content-Type\" content=\"text/html>\">",
+ "phishingUrl": "http://www.widgetsinc10+.com",
+ "coachMarks": [
+ {
+ "indicator": "URL hyperlinking",
+ "description": "URL hyperlinking hides the true URL behind text; the text can also look like another link",
+ "language": "en",
+ "order": "0",
+ "isValid": true,
+ "coachmarkLocation": {
+ "offset": 144,
+ "length": 6,
+ "type": "messageBody"
+ }
+ }
+ ]
+}
+```
v1.0 Attacksimulationroot List Payloads https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/attacksimulationroot-list-payloads.md
+
+ Title: "List payloads"
+description: "Get a list of payloads for attack simulation campaigns."
+
+ms.localizationpriority: medium
++
+# List payloads
+
+Namespace: microsoft.graph
++
+Get a list of payloads for attack simulation campaigns. This operation expects the mandatory parameter **source** to filter and query the respective data source.
+
+## 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) | AttackSimulation.Read.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | AttackSimulation.Read.All |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /security/attackSimulation/payloads?$filter=source eq 'Tenant'
+```
+
+## Optional query parameters
+
+This method supports the `$count`, `$filter`, `$orderby`, `$skipToken`, `$top`, and `$select` [OData query parameters](/graph/query-parameters) to help customize the response. You can use the `$filter` and `$orderby` query parameters on the **attackTechnique**, **attackType**, **completionDateTime**, **displayName**, **isAutomated**, **launchDateTime**, and **status** properties.
+
+If the result set spans multiple pages, the response body contains an `@odata.nextLink` that you can use to page through the result set.
+
+The following are examples of their use:
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /security/attackSimulation/payloads?$filter=source eq 'Tenant' and $count=true
+GET /security/attackSimulation/payloads?$filter=source eq 'Tenant' and $filter={property} eq '{property-value}'
+GET /security/attackSimulation/payloads?$filter=source eq 'Tenant' and $filter={property} eq '{property-value}'&$top=5
+GET /security/attackSimulation/payloads?$filter=source eq 'Tenant' and $orderby={property}
+GET /security/attackSimulation/payloads?$filter=source eq 'Tenant' and $skipToken={skipToken}
+GET /security/attackSimulation/payloads?$filter=source eq 'Tenant' and $top=1
+GET /security/attackSimulation/payloads?$filter=source eq 'Tenant' and $select={property}
+```
+
+## 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 [payload](../resources/payload.md) objects in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of a request.
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "list_payload"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/security/attackSimulation/payloads?$filter=source eq 'Tenant'
+```
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++
+### Response
+
+The following is an example of a response.
+
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.payload)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#security/attackSimulation/payloads?$filter=source eq 'Tenant'",
+ "@odata.nextLink": "https://graph.microsoft.com/beta/security/attackSimulation/payloads?$filter=source+eq+%27Tenant%27&$skiptoken=MyZRVkZCUVVGQlFVRXZMeTh2THk4dkx5OHZPSGxCUVVGQk4yZDZMMFZwZFRjcmF6WjJURk14TWtKVk9WYzNaejA5",
+ "value": [
+ {
+ "id": "2f5548d1-0dd8-4cc8-9de0-e0d6ec7ea3dc",
+ "name": "AttackSimTest Payload",
+ "description": "AttackSim Test Payload",
+ "attackType": "social",
+ "platform": "email",
+ "isAutomated": null,
+ "status": "draft",
+ "source": "tenant",
+ "language": "en",
+ "predictedCompromiseRate": 20.0,
+ "complexity": "medium",
+ "attackTechnique": "credentialHarvesting",
+ "createdBy": {
+ "email": "faiza@contoso.com",
+ "id": "121212",
+ "displayName": "Faiza"
+ },
+ "createdDateTime": "2022-01-12T03:15:01.5906699Z",
+ "lastModifiedBy": {
+ "email": "faiza@contoso.com",
+ "id": "121212",
+ "displayName": "Faiza"
+ },
+ "lastModifiedDateTime": "2021-10-07T12:23:18.8157586Z",
+ "theme": "personalizedOffer",
+ "Brand": "microsoft",
+ "payloadIndustry": "IT",
+ "isCurrentEvent": false,
+ "isControversial": false,
+ "payloadTags": [],
+ "detail" : null
+ }
+ ]
+}
+```
v1.0 Attacksimulationroot List Simulations https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/attacksimulationroot-list-simulations.md
Content-Type: application/json
}, "launchDateTime": "2021-01-01T02:01:01.01Z", "completionDateTime": "2021-01-07T01:01:01.01Z",
+ "durationInDays": 4,
"isAutomated": false, "automationId": "f1b13829-3829-f1b1-2938-b1f12938b1ab", "payloadDeliveryPlatform": "email"
v1.0 Attacksimulationroot Update Simulation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/attacksimulationroot-update-simulation.md
+
+ Title: "Update simulation"
+description: "Update an attack simulation campaign for a tenant."
+
+ms.localizationpriority: medium
++
+# Update simulation
+
+Namespace: microsoft.graph
++
+Update an attack simulation campaign for a tenant.
+
+## 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) | AttackSimulation.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | AttackSimulation.ReadWrite.All |
+
+## HTTP request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+```http
+PATCH /security/attackSimulation/simulations/{simulationId}
+```
+
+## Request headers
+
+|Header |Value |
+||-|
+|Authorization |Bearer {token}. Required.|
+|Content-Type |application/json |
+
+## Request body
++
+|Property|Type|Description|
+|:|:|:|
+|attackTechnique|[simulationAttackTechnique](../resources/simulation.md#simulationattacktechnique-values)|The social engineering technique used in the attack simulation and training campaign. Supports `$filter` and `$orderby`. Possible values are: `unknown`, `credentialHarvesting`, `attachmentMalware`, `driveByUrl`, `linkInAttachment`, `linkToMalwareFile`, `unknownFutureValue`. For more information on the types of social engineering attack techniques, see [simulations](/microsoft-365/security/office-365-security/attack-simulation-training-get-started?view=o365-worldwide&preserve-view=true#simulations).|
+|attackType|[simulationAttackType](../resources/simulation.md#simulationattacktype-values)|Attack type of the attack simulation and training campaign. Supports `$filter` and `$orderby`. Possible values are: `unknown`, `social`, `cloud`, `endpoint`, `unknownFutureValue`.|
+|completionDateTime|DateTimeOffset|Date and time of completion of the attack simulation and training campaign. Supports `$filter` and `$orderby`.|
+|description|String|Description of the attack simulation and training campaign.|
+|displayName|String|Display name of the attack simulation and training campaign. Supports `$filter` and `$orderby`.|
+|durationInDays|Int32|Simulation duration in days.|
+|excludedAccountTarget|[accountTargetContent](../resources/accounttargetcontent.md)|Users excluded from the simulation.|
+|includedAccountTarget|[accountTargetContent](../resources/accounttargetcontent.md)|Users targeted in the simulation.|
+|lastModifiedBy|[emailIdentity](../resources/emailidentity.md)|Identity of the user who most recently modified the attack simulation and training campaign.|
+|lastModifiedDateTime|DateTimeOffset|Date and time of the most recent modification of the attack simulation and training campaign.|
+|launchDateTime|DateTimeOffset|Date and time of the launch/start of the attack simulation and training campaign. Supports `$filter` and `$orderby`.|
+|payloadDeliveryPlatform|payloadDeliveryPlatform|Method of delivery of the phishing payload used in the attack simulation and training campaign. Possible values are: `unknown`, `sms`, `email`, `teams`, `unknownFutureValue`.|
+|status|[simulationStatus](../resources/simulation.md#simulationstatus-values)|Status of the attack simulation and training campaign. Supports `$filter` and `$orderby`. Possible values are: `unknown`, `draft`, `running`, `scheduled`, `succeeded`, `failed`, `cancelled`, `excluded`, `unknownFutureValue`.|
+
+## Response
+
+If successful, this method returns a `202 Accepted` response code and a tracking header named `location` in the response.
+
+## Examples
+
+### Request
+
+The following is an example of a request.
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "update_simulation",
+ "sampleKeys": ["2f5548d1-0dd8-4cc8-9de0-e0d6ec7ea3dc"]
+}
+-->
+```http
+PATCH https://graph.microsoft.com/beta/security/attackSimulation/simulations/2f5548d1-0dd8-4cc8-9de0-e0d6ec7ea3dc
+Content-type: application/json
+
+{
+ "id": "2f5548d1-0dd8-4cc8-9de0-e0d6ec7ea3dc",
+ "displayName": "Graph Simulation",
+ "description": "Test simulation created using postman",
+ "payloadDeliveryPlatform": "email",
+ "payload@odata.bind":"https://graph.microsoft.com/beta/security/attacksimulation/payloads/12345678-9abc-def0-123456789a",
+ "durationInDays": 7,
+ "attackTechnique": "credentialHarvesting",
+ "attackType": "social",
+ "status": "scheduled",
+ "completionDateTime": "2022-09-16T06:13:08.4297612Z",
+ "launchDateTime": "2022-09-05T06:13:08.4297612Z",
+ "includedAccountTarget": {
+ "@odata.type": "#microsoft.graph.addressBookAccountTargetContent",
+ "type" : "addressBook",
+ "accountTargetEmails" : [
+ "faiza@contoso.com"
+ ]
+ },
+ "excludedAccountTarget": {
+ "@odata.type": "#microsoft.graph.addressBookAccountTargetContent",
+ "type" : "addressBook",
+ "accountTargetEmails" : [
+ "sam@contoso.com"
+ ]
+ }
+}
+```
+
+# [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
+}
+-->
+
+```http
+HTTP/1.1 202 Accepted
+```
v1.0 Authentication List Methods https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authentication-list-methods.md
Title: "List methods"
-description: "Retrieve a list of authentication method objects."
+description: "Retrieve a list of authentication methods registered to a user."
ms.localizationpriority: medium ms.prod: "identity-and-sign-in"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve a list of [authenticationMethod](../resources/authenticationmethod.md) objects. This API returns only authentication methods supported on this API version. See [Azure AD authentication methods API overview](../resources/authenticationmethods-overview.md) for a list of currently supported methods.
-
+Retrieve a list of authentication methods registered to a user. The authentication methods are defined by the types derived from the [authenticationMethod](../resources/authenticationmethod.md) resource type, and only the methods supported on this API version. See [Azure AD authentication methods API overview](../resources/authenticationmethods-overview.md) for a list of currently supported methods.
## Permissions
v1.0 Bundle Additem https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bundle-additem.md
For information about error responses, see [Microsoft Graph error responses and
The following is an example of a request that adds an existing item to the specified bundle.
-# [HTTP](#tab/http)
<!-- {"blockType": "request", "name": "add-to-bundle", "isCollection": true, "@odata.type": "microsoft.graph.driveItem", "tags": "onedrive.only" } --> ```http
Content-Type: application/json
} ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Java](#tab/java)
--- ### Response
v1.0 Bundle Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bundle-delete.md
The following is an example of a request.
DELETE https://graph.microsoft.com/beta/drive/items/{bundle-id} ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Java](#tab/java)
- # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/delete-bundle-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Bundle Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bundle-get.md
The following is an example of a request.
GET https://graph.microsoft.com/v1.0/drive/bundles/{bundle-id} ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Java](#tab/java)
- # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/get-bundle-metadata-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
The following is an example of a request.
GET https://graph.microsoft.com/v1.0/drive/items/{bundle-id}?expand=children ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Java](#tab/java)
- # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/get-bundle-and-children-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Bundle List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bundle-list.md
The following is an example of a request.
GET https://graph.microsoft.com/beta/drive/bundles ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Java](#tab/java)
- # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/list-all-bundles-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
The following is an example of a request.
GET https://graph.microsoft.com/beta/drive/bundles?filter=bundle/album%20ne%20null ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Java](#tab/java)
- # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/list-album-bundles-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Bundle Removeitem https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bundle-removeitem.md
For information about error responses, see [Microsoft Graph error responses and
The following is an example of a request.
-# [HTTP](#tab/http)
<!-- {"blockType": "request", "name": "remove-from-bundle" } --> ```http DELETE https://graph.microsoft.com/beta/drive/bundles/{bundle-id}/children/{item-id} ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Java](#tab/java)
--- ### Response
v1.0 Bundle Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/bundle-update.md
Content-Type: application/json
} ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Java](#tab/java)
- # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/rename-bundle-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Businessscenario Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/businessscenario-delete.md
+
+ Title: "Delete businessScenario"
+description: "Delete a businessScenario object."
+
+ms.localizationpriority: medium
++
+# Delete businessScenario
+
+Namespace: microsoft.graph
++
+Delete a [businessScenario](../resources/businessscenario.md) object. The deletion of a scenario causes all data associated with the scenario to be deleted.
+
+## 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)|BusinessScenarioConfig.ReadWrite.OwnedBy, BusinessScenarioConfig.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application| BusinessScenarioConfig.ReadWrite.OwnedBy|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /solutions/businessScenarios/{businessScenarioId}
+```
+
+## 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_businessscenario",
+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d"]
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d
+```
+
+# [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 204 No Content
+```
v1.0 Businessscenario Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/businessscenario-get.md
+
+ Title: "Get businessScenario"
+description: "Read the properties and relationships of a businessScenario object."
+
+ms.localizationpriority: medium
++
+# Get businessScenario
+
+Namespace: microsoft.graph
++
+Read the properties and relationships of a [businessScenario](../resources/businessscenario.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)|BusinessScenarioConfig.Read.OwnedBy, BusinessScenarioConfig.ReadWrite.OwnedBy, BusinessScenarioConfig.Read.All, BusinessScenarioConfig.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BusinessScenarioConfig.Read.OwnedBy, BusinessScenarioConfig.ReadWrite.OwnedBy|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+For a specific business scenario based on its ID (primary key):
+
+``` http
+GET /solutions/businessScenarios/{businessScenarioId}
+```
+
+For a specific business scenario based on its unique name:
+
+``` http
+GET /solutions/businessScenarios(uniqueName='{uniqueName}')
+```
+
+## 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 [businessScenario](../resources/businessscenario.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_businessscenario",
+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d"]
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d
+```
+
+# [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.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.businessScenario"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.businessScenario",
+ "id": "c5d514e6c6864911ac46c720affb6e4d",
+ "displayName": "Contoso Order Tracking",
+ "uniqueName": "com.contoso.apps.ordertracking",
+ "ownerAppIds": [
+ "44109254-4b2b-7a33-76ee-c890a167b295"
+ ]
+}
+```
v1.0 Businessscenario Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/businessscenario-update.md
+
+ Title: "Update businessScenario"
+description: "Update the properties of a businessScenario object."
+
+ms.localizationpriority: medium
++
+# Update businessScenario
+
+Namespace: microsoft.graph
++
+Update the properties of a [businessScenario](../resources/businessscenario.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)|BusinessScenarioConfig.ReadWrite.OwnedBy, BusinessScenarioConfig.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BusinessScenarioConfig.ReadWrite.OwnedBy|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+For a specific business scenario based on its ID (primary key):
+
+``` http
+PATCH /solutions/businessScenarios/{businessScenarioId}
+```
+
+For a specific business scenario based on its unique name:
+
+``` http
+PATCH /solutions/businessScenarios(uniqueName='{uniqueName}')
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
++
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|Display name of the scenario. Required.|
+|ownerAppIds|String collection|Identifiers of applications that are authorized to work with this scenario. The application that creates the scenario will be automatically added to the list. Optional.|
+
+## Response
+
+If successful, this method returns a `200 OK` response code and an updated [businessScenario](../resources/businessscenario.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "update_businessscenario",
+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d"]
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d
+Content-Type: application/json
+
+{
+ "ownerAppIds": [
+ "44109254-4b2b-7a33-76ee-c890a167b295", "13eb9d8b-1d63-4153-9417-3a69ab200a78"
+ ]
+}
+```
+
+# [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.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.businessScenario"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.businessScenario",
+ "id": "c5d514e6c6864911ac46c720affb6e4d",
+ "displayName": "Contoso Order Tracking",
+ "uniqueName": "com.contoso.apps.ordertracking",
+ "ownerAppIds": [
+ "44109254-4b2b-7a33-76ee-c890a167b295", "13eb9d8b-1d63-4153-9417-3a69ab200a78"
+ ]
+}
+```
v1.0 Businessscenarioplanner Delete Tasks https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/businessscenarioplanner-delete-tasks.md
+
+ Title: "Delete businessScenarioTask"
+description: "Delete a businessScenarioTask object."
+
+ms.localizationpriority: medium
++
+# Delete businessScenarioTask
+
+Namespace: microsoft.graph
++
+Delete a [businessScenarioTask](../resources/businessscenariotask.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)|BusinessScenarioData.ReadWrite.OwnedBy|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application| BusinessScenarioData.ReadWrite.OwnedBy|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /solutions/businessScenarios/{businessScenarioId}/planner/tasks/{businessScenarioTaskId}
+```
+
+## 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_businessscenariotask",
+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d", "pmc1rS1Io0C3rXQhyXIsNmUAOeIi"]
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/tasks/pmc1rS1Io0C3rXQhyXIsNmUAOeIi
+```
+
+# [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 204 No Content
+```
v1.0 Businessscenarioplanner Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/businessscenarioplanner-get.md
+
+ Title: "Get businessScenarioPlanner"
+description: "Read the properties and relationships of a businessScenarioPlanner object."
+
+ms.localizationpriority: medium
++
+# Get businessScenarioPlanner
+
+Namespace: microsoft.graph
++
+Read the properties and relationships of a [businessScenarioPlanner](../resources/businessscenarioplanner.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)|BusinessScenarioConfig.Read.OwnedBy, BusinessScenarioConfig.ReadWrite.OwnedBy, BusinessScenarioConfig.Read.All, BusinessScenarioConfig.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BusinessScenarioConfig.Read.OwnedBy, BusinessScenarioConfig.ReadWrite.OwnedBy|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /solutions/businessScenarios/{businessScenarioId}/planner
+```
+
+## 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 [businessScenarioPlanner](../resources/businessscenarioplanner.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_businessscenarioplanner",
+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d"]
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner
+```
+
+# [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.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.businessScenarioPlanner"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.businessScenarioPlanner",
+ "id": "54379e10-f935-5776-7a30-445837f15655"
+}
+```
v1.0 Businessscenarioplanner Getplan https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/businessscenarioplanner-getplan.md
+
+ Title: "businessScenarioPlanner: getPlan"
+description: "Get information about the plannerPlan mapped to a given target."
+
+ms.localizationpriority: medium
++
+# businessScenarioPlanner: getPlan
+
+Namespace: microsoft.graph
++
+Get information about the [plannerPlan](../resources/plannerplan.md) mapped to a given target. If a **plannerPlan** doesn't exist for the specified target at the time of the request, a new plan will be created for the [businessScenario](../resources/businessscenario.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)|BusinessScenarioData.Read.OwnedBy, BusinessScenarioData.ReadWrite.OwnedBy|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BusinessScenarioData.Read.OwnedBy, BusinessScenarioData.ReadWrite.OwnedBy|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /solutions/businessScenarios/{businessScenarioId}/planner/getPlan
+```
+
+## 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 parameter that can be used with this action.
+
+|Parameter|Type|Description|
+|:|:|:|
+|target|[businessScenarioTaskTargetBase](../resources/businessscenariotasktargetbase.md)|Target for which to get the plan information.|
+
+## Response
+
+If successful, this action returns a `200 OK` response code and a [businessScenarioPlanReference](../resources/businessscenarioplanreference.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "businessscenarioplannerthis.getplan",
+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d"]
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/getPlan
+Content-Type: application/json
+
+{
+ "target": {
+ "@odata.type": "microsoft.graph.businessScenarioGroupTarget",
+ "taskTargetKind": "group",
+ "groupId": "7a339254-4b2b-4410-b295-c890a16776ee"
+ }
+}
+```
+
+# [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.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.businessScenarioPlanReference"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.businessScenarioPlanReference",
+ "id": "pmc1rS1Io0C3rXQhyXIsNmUAOeIi",
+ "title": "Order Tracking"
+}
+```
v1.0 Businessscenarioplanner List Tasks https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/businessscenarioplanner-list-tasks.md
+
+ Title: "List businessScenarioTasks"
+description: "Get a list of the businessScenarioTask objects and their properties."
+
+ms.localizationpriority: medium
++
+# List businessScenarioTasks
+Namespace: microsoft.graph
++
+Get a list of the [businessScenarioTask](../resources/businessscenariotask.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)|BusinessScenarioData.Read.OwnedBy, BusinessScenarioData.ReadWrite.OwnedBy|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BusinessScenarioData.Read.OwnedBy, BusinessScenarioData.ReadWrite.OwnedBy|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /solutions/businessScenarios/{businessScenarioId}/planner/tasks
+```
+
+## 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). You can query tasks with their context ID or location as filters.
+
+## 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 [businessScenarioTask](../resources/businessscenariotask.md) objects in the response body.
+
+## Examples
+
+### Example 1: Get all tasks for a scenario
+
+The following example shows a request that gets all tasks related to a scenario.
+
+#### Request
+
+The following is an example of a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "list_businessscenariotask",
+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d"]
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/tasks
+```
+
+# [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.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.businessScenarioTask)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.businessScenarioTask",
+ "title": "Customer order #12010",
+ "percentComplete": 0,
+ "priority": 5,
+ "id": "pmc1rS1Io0C3rXQhyXIsNmUAOeIi",
+ "target": {
+ "@odata.type": "microsoft.graph.businessScenarioGroupTarget",
+ "taskTargetKind": "group",
+ "groupId": "7a339254-4b2b-4410-b295-c890a16776ee"
+ },
+ "businessScenarioProperties": {
+ "externalObjectId": "Order#12010",
+ "externalContextId": "Warehouse-CA-36",
+ "externalObjectVersion": "000001",
+ "webUrl": "https://ordertracking.contoso.com/view?id=12010",
+ "externalBucketId": "deliveryBucket"
+ }
+ }
+ ]
+}
+```
+
+### Example 2: Get tasks associated with a specific externalContextId
+
+The following example shows a request that gets all tasks associated with a specific context.
+
+#### Request
+
+The following is an example of a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "list_businessscenariotask",
+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d"]
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/tasks?$filter=businessScenarioProperties/externalContextId eq 'Warehouse-CA-36'
+```
+
+# [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.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.businessScenarioTask)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.businessScenarioTask",
+ "title": "Customer order #12010",
+ "percentComplete": 0,
+ "priority": 5,
+ "id": "pmc1rS1Io0C3rXQhyXIsNmUAOeIi",
+ "target": {
+ "@odata.type": "microsoft.graph.businessScenarioGroupTarget",
+ "taskTargetKind": "group",
+ "groupId": "7a339254-4b2b-4410-b295-c890a16776ee"
+ },
+ "businessScenarioProperties": {
+ "externalObjectId": "Order#12010",
+ "externalContextId": "Warehouse-CA-36",
+ "externalObjectVersion": "000001",
+ "webUrl": "https://ordertracking.contoso.com/view?id=12010",
+ "externalBucketId": "deliveryBucket"
+ }
+ }
+ ]
+}
+```
+
+### Example 3: Get scenario tasks created in a specific group
+
+The following example shows a request that gets all tasks created in a specific [group](../resources/group.md).
+
+#### Request
+
+The following is an example of a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "list_businessscenariotask",
+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d"]
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/tasks?$filter=location/microsoft.graph.businessScenarioGroupTarget/groupId eq '7a339254-4b2b-4410-b295-c890a16776ee'
+```
+
+# [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.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.businessScenarioTask)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "#microsoft.graph.businessScenarioTask",
+ "title": "Customer order #12010",
+ "percentComplete": 0,
+ "priority": 5,
+ "id": "pmc1rS1Io0C3rXQhyXIsNmUAOeIi",
+ "target": {
+ "@odata.type": "microsoft.graph.businessScenarioGroupTarget",
+ "taskTargetKind": "group",
+ "groupId": "7a339254-4b2b-4410-b295-c890a16776ee"
+ },
+ "businessScenarioProperties": {
+ "externalObjectId": "Order#12010",
+ "externalContextId": "Warehouse-CA-36",
+ "externalObjectVersion": "000001",
+ "webUrl": "https://ordertracking.contoso.com/view?id=12010",
+ "externalBucketId": "deliveryBucket"
+ }
+ }
+ ]
+}
+```
v1.0 Businessscenarioplanner Post Tasks https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/businessscenarioplanner-post-tasks.md
+
+ Title: "Create businessScenarioTask"
+description: "Create a new businessScenarioTask object."
+
+ms.localizationpriority: medium
++
+# Create businessScenarioTask
+
+Namespace: microsoft.graph
++
+Create a new [businessScenarioTask](../resources/businessscenariotask.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)|BusinessScenarioData.ReadWrite.OwnedBy|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application| BusinessScenarioData.ReadWrite.OwnedBy|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /solutions/businessScenarios/{businessScenarioId}/planner/tasks
+```
+
+## 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 [businessScenarioTask](../resources/businessscenariotask.md) object.
+
+You can specify the following properties when you create a **businessScenarioTask**.
+
+|Property|Type|Description|
+|:|:|:|
+|appliedCategories|[plannerAppliedCategories](../resources/plannerappliedcategories.md)|The categories to which the task has been applied. For possible values, see [plannerAppliedCategories](../resources/plannerappliedcategories.md). Inherited from [plannerTask](../resources/plannertask.md).|
+|assigneePriority|String|Hint used to order items of this type in a list view. For details about the supported format, see [Using order hints in Planner](../resources/planner-order-hint-format.md). Inherited from [plannerTask](../resources/plannertask.md).|
+|assignments|[plannerAssignments](../resources/plannerassignments.md)|The set of assignees the task is assigned to. Inherited from [plannerTask](../resources/plannertask.md).|
+|bucketId|String|Bucket ID to which the task belongs. The bucket needs to be in the plan that the task is in. It is 28 characters long and case-sensitive. The [format validation](../resources/tasks-identifiers-disclaimer.md) is done on the service. Inherited from [plannerTask](../resources/plannertask.md).|
+|businessScenarioProperties|[businessScenarioProperties](../resources/businessscenarioproperties.md)|Scenario-specific properties of the task. **externalObjectId** and **externalBucketId** properties must be specified when creating a task. Required.|
+|conversationThreadId|String|Thread ID of the conversation on the task. This is the ID of the conversation thread object created in the **group**. Inherited from [plannerTask](../resources/plannertask.md).|
+|dueDateTime|DateTimeOffset|Date and time at which the task 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`. Inherited from [plannerTask](../resources/plannertask.md).|
+|orderHint|String|Hint used to order items of this type in a list view. For details about the supported format, see [Using order hints in Planner](../resources/planner-order-hint-format.md). Inherited from [plannerTask](../resources/plannertask.md).|
+|percentComplete|Int32|Percentage of task completion. When set to `100`, the task is considered completed. Inherited from [plannerTask](../resources/plannertask.md).|
+|planId|String|Identifier of the plan to which the task belongs. Inherited from [plannerTask](../resources/plannertask.md).|
+|priority|Int32|Priority of the task. Valid range of values is between `0` and `10` (inclusive), with increasing value being lower priority (`0` has the highest priority and `10` has the lowest priority). Currently, Planner interprets values `0` and `1` as "urgent", `2`, `3`, and `4` as "important", `5`, `6`, and `7` as "medium", and `8`, `9`, and `10` as "low". Currently, Planner sets the value `1` for "urgent", `3` for "important", `5` for "medium", and `9` for "low". Inherited from [plannerTask](../resources/plannertask.md).|
+|startDateTime|DateTimeOffset|Date and time at which the task starts. 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`. Inherited from [plannerTask](../resources/plannertask.md).|
+|target|[businessScenarioTaskTargetBase](../resources/businessscenariotasktargetbase.md)|Target of the task that specifies where the task should be placed. Required.|
+|title|String|Title of the task. Inherited from [plannerTask](../resources/plannertask.md).|
+
+## Response
+
+If successful, this method returns a `201 Created` response code and a [businessScenarioTask](../resources/businessscenariotask.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "create_businessscenariotask_from_",
+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d"]
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/tasks
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.businessScenarioTask",
+ "title": "Customer order #12010",
+ "percentComplete": 0,
+ "priority": 5,
+ "target": {
+ "@odata.type": "microsoft.graph.businessScenarioGroupTarget",
+ "taskTargetKind": "group",
+ "groupId": "7a339254-4b2b-4410-b295-c890a16776ee"
+ },
+ "businessScenarioProperties": {
+ "externalObjectId": "Order#12010",
+ "externalContextId": "Warehouse-CA-36",
+ "externalObjectVersion": "000001",
+ "webUrl": "https://ordertracking.contoso.com/view?id=12010",
+ "externalBucketId": "deliveryBucket"
+ }
+}
+```
+
+# [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.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.businessScenarioTask"
+}
+-->
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.businessScenarioTask",
+ "title": "Customer order #12010",
+ "percentComplete": 0,
+ "priority": 5,
+ "id": "pmc1rS1Io0C3rXQhyXIsNmUAOeIi",
+ "target": {
+ "@odata.type": "microsoft.graph.businessScenarioGroupTarget",
+ "taskTargetKind": "group",
+ "groupId": "7a339254-4b2b-4410-b295-c890a16776ee"
+ },
+ "businessScenarioProperties": {
+ "externalObjectId": "Order#12010",
+ "externalContextId": "Warehouse-CA-36",
+ "externalObjectVersion": "000001",
+ "webUrl": "https://ordertracking.contoso.com/view?id=12010",
+ "externalBucketId": "deliveryBucket"
+ }
+}
+```
v1.0 Businessscenariotask Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/businessscenariotask-get.md
+
+ Title: "Get businessScenarioTask"
+description: "Read the properties and relationships of a businessScenarioTask object."
+
+ms.localizationpriority: medium
++
+# Get businessScenarioTask
+
+Namespace: microsoft.graph
++
+Read the properties and relationships of a [businessScenarioTask](../resources/businessscenariotask.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)|BusinessScenarioData.Read.OwnedBy, BusinessScenarioData.ReadWrite.OwnedBy|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|BusinessScenarioData.Read.OwnedBy, BusinessScenarioData.ReadWrite.OwnedBy|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /solutions/businessScenarios/{businessScenarioId}/planner/tasks/{businessScenarioTaskId}
+```
+
+## 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 [businessScenarioTask](../resources/businessscenariotask.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_businessscenariotask",
+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d", "pmc1rS1Io0C3rXQhyXIsNmUAOeIi"]
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/tasks/pmc1rS1Io0C3rXQhyXIsNmUAOeIi
+```
+
+# [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.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.businessScenarioTask"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "title": "Customer order #12010",
+ "percentComplete": 0,
+ "priority": 5,
+ "id": "pmc1rS1Io0C3rXQhyXIsNmUAOeIi",
+ "target": {
+ "@odata.type": "microsoft.graph.businessScenarioGroupTarget",
+ "taskTargetKind": "group",
+ "groupId": "7a339254-4b2b-4410-b295-c890a16776ee"
+ },
+ "businessScenarioProperties": {
+ "externalObjectId": "Order#12010",
+ "externalContextId": "Warehouse-CA-36",
+ "externalObjectVersion": "000001",
+ "webUrl": "https://ordertracking.contoso.com/view?id=12010",
+ "externalBucketId": "deliveryBucket"
+ }
+}
+```
v1.0 Businessscenariotask Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/businessscenariotask-update.md
+
+ Title: "Update businessScenarioTask"
+description: "Update the properties of a businessScenarioTask object."
+
+ms.localizationpriority: medium
++
+# Update businessScenarioTask
+
+Namespace: microsoft.graph
++
+Update the properties of a [businessScenarioTask](../resources/businessscenariotask.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)|BusinessScenarioData.ReadWrite.OwnedBy|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application| BusinessScenarioData.ReadWrite.OwnedBy|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /solutions/businessScenarios/{businessScenarioId}/planner/tasks/{businessScenarioTaskId}
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
++
+|Property|Type|Description|
+|:|:|:|
+|appliedCategories|[plannerAppliedCategories](../resources/plannerappliedcategories.md)|The categories to which the task has been applied. For possible values, see [plannerAppliedCategories](../resources/plannerappliedcategories.md). Inherited from [plannerTask](../resources/plannertask.md).|
+|assigneePriority|String|Hint used to order items of this type in a list view. For details about the supported format, see [Using order hints in Planner](../resources/planner-order-hint-format.md). Inherited from [plannerTask](../resources/plannertask.md).|
+|assignments|[plannerAssignments](../resources/plannerassignments.md)|The set of assignees the task is assigned to. Inherited from [plannerTask](../resources/plannertask.md).|
+|bucketId|String|Bucket ID to which the task belongs. The bucket needs to be in the plan that the task is in. It is 28 characters long and case-sensitive. The [format validation](../resources/tasks-identifiers-disclaimer.md) is done on the service. Inherited from [plannerTask](../resources/plannertask.md). |
+|businessScenarioProperties|[businessScenarioProperties](../resources/businessscenarioproperties.md)|Scenario-specific properties of the task. Optional.|
+|conversationThreadId|String|Thread ID of the conversation on the task. This is the ID of the conversation thread object created in the **group**. Inherited from [plannerTask](../resources/plannertask.md).|
+|dueDateTime|DateTimeOffset|Date and time at which the task 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`. Inherited from [plannerTask](../resources/plannertask.md).|
+|orderHint|String|Hint used to order items of this type in a list view. For details about the supported format, see [Using order hints in Planner](../resources/planner-order-hint-format.md). Inherited from [plannerTask](../resources/plannertask.md).|
+|percentComplete|Int32|Percentage of task completion. When set to `100`, the task is considered completed. Inherited from [plannerTask](../resources/plannertask.md). |
+|planId|String|Identifier of the plan to which the task belongs. Inherited from [plannerTask](../resources/plannertask.md).|
+|priority|Int32|Priority of the task. Valid range of values is between `0` and `10` (inclusive), with increasing value being lower priority (`0` has the highest priority and `10` has the lowest priority). Currently, Planner interprets values `0` and `1` as "urgent", `2`, `3`, and `4` as "important", `5`, `6`, and `7` as "medium", and `8`, `9`, and `10` as "low". Currently, Planner sets the value `1` for "urgent", `3` for "important", `5` for "medium", and `9` for "low". Inherited from [plannerTask](../resources/plannertask.md).|
+|startDateTime|DateTimeOffset|Date and time at which the task starts. 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`. Inherited from [plannerTask](../resources/plannertask.md).|
+|target|[businessScenarioTaskTargetBase](../resources/businessscenariotasktargetbase.md)|Target of the task that specifies where the task should be placed. Optional.|
+|title|String|Title of the task. Inherited from [plannerTask](../resources/plannertask.md).|
+
+## Response
+
+If successful, this method returns a `200 OK` response code and an updated [businessScenarioTask](../resources/businessscenariotask.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "update_businessscenariotask",
+ "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d", "pmc1rS1Io0C3rXQhyXIsNmUAOeIi"]
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/tasks/pmc1rS1Io0C3rXQhyXIsNmUAOeIi
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.businessScenarioTask",
+ "title": "Customer order #12010",
+ "percentComplete": 20,
+ "priority": 1,
+ "businessScenarioProperties": {
+ "externalObjectVersion": "000003"
+ }
+}
+```
+
+# [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.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.businessScenarioTask"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.businessScenarioTask",
+ "title": "Customer order #12010",
+ "percentComplete": 20,
+ "priority": 1,
+ "id": "pmc1rS1Io0C3rXQhyXIsNmUAOeIi",
+ "target": {
+ "@odata.type": "microsoft.graph.businessScenarioGroupTarget",
+ "taskTargetKind": "group",
+ "groupId": "7a339254-4b2b-4410-b295-c890a16776ee"
+ },
+ "businessScenarioProperties": {
+ "externalObjectId": "Order#12010",
+ "externalContextId": "Warehouse-CA-36",
+ "externalObjectVersion": "000003",
+ "webUrl": "https://ordertracking.contoso.com/view?id=12010",
+ "externalBucketId": "deliveryBucket"
+ }
+}
+```
+
+## See also
+
+* [Update the task details associated with a scenario task](plannertaskdetails-update.md).
v1.0 Call Answer https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/call-answer.md
Content-Type: application/json
] } ```
+>**Note:** Call establishing/established notifications may arrive out of order.
#### Notification - established
Content-Type: application/json
] } ```
+>**Note:** Call establishing/established notifications may arrive out of order.
### Example 2: Answer VOIP call with application hosted media
Content-Type: application/json
] } ```
+>**Note:** Call establishing/established notifications may arrive out of order.
#### Notification - established
Content-Type: application/json
] } ```
+>**Note:** Call establishing/established notifications may arrive out of order.
#### Notification - content sharing started
v1.0 Certificatebasedauthconfiguration Post Certificatebasedauthconfiguration https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/certificatebasedauthconfiguration-post-certificatebasedauthconfiguration.md
One of the following permissions is required to call this API. To learn more, in
| Delegated (personal Microsoft account) | Not supported. | | Application | Organization.ReadWrite.All |
+For delegated scenarios, the calling user must have the *Global Administrator* [Azure AD role](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles).
+ ## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Channel Get Filesfolder https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-get-filesfolder.md
Namespace: microsoft.graph
Get the metadata for the location where the files of a [channel](../resources/channel.md) are stored.
+> [!NOTE]
+> Some special characters in the channel name will cause this API to return an error. For details, see [Known issues](/graph/known-issues#create-channel).
+ ## 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 /teams/{team-id}/channels/{channel-id}
## Optional query parameters
-This method supports the `$filter`, `$select`, and `$expand` [OData query parameters](/graph/query-parameters) to help customize the response.
+This method supports the `$filter` and `$select` [OData query parameters](/graph/query-parameters) to help customize the response.
## Request headers
v1.0 Channel List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-list.md
Namespace: microsoft.graph
Retrieve the list of [channels](../resources/channel.md) in this [team](../resources/team.md).
-This method supports federation. Any shared channel that the request initiator belongs to will be included in the response.
+>**Note:** Guest users can't see private or shared channels that they aren't members of in the response for this API.
+ ## Permissions
GET /teams/{team-id}/channels
``` ## Optional query parameters
-This method supports the `$filter`, `$select`, and `$expand` [OData query parameters](/graph/query-parameters) to help customize the response.
+This method supports the `$filter` and `$select` [OData query parameters](/graph/query-parameters) to help customize the response.
### Use $select for better performance Populating the **email** and **moderationSettings** properties for a channel is an expensive operation that results in slow performance. Use `$select` to exclude the **email** and **moderationSettings** properties to improve performance.
v1.0 Channel Post Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-post-messages.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.
v1.0 Channel Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/channel-post.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Create a new [channel](../resources/channel.md) in a team, as specified in the request body.
-> **Note:** You can add a maximum of 200 members when you create a private channel.
+Create a new [channel](../resources/channel.md) in a team, as specified in the request body. When you create a channel, the maximum length of the channel's `displayName` is 50 characters. This is the name that appears to the user in Microsoft Teams.
+
+You can add a maximum of 200 members when you create a private channel.
+
+> [!NOTE]
+> Some special characters in the channel name will cause the [Get filesFolder](/graph/api/channel-get-filesfolder) API to return an error. For details, see [Known issues](/graph/known-issues#create-channel).
## Permissions
v1.0 Chatmessage Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-update.md
specifying only the **policyViolation** property.
## Response body For applications that use delegated permissions:
-If successful, this method returns a `204 NoContent` response.
+If successful, this method returns a `204 No Content` response.
For applications that use application permissions: If successful, this method returns a `200 OK` response.
-## Example for updating policyViolation by using application permissions
+## Examples
+
+### Example 1: Update policyViolation using application permissions
#### Request
HTTP/1.1 200 OK
}-->
-## Example for updating any property of a message by using delegated permissions
+### Example 2: Update any property of a message using delegated permissions
#### Request
Here is an example of the response.
HTTP/1.1 204 NoContent ```
-### Request to update the mentions of a message by using delegated permissions
+### Example 3: Update the mentions of a message using delegated permissions
+#### Request
The following is an example of the request to update the mentions on a Microsoft Teams channel message by using delegated permissions.
Here is an example of the response.
HTTP/1.1 204 NoContent ```
-### Request to update the content with attachments of a message by using delegated permissions
+### Example 4: Update the content with attachments of a message using delegated permissions
+#### Request
The following is an example of the request to update the attachments on a Microsoft Teams channel message by using delegated permissions.
Here is an example of the response.
HTTP/1.1 204 NoContent ```
-### Request to update the reactions in a message by using delegated permissions
+### Example 5: Update the reactions in a message using delegated permissions
+#### Request
The following is an example of the request to update the reactions property on a Microsoft Teams channel message by using delegated permissions.
v1.0 Checklistitem Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/checklistitem-delete.md
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account)|Tasks.ReadWrite| |Delegated (personal Microsoft account)|Tasks.ReadWrite|
-|Application|Tasks.ReadWrite|
+|Application|Tasks.ReadWrite.All|
## HTTP request
v1.0 Checklistitem Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/checklistitem-get.md
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account)|Tasks.Read, Tasks.ReadWrite| |Delegated (personal Microsoft account)|Tasks.Read, Tasks.ReadWrite|
-|Application|Tasks.Read, Tasks.ReadWrite|
+|Application|Tasks.Read.All, Tasks.ReadWrite.All|
## HTTP request
v1.0 Checklistitem Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/checklistitem-update.md
One of the following permissions is required to call this API. To learn more, in
|:|:| |Delegated (work or school account)|Tasks.ReadWrite| |Delegated (personal Microsoft account)|Tasks.ReadWrite|
-|Application|Tasks.ReadWrite|
+|Application|Tasks.ReadWrite.All|
## HTTP request
v1.0 Cloudpc Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpc-get.md
One of the following permissions is required to call this API. To learn more, in
To get the [cloudPC](../resources/cloudpc.md) of the specified user (who is the signed-in user) in the organization using delegated permission: ``` http
-GET /me/cloudPCs{id}
+GET /me/cloudPCs/{id}
GET /users/{userId}/cloudPCs/{id} ```
Content-Type: application/json
}, "userPrincipalName": "pmitchell@cpccustomer001.onmicrosoft.com", "lastModifiedDateTime": "2020-11-03T18:14:34Z",
- "gracePeriodEndDateTime": "2020-11-010T20:00:34Z"
+ "gracePeriodEndDateTime": "2020-11-010T20:00:34Z",
+ "diskEncryptionState": "notAvailable"
} ```
Content-Type: application/json
}, "userPrincipalName": "pmitchell@cpccustomer001.onmicrosoft.com", "lastModifiedDateTime": "2020-11-03T18:14:34Z",
- "gracePeriodEndDateTime": "2020-11-010T20:00:34Z"
+ "gracePeriodEndDateTime": "2020-11-010T20:00:34Z",
+ "diskEncryptionState": "notAvailable"
} ```
v1.0 Cloudpc Getsupportedcloudpcremoteactions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpc-getsupportedcloudpcremoteactions.md
+
+ Title: "cloudPC: getSupportedCloudPcRemoteActions"
+description: "Get a list of supported Cloud PC remote actions for a specific Cloud PC device, including the action names and capabilities."
+
+ms.localizationpriority: medium
++
+# cloudPC: getSupportedCloudPcRemoteActions
+
+Namespace: microsoft.graph
++
+Get a list of supported Cloud PC remote actions for a specific Cloud PC device, including the action names and capabilities.
+
+## 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) | CloudPC.Read.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | CloudPC.ReadWrite.All |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+GET /deviceManagement/virtualEndpoint/cloudPCs/{id}/getSupportedCloudPcRemoteActions
+```
+
+## 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 [cloudPcRemoteActionCapability](../resources/cloudpcremoteactioncapability.md) objects in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of a request.
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "cloudpc_getsupportedcloudpcremoteactions"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/831dd62e-cfa1-4d49-a3b4-58d4e9920f8e/getSupportedCloudPcRemoteActions
+```
+
+# [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",
+ "@odata.type": "Collection(microsoft.graph.cloudPcRemoteActionCapability)",
+ "truncated": true
+}
+-->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.cloudPcRemoteActionCapability)",
+ "value": [
+ {
+ "actionName": "Restart",
+ "actionCapability": "disabled"
+ },
+ {
+ "actionName": "Restore",
+ "actionCapability": "disabled"
+ },
+ {
+ "actionName": "Reprovision",
+ "actionCapability": "enabled"
+ },
+ {
+ "actionName": "Resize",
+ "actionCapability": "disabled"
+ },
+ {
+ "actionName": "PlaceUnderReview",
+ "actionCapability": "disabled"
+ }
+ ]
+}
+```
v1.0 Cloudpc Retrypartneragentinstallation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpc-retrypartneragentinstallation.md
The following is an example of a request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/831dd62e-cfa1-4d49-a3b4-58d4e9920f8e/retryPartnerAgentInstallation ```+
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
+++
v1.0 Cloudpcexportjob Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcexportjob-get.md
Namespace: microsoft.graph
Read the properties and relationships of a [cloudPcExportJob](../resources/cloudpcexportjob.md) object.
+You can download a report by first [creating a new cloudPcExportJob resource](cloudpcreports-post-exportjobs.md) to initiate downloading.
+
+Use this GET operation to verify the **exportJobStatus** property of the **cloudPcExportJob** resource. When the property becomes `completed`, the report has finished downloading in the location specified by the **exportUrl** property.
+ ## 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 Cloudpconpremisesconnection Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpconpremisesconnection-get.md
Content-Type: application/json
"resourceGroupId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c585ffff/resourceGroups/ExampleRG", "virtualNetworkId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/ExampleRG/providers/Microsoft.Network/virtualNetworks/ExampleVNet", "subnetId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c585ffff/resourceGroups/ExampleRG/providers/Microsoft.Network/virtualNetworks/ExampleVNet/subnets/default",
- "healthCheckStatus": "running"
+ "healthCheckStatus": "running",
+ "virtualNetworkLocation": "westus2"
} ```
v1.0 Cloudpconpremisesconnection Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpconpremisesconnection-update.md
Content-Type: application/json
"resourceGroupId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c585ffff/resourceGroups/ExampleRG", "virtualNetworkId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/ExampleRG/providers/Microsoft.Network/virtualNetworks/ExampleVNet", "subnetId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c585ffff/resourceGroups/ExampleRG/providers/Microsoft.Network/virtualNetworks/ExampleVNet/subnets/default",
- "healthCheckStatus": "running"
+ "healthCheckStatus": "running",
+ "virtualNetworkLocation": "westus2"
} ```
v1.0 Cloudpcreports Getshareduselicenseusagereport https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcreports-getshareduselicenseusagereport.md
+
+ Title: "cloudPcReports: getSharedUseLicenseUsageReport"
+description: "Get the shared use license usage reports, such as servicePlanId, licenseCount, and claimedLicenseCount, for real-time, 7 days, or 28 days trend."
+
+ms.localizationpriority: medium
++
+# cloudPcReports: getSharedUseLicenseUsageReport
+
+Namespace: microsoft.graph
++
+Get a usage report on shared-use licenses, such as **servicePlanId**, **licenseCount**, and **claimedLicenseCount**, for real-time, 7 days, or 28 days trend.
+
+## 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) | CloudPC.Read.All, CloudPC.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | CloudPC.Read.All, CloudPC.ReadWrite.All |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceManagement/virtualEndpoint/reports/getSharedUseLicenseUsageReport
+```
+
+## 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 |
+| : | :- | :- |
+| reportName | String | Specifies the report name. |
+| filter | String | OData filter syntax. Supported filters include `and`, `or`, `lt`, `le`, `gt`, `ge`, and `eq`. |
+| select | String collection | OData select syntax. Represents the selected columns of the reports. |
+| search | String | Specifies a string to search. |
+| groupBy | String collection | Specifies how to group the reports. If used, must have the same content as the **select** parameter. |
+| orderBy | String collection | Specifies how to sort the reports. |
+| skip | Int32 | The number of records to skip. |
+| top | Int32 | The number of top records to return. |
+
+## Response
+
+If successful, this action returns a `200 OK` response code and a Stream in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of a request.
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "cloudpcreportsthis.getSharedUseLicenseUsageReport"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/reports/getSharedUseLicenseUsageReport
+Content-Type: application/json
+Content-length: 199
+
+{
+ "reportName": "SharedUseLicenseUsageReport",
+ "filter": "ServicePlanId eq '2d1d344e-d10c-41bb-953b-b3a47521dca0' and DateTimeUTC gt datetime'2022-11-30'",
+ "select":["ServicePlanId", "LicenseCount", "ClaimedLicenseCount", "DateTimeUTC"],
+ "skip": 0,
+ "top": 100
+}
+```
+
+# [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.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Edm.Stream"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/octet-stream
+
+{
+ "TotalRowCount": 2,
+ "Schema": [
+ {
+ "name": "ServicePlanId",
+ "type": "String"
+ },
+ {
+ "name": "LicenseCount",
+ "type": "Int32"
+ },
+ {
+ "name": "ClaimedLicenseCount",
+ "type": "Int32"
+ },
+ {
+ "name": "DateTimeUTC",
+ "type": "DateTime"
+ }
+ ],
+ "Values": [
+ [
+ "2d1d344e-d10c-41bb-953b-b3a47521dca0", 100, 10, "2022-12-02T00:00:00"
+ ],
+ [
+ "2d1d344e-d10c-41bb-953b-b3a47521dca0", 100, 11, "2022-12-01T00:00:00"
+ ]
+ ]
+}
+```
v1.0 Cloudpcreports Post Exportjobs https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcreports-post-exportjobs.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Create a new [cloudPcExportJob](../resources/cloudpcexportjob.md) object.
+Create a new [cloudPcExportJob](../resources/cloudpcexportjob.md) resource to initiate downloading the entire or specified portion of a report.
+
+Use the [GET cloudPcExportJob](cloudpcexportjob-get.md) operation to verify the **exportJobStatus** property of the **cloudPcExportJob** resource. When the property becomes `completed`, the report has finished downloading in the location specified by the **exportUrl** property.
## 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).
You can specify the following properties when creating a **cloudPcExportJob**.
|Property|Type|Description| |:|:|:|
-|reportName|cloudPcReportName|The report name. The possible values are: `remoteConnectionHistoricalReports`, `dailyAggregatedRemoteConnectionReports`, `totalAggregatedRemoteConnectionReports`, `unknownFutureValue`. Optional.|
+|reportName|cloudPcReportName|The report name. The possible values are: `remoteConnectionHistoricalReports`, `dailyAggregatedRemoteConnectionReports`, `totalAggregatedRemoteConnectionReports`, `sharedUseLicenseUsageReport`, `sharedUseLicenseUsageRealTimeReport`,`unknownFutureValue`. Optional.|
|filter|String|The filter applied on the report. Optional.| |select|String collection|The selected columns of the report. Optional.| |format|String|The format of the exported report. Optional.|
v1.0 Crosstenantaccesspolicy List Partners https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/crosstenantaccesspolicy-list-partners.md
Title: "List partners"
-description: "Get a list of all partner configurations within a cross-tenant access policy."
+description: "Get a list of all partner configurations within a cross-tenant access policy. You can also use the $expand parameter to list the user synchronization policy for all partner configurations."
ms.localizationpriority: medium ms.prod: "identity-and-sign-in"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get a list of all partner configurations within a cross-tenant access policy.
+Get a list of all partner configurations within a cross-tenant access policy. You can also use the `$expand` parameter to list the user synchronization policy for all partner configurations.
## Permissions
One of the following permissions is required to call this API. To learn more, in
GET /policies/crossTenantAccessPolicy/partners ```
+## Optional query parameters
+This method supports the `$select` and `$expand` OData query parameters to help customize the response. 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 collection of
## Examples
-### Request
+### Example 1: List all partner configurations within a cross-tenant access policy
+
+#### Request
# [HTTP](#tab/http)
GET https://graph.microsoft.com/beta/policies/crossTenantAccessPolicy/partners
-### Response
+#### Response
>**Note:** The response object shown here might be shortened for readability. <!-- {
Content-Type: application/json
{ "tenantId": "123f4846-ba00-4fd7-ba43-dac1f8f63013", "inboundTrust": null,
+ "automaticUserConsentSettings":
+ {
+ "inboundAllowed": null,
+ "outboundAllowed": null
+ },
"b2bCollaborationInbound": null, "b2bCollaborationOutbound": null, "b2bDirectConnectOutbound": null,
Content-Type: application/json
] } ```+
+### Example 2: List the user synchronization policy for all partner configurations
+
+#### Request
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "list_crosstenantidentitysyncpolicypartner"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/policies/crossTenantAccessPolicy/partners?$select=tenantId&$expand=identitySynchronization
+```
+
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++
+#### Response
+
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.crossTenantIdentitySyncPolicyPartner)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value":
+ [
+ {
+ "tenantId": "9c5d131d-b1c3-4fc4-9e3f-c6557947d551",
+ "identitySynchronization":
+ {
+ "tenantId": "9c5d131d-b1c3-4fc4-9e3f-c6557947d551",
+ "displayName": "Fabrikam",
+ "userSyncInbound":
+ {
+ "isSyncAllowed": true
+ }
+ }
+ }
+ ]
+}
+```
v1.0 Crosstenantaccesspolicy Post Partners https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/crosstenantaccesspolicy-post-partners.md
The following table shows the properties that are required when you create the [
|Property|Type|Description| |:|:|:|
+| automaticUserConsentSettings | [inboundOutboundPolicyConfiguration](../resources/inboundoutboundpolicyconfiguration.md) | Determines the partner-specific configuration for automatic user consent settings. Unless specifically configured, the `inboundAllowed` and `outboundAllowed` properties will be **null** and inherit from the default settings, which is always `false`. |
| b2bCollaborationInbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your partner-specific configuration for users from other organizations accessing your resources via Azure AD B2B collaboration. | | b2bCollaborationOutbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your partner-specific configuration for users in your organization going outbound to access resources in another organization via Azure AD B2B collaboration. |
-| b2bDirectConnectInbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your partner-specific configuration for users from other organizations accessing your resources via Azure AD B2B direct connect. |
+| b2bDirectConnectInbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your partner-specific configuration for users from other organizations accessing your resources via Azure B2B direct connect. |
| b2bDirectConnectOutbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your partner-specific configuration for users in your organization going outbound to access resources in another organization via Azure AD B2B direct connect. | | inboundTrust | [crossTenantAccessPolicyInboundTrust](../resources/crosstenantaccesspolicyinboundtrust.md) | Determines the partner-specific configuration for trusting other Conditional Access claims from external Azure AD organizations. |
-| tenantId | String | The tenant identifier for the partner Azure Active Directory (Azure AD) organization. |
+| isServiceProvider | Boolean | Identifies whether the partner-specific configuration is a Cloud Service Provider for your organization. |
+| tenantId | String | The tenant identifier for the partner Azure AD organization. Read-only. Key.|
## Response
v1.0 Crosstenantaccesspolicyconfigurationdefault Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/crosstenantaccesspolicyconfigurationdefault-get.md
Content-Type: application/json
"isCompliantDeviceAccepted": false, "isHybridAzureADJoinedDeviceAccepted": false, },
+ "automaticUserConsentSettings":
+ {
+ "inboundAllowed": false,
+ "outboundAllowed": false
+ },
"b2bCollaborationOutbound": { "usersAndGroups":
v1.0 Crosstenantaccesspolicyconfigurationdefault Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/crosstenantaccesspolicyconfigurationdefault-update.md
PATCH /policies/crossTenantAccessPolicy/default
|Property|Type|Description| |:|:|:|
-| inboundTrust | [crossTenantAccessPolicyInboundTrust](../resources/crosstenantaccesspolicyinboundtrust.md) | Determines the default configuration for trusting other Conditional Access claims from external Azure AD organizations. |
| b2bCollaborationInbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your default configuration for users from other organizations accessing your resources via Azure AD B2B collaboration. | | b2bCollaborationOutbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your default configuration for users in your organization going outbound to access resources in another organization via Azure AD B2B collaboration. | | b2bDirectConnectInbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your default configuration for users from other organizations accessing your resources via Azure AD B2B direct connect. | | b2bDirectConnectOutbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your default configuration for users in your organization going outbound to access resources in another organization via Azure AD B2B direct connect. |
+| inboundTrust | [crossTenantAccessPolicyInboundTrust](../resources/crosstenantaccesspolicyinboundtrust.md) | Determines the default configuration for trusting other Conditional Access claims from external Azure AD organizations. |
## Response
v1.0 Crosstenantaccesspolicyconfigurationpartner Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/crosstenantaccesspolicyconfigurationpartner-delete.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Delete a [partner-specific configuration](../resources/crosstenantaccesspolicyconfigurationpartner.md) in a cross-tenant access policy.
+Delete a [partner-specific configuration](../resources/crosstenantaccesspolicyconfigurationpartner.md) in a cross-tenant access policy. If a configuration includes a [user synchronization policy](../resources/crosstenantidentitysyncpolicypartner.md), you must first [delete the user synchronization policy](./crosstenantidentitysyncpolicypartner-delete.md) before you can delete the partner-specific configuration.
## Permissions
If successful, this method returns a `204 No Content` response code.
## Examples
+If a configuration includes a [user synchronization policy](../resources/crosstenantidentitysyncpolicypartner.md), you must first [delete the user synchronization policy](./crosstenantidentitysyncpolicypartner-delete.md) before you can delete the partner-specific configuration.
+ ### Request
v1.0 Crosstenantaccesspolicyconfigurationpartner Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/crosstenantaccesspolicyconfigurationpartner-get.md
Content-Type: application/json
{ "tenantId": "9c5d131d-b1c3-4fc4-9e3f-c6557947d551", "inboundTrust": null,
+ "automaticUserConsentSettings":
+ {
+ "inboundAllowed": null,
+ "outboundAllowed": null
+ },
"b2bCollaborationInbound": null, "b2bCollaborationOutbound": null, "b2bDirectConnectOutbound": null,
v1.0 Crosstenantaccesspolicyconfigurationpartner Put Identitysynchronization https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/crosstenantaccesspolicyconfigurationpartner-put-identitysynchronization.md
+
+ Title: "Create identitySynchronization"
+description: "Create a cross-tenant user synchronization policy for a partner-specific configuration."
+
+ms.localizationpriority: medium
++
+# Create identitySynchronization
+Namespace: microsoft.graph
++
+Create a cross-tenant user synchronization policy for a partner-specific configuration.
+
+## 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)|Policy.ReadWrite.CrossTenantAccess|
+|Delegated (personal Microsoft account)|Not applicable|
+|Application|Policy.ReadWrite.CrossTenantAccess|
+
+The signed-in user must also be assigned the following minimum [directory role](/azure/active-directory/roles/permissions-reference):
+++ Hybrid Identity Administrator+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PUT /policies/crossTenantAccessPolicy/partners/{id}/identitySynchronization
+```
+
+## 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 [crossTenantIdentitySyncPolicyPartner](../resources/crosstenantidentitysyncpolicypartner.md) object.
+
+You can specify the following properties when creating a **crossTenantIdentitySyncPolicyPartner**.
+
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|Display name for the cross-tenant user synchronization policy. Use the name of the partner Azure AD tenant to easily identify the policy. Optional.|
+|userSyncInbound|[crossTenantUserSyncInbound](../resources/crosstenantusersyncinbound.md)|Determines whether users are synchronized from the partner tenant.|
+++
+## 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": "create_crosstenantidentitysyncpolicypartner_from_"
+}
+-->
+``` http
+PUT https://graph.microsoft.com/beta/policies/crossTenantAccessPolicy/partners/90e29127-71ad-49c7-9ce8-db3f41ea06f1/identitySynchronization
+Content-Type: application/json
+
+{
+ "displayName": "Fabrikam",
+ "userSyncInbound":
+ {
+ "isSyncAllowed": true
+ }
+}
+```
+
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PHP](#tab/php)
+++++
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Crosstenantaccesspolicyconfigurationpartner Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/crosstenantaccesspolicyconfigurationpartner-update.md
PATCH /policies/crossTenantAccessPolicy/partners/{id}
|Property|Type|Description| |:|:|:|
+| automaticUserConsentSettings | [inboundOutboundPolicyConfiguration](../resources/inboundoutboundpolicyconfiguration.md) | Determines the partner-specific configuration for automatic user consent settings. |
| b2bCollaborationInbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your partner-specific configuration for users from other organizations accessing your resources via Azure AD B2B collaboration. | | b2bCollaborationOutbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your partner-specific configuration for users in your organization going outbound to access resources in another organization via Azure AD B2B collaboration. | | b2bDirectConnectInbound | [crossTenantAccessPolicyB2BSetting](../resources/crosstenantaccesspolicyb2bsetting.md) | Defines your partner-specific configuration for users from other organizations accessing your resources via Azure AD B2B direct connect. |
If successful, this method returns a `204 No Content` response code.
## Examples
-### Request
+### Example 1: Configure inbound trust settings
+
+The following example configures the partner-specific policy by setting the inbound trust settings to accept MFA, compliant, and Hybrid Azure AD Joined devices from the partner tenant.
+
+#### Request
# [HTTP](#tab/http)
Content-Type: application/json
-### Response
+#### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+
+``` http
+HTTP/1.1 204 No Content
+```
+
+### Example 2: Configure automaticUserConsent settings
+
+The following example configures the partner-specific policy by consenting for B2B collaboration on behalf of your users and accepting admin consent for the partner's users.
+
+#### Request
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "update_crosstenantaccesspolicyconfigurationpartner_automaticuserconsentsettings"
+}
+-->
+
+``` http
+PATCH https://graph.microsoft.com/beta/policies/crossTenantAccessPolicy/partners/90e29127-71ad-49c7-9ce8-db3f41ea06f1
+Content-Type: application/json
+
+{
+ "automaticUserConsentSettings":
+ {
+ "inboundAllowed": true,
+ "outboundAllowed": true
+ }
+}
+```
+
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
++++
+#### Response
<!-- { "blockType": "response",
v1.0 Crosstenantidentitysyncpolicypartner Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/crosstenantidentitysyncpolicypartner-delete.md
+
+ Title: "Delete crossTenantIdentitySyncPolicyPartner"
+description: "Delete the user synchronization policy for a partner-specific configuration."
+
+ms.localizationpriority: medium
++
+# Delete crossTenantIdentitySyncPolicyPartner
+Namespace: microsoft.graph
++
+Delete the user synchronization policy for a partner-specific configuration.
+
+## 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)|Policy.ReadWrite.CrossTenantAccess|
+|Delegated (personal Microsoft account)|Not applicable|
+|Application|Policy.ReadWrite.CrossTenantAccess|
+
+The signed-in user must also be assigned the following minimum [directory role](/azure/active-directory/roles/permissions-reference):
+++ Hybrid Identity Administrator+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /policies/crossTenantAccessPolicy/partners/{id}/identitySynchronization
+```
+
+## 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_crosstenantidentitysyncpolicypartner"
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/beta/policies/crossTenantAccessPolicy/partners/9c5d131d-b1c3-4fc4-9e3f-c6557947d551/identitySynchronization
+```
+
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
+++++
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Crosstenantidentitysyncpolicypartner Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/crosstenantidentitysyncpolicypartner-get.md
+
+ Title: "Get crossTenantIdentitySyncPolicyPartner"
+description: "Read the user synchronization policy of a partner-specific configuration."
+
+ms.localizationpriority: medium
++
+# Get crossTenantIdentitySyncPolicyPartner
+Namespace: microsoft.graph
++
+Read the user synchronization policy of a partner-specific configuration.
+
+## 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)|Policy.Read.All, Policy.ReadWrite.CrossTenantAccess|
+|Delegated (personal Microsoft account)|Not applicable|
+|Application|Policy.Read.All, Policy.ReadWrite.CrossTenantAccess|
+
+The signed-in user must also be assigned the following minimum [directory role](/azure/active-directory/roles/permissions-reference):
+++ Hybrid Identity Administrator+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /policies/crossTenantAccessPolicy/partners/{id}/identitySynchronization
+```
+
+## 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 [crossTenantIdentitySyncPolicyPartner](../resources/crosstenantidentitysyncpolicypartner.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_crosstenantidentitysyncpolicypartner"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/policies/crossTenantAccessPolicy/partners/9c5d131d-b1c3-4fc4-9e3f-c6557947d551/identitySynchronization
+```
+
+# [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.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.crossTenantIdentitySyncPolicyPartner"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "tenantId": "9c5d131d-b1c3-4fc4-9e3f-c6557947d551",
+ "displayName": "Fabrikam",
+ "userSyncInbound":
+ {
+ "isSyncAllowed": true
+ }
+}
+```
+
v1.0 Crosstenantidentitysyncpolicypartner Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/crosstenantidentitysyncpolicypartner-update.md
+
+ Title: "Update crossTenantIdentitySyncPolicyPartner"
+description: "Update the user synchronization policy of a partner-specific configuration."
+
+ms.localizationpriority: medium
++
+# Update crossTenantIdentitySyncPolicyPartner
+Namespace: microsoft.graph
++
+Update the user synchronization policy of a partner-specific configuration.
+
+## 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)|Policy.ReadWrite.CrossTenantAccess|
+|Delegated (personal Microsoft account)|Not applicable|
+|Application|Policy.ReadWrite.CrossTenantAccess|
+
+The signed-in user must also be assigned the following minimum [directory role](/azure/active-directory/roles/permissions-reference):
+++ Hybrid Identity Administrator+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /policies/crossTenantAccessPolicy/partners/{id}/identitySynchronization
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|Display name for the cross-tenant user synchronization policy. Generally, this should be the tenant name of the partner Azure AD organization. Optional.|
+|userSyncInbound|[crossTenantUserSyncInbound](../resources/crosstenantusersyncinbound.md)|Determines whether users can be synchronized from the partner tenant. If set to `false`, any current user synchronization from the source tenant to the target tenant will stop. There is no impact to existing users that have already been synchronized.|
+++
+## 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_crosstenantidentitysyncpolicypartner"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/policies/crossTenantAccessPolicy/partners/90e29127-71ad-49c7-9ce8-db3f41ea06f1/identitySynchronization
+Content-Type: application/json
+
+{
+ "userSyncInbound":
+ {
+ "isSyncAllowed": true
+ }
+}
+```
+
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+
+# [Go](#tab/go)
+
+# [PowerShell](#tab/powershell)
+
+# [PHP](#tab/php)
+++++
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Delegatedadminaccessassignment Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/delegatedadminaccessassignment-update.md
PATCH /tenantRelationships/delegatedAdminRelationships/{delegatedAdminRelationsh
If successful, this method returns a `200 OK` or a `202 Accepted` response code.
-## Response headers
+### Response headers
|Name|Description| |:|:| |Content-Type|application/json.|
v1.0 Delegatedadminrelationship Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/delegatedadminrelationship-delete.md
DELETE /tenantRelationships/delegatedAdminRelationships/{delegatedAdminRelations
## Request headers |Name|Description| |:|:|
+|Authorization|Bearer {token}. Required.|
|If-Match|If-match: {etag}. Last known ETag value for the **delegatedAdminRelationship** to be deleted. Retrieve the ETag value from a LIST or GET operation. Required.| ## Request body
v1.0 Delegatedadminrelationshipoperation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/delegatedadminrelationshipoperation-get.md
GET /tenantRelationships/delegatedAdminRelationships/{delegatedAdminRelationship
``` ## Optional query parameters
-This method supports the $select OData query parameter to retrieve specific user properties, including those that are not returned by default.
+This method supports the `$select` OData query parameter to retrieve specific user properties, including those that are not returned by default.
## Request headers |Name|Description|
v1.0 Devicemanagement Alertrecord Getportalnotifications https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrecord-getportalnotifications.md
Namespace: microsoft.graph.deviceManagement
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get a list of all portal notifications that one or more users can access.
+Get a list of all notifications that one or more users can access, from the Microsoft Endpoint Manager admin center.
## Permissions
v1.0 Devicemanagement Alertrecord Setportalnotificationassent https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/devicemanagement-alertrecord-setportalnotificationassent.md
Namespace: microsoft.graph.deviceManagement
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Set a single portal notification status to published by modifying the **isPortalNotificationSent** property to `true` for the user specified in the request.
+Set the status of the notification associated with the specified [alertRecord](../resources/devicemanagement-alertrecord.md) on the Microsoft EndPoint Manager admin center as sent, by setting the **isPortalNotificationSent** property of the [portal notification](../resources/devicemanagement-portalnotification.md) to `true`.
## Permissions
v1.0 Directory List Recommendation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/directory-list-recommendation.md
+
+ Title: "List recommendations"
+description: "Get a list of the recommendation objects and their properties."
+
+ms.localizationpriority: medium
++
+# List recommendations
+Namespace: microsoft.graph
++
+Get a list of the [recommendation](../resources/recommendation.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)|DirectoryRecommendations.Read.All, DirectoryRecommendations.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DirectoryRecommendations.Read.All, DirectoryRecommendations.ReadWrite.All|
+
+For delegated scenarios, the admin needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles):
+- Global administrator
+- Global reader
+- Security administrator
+- Security operator
+- Security reader
+- Application administrator
+- Cloud application administrator
+- Reports reader
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /directory/recommendations
+```
+
+## Optional query parameters
+This method supports `$select` and `$filter` OData query parameters to help customize the response. `$expand` is supported by the **impactedResources** relationship. 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 [recommendation](../resources/recommendation.md) objects in the response body.
+
+## Examples
+
+### Example 1: Get the list of recommendations
+
+#### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "list_recommendation"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/directory/recommendations
+```
++
+#### 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": "Collection(microsoft.graph.recommendation)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#directory/recommendations",
+ "value": [
+ {
+ "id": "0cb31920-84b9-471f-a6fb-468c1a847088_Microsoft.Identity.IAM.Insights.TurnOffPerUserMFA",
+ "recommendationType": "turnOffPerUserMFA",
+ "createdDateTime": "2022-02-28T02:53:00Z",
+ "impactStartDateTime": "2022-02-28T02:53:00Z",
+ "postponeUntilDateTime": null,
+ "lastModifiedDateTime": "2023-01-10T22:57:10.2509132Z",
+ "lastModifiedBy": "b5fa65db-0d2b-4233-8788-ab0213567669",
+ "currentScore": 0.0,
+ "maxScore": 5.0,
+ "displayName": "Convert from per-user MFA to Conditional Access MFA",
+ "featureAreas": [
+ "conditionalAccess"
+ ],
+ "insights": "13 users are currently configured for per-user Multi-Factor Authentication (MFA). However, there are 6 users configured for Conditional Access (CA) MFA. The per-user MFA configuration supersedes the MFA settings applied via CA policies, potentially creating unnecessary MFA prompts.",
+ "benefits": "Improve user productivity and minimize sign-in time with fewer MFA prompts. Ensure that your most sensitive resources can have the tighest controls, while your least sensitive resources can be more freely accessible.",
+ "category": "identityBestPractice",
+ "status": "active",
+ "priority": "medium",
+ "impactType": "users",
+ "remediationImpact": "",
+ "actionSteps": [
+ {
+ "stepNumber": 1,
+ "text": "1. To get started, confirm that there is an existing CA policy with an MFA requirement. Ensure that you are covering all resources and users you would like to secure with MFA.",
+ "actionUrl": {
+ "displayName": "Click here to view your CA policies",
+ "url": "https://portal.azure.com/#blade/Microsoft_AAD_IAM/PoliciesTemplateBlade"
+ }
+ },
+ {
+ "stepNumber": 2,
+ "text": "2. To require MFA via a CA policy, follow the steps in this tutorial.",
+ "actionUrl": {
+ "displayName": "Secure user sign-in events with Azure AD Multi-Factor Authentication",
+ "url": "https://docs.microsoft.com/en-us/azure/active-directory/authentication/tutorial-enable-azure-mfa?toc=/azure/active-directory/conditional-access/toc.json&bc=/azure/active-directory/conditional-access/breadcrumb/toc.json"
+ }
+ },
+ {
+ "stepNumber": 3,
+ "text": "3. Ensure that the per-user MFA configuration is turned off",
+ "actionUrl": {
+ "displayName": "Navigate to MFA settings.",
+ "url": "https://account.activedirectory.windowsazure.com/UserManagement/MfaSettings.aspx"
+ }
+ }
+ ]
+ },
+ ]
+}
+```
+### Example 2: Get a recommendation object without its associated resources by the recommendationType
+
+#### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "get_recommendation"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/directory/recommendations?$filter=recommendationType eq 'turnOffPerUserMFA'
+```
+
+#### 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.recommendation"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#directory/recommendations/$entity",
+ "id": "0cb31920-84b9-471f-a6fb-468c1a847088_Microsoft.Identity.IAM.Insights.TurnOffPerUserMFA",
+ "recommendationType": "turnOffPerUserMFA",
+ "createdDateTime": "2022-02-28T02:53:00Z",
+ "impactStartDateTime": "2022-02-28T02:53:00Z",
+ "postponeUntilDateTime": null,
+ "lastModifiedDateTime": "2023-01-10T22:57:10.2509132Z",
+ "lastModifiedBy": "d5a3853c-8e04-42b6-a530-bf159e99174a",
+ "currentScore": 0.0,
+ "maxScore": 5.0,
+ "displayName": "Convert from per-user MFA to Conditional Access MFA",
+ "featureAreas": [
+ "conditionalAccess"
+ ],
+ "insights": "13 users are currently configured for per-user Multi-Factor Authentication (MFA)...",
+ "benefits": "Improve user productivity and minimize sign-in time with fewer MFA prompts...",
+ "category": "identityBestPractice",
+ "status": "active",
+ "priority": "medium",
+ "impactType": "users",
+ "remediationImpact": "",
+ "actionSteps": [
+ {
+ "stepNumber": 1,
+ "text": "1. To get started, confirm that...",
+ "actionUrl": {
+ "displayName": "Click here to view your CA policies",
+ "url": "https://portal.azure.com/#blade/Microsoft_AAD_IAM/PoliciesTemplateBlade"
+ }
+ },
+ {
+ "stepNumber": 2,
+ "text": "2. To require MFA via a CA policy, follow the steps in this tutorial.",
+ "actionUrl": {
+ "displayName": "Secure user sign-in events with Azure AD Multi-Factor Authentication",
+ "url": "https://docs.microsoft.com/en-us/azure/active-directory/authentication/tutorial-enable-azure-mfa?toc=/azure/active-directory/conditional-access/toc.json&bc=/azure/active-directory/conditional-access/breadcrumb/toc.json"
+ }
+ },
+ {
+ "stepNumber": 3,
+ "text": "3. Ensure that the per-user MFA configuration is turned off",
+ "actionUrl": {
+ "displayName": "Navigate to MFA settings.",
+ "url": "https://account.activedirectory.windowsazure.com/UserManagement/MfaSettings.aspx"
+ }
+ }
+ ]
+}
+```
+
+### Example 3: Get a recommendation object with its associated impacted resources
+
+#### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "get_recommendation"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/directory/recommendations?$filter=id eq '0cb31920-84b9-471f-a6fb-468c1a847088_Microsoft.Identity.IAM.Insights.TurnOffPerUserMFA'&$expand=impactedResources
+```
+
+#### 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.recommendation"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#directory/recommendations(impactedResources())",
+ "id": "0cb31920-84b9-471f-a6fb-468c1a847088_Microsoft.Identity.IAM.Insights.TurnOffPerUserMFA",
+ "recommendationType": "turnOffPerUserMFA",
+ "createdDateTime": "2022-02-28T02:53:00Z",
+ "impactStartDateTime": "2022-02-28T02:53:00Z",
+ "postponeUntilDateTime": null,
+ "lastModifiedDateTime": "2023-01-10T22:57:10.2509132Z",
+ "lastModifiedBy": "d5a3853c-8e04-42b6-a530-bf159e99174a",
+ "currentScore": 0.0,
+ "maxScore": 5.0,
+ "displayName": "Convert from per-user MFA to Conditional Access MFA",
+ "featureAreas": [
+ "conditionalAccess"
+ ],
+ "insights": "13 users are currently configured for per-user Multi-Factor Authentication (MFA). However, there are 6 users configured for Conditional Access (CA) MFA. The per-user MFA configuration supersedes the MFA settings applied via CA policies, potentially creating unnecessary MFA prompts.",
+ "benefits": "Improve user productivity and minimize sign-in time with fewer MFA prompts. Ensure that your most sensitive resources can have the tighest controls, while your least sensitive resources can be more freely accessible.",
+ "category": "identityBestPractice",
+ "status": "active",
+ "priority": "medium",
+ "impactType": "users",
+ "remediationImpact": "",
+ "actionSteps": [
+ {
+ "stepNumber": 1,
+ "text": "1. To get started, confirm that there is an existing CA policy with an MFA requirement. Ensure that you are covering all resources and users you would like to secure with MFA.",
+ "actionUrl": {
+ "displayName": "Click here to view your CA policies",
+ "url": "https://portal.azure.com/#blade/Microsoft_AAD_IAM/PoliciesTemplateBlade"
+ }
+ },
+ {
+ "stepNumber": 2,
+ "text": "2. To require MFA via a CA policy, follow the steps in this tutorial.",
+ "actionUrl": {
+ "displayName": "Secure user sign-in events with Azure AD Multi-Factor Authentication",
+ "url": "https://docs.microsoft.com/en-us/azure/active-directory/authentication/tutorial-enable-azure-mfa?toc=/azure/active-directory/conditional-access/toc.json&bc=/azure/active-directory/conditional-access/breadcrumb/toc.json"
+ }
+ },
+ {
+ "stepNumber": 3,
+ "text": "3. Ensure that the per-user MFA configuration is turned off",
+ "actionUrl": {
+ "displayName": "Navigate to MFA settings.",
+ "url": "https://account.activedirectory.windowsazure.com/UserManagement/MfaSettings.aspx"
+ }
+ }
+ ],
+ "impactedResources@odata.context": "https://graph.microsoft.com/beta/$metadata#directory/recommendations('0cb31920-84b9-471f-a6fb-468c1a847088_Microsoft.Identity.IAM.Insights.TurnOffPerUserMFA')/impactedResources",
+ "impactedResources": []
+}
+```
v1.0 Directorysetting Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/directorysetting-update.md
In the request body, supply the values for relevant fields that should be update
## Response
-If successful, this method returns a `204 OK` response code.
+If successful, this method returns a `204 No Content` response code.
## Example ### Request
Content-type: application/json
"blockType": "response" } --> ```http
-HTTP/1.1 204 OK
+HTTP/1.1 204 No Content
``` <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
v1.0 Domain Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/domain-delete.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Domain.ReadWrite.All |
+The work or school account needs to belong to one of the following roles:
+
+* Global Administrator
+* Domain Name Administrator
+* Partner Tier2 Support
+ ## HTTP request <!-- { "blockType": "ignored" } --> ```http
v1.0 Domain Forcedelete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/domain-forcedelete.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Domain.ReadWrite.All |
+The work or school account needs to belong to one of the following roles:
+
+* Global Administrator
+* Domain Name Administrator
+* Partner Tier2 Support
+ ## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Domain Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/domain-get.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Domain.Read.All, Domain.ReadWrite.All, Directory.Read.All |
+The work or school account needs to belong to one of the following roles:
+
+* Global Administrator
+* User Administrator
+* Helpdesk Administrator
+* Service Support Administrator
+* Billing Administrator
+* Mailbox Administrator
+* Partner Tier1 Support
+* Partner Tier2 Support
+* Directory Readers
+* Directory Writers
+* AdHoc License Administrator
+* Application Administrator
+* Security Reader
+* Security Administrator
+* Privileged Role Administrator
+* Cloud Application Administrator
+* Customer LockBox Access Approver
+* Dynamics 365 Administrator
+* Power BI Administrator
+* Azure Information Protection Administrator
+* Desktop Analytics Administrator
+* License Administrator
+* Microsoft Managed Desktop Administrator
+* Authentication Administrator
+* Privileged Authentication Administrator
+* Teams Communications Administrator
+* Teams Communications Support Engineer
+* Teams Communications Support Specialist
+* Teams Administrator
+* Insights Administrator
+* Compliance Data Administrator
+* Security Operator
+* Kaizala Administrator
+* Global Reader
+* Volume Licensing Business Center User
+* Volume Licensing Service Center User
+* Modern Commerce User
+* Microsoft Store for Business User
+* Directory Reviewer
+ ## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Domain List Domainnamereferences https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/domain-list-domainnamereferences.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Domain.Read.All, Domain.ReadWrite.All |
+The work or school account needs to belong to one of the following roles:
+
+* Global Administrator
+* Domain Name Administrator
+* Partner Tier2 Support
+* Global Reader
+ [!INCLUDE [limited-info](../../includes/limited-info.md)] ## HTTP request
v1.0 Domain List Verificationdnsrecords https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/domain-list-verificationdnsrecords.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Domain.Read.All, Domain.ReadWrite.All|
+The work or school account needs to belong to one of the following roles:
+
+* Global Administrator
+* Domain Name Administrator
+* Partner Tier2 Support
+* Global Reader
+ ## HTTP request <!-- { "blockType": "ignored" } --> ```http
v1.0 Domain List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/domain-list.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Domain.Read.All, Domain.ReadWrite.All, Directory.Read.All |
+The work or school account needs to belong to one of the following roles:
+
+* Global Administrator
+* User Administrator
+* Helpdesk Administrator
+* Service Support Administrator
+* Billing Administrator
+* Mailbox Administrator
+* Partner Tier1 Support
+* Partner Tier2 Support
+* Directory Readers
+* Directory Writers
+* AdHoc License Administrator
+* Application Administrator
+* Security Reader
+* Security Administrator
+* Privileged Role Administrator
+* Cloud Application Administrator
+* Customer LockBox Access Approver
+* Dynamics 365 Administrator
+* Power BI Administrator
+* Azure Information Protection Administrator
+* Desktop Analytics Administrator
+* License Administrator
+* Microsoft Managed Desktop Administrator
+* Privileged Authentication Administrator
+* Teams Communications Administrator
+* Teams Communications Support Engineer
+* Authentication Administrator
+* Teams Communications Support Specialist
+* Teams Administrator
+* Insights Administrator
+* Compliance Data Administrator
+* Security Operator
+* Kaizala Administrator
+* Global Reader
+* Volume Licensing Business Center User
+* Volume Licensing Service Center User
+* Modern Commerce User
+* Microsoft Store for Business User
+* Directory Reviewer
+* Domain Name Administrator
+* Users
+* Guest User
+* Restricted Guest User
+ ## HTTP request <!-- { "blockType": "ignored" } --> ```http
v1.0 Domain Post Domains https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/domain-post-domains.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Domain.ReadWrite.All |
+The work or school account needs to belong to one of the following roles:
+
+* Global Administrator
+* Domain Name Administrator
+* Partner Tier2 Support
+ ## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Domain Post Federationconfiguration https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/domain-post-federationconfiguration.md
Title: "Create federationConfiguration" description: "Create a new internalDomainFederation object."-+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: apiPageType
v1.0 Domain Promote https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/domain-promote.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Domain.ReadWrite.All |
+The work or school account needs to belong to one of the following roles:
+
+* Global Administrator
+* Domain Name Administrator
+* Partner Tier2 Support
+ ## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Domain Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/domain-update.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Domain.ReadWrite.All |
+The work or school account needs to belong to one of the following roles:
+
+* Global Administrator
+* Domain Name Administrator
+* Partner Tier2 Support
+* Security Administrator
+* External Identity Provider Administrator
+ ## HTTP request <!-- { "blockType": "ignored" } --> ```http
v1.0 Domain Verify https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/domain-verify.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Domain.ReadWrite.All |
+The work or school account needs to belong to one of the following roles:
+
+* Global Administrator
+* Domain Name Administrator
+* Partner Tier2 Support
+ ## HTTP request <!-- { "blockType": "ignored" } -->
v1.0 Drive Post Bundles https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/drive-post-bundles.md
Content-Type: application/json
} ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Java](#tab/java)
- # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/create-bundle-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Content-Type: application/json
} ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Java](#tab/java)
- # [Go](#tab/go) [!INCLUDE [sample-code](../includes/snippets/go/create-album-go-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
v1.0 Driveitem Assignsensitivitylabel https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/driveitem-assignsensitivitylabel.md
The following table lists the possible values for the error types.
The following is an example of a request.
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "assignSensitivityLabel", "tags": "service.graph", "sampleKeys": ["016GVDAP3RCQS5VBQHORFIVU2ZMOSBL25U"] } --> ``` http POST https://graph.microsoft.com/beta/drive/root/items/016GVDAP3RCQS5VBQHORFIVU2ZMOSBL25U/assignSensitivityLabel
Content-Type: application/json
} ```
-# [JavaScript](#tab/javascript)
--- ### Response
v1.0 Driveitem Extractsensitivitylabels https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/driveitem-extractsensitivitylabels.md
The following are the possible values for the error types.
The following is an example of a request.
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "extract-sensitivitylabels", "tags": "service.graph", "sampleKeys": ["016GVDAP3RCQS5VBQHORFIVU2ZMOSBL25U"] } --> ``` http POST https://graph.microsoft.com/beta/drive/root/items/016GVDAP3RCQS5VBQHORFIVU2ZMOSBL25U/extractSensitivityLabels ```
-# [JavaScript](#tab/javascript)
--- ### Response
v1.0 Dynamics Currencies Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/dynamics-currencies-delete.md
Title: Delete currencies
-description: Deletes a currency object in Dynamics 365 Business Central.
-
+ Title: "Delete currencies"
+description: "Delete a currency object in Dynamics 365 Business Central."
+ documentationcenter: ''-+ ms.localizationpriority: medium ms.prod: "dynamics-365-business-central" doc_type: apiPageType
This method supports the [OData Query Parameters](/graph/query-parameters) to he
|Header|Value| ||--| |Authorization |Bearer {token}. Required. |
-|If-Match |Required. When this request header is included and the eTag provided does not match the current tag on the **currencies**, the **currencies** will not be
- updated. |
+|If-Match |Required. When this request header is included and the eTag provided does not match the current tag on the **currencies**, the **currencies** will not be updated. |
## Request body Do not supply a request body for this method. ## Response
-If successful, this method returns ```204 No Content``` response code. It does not return anything in the response body.
+If successful, this method returns `204 No Content` response code. It does not return anything in the response body.
## Example
-**Request**
+### Request
-Here is an example of the request.
+The following is an example of the request.
```http DELETE https://graph.microsoft.com/beta/financials/companies/{id}/currencies/{id} ```
-**Response**
+### Response
-Here is an example of the response.
+The following is an example of the response.
```http HTTP/1.1 204 No Content
v1.0 Dynamics Customer Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/dynamics-customer-delete.md
Title: Delete customers
-description: Deletes a customers object from Dynamics 365 Business Central.
-
+ Title: "Delete customers"
+description: "Delete a customers object from Dynamics 365 Business Central."
+ documentationcenter: ''-+ ms.localizationpriority: medium ms.prod: "dynamics-365-business-central" doc_type: apiPageType
This method supports the [OData Query Parameters](/graph/query-parameters) to he
Do not supply a request body for this method. ## Response
-If successful, this method returns ```204 No Content``` response code. It does not return anything in the response body.
+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
## Example
-**Request**
+### Request
-Here is an example of the request.
+The following is an example of the request.
```http DELETE https://graph.microsoft.com/beta/financials/companies/{id}/customers/{id} ```
-**Response**
+### Response
-Here is an example of the response.
+The following is an example of the response.
```http HTTP/1.1 204 No Content ```---
v1.0 Educationassignment Delete Rubric https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignment-delete-rubric.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Delete an [educationRubric](../resources/educationrubric.md) from an [educationAssignment](../resources/educationassignment.md).
-This method does not delete the rubric itself.
+
+This method does not delete the rubric itself and can only be performed by teachers.
## Permissions
v1.0 Educationassignment Get Rubric https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignment-get-rubric.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get the [educationRubric](../resources/educationrubric.md) object attached to an [educationAssignment](../resources/educationassignment.md), if one exists.
+Get the [educationRubric](../resources/educationrubric.md) object attached to an [educationAssignment](../resources/educationassignment.md), if one exists. Only teachers, students, and applications with application permissions can perform this operation.
## Permissions
v1.0 Educationassignment Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignment-get.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get the properties and relationships of an [assignment](../resources/educationassignment.md).
+Get the properties and relationships of an [assignment](../resources/educationassignment.md). Only teachers, students, and applications with application permissions can perform this operation.
Students can only see assignments assigned to them; teachers and applications with application permissions can see all assignments in a class.
v1.0 Educationassignment List Categories https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignment-list-categories.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-List all the categories associated with an [assignment](../resources/educationassignment.md).
+List all the categories associated with an [assignment](../resources/educationassignment.md). Only teachers, students, and applications with application permissions can perform this operation.
## 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 Educationassignment List Resources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignment-list-resources.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get all the [educationAssignmentResource](../resources/educationassignmentresource.md) objects associated with an [assignment](../resources/educationassignment.md).
+Get all the [educationAssignmentResource](../resources/educationassignmentresource.md) objects associated with an [assignment](../resources/educationassignment.md). Only teachers, students, and applications with application permissions can perform this operation.
## 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 Educationassignment List Submissions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignment-list-submissions.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-List all the [submissions](../resources/educationsubmission.md) associated with an [assignment](../resources/educationassignment.md).
+List all the [submissions](../resources/educationsubmission.md) associated with an [assignment](../resources/educationassignment.md). Only teachers, students, and applications with application permissions can perform this operation.
A teacher or an application with application permissions can get all the **submissions**, a student can only get **submissions** that they are associated with.
v1.0 Educationassignment Post Categories https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignment-post-categories.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Add one or more existing [educationCategory](../resources/educationcategory.md) objects to this [educationAssignment](../resources/educationassignment.md).
+Add one or more existing [educationCategory](../resources/educationcategory.md) objects to this [educationAssignment](../resources/educationassignment.md). Only teachers and students can perform this operation.
## 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 Educationassignment Post Resources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignment-post-resources.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Create an [assignment resource](../resources/educationassignmentresource.md). You can create the following types of assignment resources:
+Create an [assignment resource](../resources/educationassignmentresource.md). Only teachers can perform this operation.
+
+You can create the following types of assignment resources:
- [educationFileResource](../resources/educationfileresource.md) - [educationExcelResource](../resources/educationexcelresource.md)
Create an [assignment resource](../resources/educationassignmentresource.md). Yo
- [educationMediaResource](../resources/educationmediaresource.md) - [educationTeamsAppResource](../resources/educationteamsappresource.md)
-Every resource has an @odata.type property to indicate which type of resource is being created.
+Every resource has an **@odata.type** property to indicate which type of resource is being created.
> [!IMPORTANT] > Before you can upload an assignment resource, you must [set up the resources folder](../api/educationassignment-setupresourcesfolder.md) for the [educationAssignment](../resources/educationassignment.md) to upload the files to.
The following is an example of the response.
<!-- { "blockType": "response", "truncated": true,
- "@odata.type": "microsoft.graph.educationMediaResource"
+ "@odata.type": "microsoft.graph.educationTeamsAppResource"
} --> ```http HTTP/1.1 201 Created
v1.0 Educationassignment Put Rubric https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignment-put-rubric.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Attach an existing [educationRubric](../resources/educationrubric.md) object to an [educationAssignment](../resources/educationassignment.md).
+Attach an existing [educationRubric](../resources/educationrubric.md) object to an [educationAssignment](../resources/educationassignment.md). Only teachers can perform this operation.
## Permissions
v1.0 Educationassignment Remove Category https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignment-remove-category.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Remove an [educationCategory](../resources/educationcategory.md) from an [educationAssignment](../resources/educationassignment.md).
+Remove an [educationCategory](../resources/educationcategory.md) from an [educationAssignment](../resources/educationassignment.md). Only teachers can perform this operation.
## 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 Educationassignment Setupfeedbackresourcesfolder https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignment-setupfeedbackresourcesfolder.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Create a SharePoint folder to upload feedback files for a given [educationSubmission](../resources/educationsubmission.md).
+Create a SharePoint folder to upload feedback files for a given [educationSubmission](../resources/educationsubmission.md). Only teachers can perform this operation.
The teacher determines the resources to upload in the feedback resources folder of a submission.
v1.0 Educationassignment Setupresourcesfolder https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignment-setupresourcesfolder.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Create a SharePoint folder to upload files for a given [educationAssignment](../resources/educationassignment.md).
+Create a SharePoint folder to upload files for a given [educationAssignment](../resources/educationassignment.md). Only teachers can perform this operation.
-The teacher determines the resources to upload in the assignment's folder.
+The teacher determines the resources to upload in the assignment's folder.
## 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 Educationassignmentdefaults Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignmentdefaults-get.md
Namespace: microsoft.graph
Read the properties and relationships of an [educationAssignmentDefaults](../resources/educationassignmentdefaults.md) object.
-These are the class-level assignment defaults respected by new [assignments](../resources/educationassignment.md) created in the class. Callers can continue to specify custom values on each **assignment** creation if they don't want the default behaviors.
+These are the class-level assignment defaults respected by new [assignments](../resources/educationassignment.md) created in the class. Callers can continue to specify custom values on each **assignment** creation if they don't want the default behaviors. Only teachers can perform this operation.
## 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 Educationassignmentresource Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignmentresource-get.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get the properties of an [education assignment resource](../resources/educationassignmentresource.md) associated with an [assignment](../resources/educationassignment.md).
+Get the properties of an [education assignment resource](../resources/educationassignmentresource.md) associated with an [assignment](../resources/educationassignment.md). Only teachers, students, and applications with application permissions can perform this operation.
## 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 Educationassignmentsettings Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignmentsettings-get.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Read the properties and relationships of an [educationAssignmentSettings](../resources/educationassignmentsettings.md) object.
+Read the properties and relationships of an [educationAssignmentSettings](../resources/educationassignmentsettings.md) object. Only teachers can perform this operation.
## 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 Educationcategory Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationcategory-delete.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Delete an existing category.
+Delete an existing category. Only teachers can perform this operation.
## Permissions
v1.0 Educationcategory Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationcategory-get.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve an [educationCategory](../resources/educationcategory.md) object.
+Retrieve an [educationCategory](../resources/educationcategory.md) object. Only teachers, students, and applications with application permissions can perform this operation.
## Permissions
v1.0 Educationclass List Assignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationclass-list-assignments.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve a list of assignment objects.
+Retrieve a list of assignment objects. Only teachers, students, and applications with application permissions can perform this operation.
A teacher or an application executing with application permissions can see all assignment objects for the class. Students can only see assignments that are assigned to them.
v1.0 Educationclass List Categories https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationclass-list-categories.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve a list of [educationCategory](../resources/educationcategory.md) objects.
+Retrieve a list of [educationCategory](../resources/educationcategory.md) objects. Only teachers can perform this operation.
## Permissions
v1.0 Educationclass Post Assignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationclass-post-assignments.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Create a new assignment.
+Create a new assignment.
Only teachers in a class can create an assignment. Assignments start in the Draft state, which means that students will not see the assignment until publication.
v1.0 Educationclass Post Category https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationclass-post-category.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Creates a new [educationCategory](../resources/educationcategory.md) on an [educationClass](../resources/educationclass.md).
+Creates a new [educationCategory](../resources/educationcategory.md) on an [educationClass](../resources/educationclass.md). Only teachers can perform this operation.
## 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 Educationoutcome Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationoutcome-update.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Update the properties of an [educationOutcome](../resources/educationoutcome.md) object.
+Update the properties of an [educationOutcome](../resources/educationoutcome.md) object. Only teachers can perform this operation.
## Permissions
v1.0 Educationrubric Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationrubric-delete.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Delete an [educationRubric](../resources/educationrubric.md) object.
+Delete an [educationRubric](../resources/educationrubric.md) object. Only teachers can perform this operation.
## Permissions
v1.0 Educationrubric Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationrubric-get.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve the properties and relationships of an [educationRubric](../resources/educationrubric.md) object.
+Retrieve the properties and relationships of an [educationRubric](../resources/educationrubric.md) object. Only teachers and students can perform this operation.
## Permissions
v1.0 Educationrubric Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationrubric-update.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Update the properties of an [educationRubric](../resources/educationrubric.md) object.
+Update the properties of an [educationRubric](../resources/educationrubric.md) object. Only teachers can perform this operation.
Updating a rubric attached to an assignment (`PATCH /education/classes/{id}/assignments/{id}/rubric`) is only possible before the assignment is published, and what is updated is actually the original rubric that exists under `/education/users/{id}/rubrics`. After the assignment is published, an immutable copy of the rubric is made that is attached to that specific assignment. That rubric can be retrieved using [GET /education/classes/{id}/assignments/{id}/rubric](educationrubric-get.md), but it cannot be updated.
v1.0 Educationsubmission Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-get.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve a particular [submission](../resources/educationsubmission.md).
+Retrieve a particular [submission](../resources/educationsubmission.md). Only teachers, students, and applications with application permissions can perform this operation.
A **submission** object represents a student's work for an [assignment](../resources/educationassignment.md). Resources associated with the **submission** represent this work.
v1.0 Educationsubmission List Outcomes https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-list-outcomes.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve a list of [educationOutcome](../resources/educationoutcome.md) objects. There are four types of outcomes: **educationPointsOutcome**, **educationFeedbackOutcome**, **educationRubricOutcome**, and **educationFeedbackResourceOutcome**.
+Retrieve a list of [educationOutcome](../resources/educationoutcome.md) objects. There are four types of outcomes: **educationPointsOutcome**, **educationFeedbackOutcome**, **educationRubricOutcome**, and **educationFeedbackResourceOutcome**. Only teachers, students, and applications with application permissions can perform this operation.
A submission for a credit assignment (one that has no point value and no rubric) will have an [educationFeedbackOutcome](../resources/educationpointsoutcome.md). (It might also return an [educationPointsOutcome](../resources/educationpointsoutcome.md), but that outcome is ignored.)
v1.0 Educationsubmission List Resources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-list-resources.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-List the resources associated with a submission.
+List the resources associated with a submission. Only teachers, students, and applications with application permissions can perform this operation.
The [educationSubmissionResource](../resources/educationsubmissionresource.md) object is a wrapper around the actual resource object the student is working on. The wrapper also includes a pointer to the resources on the assignment if this was copied from the assignment during the assign process. These resources are the working copy of the assignment. The **submittedResources** are the resources that have officially been submitted to be graded.
v1.0 Educationsubmission List Submittedresources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-list-submittedresources.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-List the [educationSubmissionResource](../resources/educationsubmissionresource.md) objects that have officially been submitted for grading. The student who owns the submission cannot change the submitted list without resubmitting the assignment. This is a wrapper around the real resource and can contain a pointer back to the actual assignment resource if this resource was copied from the assignment.
+List the [educationSubmissionResource](../resources/educationsubmissionresource.md) objects that have officially been submitted for grading. Only teachers, students, and applications with application permissions can perform this operation.
+
+The student who owns the submission cannot change the submitted list without resubmitting the assignment. This is a wrapper around the real resource and can contain a pointer back to the actual assignment resource if this resource was copied from the assignment.
## 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 Educationsubmission Post Resources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-post-resources.md
Namespace: microsoft.graph
Add a [educationSubmissionResource](../resources/educationsubmissionresource.md) to a submission resource list.
-Only the student assigned to the submission can perform this operation.
+Only teachers and students can perform this operation.
-The operation will not succeed if the **allowStudentsToAddResources** flag is not set to `true`.
+The operation will not succeed if the **allowStudentsToAddResources** flag is not set to `true`.
To create a new file-based resource, upload the file to the resources folder associated with the submission. If the file doesn't exist or is not in that folder, the POST request will fail.
v1.0 Educationsubmission Setupresourcesfolder https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-setupresourcesfolder.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Trigger the creation of the SharePoint resource folder where all file-based resources (Word, Excel, and so on) should be uploaded for a given submission.
+Trigger the creation of the SharePoint resource folder where all file-based resources (Word, Excel, and so on) should be uploaded for a given submission. Only teachers and students can perform this operation.
Note that files must be located in this folder in order to be added as resources. Only a student in the class can determine what files to upload in a given submission-level resource folder.
v1.0 Educationsubmission Submit https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-submit.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Indicate that a student is done with the work and is ready to hand in the assignment.
+Indicate that a student is done with the work and is ready to hand in the assignment. Only teachers, students, and applications with application permissions can perform this operation.
This method changes the status of the submission from `working` to `submitted`. During the submit process, all the resources are copied to the **submittedResources** bucket. The teacher will be looking at the submitted resources list for grading.
v1.0 Educationsubmission Unsubmit https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmission-unsubmit.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Indicate that a student wants to work on the submitted assignment after it was turned in.
+Indicate that a student wants to work on the submitted assignment after it was turned in. Only teachers, students, and applications with application permissions can perform this operation.
This method changes the status of the submission from `submitted` to `working`. During the submit process, all the resources are copied from **submittedResources** to **workingResources**. The teacher will be looking at the working resources list for grading.
v1.0 Educationsubmissionresource Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmissionresource-delete.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Deletes an [educationSubmissionResource](../resources/educationsubmissionresource.md) from the submission. This can only be done by the student. If the resource was copied from the assignment, a new copy of the resource will be created after the current copy is deleted. This allows you to "reset" the resource to its original state. If the resource was not copied from the assignment but was added from the student, the resource is simply deleted.
+Delete an [educationSubmissionResource](../resources/educationsubmissionresource.md) from the submission. Only teachers and students can perform this operation.
+
+If the resource was copied from the assignment, a new copy of the resource will be created after the current copy is deleted. This allows you to "reset" the resource to its original state. If the resource was not copied from the assignment but was added from the student, the resource is simply deleted.
## 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 Educationsubmissionresource Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmissionresource-get.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve the properties of a specific resource associated with a [submission](../resources/educationsubmissionresource.md).
+Retrieve the properties of a specific resource associated with a [submission](../resources/educationsubmissionresource.md). Only teachers, students, and applications with application permissions can perform this operation.
This resource is in the "working" resource list and should be considered work in process by a student. This resource is wrapped with a possible pointer back to the assignment resource if it was copied from the assignment.
v1.0 Educationsubmittedsubmissionresource Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationsubmittedsubmissionresource-get.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve a [submitted resource](../resources/educationsubmissionresource.md).
+Retrieve a [submitted resource](../resources/educationsubmissionresource.md). Only teachers, students, and applications with application permissions can perform this operation.
Resources will be available to a teacher or an application with application permissions after a student submits it, and will be available to the student after the teacher releases the submission. Note that teachers can leave notes in some resources.
v1.0 Educationuser List Assignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationuser-list-assignments.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Returns a list of assignments assigned to a user for all classes.
+Returns a list of assignments assigned to a user for all classes. Only teachers, students, and applications with application permissions can perform this operation.
This utility namespace allows a caller to find all the assignments belonging to a student or a teacher in a single call rather than having to request assignments from each class. The assignment list contains what is needed to get the detailed information for the assignment from within the class namespace. All other operations on the assignment should use the class namespace.
v1.0 Emailauthenticationmethodconfiguration Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/emailauthenticationmethodconfiguration-delete.md
Title: "Delete emailAuthenticationMethodConfiguration" description: "Deletes an emailAuthenticationMethodConfiguration object."-+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
v1.0 Emailauthenticationmethodconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/emailauthenticationmethodconfiguration-get.md
Title: "Get emailAuthenticationMethodConfiguration" description: "Read the properties and relationships of an emailAuthenticationMethodConfiguration object."-+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
Content-Type: application/json
"id": "Email", "state": "enabled", "allowExternalIdToUseEmailOtp": "default",
- "includeTargets": []
+ "includeTargets": [],
+ "excludeTargets": []
} ```
v1.0 Emailauthenticationmethodconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/emailauthenticationmethodconfiguration-update.md
Title: "Update emailAuthenticationMethodConfiguration" description: "Update the properties of an emailAuthenticationMethodConfiguration object."-+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
v1.0 Entitlementmanagement Post Accesspackageassignmentpolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/entitlementmanagement-post-accesspackageassignmentpolicies.md
Content-type: application/json
#### Request
-In the following example, the pre-defined **customAccessPackageWorkflowExtension** object is triggered when an access package assigned request is created and when it's granted.
+In the following example, the pre-defined **customAccessPackageWorkflowExtension** object is triggered when an access package assigned request is created and when it's granted. The identifier provided within the **customExtension** field is the **customAccessPackageWorkflowExtension** object's ID.
# [HTTP](#tab/http)
Content-type: application/json
{ "stage": "assignmentRequestCreated", "customExtension": {
- "id": "219f57b6-7983-45a1-be01-2c228b7a43f8" //customAccessPackageWorkflowExtension.id
+ "id": "219f57b6-7983-45a1-be01-2c228b7a43f8"
} }, {
Content-type: application/json
[!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 Fido2authenticationmethodconfiguration Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/fido2authenticationmethodconfiguration-delete.md
Title: "Delete fido2AuthenticationMethodConfiguration" description: "Delete a fido2AuthenticationMethodConfiguration object."-+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
v1.0 Fido2authenticationmethodconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/fido2authenticationmethodconfiguration-get.md
Title: "Get fido2AuthenticationMethodConfiguration" description: "Read the properties and relationships of a fido2AuthenticationMethodConfiguration object."-+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
Content-type: application/json
"id": "all_users", "isRegistrationRequired": false }
- ]
+ ],
+ "excludeTargets": []
} ```
v1.0 Fido2authenticationmethodconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/fido2authenticationmethodconfiguration-update.md
Title: "Update fido2AuthenticationMethodConfiguration" description: "Update the properties of a fido2AuthenticationMethodConfiguration object."-+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
v1.0 Group List Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/group-list-members.md
Get a list of the group's direct members. A group can have users, contacts, devi
When a group contains more than 100 members, Microsoft Graph returns a `@odata.nextLink` property in the response that contains a URL to the next page of results. If that property is present, continue making additional requests with the `@odata.nextLink` URL in each response, until all the results are returned, as described in [paging Microsoft Graph data in your app](/graph/paging).
+An attempt to filter by an OData cast that represents an unsupported member type returns a `400 Bad Request` error with the `Request_UnsupportedQuery` code.
+ ## 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.
If successful, this method returns a `200 OK` response code and collection of [directoryObject](../resources/directoryobject.md) objects in the response body.
+An attempt to filter by an OData cast that represents an unsupported member type returns a `400 Bad Request` error with the `Request_UnsupportedQuery` code. For example, `/groups/{id}}/members/microsoft.graph.group` when the group is a Microsoft 365 group will return this error, because Microsoft 365 groups cannot have other groups as members.
+ ## Examples ### Example 1: Get the direct membership in a group
v1.0 Group List Transitivemembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/group-list-transitivemembers.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get a list of the group's members. A group can have users, contacts, devices, service principals, and other groups as members. This operation is transitive and will also return a flat list of all nested members.
+Get a list of the group's members. A group can different object types as members. For more information about supported member types for different groups, see [Group membership](../resources/groups-overview.md#group-membership).
+
+This operation is transitive and returns a flat list of all nested members. An attempt to filter by an OData cast that represents an unsupported member type returns a `400 Bad Request` error with the `Request_UnsupportedQuery` code.
## Permissions
Do not supply a request body for this method.
If successful, this method returns a `200 OK` response code and collection of [directoryObject](../resources/directoryobject.md) objects in the response body.
+ An attempt to filter by an OData cast that represents an unsupported member type returns a `400 Bad Request` error with the `Request_UnsupportedQuery` code. For example, `/groups/{id}}/transitiveMembers/microsoft.graph.group` when the group is a Microsoft 365 group will return this error, because Microsoft 365 groups cannot have other groups as members.
+ ## Examples ### Example 1: Get the transitive membership of a group
Content-type: application/json
The following is an example of the request.
-# [HTTP](#tab/http)
- <!-- { "blockType": "ignored", "name": "get_group_transitivemembers_count"
GET https://graph.microsoft.com/beta/groups/{id}/transitiveMembers/$count
ConsistencyLevel: eventual ```
-# [C#](#tab/csharp)
--
-# [JavaScript](#tab/javascript)
--
-# [Objective-C](#tab/objc)
--
-# [Java](#tab/java)
----- #### Response The following is an example of the response. <!-- {
- "blockType": "response",
+ "blockType": "response"
} -->- ```http HTTP/1.1 200 OK Content-type: text/plain
v1.0 Group List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/group-list.md
Content-type: application/json
} ```
-### Example 5: Use $search to get groups with display names that contain the letters 'Video' including a count of returned objects
-
-#### Request
-
-The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries).
-
-> **Note:** The `$count` and `$search` query parameters are currently not available in Azure AD B2C tenants.
--
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "get_video_count_true"
-}-->
-
-```msgraph-interactive
-GET https://graph.microsoft.com/beta/groups?$search="displayName:Video"&$count=true
-ConsistencyLevel: eventual
-```
-
-# [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.
-
-<!-- {
- "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.group",
- "isCollection": true
-} -->
-
-```http
-HTTP/1.1 200 OK
-Content-type: application/json
-
-{
- "@odata.context":"https://graph.microsoft.com/beta/$metadata#groups",
- "@odata.count":1396,
- "value":[
- {
- "displayName":"SFA Videos",
- "mail":"SFAVideos@service.contoso.com",
- "mailNickname":"SFAVideos"
- }
- ]
-}
-```
-
-### Example 6: Use $search to get groups with display names that contain the letters 'Video' or a description that contains the letters 'prod' including a count of returned objects
+### Example 5: Use $search to get groups with display names that contain the letters 'Video' or a description that contains the letters 'prod' including a count of returned objects
#### Request
Content-type: application/json
} ```
-### Example 7: List dynamic groups
+### Example 6: List dynamic groups
#### Request
Content-type: application/json
} ```
-### Example 8: List any groups with any licenses
+### Example 7: List any groups with any licenses and get the group's members
#### Request
Content-type: application/json
}--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/groups?$select=id,assignedLicenses&$filter=assignedLicenses/any()
+GET https://graph.microsoft.com/beta/groups?$select=id,assignedLicenses&$filter=assignedLicenses/any()&$expand=members($select=id,displayName)
``` # [C#](#tab/csharp)
HTTP/1.1 200 OK
Content-type: application/json {
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#groups(id,assignedLicenses)",
- "value": [
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#groups(id,assignedLicenses,members())",
+ "value": [
+ {
+ "id": "5caf712c-8483-4b3d-8384-d8da988c0ca4",
+ "assignedLicenses": [
{
- "id": "5caf712c-8483-4b3d-8384-d8da988c0ca4",
- "assignedLicenses": [
- {
- "disabledPlans": [],
- "skuId": "6fd2c87f-b296-42f0-b197-1e91e994b900"
- }
- ]
- },
+ "disabledPlans": [],
+ "skuId": "6fd2c87f-b296-42f0-b197-1e91e994b900"
+ }
+ ],
+ "members": [
{
- "id": "aae8ec2a-5a08-4013-ae70-fafbb5c20de1",
- "assignedLicenses": [
- {
- "disabledPlans": [
- "7547a3fe-08ee-4ccb-b430-5077c5041653"
- ],
- "skuId": "18181a46-0d4e-45cd-891e-60aabd171b4e"
- }
- ]
+ "@odata.type": "#microsoft.graph.user",
+ "id": "0952e4c8-432f-4950-a65c-769c45993527"
}, {
- "id": "e55bdaa0-e104-479a-979e-b0457fff6380",
- "assignedLicenses": [
- {
- "disabledPlans": [
- "7547a3fe-08ee-4ccb-b430-5077c5041653"
- ],
- "skuId": "6fd2c87f-b296-42f0-b197-1e91e994b900"
- }
- ]
+ "@odata.type": "#microsoft.graph.user",
+ "id": "49e373b6-4717-40c6-ad43-843c45a258f0"
}
- ]
+ ]
+ },
+ {
+ "id": "aae8ec2a-5a08-4013-ae70-fafbb5c20de1",
+ "assignedLicenses": [
+ {
+ "disabledPlans": [
+ "7547a3fe-08ee-4ccb-b430-5077c5041653"
+ ],
+ "skuId": "18181a46-0d4e-45cd-891e-60aabd171b4e"
+ }
+ ],
+ "members": []
+ }
+ ]
} ```
v1.0 Group Post Groups https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/group-post-groups.md
Content-type: application/json
The following is an example of the request. The calling user must be assigned the _RoleManagement.ReadWrite.Directory_ permission to set the **isAssignableToRole** property or update the membership of such groups.
-**NOTE:** A group with **isAssignableToRole** property set to `true` cannot be of dynamic membership type. For more information, see [Using a group to manage Azure AD role assignments](https://go.microsoft.com/fwlink/?linkid=2103037).
+A group with **isAssignableToRole** property set to `true` cannot be of dynamic membership type, its **securityEnabled** must be set to `true`, and **visibility** can only be `Private`.
# [HTTP](#tab/http)
v1.0 Group Post Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/group-post-members.md
Namespace: microsoft.graph
Add a member to a security or Microsoft 365 group through the **members** navigation property.
-The following table shows the types of members that can be added to either security groups or Microsoft 365 groups.
-
-| Object type | Member of security group | Member of Microsoft 365 group |
-|-|-|-|
-| User | ![Can be group member][Yes] | ![Can be group member][Yes] |
-| Security group | ![Can be group member][Yes] | ![Cannot be group member][No] |
-| Microsoft 365 group | ![Cannot be group member][No] | ![Cannot be group member][No] |
-| Device | ![Can be group member][Yes] | ![Cannot be group member][No] |
-| Service principal | ![Can be group member][Yes] | ![Cannot be group member][No] |
-| Organizational contact | ![Can be group member][Yes] | ![Cannot be group member][No] |
- ## 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).
+The following table shows the least privileged permission that's required by each resource type when calling 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) | GroupMember.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All |
-| Delegated (personal Microsoft account) | Not supported. |
-| Application | GroupMember.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All |
+| Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application |
+|:-|:|:-|:|
+| [device](../resources/device.md) | GroupMember.ReadWrite.All and Device.ReadWrite.All | Not supported. | GroupMember.ReadWrite.All and Device.ReadWrite.All |
+| [group](../resources/group.md) | GroupMember.ReadWrite.All and Group.ReadWrite.All | Not supported. | GroupMember.ReadWrite.All and Group.ReadWrite.All |
+| [orgContact](../resources/device.md) | GroupMember.ReadWrite.All and OrgContact.Read.All | Not supported. | GroupMember.ReadWrite.All and OrgContact.Read.All |
+| [servicePrincipal](../resources/group.md) | GroupMember.ReadWrite.All and Application.ReadWrite.All | Not supported. | GroupMember.ReadWrite.All and Application.ReadWrite.All |
+| [user](../resources/user.md) | GroupMember.ReadWrite.All and User.ReadWrite.All | Not supported. | UGroupMember.ReadWrite.All and User.ReadWrite.All |
> [!IMPORTANT] > To add members to a role-assignable group, the calling user must also be assigned the _RoleManagement.ReadWrite.Directory_ permission.
v1.0 Horizontalsection Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/horizontalsection-get.md
GET https://graph.microsoft.com/beta/sites/{sitesId}/pages/{sitePageId}/canvasLa
[!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)
+
GET https://graph.microsoft.com/beta/sites/{sitesId}/pages/{sitePageId}/canvasLa
[!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 Horizontalsection List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/horizontalsection-list.md
GET https://graph.microsoft.com/beta/sites/{sitesId}/pages/{sitePageId}/canvasLa
[!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 Horizontalsectioncolumn Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/horizontalsectioncolumn-get.md
GET https://graph.microsoft.com/beta/sites/{sitesId}/pages/{sitePageId}/canvasLa
[!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)
+
GET https://graph.microsoft.com/beta/sites/{sitesId}/pages/{sitePageId}/canvasLa
[!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 Horizontalsectioncolumn List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/horizontalsectioncolumn-list.md
GET https://graph.microsoft.com/beta/sites/{sitesId}/pages/{sitePageId}/canvasLa
[!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 Identitycontainer Post Identityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitycontainer-post-identityproviders.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Create an identity provider resource that is of the type specified in the request body.
+Create an identity provider object that is of the type specified in the request body.
Among the types of providers derived from identityProviderBase, you can currently create a [socialIdentityProvider](../resources/socialidentityprovider.md) resource in Azure AD. In Azure AD B2C, this operation can currently create a [socialIdentityProvider](../resources/socialidentityprovider.md), [openIdConnectIdentityProvider](../resources/openidconnectidentityprovider.md), or an [appleManagedIdentityProvider](../resources/applemanagedidentityprovider.md) resource.
v1.0 Identitygovernance Lifecycleworkflowscontainer Post Customtaskextensions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-lifecycleworkflowscontainer-post-customtaskextensions.md
You can specify the following properties when creating a **customTaskExtension**
|authenticationConfiguration|[microsoft.graph.customExtensionAuthenticationConfiguration](../resources/customextensionauthenticationconfiguration.md)|The authentication configuration for the `customTaskExtension`.| |clientConfiguration|[microsoft.graph.customExtensionClientConfiguration](../resources/customextensionclientconfiguration.md)|The client configuration for a custom extension.| |description|String|The description of the `customTaskExtension`.|
-|displayName|String|The display name of the `customTaskExtension`.|
+|displayName|String|A unique string that identifies the `customTaskExtension`.|
|endpointConfiguration|[microsoft.graph.customExtensionEndpointConfiguration](../resources/customextensionendpointconfiguration.md)|The endpoint configuration for a custom extension. Optional.| |callbackConfiguration|[microsoft.graph.identityGovernance.customTaskExtensionCallbackConfiguration](../resources/identitygovernance-customtaskextensioncallbackconfiguration.md)|The callback configuration for a custom extension. Optional.|
v1.0 Identitygovernance Run List Taskprocessingresults https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-run-list-taskprocessingresults.md
Title: "List taskProcessingResults (for a userProcessingResult in a run)"
-description: "Get the taskProcessingResult resources for a userProcessingResult from a run."
+ Title: "List taskProcessingResults (for a run)"
+description: "Get the taskProcessingResult resources from a run."
ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
-# List taskProcessingResults (for a userProcessingResult in a run)
+# List taskProcessingResults (for a run)
Namespace: microsoft.graph.identityGovernance [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get the taskProcessingResult resources for a [userProcessingResult](../resources/identitygovernance-userprocessingresult.md) from a [run](../resources/identitygovernance-run.md).
+Get the [taskProcessingResult](../resources/identitygovernance-taskprocessingresult.md) resources for a [run](../resources/identitygovernance-run.md).
## Permissions
For delegated scenarios, the admin needs one of the following [Azure AD roles](/
} --> ``` http
-GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/{runId}/userProcessingResults/{userProcessingResultId}/taskProcessingResults
+GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/{runId}/taskProcessingResults
``` ## Optional query parameters
If successful, this method returns a `200 OK` response code and a collection of
## Examples
-### Example 1: Get the task processing results for a user processing result in a run report for a workflow
+### Example 1: Get the task processing results in a run report from a workflow
-#### Request
+### Request
The following is an example of a request.
The following is an example of a request.
} --> ``` http
-GET https://graph.microsoft.com/beta/IdentityGovernance/lifecycleWorkflows/workflows/14879e66-9ea9-48d0-804d-8fea672d0341/runs/72885f91-2cf0-44b1-b3ed-bd145af0192c/userProcessingResults/78b83505-6967-4168-a7ea-4921c0543ce9/taskProcessingResults
+GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/a977dbe8-0f3f-4ae6-b3a7-29e1010ac4cc/runs/33bf1a9c-2b26-49b6-996f-ca416c518341/taskProcessingResults
``` # [C#](#tab/csharp)
GET https://graph.microsoft.com/beta/IdentityGovernance/lifecycleWorkflows/workf
-#### Response
+### Response
The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
HTTP/1.1 200 OK
Content-Type: application/json {
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/workflows('14879e66-9ea9-48d0-804d-8fea672d0341')/runs('dad77a47-6eda-4de7-bc37-fe8eb5aaf17d')/userProcessingResults('78b83505-6967-4168-a7ea-4921c0543ce9')/taskProcessingResults",
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/workflows('a977dbe8-0f3f-4ae6-b3a7-29e1010ac4cc')/runs('33bf1a9c-2b26-49b6-996f-ca416c518341')/taskProcessingResults",
"value": [ {
- "completedDateTime": "2022-08-24T23:28:05.3529197Z",
- "createdDateTime": "2022-08-24T23:28:04.5490995Z",
- "id": "05a96d7a-0e00-459c-b6c8-1870099e8275",
- "processingStatus": "completed",
- "startedDateTime": "2022-08-24T23:28:05.1234966Z",
- "failureReason": null,
- "subject": {
- "id": "ea09ac2e-77e3-4134-85f2-25ccf3c33387"
- },
- "task": {
- "category": "joiner,leaver",
- "continueOnError": false,
- "description": "Enable user account in the directory",
- "displayName": "Enable User Account",
- "executionSequence": 1,
- "id": "917e9eab-415d-4e45-b39d-87eb5e30de38",
- "isEnabled": false,
- "taskDefinitionId": "6fc52c9d-398b-4305-9763-15f42c1676fc",
- "arguments": []
- }
- },
- {
- "completedDateTime": "2022-08-24T23:28:06.760333Z",
- "createdDateTime": "2022-08-24T23:28:04.5571759Z",
- "id": "e30b12e1-45fa-4463-8d54-48f43fd8942a",
+ "completedDateTime": "2023-01-20T17:16:03.4863553Z",
+ "createdDateTime": "2023-01-20T17:16:00.9095011Z",
+ "id": "7a21089f-ec13-4e9c-997e-b31f4e59d41e",
"processingStatus": "completed",
- "startedDateTime": "2022-08-24T23:28:06.3926865Z",
+ "startedDateTime": "2023-01-20T17:16:02.8025169Z",
"failureReason": null, "subject": {
- "id": "ea09ac2e-77e3-4134-85f2-25ccf3c33387"
+ "id": "1baa57fa-3c4e-4526-ba5a-db47a9df95f0"
}, "task": { "category": "joiner,leaver", "continueOnError": false, "description": "Add user to selected groups", "displayName": "Add User To Groups",
- "executionSequence": 2,
- "id": "eedd8043-90a1-4e3c-9112-b2a8917ea3ae",
+ "executionSequence": 3,
+ "id": "c8dbaed8-3d23-4e5a-8f65-130767639667",
"isEnabled": true, "taskDefinitionId": "22085229-5809-45e8-97fd-270d28d66910", "arguments": [ { "name": "groupID",
- "value": "e5659cb0-bcbb-4a9f-9092-90f72bd19028"
+ "value": "1624be55-d924-491e-ac72-401f6f961e4d"
} ] }
Content-Type: application/json
} ```
-### Example 2: Get the specific properties of task processing results for a user processing result in a run report for a workflow
+### Example 2: Get the specific properties of task processing results in a run report for a workflow
#### Request The following is an example of a request. - # [HTTP](#tab/http) <!-- { "blockType": "request",
The following is an example of a request.
} --> ``` http
-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
+GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/a977dbe8-0f3f-4ae6-b3a7-29e1010ac4cc/runs/33bf1a9c-2b26-49b6-996f-ca416c518341/taskProcessingResults?$select=id,failureReason,processingStatus,subject
``` # [C#](#tab/csharp)
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workf
-#### Response
+### Response
The following is an example of the response >**Note:** The response object shown here might be shortened for readability.
HTTP/1.1 200 OK
Content-Type: application/json {
- "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/workflows('15239232-66ed-445b-8292-2f5bbb2eb833')/runs('e65e08a0-d68d-41dc-915b-8c4019af5cc2')/userProcessingResults('40efc576-840f-47d0-ab95-5abca800f8a2')/taskProcessingResults(id,failureReason,processingStatus,subject,task)",
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/workflows('a977dbe8-0f3f-4ae6-b3a7-29e1010ac4cc')/runs('33bf1a9c-2b26-49b6-996f-ca416c518341')/taskProcessingResults(id,failureReason,processingStatus,subject)",
"value": [ {
- "id": "78650318-7238-4e7e-852f-2c36cbeff340",
+ "id": "7a21089f-ec13-4e9c-997e-b31f4e59d41e",
"processingStatus": "completed", "failureReason": null, "subject": {
- "id": "df744d9e-2148-4922-88a8-633896c1e929"
+ "id": "1baa57fa-3c4e-4526-ba5a-db47a9df95f0"
}, "task": {
- "category": "leaver",
- "continueOnError": false,
- "description": "Remove all licenses assigned to the user",
- "displayName": "Remove all licenses for user",
- "executionSequence": 1,
- "id": "f71246b2-269c-4ba6-ab8e-afc1a05114cb",
- "isEnabled": true,
- "taskDefinitionId": "8fa97d28-3e52-4985-b3a9-a1126f9b8b4e",
- "arguments": []
- }
- },
- {
- "id": "3d2e459d-5614-42e4-952b-0e917b5f6646",
- "processingStatus": "completed",
- "failureReason": null,
- "subject": {
- "id": "df744d9e-2148-4922-88a8-633896c1e929"
- },
- "task": {
- "category": "leaver",
- "continueOnError": false,
- "description": "Remove user from all Teams memberships",
- "displayName": "Remove user from all Teams",
- "executionSequence": 2,
- "id": "ed545f03-e8d8-45fb-9cbd-15c937f2a866",
- "isEnabled": true,
- "taskDefinitionId": "81f7b200-2816-4b3b-8c5d-dc556f07b024",
- "arguments": []
- }
- },
- {
- "id": "03359fa6-c63c-4573-92c2-4c9518ca98aa",
- "processingStatus": "completed",
- "failureReason": null,
- "subject": {
- "id": "df744d9e-2148-4922-88a8-633896c1e929"
- },
- "task": {
- "category": "leaver",
+ "category": "joiner,leaver",
"continueOnError": false,
- "description": "Delete user account in Azure AD",
- "displayName": "Delete User Account",
+ "description": "Add user to selected groups",
+ "displayName": "Add User To Groups",
"executionSequence": 3,
- "id": "b4cefaa0-6ceb-461d-bbf5-ec69246463fd",
+ "id": "c8dbaed8-3d23-4e5a-8f65-130767639667",
"isEnabled": true,
- "taskDefinitionId": "8d18588d-9ad3-4c0f-99d0-ec215f0e3dff",
- "arguments": []
+ "taskDefinitionId": "22085229-5809-45e8-97fd-270d28d66910",
+ "arguments": [
+ {
+ "name": "groupID",
+ "value": "1624be55-d924-491e-ac72-401f6f961e4d"
+ }
+ ]
} } ]
v1.0 Identitygovernance Task Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-task-update.md
+
+ Title: "Update task (within a workflow)"
+description: "Update the properties of a task object within a workflow object."
+
+ms.localizationpriority: medium
++
+# Update task (within a workflow)
+
+Namespace: microsoft.graph.identityGovernance
++
+Update the properties of a [task](../resources/identitygovernance-task.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)|LifecycleWorkflows.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|LifecycleWorkflows.ReadWrite.All|
+
+For delegated scenarios, the admin needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles):
+
+- Global administrator
+- Lifecycle workflows administrator
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/tasks/{taskId}
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
++
+|Property|Type|Description|
+|:|:|:|
+|description|String|Describes the purpose of the task for administrative use.|
+|displayName|String|A unique string that identifies the task within the workflow.|
+
+## Response
+
+If successful, this action returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+
+The following is an example of a request.
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "lifecycleworkflows_update_task"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/beta/identitygovernance/lifecycleWorkflows/workflows/8696088c-1aef-4f65-afe9-acd55343e327/tasks/eb0b8bc2-7756-4429-8ce8-b9f09063cf54
+Content-Type: application/json
+Content-length: 454
+
+{
+ "description": "Add user to selected groups",
+ "displayName": "Update marketing day 1 add users to Group set up",
+}
+```
+
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Java](#tab/java)
+++++
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
v1.0 Identitygovernance Userprocessingresult Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-userprocessingresult-get.md
Namespace: microsoft.graph.identityGovernance
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get the user processing result of a [run](../resources/identitygovernance-run.md) object.
+Get the user processing result of a user processing result of a [run](../resources/identitygovernance-run.md).
## Permissions
Content-Type: application/json
} } ```-
v1.0 Identitygovernance Userprocessingresult List Taskprocessingresults https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/identitygovernance-userprocessingresult-list-taskprocessingresults.md
Namespace: microsoft.graph.identityGovernance
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get the task processing result from a [userProcessingResult](../resources/identitygovernance-userprocessingresult.md).
+Get the task processing result from a [userProcessingResult](../resources/identitygovernance-userprocessingresult.md) either directly or through a [run](../resources/identitygovernance-run.md).
## Permissions
For delegated scenarios, the admin needs one of the following [Azure AD roles](/
--> ``` http GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/userProcessingResults/{userProcessingResultId}/taskProcessingResults
+GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/{runId}/userProcessingResults/{userProcessingResultId}/taskProcessingResults
``` ## Optional query parameters
Content-Type: application/json
] } ```+
+### Example 3: Get the task processing results for a user processing result in a run report for a workflow
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "lifecycleworkflows_list_workflow_userprocessingresult_taskprocessingresults"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/14879e66-9ea9-48d0-804d-8fea672d0341/runs/72885f91-2cf0-44b1-b3ed-bd145af0192c/userProcessingResults/78b83505-6967-4168-a7ea-4921c0543ce9/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
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.identityGovernance.taskProcessingResult)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/workflows('14879e66-9ea9-48d0-804d-8fea672d0341')/runs('dad77a47-6eda-4de7-bc37-fe8eb5aaf17d')/userProcessingResults('78b83505-6967-4168-a7ea-4921c0543ce9')/taskProcessingResults",
+ "value": [
+ {
+ "completedDateTime": "2022-08-24T23:28:05.3529197Z",
+ "createdDateTime": "2022-08-24T23:28:04.5490995Z",
+ "id": "05a96d7a-0e00-459c-b6c8-1870099e8275",
+ "processingStatus": "completed",
+ "startedDateTime": "2022-08-24T23:28:05.1234966Z",
+ "failureReason": null,
+ "subject": {
+ "id": "ea09ac2e-77e3-4134-85f2-25ccf3c33387"
+ },
+ "task": {
+ "category": "joiner,leaver",
+ "continueOnError": false,
+ "description": "Enable user account in the directory",
+ "displayName": "Enable User Account",
+ "executionSequence": 1,
+ "id": "917e9eab-415d-4e45-b39d-87eb5e30de38",
+ "isEnabled": false,
+ "taskDefinitionId": "6fc52c9d-398b-4305-9763-15f42c1676fc",
+ "arguments": []
+ }
+ },
+ {
+ "completedDateTime": "2022-08-24T23:28:06.760333Z",
+ "createdDateTime": "2022-08-24T23:28:04.5571759Z",
+ "id": "e30b12e1-45fa-4463-8d54-48f43fd8942a",
+ "processingStatus": "completed",
+ "startedDateTime": "2022-08-24T23:28:06.3926865Z",
+ "failureReason": null,
+ "subject": {
+ "id": "ea09ac2e-77e3-4134-85f2-25ccf3c33387"
+ },
+ "task": {
+ "category": "joiner,leaver",
+ "continueOnError": false,
+ "description": "Add user to selected groups",
+ "displayName": "Add User To Groups",
+ "executionSequence": 2,
+ "id": "eedd8043-90a1-4e3c-9112-b2a8917ea3ae",
+ "isEnabled": true,
+ "taskDefinitionId": "22085229-5809-45e8-97fd-270d28d66910",
+ "arguments": [
+ {
+ "name": "groupID",
+ "value": "e5659cb0-bcbb-4a9f-9092-90f72bd19028"
+ }
+ ]
+ }
+ }
+ ]
+}
+```
+
+### Example 4: Get the specific properties of task processing results for a user processing result in a run report for a workflow
+
+#### Request
+
+The following is an example of a request.
+++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "lifecycleworkflows_list_workflow_userprocessingresult_taskprocessingresults_select"
+}
+-->
+``` http
+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
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.identityGovernance.taskProcessingResult)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/workflows('15239232-66ed-445b-8292-2f5bbb2eb833')/runs('e65e08a0-d68d-41dc-915b-8c4019af5cc2')/userProcessingResults('40efc576-840f-47d0-ab95-5abca800f8a2')/taskProcessingResults(id,failureReason,processingStatus,subject,task)",
+ "value": [
+ {
+ "id": "78650318-7238-4e7e-852f-2c36cbeff340",
+ "processingStatus": "completed",
+ "failureReason": null,
+ "subject": {
+ "id": "df744d9e-2148-4922-88a8-633896c1e929"
+ },
+ "task": {
+ "category": "leaver",
+ "continueOnError": false,
+ "description": "Remove all licenses assigned to the user",
+ "displayName": "Remove all licenses for user",
+ "executionSequence": 1,
+ "id": "f71246b2-269c-4ba6-ab8e-afc1a05114cb",
+ "isEnabled": true,
+ "taskDefinitionId": "8fa97d28-3e52-4985-b3a9-a1126f9b8b4e",
+ "arguments": []
+ }
+ },
+ {
+ "id": "3d2e459d-5614-42e4-952b-0e917b5f6646",
+ "processingStatus": "completed",
+ "failureReason": null,
+ "subject": {
+ "id": "df744d9e-2148-4922-88a8-633896c1e929"
+ },
+ "task": {
+ "category": "leaver",
+ "continueOnError": false,
+ "description": "Remove user from all Teams memberships",
+ "displayName": "Remove user from all Teams",
+ "executionSequence": 2,
+ "id": "ed545f03-e8d8-45fb-9cbd-15c937f2a866",
+ "isEnabled": true,
+ "taskDefinitionId": "81f7b200-2816-4b3b-8c5d-dc556f07b024",
+ "arguments": []
+ }
+ },
+ {
+ "id": "03359fa6-c63c-4573-92c2-4c9518ca98aa",
+ "processingStatus": "completed",
+ "failureReason": null,
+ "subject": {
+ "id": "df744d9e-2148-4922-88a8-633896c1e929"
+ },
+ "task": {
+ "category": "leaver",
+ "continueOnError": false,
+ "description": "Delete user account in Azure AD",
+ "displayName": "Delete User Account",
+ "executionSequence": 3,
+ "id": "b4cefaa0-6ceb-461d-bbf5-ec69246463fd",
+ "isEnabled": true,
+ "taskDefinitionId": "8d18588d-9ad3-4c0f-99d0-ec215f0e3dff",
+ "arguments": []
+ }
+ }
+ ]
+}
+```
v1.0 Impactedresource Complete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/impactedresource-complete.md
+
+ Title: "impactedResource: complete"
+description: "Complete an impactedResource object and update its status to completedByUser."
+
+ms.localizationpriority: medium
++
+# impactedResource: complete
+Namespace: microsoft.graph
++
+Complete an [impactedResource](../resources/impactedresource.md) object and update its **status** to `completedByUser`.
+
+## 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)|DirectoryRecommendations.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DirectoryRecommendations.ReadWrite.All|
+
+For delegated scenarios, the admin needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles):
+- Global administrator
+- Security administrator
+- Security operator
+- Application administrator
+- Cloud application administrator
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /directory/recommendations/{recommendationId}/impactedResources/{impactedResourceId}/complete
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this action returns a `200 OK` response code and a [impactedResource](../resources/impactedresource.md) in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "impactedresourcethis.complete"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/directory/recommendations/0cb31920-84b9-471f-a6fb-468c1a847088_Microsoft.Identity.IAM.Insights.ApplicationCredentialExpiry/impactedResources/dbd9935e-15b7-4800-9049-8d8704c23ad2/complete
+```
++
+### 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.impactedResource"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#impactedResource",
+ "@odata.type": "#microsoft.graph.impactedResource",
+ "id": "dbd9935e-15b7-4800-9049-8d8704c23ad2",
+ "subjectId": "f9c3466a-9cb5-46ee-84db-e7e6e405b937",
+ "recommendationId": "7918d4b5-0442-4a97-be2d-36f9f9962ece_Microsoft.Identity.IAM.Insights.ApplicationCredentialExpiry",
+ "resourceType": "app",
+ "addedDateTime": "2022-03-19T09:40:39.0420371Z",
+ "postponeUntilDateTime": null,
+ "lastModifiedDateTime": "2022-04-04T20:43:28.9687029Z",
+ "lastModifiedBy": "b5fa65db-0d2b-4233-8788-ab0213567669",
+ "displayName": "Contoso IWA App Tutorial",
+ "owner": null,
+ "rank": 1,
+ "portalUrl": "https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/Credentials/appId/ f9c3466a-9cb5-46ee-84db-e7e6e405b937",
+ "apiUrl": null,
+ "status": "completedBySystem",
+ "additionalDetails": [
+ {
+ "key": "ExpiringCredentialsCount",
+ "value": "1"
+ }
+ ]
+}
+```
+
v1.0 Impactedresource Dismiss https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/impactedresource-dismiss.md
+
+ Title: "impactedResource: dismiss"
+description: "Dismiss a recommendationResource object and update its status to dismissed."
+
+ms.localizationpriority: medium
++
+# impactedResource: dismiss
+Namespace: microsoft.graph
++
+Dismiss an [impactedResources](../resources/impactedresource.md) object and update its status to `dismissed`.
+
+## 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)|DirectoryRecommendations.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DirectoryRecommendations.ReadWrite.All|
+
+For delegated scenarios, the admin needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles):
+- Global administrator
+- Security administrator
+- Security operator
+- Application administrator
+- Cloud application administrator
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /directory/recommendations/{recommendationId}/impactedResources/{impactedResourceId}/dismiss
+```
+
+## 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 are required with this action.
+
+|Parameter|Type|Description|
+|:|:|:|
+|dismissReason|String|Audited reason for deeming an [impactedResource](../resources/impactedresource.md) inapplicable to you.|
+++
+## Response
+
+If successful, this action returns a `200 OK` response code and a [impactedResource](../resources/impactedresource.md) in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "impactedresourcethis.dismiss"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/directory/recommendations/0cb31920-84b9-471f-a6fb-468c1a847088_Microsoft.Identity.IAM.Insights.ApplicationCredentialExpiry/impactedResources/dbd9935e-15b7-4800-9049-8d8704c23ad2/dismiss
+Content-Type: application/json
+
+{
+ "dismissReason": "Application is no longer needed."
+}
+```
++
+### 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.impactedResource"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#impactedResource",
+ "@odata.type": "#microsoft.graph.impactedResource",
+ "id": "dbd9935e-15b7-4800-9049-8d8704c23ad2",
+ "subjectId": "f9c3466a-9cb5-46ee-84db-e7e6e405b937",
+ "recommendationId": "7918d4b5-0442-4a97-be2d-36f9f9962ece_Microsoft.Identity.IAM.Insights.ApplicationCredentialExpiry",
+ "resourceType": "app",
+ "addedDateTime": "2022-03-19T09:40:39.0420371Z",
+ "postponeUntilDateTime": null,
+ "lastModifiedDateTime": "2022-04-04T20:43:28.9687029Z",
+ "lastModifiedBy": "b5fa65db-0d2b-4233-8788-ab0213567669",
+ "displayName": "Contoso IWA App Tutorial",
+ "owner": null,
+ "rank": 1,
+ "portalUrl": "https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/Credentials/appId/ f9c3466a-9cb5-46ee-84db-e7e6e405b937",
+ "apiUrl": null,
+ "status": "dismissed",
+ "additionalDetails": [
+ {
+ "key": "ExpiringCredentialsCount",
+ "value": "1"
+ }
+ ]
+}
+```
+
v1.0 Impactedresource Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/impactedresource-get.md
+
+ Title: "Get impactedResource"
+description: "Read the properties and relationships of an impactedResource object."
+
+ms.localizationpriority: medium
++
+# Get impactedResource
+Namespace: microsoft.graph
++
+Read the properties and relationships of an [impactedResource](../resources/impactedresource.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)|DirectoryRecommendations.Read.All, DirectoryRecommendations.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DirectoryRecommendations.Read.All, DirectoryRecommendations.ReadWrite.All|
+
+For delegated scenarios, the admin needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles):
+- Global administrator
+- Global reader
+- Security administrator
+- Security operator
+- Security reader
+- Application administrator
+- Cloud application administrator
+- Reports reader
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /directory/recommendations/{recommendationId}/impactedResources/{impactedResourceId}
+```
+
+## Optional query parameters
+This method supports the `$select` OData query parameter 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 an [impactedResource](../resources/impactedresource.md) object in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "get_impactedresource"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/directory/recommendations/0cb31920-84b9-471f-a6fb-468c1a847088_Microsoft.Identity.IAM.Insights.ApplicationCredentialExpiry/impactedResources/dbd9935e-15b7-4800-9049-8d8704c23ad2
+```
++
+### 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.impactedResource"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#directory/recommendations('0cb31920-84b9-471f-a6fb-468c1a847088_Microsoft.Identity.IAM.Insights.ApplicationCredentialExpiry')/impactedResources/$entity",
+ "id": "dbd9935e-15b7-4800-9049-8d8704c23ad2",
+ "subjectId": "f9c3466a-9cb5-46ee-84db-e7e6e405b937",
+ "recommendationId": "0cb31920-84b9-471f-a6fb-468c1a847088_Microsoft.Identity.IAM.Insights.ApplicationCredentialExpiry",
+ "resourceType": "app",
+ "addedDateTime": "2022-03-19T09:40:39.0420371Z",
+ "postponeUntilDateTime": null,
+ "lastModifiedDateTime": "2022-04-04T20:43:28.9687029Z",
+ "lastModifiedBy": "b5fa65db-0d2b-4233-8788-ab0213567669",
+ "displayName": "Contoso IWA App Tutorial",
+ "owner": null,
+ "rank": 1,
+ "portalUrl": "https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/Credentials/appId/f9c3466a-9cb5-46ee-84db-e7e6e405b937",
+ "apiUrl": null,
+ "status": "completedBySystem",
+ "additionalDetails": [
+ {
+ "key": "ExpiringCredentialsCount",
+ "value": "1"
+ }
+ ]
+}
+```
+
v1.0 Impactedresource Postpone https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/impactedresource-postpone.md
+
+ Title: "impactedResource: postpone"
+description: "Postpone action on an impactedResource object to a specified future date and time."
+
+ms.localizationpriority: medium
++
+# impactedResource: postpone
+Namespace: microsoft.graph
++
+Postpone action on an [impactedResource](../resources/impactedresource.md) object to a specified future date and time by marking its **status** as `postponed`. On the specified date and time, Azure AD will automatically mark the status of the **impactedResource** object to `active`.
+
+## 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)|DirectoryRecommendations.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DirectoryRecommendations.ReadWrite.All|
+
+For delegated scenarios, the admin needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles):
+- Global administrator
+- Security administrator
+- Security operator
+- Application administrator
+- Cloud application administrator
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /directory/recommendations/{recommendationId}/impactedResources/{impactedResourceId}/postpone
+```
+
+## 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 are required with this action.
+
+|Parameter|Type|Description|
+|:|:|:|
+|postponeUntilDateTime|DateTimeOffset|The date and time when the **status** of the **impactedResource** will be updated to `active`.|
+++
+## Response
+
+If successful, this action returns a `200 OK` response code and a [impactedResource](../resources/impactedresource.md) in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "impactedresourcethis.postpone"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/directory/recommendations/0cb31920-84b9-471f-a6fb-468c1a847088_Microsoft.Identity.IAM.Insights.ApplicationCredentialExpiry/impactedResources/dbd9935e-15b7-4800-9049-8d8704c23ad2/postpone
+Content-Type: application/json
+
+{
+ "postponeUntilDateTime": "2023-03-01T09:40:39.0420371Z"
+}
+```
++
+### 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.impactedResource"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#impactedResource",
+ "@odata.type": "#microsoft.graph.impactedResource",
+ "id": "dbd9935e-15b7-4800-9049-8d8704c23ad2",
+ "subjectId": "f9c3466a-9cb5-46ee-84db-e7e6e405b937",
+ "recommendationId": "7918d4b5-0442-4a97-be2d-36f9f9962ece_Microsoft.Identity.IAM.Insights.ApplicationCredentialExpiry",
+ "resourceType": "app",
+ "addedDateTime": "2022-03-19T09:40:39.0420371Z",
+ "postponeUntilDateTime": "2023-03-01T09:40:39.0420371Z",
+ "lastModifiedDateTime": "2022-04-04T20:43:28.9687029Z",
+ "lastModifiedBy": "b5fa65db-0d2b-4233-8788-ab0213567669",
+ "displayName": "Contoso IWA App Tutorial",
+ "owner": null,
+ "rank": 1,
+ "portalUrl": "https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/Credentials/appId/ f9c3466a-9cb5-46ee-84db-e7e6e405b937",
+ "apiUrl": null,
+ "status": "postponed",
+ "additionalDetails": [
+ {
+ "key": "ExpiringCredentialsCount",
+ "value": "1"
+ }
+ ]
+}
+```
+
v1.0 Impactedresource Reactivate https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/impactedresource-reactivate.md
+
+ Title: "impactedResource: reactivate"
+description: "Reactivate an accidentally dismissed, completed, or postponed impactedResource object."
+
+ms.localizationpriority: medium
++
+# impactedResource: reactivate
+Namespace: microsoft.graph
++
+Reactivate an accidentally dismissed, completed, or postponed **impactedResource** object. This action updates the **status** of the resource to `active`. This method is relevant only if the status of the **impactedResource** object is `dismissed`, `postponed`, or `completedByUser`.
+
+## 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)|DirectoryRecommendations.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DirectoryRecommendations.ReadWrite.All|
+
+For delegated scenarios, the admin needs one of the following [Azure AD roles](/azure/active-directory/users-groups-roles/directory-assign-admin-roles#available-roles):
+- Global administrator
+- Security administrator
+- Security operator
+- Application administrator
+- Cloud application administrator
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /directory/recommendations/{recommendationId}/impactedResources/{impactedResourceId}/reactivate
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this action returns a `200 OK` response code and a [impactedResource](../resources/impactedresource.md) in the response body.
+
+## Examples
+
+### Request
+The following is an example of a request.
+<!-- {
+ "blockType": "request",
+ "name": "impactedresourcethis.reactivate"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/directory/recommendations/0cb31920-84b9-471f-a6fb-468c1a847088_Microsoft.Identity.IAM.Insights.ApplicationCredentialExpiry/impactedResources/dbd9935e-15b7-4800-9049-8d8704c23ad2/reactivate
+```
++
+### 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.impactedResource"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#impactedResource",
+ "@odata.type": "#microsoft.graph.impactedResource",
+ "id": "dbd9935e-15b7-4800-9049-8d8704c23ad2",
+ "subjectId": "f9c3466a-9cb5-46ee-84db-e7e6e405b937",
+ "recommendationId": "7918d4b5-0442-4a97-be2d-36f9f9962ece_Microsoft.Identity.IAM.Insights.ApplicationCredentialExpiry",
+ "resourceType": "app",
+ "addedDateTime": "2022-03-19T09:40:39.0420371Z",
+ "postponeUntilDateTime": null,
+ "lastModifiedDateTime": "2022-04-04T20:43:28.9687029Z",
+ "lastModifiedBy": "b5fa65db-0d2b-4233-8788-ab0213567669",
+ "displayName": "Contoso IWA App Tutorial",
+ "owner": null,
+ "rank": 1,
+ "portalUrl": "https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/Credentials/appId/ f9c3466a-9cb5-46ee-84db-e7e6e405b937",
+ "apiUrl": null,
+ "status": "active",
+ "additionalDetails": [
+ {
+ "key": "ExpiringCredentialsCount",
+ "value": "1"
+ }
+ ]
+}
+```
+
v1.0 Internaldomainfederation Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/internaldomainfederation-delete.md
Title: "Delete internalDomainFederation" description: "Deletes an internalDomainFederation object."-+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: apiPageType
v1.0 Internaldomainfederation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/internaldomainfederation-get.md
Title: "Get internalDomainFederation" description: "Read the properties and relationships of an internalDomainFederation object."-+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: apiPageType
v1.0 Internaldomainfederation Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/internaldomainfederation-update.md
Title: "Update internalDomainFederation" description: "Update the properties of an internalDomainFederation object."-+ ms.localizationpriority: medium ms.prod: "identity-and-sign-in" doc_type: apiPageType
v1.0 Intune Androidforwork Androiddeviceownerenrollmentprofile Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androiddeviceownerenrollmentprofile-create.md
Title: "Create androidDeviceOwnerEnrollmentProfile" description: "Create a new androidDeviceOwnerEnrollmentProfile object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [androidDeviceOwnerEnrollmentProfile](../resources/intune-androidforwork-androiddeviceownerenrollmentprofile.md) object.
-## Prerequisites
+## 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)|
The following table shows the properties that are required when you create the a
|wifiPassword|String|String that contains the wi-fi login password| |wifiSecurityType|[aospWifiSecurityType](../resources/intune-androidforwork-aospwifisecuritytype.md)|String that contains the wi-fi security type. Possible values are: `none`, `wpa`, `wep`.| |wifiHidden|Boolean|Boolean that indicates if hidden wifi networks are enabled|
+|isTeamsDeviceProfile|Boolean|Boolean indicating if this profile is an Android AOSP for Teams device profile.|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceManagement/androidDeviceOwnerEnrollmentProfiles Content-type: application/json
-Content-length: 948
+Content-length: 981
{ "@odata.type": "#microsoft.graph.androidDeviceOwnerEnrollmentProfile",
Content-length: 948
"wifiSsid": "Wifi Ssid value", "wifiPassword": "Wifi Password value", "wifiSecurityType": "wpa",
- "wifiHidden": true
+ "wifiHidden": true,
+ "isTeamsDeviceProfile": 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: 1120
+Content-Length: 1153
{ "@odata.type": "#microsoft.graph.androidDeviceOwnerEnrollmentProfile",
Content-Length: 1120
"wifiSsid": "Wifi Ssid value", "wifiPassword": "Wifi Password value", "wifiSecurityType": "wpa",
- "wifiHidden": true
+ "wifiHidden": true,
+ "isTeamsDeviceProfile": true
} ```-----
v1.0 Intune Androidforwork Androiddeviceownerenrollmentprofile Createtoken https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androiddeviceownerenrollmentprofile-createtoken.md
Title: "createToken action" description: "Not yet documented"-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Not yet documented
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Androidforwork Androiddeviceownerenrollmentprofile Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androiddeviceownerenrollmentprofile-delete.md
Title: "Delete androidDeviceOwnerEnrollmentProfile" description: "Deletes a androidDeviceOwnerEnrollmentProfile."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [androidDeviceOwnerEnrollmentProfile](../resources/intune-androidforwork-androiddeviceownerenrollmentprofile.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Androidforwork Androiddeviceownerenrollmentprofile Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androiddeviceownerenrollmentprofile-get.md
Title: "Get androidDeviceOwnerEnrollmentProfile" description: "Read properties and relationships of the androidDeviceOwnerEnrollmentProfile object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [androidDeviceOwnerEnrollmentProfile](../resources/intune-androidforwork-androiddeviceownerenrollmentprofile.md) object.
-## Prerequisites
+## 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)|
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: 1195
+Content-Length: 1230
{ "value": {
Content-Length: 1195
"wifiSsid": "Wifi Ssid value", "wifiPassword": "Wifi Password value", "wifiSecurityType": "wpa",
- "wifiHidden": true
+ "wifiHidden": true,
+ "isTeamsDeviceProfile": true
} } ```-----
v1.0 Intune Androidforwork Androiddeviceownerenrollmentprofile List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androiddeviceownerenrollmentprofile-list.md
Title: "List androidDeviceOwnerEnrollmentProfiles" description: "List properties and relationships of the androidDeviceOwnerEnrollmentProfile objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [androidDeviceOwnerEnrollmentProfile](../resources/intune-androidforwork-androiddeviceownerenrollmentprofile.md) objects.
-## Prerequisites
+## 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)|
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: 1265
+Content-Length: 1302
{ "value": [
Content-Length: 1265
"wifiSsid": "Wifi Ssid value", "wifiPassword": "Wifi Password value", "wifiSecurityType": "wpa",
- "wifiHidden": true
+ "wifiHidden": true,
+ "isTeamsDeviceProfile": true
} ] } ```-----
v1.0 Intune Androidforwork Androiddeviceownerenrollmentprofile Revoketoken https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androiddeviceownerenrollmentprofile-revoketoken.md
Title: "revokeToken action" description: "Not yet documented"-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Not yet documented
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Androidforwork Androiddeviceownerenrollmentprofile Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androiddeviceownerenrollmentprofile-update.md
Title: "Update androidDeviceOwnerEnrollmentProfile" description: "Update the properties of a androidDeviceOwnerEnrollmentProfile object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [androidDeviceOwnerEnrollmentProfile](../resources/intune-androidforwork-androiddeviceownerenrollmentprofile.md) object.
-## Prerequisites
+## 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)|
The following table shows the properties that are required when you create the [
|wifiPassword|String|String that contains the wi-fi login password| |wifiSecurityType|[aospWifiSecurityType](../resources/intune-androidforwork-aospwifisecuritytype.md)|String that contains the wi-fi security type. Possible values are: `none`, `wpa`, `wep`.| |wifiHidden|Boolean|Boolean that indicates if hidden wifi networks are enabled|
+|isTeamsDeviceProfile|Boolean|Boolean indicating if this profile is an Android AOSP for Teams device profile.|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceManagement/androidDeviceOwnerEnrollmentProfiles/{androidDeviceOwnerEnrollmentProfileId} Content-type: application/json
-Content-length: 948
+Content-length: 981
{ "@odata.type": "#microsoft.graph.androidDeviceOwnerEnrollmentProfile",
Content-length: 948
"wifiSsid": "Wifi Ssid value", "wifiPassword": "Wifi Password value", "wifiSecurityType": "wpa",
- "wifiHidden": true
+ "wifiHidden": true,
+ "isTeamsDeviceProfile": 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: 1120
+Content-Length: 1153
{ "@odata.type": "#microsoft.graph.androidDeviceOwnerEnrollmentProfile",
Content-Length: 1120
"wifiSsid": "Wifi Ssid value", "wifiPassword": "Wifi Password value", "wifiSecurityType": "wpa",
- "wifiHidden": true
+ "wifiHidden": true,
+ "isTeamsDeviceProfile": true
} ```-----
v1.0 Intune Androidforwork Androidforworkappconfigurationschema Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidforworkappconfigurationschema-create.md
Title: "Create androidForWorkAppConfigurationSchema" description: "Create a new androidForWorkAppConfigurationSchema object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [androidForWorkAppConfigurationSchema](../resources/intune-androidforwork-androidforworkappconfigurationschema.md) object.
-## Prerequisites
+## 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)|
Content-Length: 844
] } ```-----
v1.0 Intune Androidforwork Androidforworkappconfigurationschema Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidforworkappconfigurationschema-delete.md
Title: "Delete androidForWorkAppConfigurationSchema" description: "Deletes a androidForWorkAppConfigurationSchema."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [androidForWorkAppConfigurationSchema](../resources/intune-androidforwork-androidforworkappconfigurationschema.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Androidforwork Androidforworkappconfigurationschema Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidforworkappconfigurationschema-get.md
Title: "Get androidForWorkAppConfigurationSchema" description: "Read properties and relationships of the androidForWorkAppConfigurationSchema object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [androidForWorkAppConfigurationSchema](../resources/intune-androidforwork-androidforworkappconfigurationschema.md) object.
-## Prerequisites
+## 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)|
Content-Length: 913
} } ```-----
v1.0 Intune Androidforwork Androidforworkappconfigurationschema List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidforworkappconfigurationschema-list.md
Title: "List androidForWorkAppConfigurationSchemas" description: "List properties and relationships of the androidForWorkAppConfigurationSchema objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [androidForWorkAppConfigurationSchema](../resources/intune-androidforwork-androidforworkappconfigurationschema.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 977
] } ```-----
v1.0 Intune Androidforwork Androidforworkappconfigurationschema Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidforworkappconfigurationschema-update.md
Title: "Update androidForWorkAppConfigurationSchema" description: "Update the properties of a androidForWorkAppConfigurationSchema object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [androidForWorkAppConfigurationSchema](../resources/intune-androidforwork-androidforworkappconfigurationschema.md) object.
-## Prerequisites
+## 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)|
Content-Length: 844
] } ```-----
v1.0 Intune Androidforwork Androidforworkenrollmentprofile Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidforworkenrollmentprofile-create.md
Title: "Create androidForWorkEnrollmentProfile" description: "Create a new androidForWorkEnrollmentProfile object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [androidForWorkEnrollmentProfile](../resources/intune-androidforwork-androidforworkenrollmentprofile.md) object.
-## Prerequisites
+## 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)|
Content-Length: 668
} } ```-----
v1.0 Intune Androidforwork Androidforworkenrollmentprofile Createtoken https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidforworkenrollmentprofile-createtoken.md
Title: "createToken action" description: "Not yet documented"-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Not yet documented
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Androidforwork Androidforworkenrollmentprofile Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidforworkenrollmentprofile-delete.md
Title: "Delete androidForWorkEnrollmentProfile" description: "Deletes a androidForWorkEnrollmentProfile."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [androidForWorkEnrollmentProfile](../resources/intune-androidforwork-androidforworkenrollmentprofile.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Androidforwork Androidforworkenrollmentprofile Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidforworkenrollmentprofile-get.md
Title: "Get androidForWorkEnrollmentProfile" description: "Read properties and relationships of the androidForWorkEnrollmentProfile object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [androidForWorkEnrollmentProfile](../resources/intune-androidforwork-androidforworkenrollmentprofile.md) object.
-## Prerequisites
+## 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)|
Content-Length: 719
} } ```-----
v1.0 Intune Androidforwork Androidforworkenrollmentprofile List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidforworkenrollmentprofile-list.md
Title: "List androidForWorkEnrollmentProfiles" description: "List properties and relationships of the androidForWorkEnrollmentProfile objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [androidForWorkEnrollmentProfile](../resources/intune-androidforwork-androidforworkenrollmentprofile.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 765
] } ```-----
v1.0 Intune Androidforwork Androidforworkenrollmentprofile Revoketoken https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidforworkenrollmentprofile-revoketoken.md
Title: "revokeToken action" description: "Not yet documented"-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Not yet documented
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Androidforwork Androidforworkenrollmentprofile Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidforworkenrollmentprofile-update.md
Title: "Update androidForWorkEnrollmentProfile" description: "Update the properties of a androidForWorkEnrollmentProfile object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [androidForWorkEnrollmentProfile](../resources/intune-androidforwork-androidforworkenrollmentprofile.md) object.
-## Prerequisites
+## 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)|
Content-Length: 668
} } ```-----
v1.0 Intune Androidforwork Androidforworksettings Completesignup https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidforworksettings-completesignup.md
Title: "completeSignup action" description: "Not yet documented"-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Not yet documented
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Androidforwork Androidforworksettings Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidforworksettings-get.md
Title: "Get androidForWorkSettings" description: "Read properties and relationships of the androidForWorkSettings object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [androidForWorkSettings](../resources/intune-androidforwork-androidforworksettings.md) object.
-## Prerequisites
+## 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)|
Content-Length: 613
} } ```-----
v1.0 Intune Androidforwork Androidforworksettings Requestsignupurl https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidforworksettings-requestsignupurl.md
Title: "requestSignupUrl action" description: "Not yet documented"-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Not yet documented
-## Prerequisites
+## 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)|
Content-Length: 56
"value": "https://example.com/requestSignupUrl/" } ```-----
v1.0 Intune Androidforwork Androidforworksettings Syncapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidforworksettings-syncapps.md
Title: "syncApps action" description: "Not yet documented"-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Not yet documented
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Androidforwork Androidforworksettings Unbind https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidforworksettings-unbind.md
Title: "unbind action" description: "Not yet documented"-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Not yet documented
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Androidforwork Androidforworksettings Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidforworksettings-update.md
Title: "Update androidForWorkSettings" description: "Update the properties of a androidForWorkSettings object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [androidForWorkSettings](../resources/intune-androidforwork-androidforworksettings.md) object.
-## Prerequisites
+## 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)|
Content-Length: 568
"deviceOwnerManagementEnabled": true } ```-----
v1.0 Intune Androidforwork Androidmanagedstoreaccountenterprisesettings Addapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidmanagedstoreaccountenterprisesettings-addapps.md
+
+ Title: "addApps action"
+description: "Not yet documented"
+
+localization_priority: Normal
++
+# addApps 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
+
+## 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)|DeviceManagementConfiguration.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|DeviceManagementConfiguration.Read.All|
+
+## HTTP Request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceManagement/androidManagedStoreAccountEnterpriseSettings/addApps
+```
+
+## Request headers
+|Header|Value|
+|:|:|
+|Authorization|Bearer &lt;token&gt; Required.|
+|Accept|application/json|
+
+## Request body
+In the request body, supply JSON representation of the parameters.
+
+The following table shows the parameters that can be used with this action.
+
+|Property|Type|Description|
+|:|:|:|
+|productIds|String collection|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/androidManagedStoreAccountEnterpriseSettings/addApps
+
+Content-type: application/json
+Content-length: 53
+
+{
+ "productIds": [
+ "Product Ids 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 204 No Content
+```
v1.0 Intune Androidforwork Androidmanagedstoreaccountenterprisesettings Approveapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidmanagedstoreaccountenterprisesettings-approveapps.md
Title: "approveApps action" description: "Not yet documented"-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Not yet documented
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Androidforwork Androidmanagedstoreaccountenterprisesettings Completesignup https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidmanagedstoreaccountenterprisesettings-completesignup.md
Title: "completeSignup action" description: "Not yet documented"-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Not yet documented
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Androidforwork Androidmanagedstoreaccountenterprisesettings Creategoogleplaywebtoken https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidmanagedstoreaccountenterprisesettings-creategoogleplaywebtoken.md
Title: "createGooglePlayWebToken action" description: "Generates a web token that is used in an embeddable component."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Generates a web token that is used in an embeddable component.
-## Prerequisites
+## 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)|
Content-Length: 53
"value": "Create Google Play Web Token value" } ```-----
v1.0 Intune Androidforwork Androidmanagedstoreaccountenterprisesettings Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidmanagedstoreaccountenterprisesettings-get.md
Title: "Get androidManagedStoreAccountEnterpriseSettings" description: "Read properties and relationships of the androidManagedStoreAccountEnterpriseSettings object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [androidManagedStoreAccountEnterpriseSettings](../resources/intune-androidforwork-androidmanagedstoreaccountenterprisesettings.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1192
} } ```-----
v1.0 Intune Androidforwork Androidmanagedstoreaccountenterprisesettings Requestsignupurl https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidmanagedstoreaccountenterprisesettings-requestsignupurl.md
Title: "requestSignupUrl action" description: "Not yet documented"-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Not yet documented
-## Prerequisites
+## 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)|
Content-Length: 56
"value": "https://example.com/requestSignupUrl/" } ```-----
v1.0 Intune Androidforwork Androidmanagedstoreaccountenterprisesettings Setandroiddeviceownerfullymanagedenrollmentstate https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidmanagedstoreaccountenterprisesettings-setandroiddeviceownerfullymanagedenrollmentstate.md
Title: "setAndroidDeviceOwnerFullyManagedEnrollmentState action" description: "Sets the AndroidManagedStoreAccountEnterpriseSettings AndroidDeviceOwnerFullyManagedEnrollmentEnabled to the given value."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Sets the AndroidManagedStoreAccountEnterpriseSettings AndroidDeviceOwnerFullyManagedEnrollmentEnabled to the given value.
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Androidforwork Androidmanagedstoreaccountenterprisesettings Syncapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidmanagedstoreaccountenterprisesettings-syncapps.md
Title: "syncApps action" description: "Not yet documented"-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Not yet documented
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Androidforwork Androidmanagedstoreaccountenterprisesettings Unbind https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidmanagedstoreaccountenterprisesettings-unbind.md
Title: "unbind action" description: "Not yet documented"-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Not yet documented
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Androidforwork Androidmanagedstoreaccountenterprisesettings Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidmanagedstoreaccountenterprisesettings-update.md
Title: "Update androidManagedStoreAccountEnterpriseSettings" description: "Update the properties of a androidManagedStoreAccountEnterpriseSettings object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [androidManagedStoreAccountEnterpriseSettings](../resources/intune-androidforwork-androidmanagedstoreaccountenterprisesettings.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1115
] } ```-----
v1.0 Intune Androidforwork Androidmanagedstoreappconfigurationschema Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidmanagedstoreappconfigurationschema-create.md
Title: "Create androidManagedStoreAppConfigurationSchema" description: "Create a new androidManagedStoreAppConfigurationSchema object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [androidManagedStoreAppConfigurationSchema](../resources/intune-androidforwork-androidmanagedstoreappconfigurationschema.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1634
] } ```-----
v1.0 Intune Androidforwork Androidmanagedstoreappconfigurationschema Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidmanagedstoreappconfigurationschema-delete.md
Title: "Delete androidManagedStoreAppConfigurationSchema" description: "Deletes a androidManagedStoreAppConfigurationSchema."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [androidManagedStoreAppConfigurationSchema](../resources/intune-androidforwork-androidmanagedstoreappconfigurationschema.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Androidforwork Androidmanagedstoreappconfigurationschema Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidmanagedstoreappconfigurationschema-get.md
Title: "Get androidManagedStoreAppConfigurationSchema" description: "Read properties and relationships of the androidManagedStoreAppConfigurationSchema object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [androidManagedStoreAppConfigurationSchema](../resources/intune-androidforwork-androidmanagedstoreappconfigurationschema.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1755
} } ```-----
v1.0 Intune Androidforwork Androidmanagedstoreappconfigurationschema List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidmanagedstoreappconfigurationschema-list.md
Title: "List androidManagedStoreAppConfigurationSchemas" description: "List properties and relationships of the androidManagedStoreAppConfigurationSchema objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [androidManagedStoreAppConfigurationSchema](../resources/intune-androidforwork-androidmanagedstoreappconfigurationschema.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 1871
] } ```-----
v1.0 Intune Androidforwork Androidmanagedstoreappconfigurationschema Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidforwork-androidmanagedstoreappconfigurationschema-update.md
Title: "Update androidManagedStoreAppConfigurationSchema" description: "Update the properties of a androidManagedStoreAppConfigurationSchema object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [androidManagedStoreAppConfigurationSchema](../resources/intune-androidforwork-androidmanagedstoreappconfigurationschema.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1634
] } ```-----
v1.0 Intune Androidfotaservice Devicemanagementreports Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidfotaservice-devicemanagementreports-get.md
Title: "Get deviceManagementReports" description: "Read properties and relationships of the deviceManagementReports object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [deviceManagementReports](../resources/intune-androidfotaservice-devicemanagementreports.md) object.
-## Prerequisites
+## 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)|
Content-Length: 86
} } ```-----
v1.0 Intune Androidfotaservice Devicemanagementreports Getzebrafotadeploymentreport https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidfotaservice-devicemanagementreports-getzebrafotadeploymentreport.md
Title: "getZebraFotaDeploymentReport action" description: "Not yet documented"-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Not yet documented
-## Prerequisites
+## 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)|
Content-Length: 95
"value": "Z2V0WmVicmFGb3RhRGVwbG95bWVudFJlcG9ydCBJbnR1bmUgRG9jIFNhbXBsZSAyMDcxMDQ2MzM5" } ```-----
v1.0 Intune Androidfotaservice Devicemanagementreports Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidfotaservice-devicemanagementreports-update.md
Title: "Update deviceManagementReports" description: "Update the properties of a deviceManagementReports object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [deviceManagementReports](../resources/intune-androidfotaservice-devicemanagementreports.md) object.
-## Prerequisites
+## 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)|
Content-Length: 65
"@odata.type": "#microsoft.graph.deviceManagementReports" } ```-----
v1.0 Intune Androidfotaservice Zebrafotaartifact Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidfotaservice-zebrafotaartifact-create.md
Title: "Create zebraFotaArtifact" description: "Create a new zebraFotaArtifact object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [zebraFotaArtifact](../resources/intune-androidfotaservice-zebrafotaartifact.md) object.
-## Prerequisites
+## 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)|
Content-Length: 399
"description": "Description value" } ```-----
v1.0 Intune Androidfotaservice Zebrafotaartifact Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidfotaservice-zebrafotaartifact-delete.md
Title: "Delete zebraFotaArtifact" description: "Deletes a zebraFotaArtifact."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [zebraFotaArtifact](../resources/intune-androidfotaservice-zebrafotaartifact.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Androidfotaservice Zebrafotaartifact Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidfotaservice-zebrafotaartifact-get.md
Title: "Get zebraFotaArtifact" description: "Read properties and relationships of the zebraFotaArtifact object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [zebraFotaArtifact](../resources/intune-androidfotaservice-zebrafotaartifact.md) object.
-## Prerequisites
+## 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)|
Content-Length: 434
} } ```-----
v1.0 Intune Androidfotaservice Zebrafotaartifact List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidfotaservice-zebrafotaartifact-list.md
Title: "List zebraFotaArtifacts" description: "List properties and relationships of the zebraFotaArtifact objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [zebraFotaArtifact](../resources/intune-androidfotaservice-zebrafotaartifact.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 464
] } ```-----
v1.0 Intune Androidfotaservice Zebrafotaartifact Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidfotaservice-zebrafotaartifact-update.md
Title: "Update zebraFotaArtifact" description: "Update the properties of a zebraFotaArtifact object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [zebraFotaArtifact](../resources/intune-androidfotaservice-zebrafotaartifact.md) object.
-## Prerequisites
+## 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)|
Content-Length: 399
"description": "Description value" } ```-----
v1.0 Intune Androidfotaservice Zebrafotaconnector Approvefotaapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidfotaservice-zebrafotaconnector-approvefotaapps.md
Title: "approveFotaApps action" description: "Not yet documented"-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Not yet documented
-## Prerequisites
+## 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)|
Content-Length: 21
"value": true } ```-----
v1.0 Intune Androidfotaservice Zebrafotaconnector Connect https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidfotaservice-zebrafotaconnector-connect.md
Title: "connect action" description: "Not yet documented"-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Not yet documented
-## Prerequisites
+## 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)|
Content-Length: 21
"value": true } ```-----
v1.0 Intune Androidfotaservice Zebrafotaconnector Disconnect https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidfotaservice-zebrafotaconnector-disconnect.md
Title: "disconnect action" description: "Not yet documented"-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Not yet documented
-## Prerequisites
+## 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)|
Content-Length: 21
"value": true } ```-----
v1.0 Intune Androidfotaservice Zebrafotaconnector Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidfotaservice-zebrafotaconnector-get.md
Title: "Get zebraFotaConnector" description: "Read properties and relationships of the zebraFotaConnector object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [zebraFotaConnector](../resources/intune-androidfotaservice-zebrafotaconnector.md) object.
-## Prerequisites
+## 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)|
Content-Length: 388
} } ```-----
v1.0 Intune Androidfotaservice Zebrafotaconnector Hasactivedeployments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidfotaservice-zebrafotaconnector-hasactivedeployments.md
Title: "hasActiveDeployments action" description: "Not yet documented"-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Not yet documented
-## Prerequisites
+## 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)|
Content-Length: 21
"value": true } ```-----
v1.0 Intune Androidfotaservice Zebrafotaconnector Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidfotaservice-zebrafotaconnector-update.md
Title: "Update zebraFotaConnector" description: "Update the properties of a zebraFotaConnector object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [zebraFotaConnector](../resources/intune-androidfotaservice-zebrafotaconnector.md) object.
-## Prerequisites
+## 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)|
Content-Length: 355
"fotaAppsApproved": true } ```-----
v1.0 Intune Androidfotaservice Zebrafotadeployment Cancel https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidfotaservice-zebrafotadeployment-cancel.md
Title: "cancel action" description: "Not yet documented"-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Not yet documented
-## Prerequisites
+## 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)|
Content-Length: 21
"value": true } ```-----
v1.0 Intune Androidfotaservice Zebrafotadeployment Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidfotaservice-zebrafotadeployment-create.md
Title: "Create zebraFotaDeployment" description: "Create a new zebraFotaDeployment object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [zebraFotaDeployment](../resources/intune-androidfotaservice-zebrafotadeployment.md) object.
-## Prerequisites
+## 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)|
Content-Length: 2073
} } ```-----
v1.0 Intune Androidfotaservice Zebrafotadeployment Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidfotaservice-zebrafotadeployment-delete.md
Title: "Delete zebraFotaDeployment" description: "Deletes a zebraFotaDeployment."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [zebraFotaDeployment](../resources/intune-androidfotaservice-zebrafotadeployment.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Androidfotaservice Zebrafotadeployment Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidfotaservice-zebrafotadeployment-get.md
Title: "Get zebraFotaDeployment" description: "Read properties and relationships of the zebraFotaDeployment object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [zebraFotaDeployment](../resources/intune-androidfotaservice-zebrafotadeployment.md) object.
-## Prerequisites
+## 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)|
Content-Length: 2194
} } ```-----
v1.0 Intune Androidfotaservice Zebrafotadeployment List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidfotaservice-zebrafotadeployment-list.md
Title: "List zebraFotaDeployments" description: "List properties and relationships of the zebraFotaDeployment objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [zebraFotaDeployment](../resources/intune-androidfotaservice-zebrafotadeployment.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 2310
] } ```-----
v1.0 Intune Androidfotaservice Zebrafotadeployment Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-androidfotaservice-zebrafotadeployment-update.md
Title: "Update zebraFotaDeployment" description: "Update the properties of a zebraFotaDeployment object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [zebraFotaDeployment](../resources/intune-androidfotaservice-zebrafotadeployment.md) object.
-## Prerequisites
+## 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)|
Content-Length: 2073
} } ```-----
v1.0 Intune Apps Androidforworkapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidforworkapp-create.md
Title: "Create androidForWorkApp" description: "Create a new androidForWorkApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [androidForWorkApp](../resources/intune-apps-androidforworkapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1132
"appStoreUrl": "https://example.com/appStoreUrl/" } ```-----
v1.0 Intune Apps Androidforworkapp Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidforworkapp-delete.md
Title: "Delete androidForWorkApp" description: "Deletes a androidForWorkApp."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [androidForWorkApp](../resources/intune-apps-androidforworkapp.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Androidforworkapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidforworkapp-get.md
Title: "Get androidForWorkApp" description: "Read properties and relationships of the androidForWorkApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [androidForWorkApp](../resources/intune-apps-androidforworkapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1215
} } ```-----
v1.0 Intune Apps Androidforworkapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidforworkapp-list.md
Title: "List androidForWorkApps" description: "List properties and relationships of the androidForWorkApp objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [androidForWorkApp](../resources/intune-apps-androidforworkapp.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 1293
] } ```-----
v1.0 Intune Apps Androidforworkapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidforworkapp-update.md
Title: "Update androidForWorkApp" description: "Update the properties of a androidForWorkApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [androidForWorkApp](../resources/intune-apps-androidforworkapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1132
"appStoreUrl": "https://example.com/appStoreUrl/" } ```-----
v1.0 Intune Apps Androidforworkmobileappconfiguration Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidforworkmobileappconfiguration-create.md
Title: "Create androidForWorkMobileAppConfiguration" description: "Create a new androidForWorkMobileAppConfiguration object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [androidForWorkMobileAppConfiguration](../resources/intune-apps-androidforworkmobileappconfiguration.md) object.
-## Prerequisites
+## 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)|
Content-Length: 814
"connectedAppsEnabled": true } ```-----
v1.0 Intune Apps Androidforworkmobileappconfiguration Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidforworkmobileappconfiguration-delete.md
Title: "Delete androidForWorkMobileAppConfiguration" description: "Deletes a androidForWorkMobileAppConfiguration."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [androidForWorkMobileAppConfiguration](../resources/intune-apps-androidforworkmobileappconfiguration.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Androidforworkmobileappconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidforworkmobileappconfiguration-get.md
Title: "Get androidForWorkMobileAppConfiguration" description: "Read properties and relationships of the androidForWorkMobileAppConfiguration object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [androidForWorkMobileAppConfiguration](../resources/intune-apps-androidforworkmobileappconfiguration.md) object.
-## Prerequisites
+## 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)|
Content-Length: 881
} } ```-----
v1.0 Intune Apps Androidforworkmobileappconfiguration List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidforworkmobileappconfiguration-list.md
Title: "List androidForWorkMobileAppConfigurations" description: "List properties and relationships of the androidForWorkMobileAppConfiguration objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [androidForWorkMobileAppConfiguration](../resources/intune-apps-androidforworkmobileappconfiguration.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 943
] } ```-----
v1.0 Intune Apps Androidforworkmobileappconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidforworkmobileappconfiguration-update.md
Title: "Update androidForWorkMobileAppConfiguration" description: "Update the properties of a androidForWorkMobileAppConfiguration object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [androidForWorkMobileAppConfiguration](../resources/intune-apps-androidforworkmobileappconfiguration.md) object.
-## Prerequisites
+## 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)|
Content-Length: 814
"connectedAppsEnabled": true } ```-----
v1.0 Intune Apps Androidlobapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidlobapp-create.md
Title: "Create androidLobApp" description: "Create a new androidLobApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [androidLobApp](../resources/intune-apps-androidlobapp.md) object.
-## Prerequisites
+## 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)|
The following table shows the properties that are required when you create the a
|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)| |packageId|String|The package identifier.|
-|identityName|String|The Identity Name.|
+|identityName|String|The Identity Name. This property is deprecated starting in February 2023 (Release 2302).|
|minimumSupportedOperatingSystem|[androidMinimumOperatingSystem](../resources/intune-apps-androidminimumoperatingsystem.md)|The value for the minimum applicable operating system.| |versionName|String|The version name of Android Line of Business (LoB) app.| |versionCode|String|The version code of Android Line of Business (LoB) app.|
-|identityVersion|String|The identity version.|
+|identityVersion|String|The identity version. This property is deprecated starting in February 2023 (Release 2302).|
Content-Length: 1682
"identityVersion": "Identity Version value" } ```-----
v1.0 Intune Apps Androidlobapp Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidlobapp-delete.md
Title: "Delete androidLobApp" description: "Deletes a androidLobApp."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [androidLobApp](../resources/intune-apps-androidlobapp.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Androidlobapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidlobapp-get.md
Title: "Get androidLobApp" description: "Read properties and relationships of the androidLobApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [androidLobApp](../resources/intune-apps-androidlobapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1809
} } ```-----
v1.0 Intune Apps Androidlobapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidlobapp-list.md
Title: "List androidLobApps" description: "List properties and relationships of the androidLobApp objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [androidLobApp](../resources/intune-apps-androidlobapp.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 1931
] } ```-----
v1.0 Intune Apps Androidlobapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidlobapp-update.md
Title: "Update androidLobApp" description: "Update the properties of a androidLobApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [androidLobApp](../resources/intune-apps-androidlobapp.md) object.
-## Prerequisites
+## 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)|
The following table shows the properties that are required when you create the [
|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)| |packageId|String|The package identifier.|
-|identityName|String|The Identity Name.|
+|identityName|String|The Identity Name. This property is deprecated starting in February 2023 (Release 2302).|
|minimumSupportedOperatingSystem|[androidMinimumOperatingSystem](../resources/intune-apps-androidminimumoperatingsystem.md)|The value for the minimum applicable operating system.| |versionName|String|The version name of Android Line of Business (LoB) app.| |versionCode|String|The version code of Android Line of Business (LoB) app.|
-|identityVersion|String|The identity version.|
+|identityVersion|String|The identity version. This property is deprecated starting in February 2023 (Release 2302).|
Content-Length: 1682
"identityVersion": "Identity Version value" } ```-----
v1.0 Intune Apps Androidmanagedstoreapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidmanagedstoreapp-create.md
Title: "Create androidManagedStoreApp" description: "Create a new androidManagedStoreApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [androidManagedStoreApp](../resources/intune-apps-androidmanagedstoreapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1397
"supportsOemConfig": true } ```-----
v1.0 Intune Apps Androidmanagedstoreapp Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidmanagedstoreapp-delete.md
Title: "Delete androidManagedStoreApp" description: "Deletes a androidManagedStoreApp."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [androidManagedStoreApp](../resources/intune-apps-androidmanagedstoreapp.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Androidmanagedstoreapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidmanagedstoreapp-get.md
Title: "Get androidManagedStoreApp" description: "Read properties and relationships of the androidManagedStoreApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [androidManagedStoreApp](../resources/intune-apps-androidmanagedstoreapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1500
} } ```-----
v1.0 Intune Apps Androidmanagedstoreapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidmanagedstoreapp-list.md
Title: "List androidManagedStoreApps" description: "List properties and relationships of the androidManagedStoreApp objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [androidManagedStoreApp](../resources/intune-apps-androidmanagedstoreapp.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 1598
] } ```-----
v1.0 Intune Apps Androidmanagedstoreapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidmanagedstoreapp-update.md
Title: "Update androidManagedStoreApp" description: "Update the properties of a androidManagedStoreApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [androidManagedStoreApp](../resources/intune-apps-androidmanagedstoreapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1397
"supportsOemConfig": true } ```-----
v1.0 Intune Apps Androidmanagedstoreappconfiguration Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidmanagedstoreappconfiguration-create.md
Title: "Create androidManagedStoreAppConfiguration" description: "Create a new androidManagedStoreAppConfiguration object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [androidManagedStoreAppConfiguration](../resources/intune-apps-androidmanagedstoreappconfiguration.md) object.
-## Prerequisites
+## 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)|
Content-Length: 846
"connectedAppsEnabled": true } ```-----
v1.0 Intune Apps Androidmanagedstoreappconfiguration Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidmanagedstoreappconfiguration-delete.md
Title: "Delete androidManagedStoreAppConfiguration" description: "Deletes a androidManagedStoreAppConfiguration."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [androidManagedStoreAppConfiguration](../resources/intune-apps-androidmanagedstoreappconfiguration.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Androidmanagedstoreappconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidmanagedstoreappconfiguration-get.md
Title: "Get androidManagedStoreAppConfiguration" description: "Read properties and relationships of the androidManagedStoreAppConfiguration object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [androidManagedStoreAppConfiguration](../resources/intune-apps-androidmanagedstoreappconfiguration.md) object.
-## Prerequisites
+## 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)|
Content-Length: 915
} } ```-----
v1.0 Intune Apps Androidmanagedstoreappconfiguration List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidmanagedstoreappconfiguration-list.md
Title: "List androidManagedStoreAppConfigurations" description: "List properties and relationships of the androidManagedStoreAppConfiguration objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [androidManagedStoreAppConfiguration](../resources/intune-apps-androidmanagedstoreappconfiguration.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 979
] } ```-----
v1.0 Intune Apps Androidmanagedstoreappconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidmanagedstoreappconfiguration-update.md
Title: "Update androidManagedStoreAppConfiguration" description: "Update the properties of a androidManagedStoreAppConfiguration object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [androidManagedStoreAppConfiguration](../resources/intune-apps-androidmanagedstoreappconfiguration.md) object.
-## Prerequisites
+## 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)|
Content-Length: 846
"connectedAppsEnabled": true } ```-----
v1.0 Intune Apps Androidmanagedstorewebapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidmanagedstorewebapp-create.md
Title: "Create androidManagedStoreWebApp" description: "Create a new androidManagedStoreWebApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [androidManagedStoreWebApp](../resources/intune-apps-androidmanagedstorewebapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1400
"supportsOemConfig": true } ```-----
v1.0 Intune Apps Androidmanagedstorewebapp Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidmanagedstorewebapp-delete.md
Title: "Delete androidManagedStoreWebApp" description: "Deletes a androidManagedStoreWebApp."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [androidManagedStoreWebApp](../resources/intune-apps-androidmanagedstorewebapp.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Androidmanagedstorewebapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidmanagedstorewebapp-get.md
Title: "Get androidManagedStoreWebApp" description: "Read properties and relationships of the androidManagedStoreWebApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [androidManagedStoreWebApp](../resources/intune-apps-androidmanagedstorewebapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1503
} } ```-----
v1.0 Intune Apps Androidmanagedstorewebapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidmanagedstorewebapp-list.md
Title: "List androidManagedStoreWebApps" description: "List properties and relationships of the androidManagedStoreWebApp objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [androidManagedStoreWebApp](../resources/intune-apps-androidmanagedstorewebapp.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 1601
] } ```-----
v1.0 Intune Apps Androidmanagedstorewebapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidmanagedstorewebapp-update.md
Title: "Update androidManagedStoreWebApp" description: "Update the properties of a androidManagedStoreWebApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [androidManagedStoreWebApp](../resources/intune-apps-androidmanagedstorewebapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1400
"supportsOemConfig": true } ```-----
v1.0 Intune Apps Androidstoreapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidstoreapp-create.md
Title: "Create androidStoreApp" description: "Create a new androidStoreApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [androidStoreApp](../resources/intune-apps-androidstoreapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1499
} } ```-----
v1.0 Intune Apps Androidstoreapp Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidstoreapp-delete.md
Title: "Delete androidStoreApp" description: "Deletes a androidStoreApp."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [androidStoreApp](../resources/intune-apps-androidstoreapp.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Androidstoreapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidstoreapp-get.md
Title: "Get androidStoreApp" description: "Read properties and relationships of the androidStoreApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [androidStoreApp](../resources/intune-apps-androidstoreapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1616
} } ```-----
v1.0 Intune Apps Androidstoreapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidstoreapp-list.md
Title: "List androidStoreApps" description: "List properties and relationships of the androidStoreApp objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [androidStoreApp](../resources/intune-apps-androidstoreapp.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 1728
] } ```-----
v1.0 Intune Apps Androidstoreapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-androidstoreapp-update.md
Title: "Update androidStoreApp" description: "Update the properties of a androidStoreApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [androidStoreApp](../resources/intune-apps-androidstoreapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1499
} } ```-----
v1.0 Intune Apps Enterprisecodesigningcertificate Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-enterprisecodesigningcertificate-create.md
Title: "Create enterpriseCodeSigningCertificate" description: "Create a new enterpriseCodeSigningCertificate object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [enterpriseCodeSigningCertificate](../resources/intune-apps-enterprisecodesigningcertificate.md) object.
-## Prerequisites
+## 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)|
Content-Length: 439
"uploadDateTime": "2016-12-31T23:58:46.5747426-08:00" } ```-----
v1.0 Intune Apps Enterprisecodesigningcertificate Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-enterprisecodesigningcertificate-delete.md
Title: "Delete enterpriseCodeSigningCertificate" description: "Deletes a enterpriseCodeSigningCertificate."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [enterpriseCodeSigningCertificate](../resources/intune-apps-enterprisecodesigningcertificate.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Enterprisecodesigningcertificate Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-enterprisecodesigningcertificate-get.md
Title: "Get enterpriseCodeSigningCertificate" description: "Read properties and relationships of the enterpriseCodeSigningCertificate object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [enterpriseCodeSigningCertificate](../resources/intune-apps-enterprisecodesigningcertificate.md) object.
-## Prerequisites
+## 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)|
Content-Length: 478
} } ```-----
v1.0 Intune Apps Enterprisecodesigningcertificate List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-enterprisecodesigningcertificate-list.md
Title: "List enterpriseCodeSigningCertificates" description: "List properties and relationships of the enterpriseCodeSigningCertificate objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [enterpriseCodeSigningCertificate](../resources/intune-apps-enterprisecodesigningcertificate.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 512
] } ```-----
v1.0 Intune Apps Enterprisecodesigningcertificate Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-enterprisecodesigningcertificate-update.md
Title: "Update enterpriseCodeSigningCertificate" description: "Update the properties of a enterpriseCodeSigningCertificate object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [enterpriseCodeSigningCertificate](../resources/intune-apps-enterprisecodesigningcertificate.md) object.
-## Prerequisites
+## 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)|
Content-Length: 439
"uploadDateTime": "2016-12-31T23:58:46.5747426-08:00" } ```-----
v1.0 Intune Apps Iosipadoswebclip Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosipadoswebclip-create.md
Title: "Create iosiPadOSWebClip" description: "Create a new iosiPadOSWebClip object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [iosiPadOSWebClip](../resources/intune-apps-iosipadoswebclip.md) object.
-## Prerequisites
+## 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)|
The following table shows the properties that are required when you create the i
|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)|
-|appUrl|String|The web app URL.|
-|useManagedBrowser|Boolean|Whether or not to use managed browser. When true, the app will be required to be opened in an Intune-protected browser. When false, the app will not be required to be opened in an Intune-protected browser.|
+|appUrl|String|Indicates iOS/iPadOS web clip app URL. Example: "https://www.contoso.com"|
+|useManagedBrowser|Boolean|Whether or not to use managed browser. When TRUE, the app will be required to be opened in Microsoft Edge. When FALSE, the app will not be required to be opened in Microsoft Edge. By default, this property is set to FALSE.|
Content-Length: 1018
"useManagedBrowser": true } ```-----
v1.0 Intune Apps Iosipadoswebclip Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosipadoswebclip-delete.md
Title: "Delete iosiPadOSWebClip" description: "Deletes a iosiPadOSWebClip."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [iosiPadOSWebClip](../resources/intune-apps-iosipadoswebclip.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Iosipadoswebclip Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosipadoswebclip-get.md
Title: "Get iosiPadOSWebClip" description: "Read properties and relationships of the iosiPadOSWebClip object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [iosiPadOSWebClip](../resources/intune-apps-iosipadoswebclip.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1095
} } ```-----
v1.0 Intune Apps Iosipadoswebclip List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosipadoswebclip-list.md
Title: "List iosiPadOSWebClips" description: "List properties and relationships of the iosiPadOSWebClip objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [iosiPadOSWebClip](../resources/intune-apps-iosipadoswebclip.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 1167
] } ```-----
v1.0 Intune Apps Iosipadoswebclip Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosipadoswebclip-update.md
Title: "Update iosiPadOSWebClip" description: "Update the properties of a iosiPadOSWebClip object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [iosiPadOSWebClip](../resources/intune-apps-iosipadoswebclip.md) object.
-## Prerequisites
+## 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)|
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)|
-|appUrl|String|The web app URL.|
-|useManagedBrowser|Boolean|Whether or not to use managed browser. When true, the app will be required to be opened in an Intune-protected browser. When false, the app will not be required to be opened in an Intune-protected browser.|
+|appUrl|String|Indicates iOS/iPadOS web clip app URL. Example: "https://www.contoso.com"|
+|useManagedBrowser|Boolean|Whether or not to use managed browser. When TRUE, the app will be required to be opened in Microsoft Edge. When FALSE, the app will not be required to be opened in Microsoft Edge. By default, this property is set to FALSE.|
Content-Length: 1018
"useManagedBrowser": true } ```-----
v1.0 Intune Apps Ioslobapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-ioslobapp-create.md
Title: "Create iosLobApp" description: "Create a new iosLobApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [iosLobApp](../resources/intune-apps-ioslobapp.md) object.
-## Prerequisites
+## 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)|
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. This property is being deprecated in 2211(November 2022)|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps Content-type: application/json
-Content-length: 1508
+Content-length: 1480
{ "@odata.type": "#microsoft.graph.iosLobApp",
Content-length: 1508
"v12_0": true, "v13_0": true, "v14_0": true,
- "v15_0": true
+ "v15_0": true,
+ "v16_0": true
}, "expirationDateTime": "2016-12-31T23:57:57.2481234-08:00", "versionNumber": "Version Number value",
- "buildNumber": "Build Number value",
- "identityVersion": "Identity Version value"
+ "buildNumber": "Build Number 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: 1680
+Content-Length: 1652
{ "@odata.type": "#microsoft.graph.iosLobApp",
Content-Length: 1680
"v12_0": true, "v13_0": true, "v14_0": true,
- "v15_0": true
+ "v15_0": true,
+ "v16_0": true
}, "expirationDateTime": "2016-12-31T23:57:57.2481234-08:00", "versionNumber": "Version Number value",
- "buildNumber": "Build Number value",
- "identityVersion": "Identity Version value"
+ "buildNumber": "Build Number value"
} ```-----
v1.0 Intune Apps Ioslobapp Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-ioslobapp-delete.md
Title: "Delete iosLobApp" description: "Deletes a iosLobApp."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [iosLobApp](../resources/intune-apps-ioslobapp.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Ioslobapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-ioslobapp-get.md
Title: "Get iosLobApp" description: "Read properties and relationships of the iosLobApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [iosLobApp](../resources/intune-apps-ioslobapp.md) object.
-## Prerequisites
+## 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)|
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: 1801
+Content-Length: 1773
{ "value": {
Content-Length: 1801
"v12_0": true, "v13_0": true, "v14_0": true,
- "v15_0": true
+ "v15_0": true,
+ "v16_0": true
}, "expirationDateTime": "2016-12-31T23:57:57.2481234-08:00", "versionNumber": "Version Number value",
- "buildNumber": "Build Number value",
- "identityVersion": "Identity Version value"
+ "buildNumber": "Build Number value"
} } ```-----
v1.0 Intune Apps Ioslobapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-ioslobapp-list.md
Title: "List iosLobApps" description: "List properties and relationships of the iosLobApp objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [iosLobApp](../resources/intune-apps-ioslobapp.md) objects.
-## Prerequisites
+## 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)|
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: 1917
+Content-Length: 1889
{ "value": [
Content-Length: 1917
"v12_0": true, "v13_0": true, "v14_0": true,
- "v15_0": true
+ "v15_0": true,
+ "v16_0": true
}, "expirationDateTime": "2016-12-31T23:57:57.2481234-08:00", "versionNumber": "Version Number value",
- "buildNumber": "Build Number value",
- "identityVersion": "Identity Version value"
+ "buildNumber": "Build Number value"
} ] } ```-----
v1.0 Intune Apps Ioslobapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-ioslobapp-update.md
Title: "Update iosLobApp" description: "Update the properties of a iosLobApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [iosLobApp](../resources/intune-apps-ioslobapp.md) object.
-## Prerequisites
+## 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)|
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. This property is being deprecated in 2211(November 2022)|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId} Content-type: application/json
-Content-length: 1508
+Content-length: 1480
{ "@odata.type": "#microsoft.graph.iosLobApp",
Content-length: 1508
"v12_0": true, "v13_0": true, "v14_0": true,
- "v15_0": true
+ "v15_0": true,
+ "v16_0": true
}, "expirationDateTime": "2016-12-31T23:57:57.2481234-08:00", "versionNumber": "Version Number value",
- "buildNumber": "Build Number value",
- "identityVersion": "Identity Version value"
+ "buildNumber": "Build Number 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: 1680
+Content-Length: 1652
{ "@odata.type": "#microsoft.graph.iosLobApp",
Content-Length: 1680
"v12_0": true, "v13_0": true, "v14_0": true,
- "v15_0": true
+ "v15_0": true,
+ "v16_0": true
}, "expirationDateTime": "2016-12-31T23:57:57.2481234-08:00", "versionNumber": "Version Number value",
- "buildNumber": "Build Number value",
- "identityVersion": "Identity Version value"
+ "buildNumber": "Build Number value"
} ```-----
v1.0 Intune Apps Ioslobappprovisioningconfigurationassignment Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-ioslobappprovisioningconfigurationassignment-create.md
Title: "Create iosLobAppProvisioningConfigurationAssignment" description: "Create a new iosLobAppProvisioningConfigurationAssignment object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [iosLobAppProvisioningConfigurationAssignment](../resources/intune-apps-ioslobappprovisioningconfigurationassignment.md) object.
-## Prerequisites
+## 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)|
Content-Length: 400
} } ```-----
v1.0 Intune Apps Ioslobappprovisioningconfigurationassignment Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-ioslobappprovisioningconfigurationassignment-delete.md
Title: "Delete iosLobAppProvisioningConfigurationAssignment" description: "Deletes a iosLobAppProvisioningConfigurationAssignment."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [iosLobAppProvisioningConfigurationAssignment](../resources/intune-apps-ioslobappprovisioningconfigurationassignment.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Ioslobappprovisioningconfigurationassignment Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-ioslobappprovisioningconfigurationassignment-get.md
Title: "Get iosLobAppProvisioningConfigurationAssignment" description: "Read properties and relationships of the iosLobAppProvisioningConfigurationAssignment object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [iosLobAppProvisioningConfigurationAssignment](../resources/intune-apps-ioslobappprovisioningconfigurationassignment.md) object.
-## Prerequisites
+## 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)|
Content-Length: 433
} } ```-----
v1.0 Intune Apps Ioslobappprovisioningconfigurationassignment List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-ioslobappprovisioningconfigurationassignment-list.md
Title: "List iosLobAppProvisioningConfigurationAssignments" description: "List properties and relationships of the iosLobAppProvisioningConfigurationAssignment objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [iosLobAppProvisioningConfigurationAssignment](../resources/intune-apps-ioslobappprovisioningconfigurationassignment.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 461
] } ```-----
v1.0 Intune Apps Ioslobappprovisioningconfigurationassignment Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-ioslobappprovisioningconfigurationassignment-update.md
Title: "Update iosLobAppProvisioningConfigurationAssignment" description: "Update the properties of a iosLobAppProvisioningConfigurationAssignment object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [iosLobAppProvisioningConfigurationAssignment](../resources/intune-apps-ioslobappprovisioningconfigurationassignment.md) object.
-## Prerequisites
+## 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)|
Content-Length: 400
} } ```-----
v1.0 Intune Apps Iosmobileappconfiguration Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosmobileappconfiguration-create.md
Title: "Create iosMobileAppConfiguration" description: "Create a new iosMobileAppConfiguration object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [iosMobileAppConfiguration](../resources/intune-apps-iosmobileappconfiguration.md) object.
-## Prerequisites
+## 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)|
Content-Length: 768
] } ```-----
v1.0 Intune Apps Iosmobileappconfiguration Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosmobileappconfiguration-delete.md
Title: "Delete iosMobileAppConfiguration" description: "Deletes a iosMobileAppConfiguration."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [iosMobileAppConfiguration](../resources/intune-apps-iosmobileappconfiguration.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Iosmobileappconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosmobileappconfiguration-get.md
Title: "Get iosMobileAppConfiguration" description: "Read properties and relationships of the iosMobileAppConfiguration object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [iosMobileAppConfiguration](../resources/intune-apps-iosmobileappconfiguration.md) object.
-## Prerequisites
+## 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)|
Content-Length: 831
} } ```-----
v1.0 Intune Apps Iosmobileappconfiguration List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosmobileappconfiguration-list.md
Title: "List iosMobileAppConfigurations" description: "List properties and relationships of the iosMobileAppConfiguration objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [iosMobileAppConfiguration](../resources/intune-apps-iosmobileappconfiguration.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 889
] } ```-----
v1.0 Intune Apps Iosmobileappconfiguration Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosmobileappconfiguration-update.md
Title: "Update iosMobileAppConfiguration" description: "Update the properties of a iosMobileAppConfiguration object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [iosMobileAppConfiguration](../resources/intune-apps-iosmobileappconfiguration.md) object.
-## Prerequisites
+## 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)|
Content-Length: 768
] } ```-----
v1.0 Intune Apps Iosstoreapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosstoreapp-create.md
Title: "Create iosStoreApp" description: "Create a new iosStoreApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [iosStoreApp](../resources/intune-apps-iosstoreapp.md) object.
-## Prerequisites
+## 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)|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps Content-type: application/json
-Content-length: 1257
+Content-length: 1277
{ "@odata.type": "#microsoft.graph.iosStoreApp",
Content-length: 1257
"v12_0": true, "v13_0": true, "v14_0": true,
- "v15_0": true
+ "v15_0": true,
+ "v16_0": 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: 1429
+Content-Length: 1449
{ "@odata.type": "#microsoft.graph.iosStoreApp",
Content-Length: 1429
"v12_0": true, "v13_0": true, "v14_0": true,
- "v15_0": true
+ "v15_0": true,
+ "v16_0": true
} } ```-----
v1.0 Intune Apps Iosstoreapp Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosstoreapp-delete.md
Title: "Delete iosStoreApp" description: "Deletes a iosStoreApp."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [iosStoreApp](../resources/intune-apps-iosstoreapp.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Iosstoreapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosstoreapp-get.md
Title: "Get iosStoreApp" description: "Read properties and relationships of the iosStoreApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [iosStoreApp](../resources/intune-apps-iosstoreapp.md) object.
-## Prerequisites
+## 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)|
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: 1538
+Content-Length: 1560
{ "value": {
Content-Length: 1538
"v12_0": true, "v13_0": true, "v14_0": true,
- "v15_0": true
+ "v15_0": true,
+ "v16_0": true
} } } ```-----
v1.0 Intune Apps Iosstoreapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosstoreapp-list.md
Title: "List iosStoreApps" description: "List properties and relationships of the iosStoreApp objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [iosStoreApp](../resources/intune-apps-iosstoreapp.md) objects.
-## Prerequisites
+## 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)|
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: 1642
+Content-Length: 1666
{ "value": [
Content-Length: 1642
"v12_0": true, "v13_0": true, "v14_0": true,
- "v15_0": true
+ "v15_0": true,
+ "v16_0": true
} } ] } ```-----
v1.0 Intune Apps Iosstoreapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosstoreapp-update.md
Title: "Update iosStoreApp" description: "Update the properties of a iosStoreApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [iosStoreApp](../resources/intune-apps-iosstoreapp.md) object.
-## Prerequisites
+## 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)|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId} Content-type: application/json
-Content-length: 1257
+Content-length: 1277
{ "@odata.type": "#microsoft.graph.iosStoreApp",
Content-length: 1257
"v12_0": true, "v13_0": true, "v14_0": true,
- "v15_0": true
+ "v15_0": true,
+ "v16_0": 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: 1429
+Content-Length: 1449
{ "@odata.type": "#microsoft.graph.iosStoreApp",
Content-Length: 1429
"v12_0": true, "v13_0": true, "v14_0": true,
- "v15_0": true
+ "v15_0": true,
+ "v16_0": true
} } ```-----
v1.0 Intune Apps Iosvppapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosvppapp-create.md
Title: "Create iosVppApp" description: "Create a new iosVppApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [iosVppApp](../resources/intune-apps-iosvppapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 2228
] } ```-----
v1.0 Intune Apps Iosvppapp Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosvppapp-delete.md
Title: "Delete iosVppApp" description: "Deletes a iosVppApp."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [iosVppApp](../resources/intune-apps-iosvppapp.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Iosvppapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosvppapp-get.md
Title: "Get iosVppApp" description: "Read properties and relationships of the iosVppApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [iosVppApp](../resources/intune-apps-iosvppapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 2371
} } ```-----
v1.0 Intune Apps Iosvppapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosvppapp-list.md
Title: "List iosVppApps" description: "List properties and relationships of the iosVppApp objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [iosVppApp](../resources/intune-apps-iosvppapp.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 2509
] } ```-----
v1.0 Intune Apps Iosvppapp Revokealllicenses https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosvppapp-revokealllicenses.md
Title: "revokeAllLicenses action" description: "Revoke all assigned iOS VPP licenses for given app."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Revoke all assigned iOS VPP licenses for given app.
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Iosvppapp Revokedevicelicense https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosvppapp-revokedevicelicense.md
Title: "revokeDeviceLicense action" description: "Revoke assigned iOS VPP device license for given app."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Revoke assigned iOS VPP device license for given app.
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Iosvppapp Revokeuserlicense https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosvppapp-revokeuserlicense.md
Title: "revokeUserLicense action" description: "Revoke assigned iOS VPP user license for given app."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Revoke assigned iOS VPP user license for given app.
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Iosvppapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosvppapp-update.md
Title: "Update iosVppApp" description: "Update the properties of a iosVppApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [iosVppApp](../resources/intune-apps-iosvppapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 2228
] } ```-----
v1.0 Intune Apps Iosvppappassigneddevicelicense Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneddevicelicense-create.md
Title: "Create iosVppAppAssignedDeviceLicense" description: "Create a new iosVppAppAssignedDeviceLicense object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [iosVppAppAssignedDeviceLicense](../resources/intune-apps-iosvppappassigneddevicelicense.md) object.
-## Prerequisites
+## 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)|
Content-Length: 376
"deviceName": "Device Name value" } ```-----
v1.0 Intune Apps Iosvppappassigneddevicelicense Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneddevicelicense-delete.md
Title: "Delete iosVppAppAssignedDeviceLicense" description: "Deletes a iosVppAppAssignedDeviceLicense."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [iosVppAppAssignedDeviceLicense](../resources/intune-apps-iosvppappassigneddevicelicense.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Iosvppappassigneddevicelicense Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneddevicelicense-get.md
Title: "Get iosVppAppAssignedDeviceLicense" description: "Read properties and relationships of the iosVppAppAssignedDeviceLicense object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [iosVppAppAssignedDeviceLicense](../resources/intune-apps-iosvppappassigneddevicelicense.md) object.
-## Prerequisites
+## 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)|
Content-Length: 411
} } ```-----
v1.0 Intune Apps Iosvppappassigneddevicelicense List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneddevicelicense-list.md
Title: "List iosVppAppAssignedDeviceLicenses" description: "List properties and relationships of the iosVppAppAssignedDeviceLicense objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [iosVppAppAssignedDeviceLicense](../resources/intune-apps-iosvppappassigneddevicelicense.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 441
] } ```-----
v1.0 Intune Apps Iosvppappassigneddevicelicense Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneddevicelicense-update.md
Title: "Update iosVppAppAssignedDeviceLicense" description: "Update the properties of a iosVppAppAssignedDeviceLicense object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [iosVppAppAssignedDeviceLicense](../resources/intune-apps-iosvppappassigneddevicelicense.md) object.
-## Prerequisites
+## 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)|
Content-Length: 376
"deviceName": "Device Name value" } ```-----
v1.0 Intune Apps Iosvppappassignedlicense Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosvppappassignedlicense-create.md
Title: "Create iosVppAppAssignedLicense" description: "Create a new iosVppAppAssignedLicense object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [iosVppAppAssignedLicense](../resources/intune-apps-iosvppappassignedlicense.md) object.
-## Prerequisites
+## 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)|
Content-Length: 283
"userPrincipalName": "User Principal Name value" } ```-----
v1.0 Intune Apps Iosvppappassignedlicense Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosvppappassignedlicense-delete.md
Title: "Delete iosVppAppAssignedLicense" description: "Deletes a iosVppAppAssignedLicense."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [iosVppAppAssignedLicense](../resources/intune-apps-iosvppappassignedlicense.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Iosvppappassignedlicense Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosvppappassignedlicense-get.md
Title: "Get iosVppAppAssignedLicense" description: "Read properties and relationships of the iosVppAppAssignedLicense object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [iosVppAppAssignedLicense](../resources/intune-apps-iosvppappassignedlicense.md) object.
-## Prerequisites
+## 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)|
Content-Length: 314
} } ```-----
v1.0 Intune Apps Iosvppappassignedlicense List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosvppappassignedlicense-list.md
Title: "List iosVppAppAssignedLicenses" description: "List properties and relationships of the iosVppAppAssignedLicense objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [iosVppAppAssignedLicense](../resources/intune-apps-iosvppappassignedlicense.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 340
] } ```-----
v1.0 Intune Apps Iosvppappassignedlicense Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosvppappassignedlicense-update.md
Title: "Update iosVppAppAssignedLicense" description: "Update the properties of a iosVppAppAssignedLicense object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [iosVppAppAssignedLicense](../resources/intune-apps-iosvppappassignedlicense.md) object.
-## Prerequisites
+## 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)|
Content-Length: 283
"userPrincipalName": "User Principal Name value" } ```-----
v1.0 Intune Apps Iosvppappassigneduserlicense Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneduserlicense-create.md
Title: "Create iosVppAppAssignedUserLicense" description: "Create a new iosVppAppAssignedUserLicense object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [iosVppAppAssignedUserLicense](../resources/intune-apps-iosvppappassigneduserlicense.md) object.
-## Prerequisites
+## 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)|
Content-Length: 287
"userPrincipalName": "User Principal Name value" } ```-----
v1.0 Intune Apps Iosvppappassigneduserlicense Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneduserlicense-delete.md
Title: "Delete iosVppAppAssignedUserLicense" description: "Deletes a iosVppAppAssignedUserLicense."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [iosVppAppAssignedUserLicense](../resources/intune-apps-iosvppappassigneduserlicense.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Iosvppappassigneduserlicense Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneduserlicense-get.md
Title: "Get iosVppAppAssignedUserLicense" description: "Read properties and relationships of the iosVppAppAssignedUserLicense object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [iosVppAppAssignedUserLicense](../resources/intune-apps-iosvppappassigneduserlicense.md) object.
-## Prerequisites
+## 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)|
Content-Length: 318
} } ```-----
v1.0 Intune Apps Iosvppappassigneduserlicense List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneduserlicense-list.md
Title: "List iosVppAppAssignedUserLicenses" description: "List properties and relationships of the iosVppAppAssignedUserLicense objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [iosVppAppAssignedUserLicense](../resources/intune-apps-iosvppappassigneduserlicense.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 344
] } ```-----
v1.0 Intune Apps Iosvppappassigneduserlicense Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-iosvppappassigneduserlicense-update.md
Title: "Update iosVppAppAssignedUserLicense" description: "Update the properties of a iosVppAppAssignedUserLicense object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [iosVppAppAssignedUserLicense](../resources/intune-apps-iosvppappassigneduserlicense.md) object.
-## Prerequisites
+## 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)|
Content-Length: 287
"userPrincipalName": "User Principal Name value" } ```-----
v1.0 Intune Apps Macosdmgapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosdmgapp-create.md
Title: "Create macOSDmgApp" description: "Create a new macOSDmgApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [macOSDmgApp](../resources/intune-apps-macosdmgapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1737
} } ```-----
v1.0 Intune Apps Macosdmgapp Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosdmgapp-delete.md
Title: "Delete macOSDmgApp" description: "Deletes a macOSDmgApp."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [macOSDmgApp](../resources/intune-apps-macosdmgapp.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Macosdmgapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosdmgapp-get.md
Title: "Get macOSDmgApp" description: "Read properties and relationships of the macOSDmgApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [macOSDmgApp](../resources/intune-apps-macosdmgapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1866
} } ```-----
v1.0 Intune Apps Macosdmgapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosdmgapp-list.md
Title: "List macOSDmgApps" description: "List properties and relationships of the macOSDmgApp objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [macOSDmgApp](../resources/intune-apps-macosdmgapp.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 1990
] } ```-----
v1.0 Intune Apps Macosdmgapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosdmgapp-update.md
Title: "Update macOSDmgApp" description: "Update the properties of a macOSDmgApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [macOSDmgApp](../resources/intune-apps-macosdmgapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1737
} } ```-----
v1.0 Intune Apps Macoslobapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macoslobapp-create.md
Title: "Create macOSLobApp" description: "Create a new macOSLobApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [macOSLobApp](../resources/intune-apps-macoslobapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1934
"installAsManaged": true } ```-----
v1.0 Intune Apps Macoslobapp Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macoslobapp-delete.md
Title: "Delete macOSLobApp" description: "Deletes a macOSLobApp."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [macOSLobApp](../resources/intune-apps-macoslobapp.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Macoslobapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macoslobapp-get.md
Title: "Get macOSLobApp" description: "Read properties and relationships of the macOSLobApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [macOSLobApp](../resources/intune-apps-macoslobapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 2079
} } ```-----
v1.0 Intune Apps Macoslobapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macoslobapp-list.md
Title: "List macOSLobApps" description: "List properties and relationships of the macOSLobApp objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [macOSLobApp](../resources/intune-apps-macoslobapp.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 2219
] } ```-----
v1.0 Intune Apps Macoslobapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macoslobapp-update.md
Title: "Update macOSLobApp" description: "Update the properties of a macOSLobApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [macOSLobApp](../resources/intune-apps-macoslobapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1934
"installAsManaged": true } ```-----
v1.0 Intune Apps Macosmdatpapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmdatpapp-create.md
Title: "Create macOSMdatpApp" description: "Create a new macOSMdatpApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [macOSMdatpApp](../resources/intune-apps-macosmdatpapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 941
"supersededAppCount": 2 } ```-----
v1.0 Intune Apps Macosmdatpapp Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmdatpapp-delete.md
Title: "Delete macOSMdatpApp" description: "Deletes a macOSMdatpApp."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [macOSMdatpApp](../resources/intune-apps-macosmdatpapp.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Macosmdatpapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmdatpapp-get.md
Title: "Get macOSMdatpApp" description: "Read properties and relationships of the macOSMdatpApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [macOSMdatpApp](../resources/intune-apps-macosmdatpapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1014
} } ```-----
v1.0 Intune Apps Macosmdatpapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmdatpapp-list.md
Title: "List macOSMdatpApps" description: "List properties and relationships of the macOSMdatpApp objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [macOSMdatpApp](../resources/intune-apps-macosmdatpapp.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 1082
] } ```-----
v1.0 Intune Apps Macosmdatpapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmdatpapp-update.md
Title: "Update macOSMdatpApp" description: "Update the properties of a macOSMdatpApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [macOSMdatpApp](../resources/intune-apps-macosmdatpapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 941
"supersededAppCount": 2 } ```-----
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 ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 953
"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 ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` 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 ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1026
} } ```-----
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 ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 1094
] } ```-----
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 ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [macOSMicrosoftDefenderApp](../resources/intune-apps-macosmicrosoftdefenderapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 953
"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
Title: "Create macOSMicrosoftEdgeApp" description: "Create a new macOSMicrosoftEdgeApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [macOSMicrosoftEdgeApp](../resources/intune-apps-macosmicrosoftedgeapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 971
"channel": "beta" } ```-----
v1.0 Intune Apps Macosmicrosoftedgeapp Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmicrosoftedgeapp-delete.md
Title: "Delete macOSMicrosoftEdgeApp" description: "Deletes a macOSMicrosoftEdgeApp."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [macOSMicrosoftEdgeApp](../resources/intune-apps-macosmicrosoftedgeapp.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Macosmicrosoftedgeapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmicrosoftedgeapp-get.md
Title: "Get macOSMicrosoftEdgeApp" description: "Read properties and relationships of the macOSMicrosoftEdgeApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [macOSMicrosoftEdgeApp](../resources/intune-apps-macosmicrosoftedgeapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1046
} } ```-----
v1.0 Intune Apps Macosmicrosoftedgeapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmicrosoftedgeapp-list.md
Title: "List macOSMicrosoftEdgeApps" description: "List properties and relationships of the macOSMicrosoftEdgeApp objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [macOSMicrosoftEdgeApp](../resources/intune-apps-macosmicrosoftedgeapp.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 1116
] } ```-----
v1.0 Intune Apps Macosmicrosoftedgeapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosmicrosoftedgeapp-update.md
Title: "Update macOSMicrosoftEdgeApp" description: "Update the properties of a macOSMicrosoftEdgeApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [macOSMicrosoftEdgeApp](../resources/intune-apps-macosmicrosoftedgeapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 971
"channel": "beta" } ```-----
v1.0 Intune Apps Macosofficesuiteapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosofficesuiteapp-create.md
Title: "Create macOSOfficeSuiteApp" description: "Create a new macOSOfficeSuiteApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [macOSOfficeSuiteApp](../resources/intune-apps-macosofficesuiteapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 947
"supersededAppCount": 2 } ```-----
v1.0 Intune Apps Macosofficesuiteapp Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosofficesuiteapp-delete.md
Title: "Delete macOSOfficeSuiteApp" description: "Deletes a macOSOfficeSuiteApp."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [macOSOfficeSuiteApp](../resources/intune-apps-macosofficesuiteapp.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Macosofficesuiteapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosofficesuiteapp-get.md
Title: "Get macOSOfficeSuiteApp" description: "Read properties and relationships of the macOSOfficeSuiteApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [macOSOfficeSuiteApp](../resources/intune-apps-macosofficesuiteapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1020
} } ```-----
v1.0 Intune Apps Macosofficesuiteapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosofficesuiteapp-list.md
Title: "List macOSOfficeSuiteApps" description: "List properties and relationships of the macOSOfficeSuiteApp objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [macOSOfficeSuiteApp](../resources/intune-apps-macosofficesuiteapp.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 1088
] } ```-----
v1.0 Intune Apps Macosofficesuiteapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosofficesuiteapp-update.md
Title: "Update macOSOfficeSuiteApp" description: "Update the properties of a macOSOfficeSuiteApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [macOSOfficeSuiteApp](../resources/intune-apps-macosofficesuiteapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 947
"supersededAppCount": 2 } ```-----
v1.0 Intune Apps Macosvppapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosvppapp-create.md
Title: "Create macOsVppApp" description: "Create a new macOsVppApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [macOsVppApp](../resources/intune-apps-macosvppapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 2098
] } ```-----
v1.0 Intune Apps Macosvppapp Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosvppapp-delete.md
Title: "Delete macOsVppApp" description: "Deletes a macOsVppApp."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [macOsVppApp](../resources/intune-apps-macosvppapp.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Macosvppapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosvppapp-get.md
Title: "Get macOsVppApp" description: "Read properties and relationships of the macOsVppApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [macOsVppApp](../resources/intune-apps-macosvppapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 2231
} } ```-----
v1.0 Intune Apps Macosvppapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosvppapp-list.md
Title: "List macOsVppApps" description: "List properties and relationships of the macOsVppApp objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [macOsVppApp](../resources/intune-apps-macosvppapp.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 2359
] } ```-----
v1.0 Intune Apps Macosvppapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosvppapp-update.md
Title: "Update macOsVppApp" description: "Update the properties of a macOsVppApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [macOsVppApp](../resources/intune-apps-macosvppapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 2098
] } ```-----
v1.0 Intune Apps Macosvppappassignedlicense Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosvppappassignedlicense-create.md
Title: "Create macOsVppAppAssignedLicense" description: "Create a new macOsVppAppAssignedLicense object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [macOsVppAppAssignedLicense](../resources/intune-apps-macosvppappassignedlicense.md) object.
-## Prerequisites
+## 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)|
Content-Length: 285
"userPrincipalName": "User Principal Name value" } ```-----
v1.0 Intune Apps Macosvppappassignedlicense Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosvppappassignedlicense-delete.md
Title: "Delete macOsVppAppAssignedLicense" description: "Deletes a macOsVppAppAssignedLicense."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [macOsVppAppAssignedLicense](../resources/intune-apps-macosvppappassignedlicense.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Macosvppappassignedlicense Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosvppappassignedlicense-get.md
Title: "Get macOsVppAppAssignedLicense" description: "Read properties and relationships of the macOsVppAppAssignedLicense object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [macOsVppAppAssignedLicense](../resources/intune-apps-macosvppappassignedlicense.md) object.
-## Prerequisites
+## 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)|
Content-Length: 316
} } ```-----
v1.0 Intune Apps Macosvppappassignedlicense List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosvppappassignedlicense-list.md
Title: "List macOsVppAppAssignedLicenses" description: "List properties and relationships of the macOsVppAppAssignedLicense objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [macOsVppAppAssignedLicense](../resources/intune-apps-macosvppappassignedlicense.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 342
] } ```-----
v1.0 Intune Apps Macosvppappassignedlicense Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-macosvppappassignedlicense-update.md
Title: "Update macOsVppAppAssignedLicense" description: "Update the properties of a macOsVppAppAssignedLicense object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [macOsVppAppAssignedLicense](../resources/intune-apps-macosvppappassignedlicense.md) object.
-## Prerequisites
+## 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)|
Content-Length: 285
"userPrincipalName": "User Principal Name value" } ```-----
v1.0 Intune Apps Managedandroidlobapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-managedandroidlobapp-create.md
Title: "Create managedAndroidLobApp" description: "Create a new managedAndroidLobApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [managedAndroidLobApp](../resources/intune-apps-managedandroidlobapp.md) object.
-## Prerequisites
+## 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)|
The following table shows the properties that are required when you create the m
|fileName|String|The name of the main Lob application file. Inherited from [managedMobileLobApp](../resources/intune-apps-managedmobilelobapp.md)| |size|Int64|The total size, including all uploaded files. Inherited from [managedMobileLobApp](../resources/intune-apps-managedmobilelobapp.md)| |packageId|String|The package identifier.|
-|identityName|String|The Identity Name.|
+|identityName|String|The Identity Name. This property is deprecated starting in February 2023 (Release 2302).|
|minimumSupportedOperatingSystem|[androidMinimumOperatingSystem](../resources/intune-apps-androidminimumoperatingsystem.md)|The value for the minimum applicable operating system.| |versionName|String|The version name of managed Android Line of Business (LoB) app.| |versionCode|String|The version code of managed Android Line of Business (LoB) app.|
-|identityVersion|String|The identity version.|
+|identityVersion|String|The identity version. This property is deprecated starting in February 2023 (Release 2302).|
Content-Length: 1760
"identityVersion": "Identity Version value" } ```-----
v1.0 Intune Apps Managedandroidlobapp Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-managedandroidlobapp-delete.md
Title: "Delete managedAndroidLobApp" description: "Deletes a managedAndroidLobApp."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [managedAndroidLobApp](../resources/intune-apps-managedandroidlobapp.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Managedandroidlobapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-managedandroidlobapp-get.md
Title: "Get managedAndroidLobApp" description: "Read properties and relationships of the managedAndroidLobApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [managedAndroidLobApp](../resources/intune-apps-managedandroidlobapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1891
} } ```-----
v1.0 Intune Apps Managedandroidlobapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-managedandroidlobapp-list.md
Title: "List managedAndroidLobApps" description: "List properties and relationships of the managedAndroidLobApp objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [managedAndroidLobApp](../resources/intune-apps-managedandroidlobapp.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 2017
] } ```-----
v1.0 Intune Apps Managedandroidlobapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-managedandroidlobapp-update.md
Title: "Update managedAndroidLobApp" description: "Update the properties of a managedAndroidLobApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [managedAndroidLobApp](../resources/intune-apps-managedandroidlobapp.md) object.
-## Prerequisites
+## 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)|
The following table shows the properties that are required when you create the [
|fileName|String|The name of the main Lob application file. Inherited from [managedMobileLobApp](../resources/intune-apps-managedmobilelobapp.md)| |size|Int64|The total size, including all uploaded files. Inherited from [managedMobileLobApp](../resources/intune-apps-managedmobilelobapp.md)| |packageId|String|The package identifier.|
-|identityName|String|The Identity Name.|
+|identityName|String|The Identity Name. This property is deprecated starting in February 2023 (Release 2302).|
|minimumSupportedOperatingSystem|[androidMinimumOperatingSystem](../resources/intune-apps-androidminimumoperatingsystem.md)|The value for the minimum applicable operating system.| |versionName|String|The version name of managed Android Line of Business (LoB) app.| |versionCode|String|The version code of managed Android Line of Business (LoB) app.|
-|identityVersion|String|The identity version.|
+|identityVersion|String|The identity version. This property is deprecated starting in February 2023 (Release 2302).|
Content-Length: 1760
"identityVersion": "Identity Version value" } ```-----
v1.0 Intune Apps Managedandroidstoreapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-managedandroidstoreapp-create.md
Title: "Create managedAndroidStoreApp" description: "Create a new managedAndroidStoreApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [managedAndroidStoreApp](../resources/intune-apps-managedandroidstoreapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1533
} } ```-----
v1.0 Intune Apps Managedandroidstoreapp Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-managedandroidstoreapp-delete.md
Title: "Delete managedAndroidStoreApp" description: "Deletes a managedAndroidStoreApp."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [managedAndroidStoreApp](../resources/intune-apps-managedandroidstoreapp.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Managedandroidstoreapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-managedandroidstoreapp-get.md
Title: "Get managedAndroidStoreApp" description: "Read properties and relationships of the managedAndroidStoreApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [managedAndroidStoreApp](../resources/intune-apps-managedandroidstoreapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1652
} } ```-----
v1.0 Intune Apps Managedandroidstoreapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-managedandroidstoreapp-list.md
Title: "List managedAndroidStoreApps" description: "List properties and relationships of the managedAndroidStoreApp objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [managedAndroidStoreApp](../resources/intune-apps-managedandroidstoreapp.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 1766
] } ```-----
v1.0 Intune Apps Managedandroidstoreapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-managedandroidstoreapp-update.md
Title: "Update managedAndroidStoreApp" description: "Update the properties of a managedAndroidStoreApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [managedAndroidStoreApp](../resources/intune-apps-managedandroidstoreapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1533
} } ```-----
v1.0 Intune Apps Managedapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-managedapp-get.md
Title: "Get managedApp" description: "Read properties and relationships of the managedApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [managedApp](../resources/intune-apps-managedapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1086
} } ```-----
v1.0 Intune Apps Managedapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-managedapp-list.md
Title: "List managedApps" description: "List properties and relationships of the managedApp objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [managedApp](../resources/intune-apps-managedapp.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 1158
] } ```-----
v1.0 Intune Apps Manageddevicemobileappconfiguration Assign https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-manageddevicemobileappconfiguration-assign.md
Title: "assign action" description: "Not yet documented"-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Not yet documented
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Manageddevicemobileappconfiguration Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-manageddevicemobileappconfiguration-get.md
Title: "Get managedDeviceMobileAppConfiguration" description: "Read properties and relationships of the managedDeviceMobileAppConfiguration object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [managedDeviceMobileAppConfiguration](../resources/intune-apps-manageddevicemobileappconfiguration.md) object.
-## Prerequisites
+## 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)|
Content-Length: 519
} } ```-----
v1.0 Intune Apps Manageddevicemobileappconfiguration List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-manageddevicemobileappconfiguration-list.md
Title: "List managedDeviceMobileAppConfigurations" description: "List properties and relationships of the managedDeviceMobileAppConfiguration objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [managedDeviceMobileAppConfiguration](../resources/intune-apps-manageddevicemobileappconfiguration.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 559
] } ```-----
v1.0 Intune Apps Manageddevicemobileappconfigurationassignment Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-manageddevicemobileappconfigurationassignment-create.md
Title: "Create managedDeviceMobileAppConfigurationAssignment" description: "Create a new managedDeviceMobileAppConfigurationAssignment object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [managedDeviceMobileAppConfigurationAssignment](../resources/intune-apps-manageddevicemobileappconfigurationassignment.md) object.
-## Prerequisites
+## 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)|
Content-Length: 395
} } ```-----
v1.0 Intune Apps Manageddevicemobileappconfigurationassignment Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-manageddevicemobileappconfigurationassignment-delete.md
Title: "Delete managedDeviceMobileAppConfigurationAssignment" description: "Deletes a managedDeviceMobileAppConfigurationAssignment."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [managedDeviceMobileAppConfigurationAssignment](../resources/intune-apps-manageddevicemobileappconfigurationassignment.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Manageddevicemobileappconfigurationassignment Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-manageddevicemobileappconfigurationassignment-get.md
Title: "Get managedDeviceMobileAppConfigurationAssignment" description: "Read properties and relationships of the managedDeviceMobileAppConfigurationAssignment object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [managedDeviceMobileAppConfigurationAssignment](../resources/intune-apps-manageddevicemobileappconfigurationassignment.md) object.
-## Prerequisites
+## 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)|
Content-Length: 428
} } ```-----
v1.0 Intune Apps Manageddevicemobileappconfigurationassignment List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-manageddevicemobileappconfigurationassignment-list.md
Title: "List managedDeviceMobileAppConfigurationAssignments" description: "List properties and relationships of the managedDeviceMobileAppConfigurationAssignment objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [managedDeviceMobileAppConfigurationAssignment](../resources/intune-apps-manageddevicemobileappconfigurationassignment.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 456
] } ```-----
v1.0 Intune Apps Manageddevicemobileappconfigurationassignment Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-manageddevicemobileappconfigurationassignment-update.md
Title: "Update managedDeviceMobileAppConfigurationAssignment" description: "Update the properties of a managedDeviceMobileAppConfigurationAssignment object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [managedDeviceMobileAppConfigurationAssignment](../resources/intune-apps-manageddevicemobileappconfigurationassignment.md) object.
-## Prerequisites
+## 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)|
Content-Length: 395
} } ```-----
v1.0 Intune Apps Manageddevicemobileappconfigurationdevicestatus Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-manageddevicemobileappconfigurationdevicestatus-create.md
Title: "Create managedDeviceMobileAppConfigurationDeviceStatus" description: "Create a new managedDeviceMobileAppConfigurationDeviceStatus object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [managedDeviceMobileAppConfigurationDeviceStatus](../resources/intune-apps-manageddevicemobileappconfigurationdevicestatus.md) object.
-## Prerequisites
+## 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)|
Content-Length: 512
"userPrincipalName": "User Principal Name value" } ```-----
v1.0 Intune Apps Manageddevicemobileappconfigurationdevicestatus Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-manageddevicemobileappconfigurationdevicestatus-delete.md
Title: "Delete managedDeviceMobileAppConfigurationDeviceStatus" description: "Deletes a managedDeviceMobileAppConfigurationDeviceStatus."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [managedDeviceMobileAppConfigurationDeviceStatus](../resources/intune-apps-manageddevicemobileappconfigurationdevicestatus.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Manageddevicemobileappconfigurationdevicestatus Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-manageddevicemobileappconfigurationdevicestatus-get.md
Title: "Get managedDeviceMobileAppConfigurationDeviceStatus" description: "Read properties and relationships of the managedDeviceMobileAppConfigurationDeviceStatus object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [managedDeviceMobileAppConfigurationDeviceStatus](../resources/intune-apps-manageddevicemobileappconfigurationdevicestatus.md) object.
-## Prerequisites
+## 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)|
Content-Length: 551
} } ```-----
v1.0 Intune Apps Manageddevicemobileappconfigurationdevicestatus List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-manageddevicemobileappconfigurationdevicestatus-list.md
Title: "List managedDeviceMobileAppConfigurationDeviceStatuses" description: "List properties and relationships of the managedDeviceMobileAppConfigurationDeviceStatus objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [managedDeviceMobileAppConfigurationDeviceStatus](../resources/intune-apps-manageddevicemobileappconfigurationdevicestatus.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 585
] } ```-----
v1.0 Intune Apps Manageddevicemobileappconfigurationdevicestatus Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-manageddevicemobileappconfigurationdevicestatus-update.md
Title: "Update managedDeviceMobileAppConfigurationDeviceStatus" description: "Update the properties of a managedDeviceMobileAppConfigurationDeviceStatus object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [managedDeviceMobileAppConfigurationDeviceStatus](../resources/intune-apps-manageddevicemobileappconfigurationdevicestatus.md) object.
-## Prerequisites
+## 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)|
Content-Length: 512
"userPrincipalName": "User Principal Name value" } ```-----
v1.0 Intune Apps Manageddevicemobileappconfigurationdevicesummary Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-manageddevicemobileappconfigurationdevicesummary-get.md
Title: "Get managedDeviceMobileAppConfigurationDeviceSummary" description: "Read properties and relationships of the managedDeviceMobileAppConfigurationDeviceSummary object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [managedDeviceMobileAppConfigurationDeviceSummary](../resources/intune-apps-manageddevicemobileappconfigurationdevicesummary.md) object.
-## Prerequisites
+## 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)|
Content-Length: 450
} } ```-----
v1.0 Intune Apps Manageddevicemobileappconfigurationdevicesummary Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-manageddevicemobileappconfigurationdevicesummary-update.md
Title: "Update managedDeviceMobileAppConfigurationDeviceSummary" description: "Update the properties of a managedDeviceMobileAppConfigurationDeviceSummary object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [managedDeviceMobileAppConfigurationDeviceSummary](../resources/intune-apps-manageddevicemobileappconfigurationdevicesummary.md) object.
-## Prerequisites
+## 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)|
Content-Length: 409
"configurationVersion": 4 } ```-----
v1.0 Intune Apps Manageddevicemobileappconfigurationuserstatus Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-manageddevicemobileappconfigurationuserstatus-create.md
Title: "Create managedDeviceMobileAppConfigurationUserStatus" description: "Create a new managedDeviceMobileAppConfigurationUserStatus object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [managedDeviceMobileAppConfigurationUserStatus](../resources/intune-apps-manageddevicemobileappconfigurationuserstatus.md) object.
-## Prerequisites
+## 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)|
Content-Length: 355
"userPrincipalName": "User Principal Name value" } ```-----
v1.0 Intune Apps Manageddevicemobileappconfigurationuserstatus Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-manageddevicemobileappconfigurationuserstatus-delete.md
Title: "Delete managedDeviceMobileAppConfigurationUserStatus" description: "Deletes a managedDeviceMobileAppConfigurationUserStatus."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [managedDeviceMobileAppConfigurationUserStatus](../resources/intune-apps-manageddevicemobileappconfigurationuserstatus.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Manageddevicemobileappconfigurationuserstatus Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-manageddevicemobileappconfigurationuserstatus-get.md
Title: "Get managedDeviceMobileAppConfigurationUserStatus" description: "Read properties and relationships of the managedDeviceMobileAppConfigurationUserStatus object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [managedDeviceMobileAppConfigurationUserStatus](../resources/intune-apps-manageddevicemobileappconfigurationuserstatus.md) object.
-## Prerequisites
+## 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)|
Content-Length: 388
} } ```-----
v1.0 Intune Apps Manageddevicemobileappconfigurationuserstatus List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-manageddevicemobileappconfigurationuserstatus-list.md
Title: "List managedDeviceMobileAppConfigurationUserStatuses" description: "List properties and relationships of the managedDeviceMobileAppConfigurationUserStatus objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [managedDeviceMobileAppConfigurationUserStatus](../resources/intune-apps-manageddevicemobileappconfigurationuserstatus.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 416
] } ```-----
v1.0 Intune Apps Manageddevicemobileappconfigurationuserstatus Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-manageddevicemobileappconfigurationuserstatus-update.md
Title: "Update managedDeviceMobileAppConfigurationUserStatus" description: "Update the properties of a managedDeviceMobileAppConfigurationUserStatus object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [managedDeviceMobileAppConfigurationUserStatus](../resources/intune-apps-manageddevicemobileappconfigurationuserstatus.md) object.
-## Prerequisites
+## 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)|
Content-Length: 355
"userPrincipalName": "User Principal Name value" } ```-----
v1.0 Intune Apps Manageddevicemobileappconfigurationusersummary Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-manageddevicemobileappconfigurationusersummary-get.md
Title: "Get managedDeviceMobileAppConfigurationUserSummary" description: "Read properties and relationships of the managedDeviceMobileAppConfigurationUserSummary object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [managedDeviceMobileAppConfigurationUserSummary](../resources/intune-apps-manageddevicemobileappconfigurationusersummary.md) object.
-## Prerequisites
+## 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)|
Content-Length: 409
} } ```-----
v1.0 Intune Apps Manageddevicemobileappconfigurationusersummary Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-manageddevicemobileappconfigurationusersummary-update.md
Title: "Update managedDeviceMobileAppConfigurationUserSummary" description: "Update the properties of a managedDeviceMobileAppConfigurationUserSummary object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [managedDeviceMobileAppConfigurationUserSummary](../resources/intune-apps-manageddevicemobileappconfigurationusersummary.md) object.
-## Prerequisites
+## 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)|
Content-Length: 370
"configurationVersion": 4 } ```-----
v1.0 Intune Apps Managedioslobapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-managedioslobapp-create.md
Title: "Create managedIOSLobApp" description: "Create a new managedIOSLobApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [managedIOSLobApp](../resources/intune-apps-managedioslobapp.md) object.
-## Prerequisites
+## 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)|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps Content-type: application/json
-Content-length: 1586
+Content-length: 1606
{ "@odata.type": "#microsoft.graph.managedIOSLobApp",
Content-length: 1586
"v12_0": true, "v13_0": true, "v14_0": true,
- "v15_0": true
+ "v15_0": true,
+ "v16_0": true
}, "expirationDateTime": "2016-12-31T23:57:57.2481234-08:00", "versionNumber": "Version Number 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: 1758
+Content-Length: 1778
{ "@odata.type": "#microsoft.graph.managedIOSLobApp",
Content-Length: 1758
"v12_0": true, "v13_0": true, "v14_0": true,
- "v15_0": true
+ "v15_0": true,
+ "v16_0": true
}, "expirationDateTime": "2016-12-31T23:57:57.2481234-08:00", "versionNumber": "Version Number value",
Content-Length: 1758
"identityVersion": "Identity Version value" } ```-----
v1.0 Intune Apps Managedioslobapp Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-managedioslobapp-delete.md
Title: "Delete managedIOSLobApp" description: "Deletes a managedIOSLobApp."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [managedIOSLobApp](../resources/intune-apps-managedioslobapp.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Managedioslobapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-managedioslobapp-get.md
Title: "Get managedIOSLobApp" description: "Read properties and relationships of the managedIOSLobApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [managedIOSLobApp](../resources/intune-apps-managedioslobapp.md) object.
-## Prerequisites
+## 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)|
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: 1883
+Content-Length: 1905
{ "value": {
Content-Length: 1883
"v12_0": true, "v13_0": true, "v14_0": true,
- "v15_0": true
+ "v15_0": true,
+ "v16_0": true
}, "expirationDateTime": "2016-12-31T23:57:57.2481234-08:00", "versionNumber": "Version Number value",
Content-Length: 1883
} } ```-----
v1.0 Intune Apps Managedioslobapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-managedioslobapp-list.md
Title: "List managedIOSLobApps" description: "List properties and relationships of the managedIOSLobApp objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [managedIOSLobApp](../resources/intune-apps-managedioslobapp.md) objects.
-## Prerequisites
+## 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)|
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: 2003
+Content-Length: 2027
{ "value": [
Content-Length: 2003
"v12_0": true, "v13_0": true, "v14_0": true,
- "v15_0": true
+ "v15_0": true,
+ "v16_0": true
}, "expirationDateTime": "2016-12-31T23:57:57.2481234-08:00", "versionNumber": "Version Number value",
Content-Length: 2003
] } ```-----
v1.0 Intune Apps Managedioslobapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-managedioslobapp-update.md
Title: "Update managedIOSLobApp" description: "Update the properties of a managedIOSLobApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [managedIOSLobApp](../resources/intune-apps-managedioslobapp.md) object.
-## Prerequisites
+## 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)|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId} Content-type: application/json
-Content-length: 1586
+Content-length: 1606
{ "@odata.type": "#microsoft.graph.managedIOSLobApp",
Content-length: 1586
"v12_0": true, "v13_0": true, "v14_0": true,
- "v15_0": true
+ "v15_0": true,
+ "v16_0": true
}, "expirationDateTime": "2016-12-31T23:57:57.2481234-08:00", "versionNumber": "Version Number 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: 1758
+Content-Length: 1778
{ "@odata.type": "#microsoft.graph.managedIOSLobApp",
Content-Length: 1758
"v12_0": true, "v13_0": true, "v14_0": true,
- "v15_0": true
+ "v15_0": true,
+ "v16_0": true
}, "expirationDateTime": "2016-12-31T23:57:57.2481234-08:00", "versionNumber": "Version Number value",
Content-Length: 1758
"identityVersion": "Identity Version value" } ```-----
v1.0 Intune Apps Managediosstoreapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-managediosstoreapp-create.md
Title: "Create managedIOSStoreApp" description: "Create a new managedIOSStoreApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [managedIOSStoreApp](../resources/intune-apps-managediosstoreapp.md) object.
-## Prerequisites
+## 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)|
Here is an example of the request.
``` http POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps Content-type: application/json
-Content-length: 1335
+Content-length: 1355
{ "@odata.type": "#microsoft.graph.managedIOSStoreApp",
Content-length: 1335
"v12_0": true, "v13_0": true, "v14_0": true,
- "v15_0": true
+ "v15_0": true,
+ "v16_0": 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: 1507
+Content-Length: 1527
{ "@odata.type": "#microsoft.graph.managedIOSStoreApp",
Content-Length: 1507
"v12_0": true, "v13_0": true, "v14_0": true,
- "v15_0": true
+ "v15_0": true,
+ "v16_0": true
} } ```-----
v1.0 Intune Apps Managediosstoreapp Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-managediosstoreapp-delete.md
Title: "Delete managedIOSStoreApp" description: "Deletes a managedIOSStoreApp."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [managedIOSStoreApp](../resources/intune-apps-managediosstoreapp.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Managediosstoreapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-managediosstoreapp-get.md
Title: "Get managedIOSStoreApp" description: "Read properties and relationships of the managedIOSStoreApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [managedIOSStoreApp](../resources/intune-apps-managediosstoreapp.md) object.
-## Prerequisites
+## 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)|
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: 1620
+Content-Length: 1642
{ "value": {
Content-Length: 1620
"v12_0": true, "v13_0": true, "v14_0": true,
- "v15_0": true
+ "v15_0": true,
+ "v16_0": true
} } } ```-----
v1.0 Intune Apps Managediosstoreapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-managediosstoreapp-list.md
Title: "List managedIOSStoreApps" description: "List properties and relationships of the managedIOSStoreApp objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [managedIOSStoreApp](../resources/intune-apps-managediosstoreapp.md) objects.
-## Prerequisites
+## 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)|
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: 1728
+Content-Length: 1752
{ "value": [
Content-Length: 1728
"v12_0": true, "v13_0": true, "v14_0": true,
- "v15_0": true
+ "v15_0": true,
+ "v16_0": true
} } ] } ```-----
v1.0 Intune Apps Managediosstoreapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-managediosstoreapp-update.md
Title: "Update managedIOSStoreApp" description: "Update the properties of a managedIOSStoreApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [managedIOSStoreApp](../resources/intune-apps-managediosstoreapp.md) object.
-## Prerequisites
+## 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)|
Here is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId} Content-type: application/json
-Content-length: 1335
+Content-length: 1355
{ "@odata.type": "#microsoft.graph.managedIOSStoreApp",
Content-length: 1335
"v12_0": true, "v13_0": true, "v14_0": true,
- "v15_0": true
+ "v15_0": true,
+ "v16_0": 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: 1507
+Content-Length: 1527
{ "@odata.type": "#microsoft.graph.managedIOSStoreApp",
Content-Length: 1507
"v12_0": true, "v13_0": true, "v14_0": true,
- "v15_0": true
+ "v15_0": true,
+ "v16_0": true
} } ```-----
v1.0 Intune Apps Managedmobilelobapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-managedmobilelobapp-get.md
Title: "Get managedMobileLobApp" description: "Read properties and relationships of the managedMobileLobApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [managedMobileLobApp](../resources/intune-apps-managedmobilelobapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1214
} } ```-----
v1.0 Intune Apps Managedmobilelobapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-managedmobilelobapp-list.md
Title: "List managedMobileLobApps" description: "List properties and relationships of the managedMobileLobApp objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [managedMobileLobApp](../resources/intune-apps-managedmobilelobapp.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 1292
] } ```-----
v1.0 Intune Apps Microsoftstoreforbusinessapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-microsoftstoreforbusinessapp-create.md
Title: "Create microsoftStoreForBusinessApp" description: "Create a new microsoftStoreForBusinessApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [microsoftStoreForBusinessApp](../resources/intune-apps-microsoftstoreforbusinessapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1361
} } ```-----
v1.0 Intune Apps Microsoftstoreforbusinessapp Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-microsoftstoreforbusinessapp-delete.md
Title: "Delete microsoftStoreForBusinessApp" description: "Deletes a microsoftStoreForBusinessApp."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [microsoftStoreForBusinessApp](../resources/intune-apps-microsoftstoreforbusinessapp.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Microsoftstoreforbusinessapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-microsoftstoreforbusinessapp-get.md
Title: "Get microsoftStoreForBusinessApp" description: "Read properties and relationships of the microsoftStoreForBusinessApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [microsoftStoreForBusinessApp](../resources/intune-apps-microsoftstoreforbusinessapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1458
} } ```-----
v1.0 Intune Apps Microsoftstoreforbusinessapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-microsoftstoreforbusinessapp-list.md
Title: "List microsoftStoreForBusinessApps" description: "List properties and relationships of the microsoftStoreForBusinessApp objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [microsoftStoreForBusinessApp](../resources/intune-apps-microsoftstoreforbusinessapp.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 1550
] } ```-----
v1.0 Intune Apps Microsoftstoreforbusinessapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-microsoftstoreforbusinessapp-update.md
Title: "Update microsoftStoreForBusinessApp" description: "Update the properties of a microsoftStoreForBusinessApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [microsoftStoreForBusinessApp](../resources/intune-apps-microsoftstoreforbusinessapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1361
} } ```-----
v1.0 Intune Apps Microsoftstoreforbusinesscontainedapp Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-microsoftstoreforbusinesscontainedapp-create.md
Title: "Create microsoftStoreForBusinessContainedApp" description: "Create a new microsoftStoreForBusinessContainedApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [microsoftStoreForBusinessContainedApp](../resources/intune-apps-microsoftstoreforbusinesscontainedapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 176
"appUserModelId": "App User Model Id value" } ```-----
v1.0 Intune Apps Microsoftstoreforbusinesscontainedapp Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-microsoftstoreforbusinesscontainedapp-delete.md
Title: "Delete microsoftStoreForBusinessContainedApp" description: "Deletes a microsoftStoreForBusinessContainedApp."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [microsoftStoreForBusinessContainedApp](../resources/intune-apps-microsoftstoreforbusinesscontainedapp.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Microsoftstoreforbusinesscontainedapp Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-microsoftstoreforbusinesscontainedapp-get.md
Title: "Get microsoftStoreForBusinessContainedApp" description: "Read properties and relationships of the microsoftStoreForBusinessContainedApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [microsoftStoreForBusinessContainedApp](../resources/intune-apps-microsoftstoreforbusinesscontainedapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 201
} } ```-----
v1.0 Intune Apps Microsoftstoreforbusinesscontainedapp List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-microsoftstoreforbusinesscontainedapp-list.md
Title: "List microsoftStoreForBusinessContainedApps" description: "List properties and relationships of the microsoftStoreForBusinessContainedApp objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [microsoftStoreForBusinessContainedApp](../resources/intune-apps-microsoftstoreforbusinesscontainedapp.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 221
] } ```-----
v1.0 Intune Apps Microsoftstoreforbusinesscontainedapp Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-microsoftstoreforbusinesscontainedapp-update.md
Title: "Update microsoftStoreForBusinessContainedApp" description: "Update the properties of a microsoftStoreForBusinessContainedApp object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [microsoftStoreForBusinessContainedApp](../resources/intune-apps-microsoftstoreforbusinesscontainedapp.md) object.
-## Prerequisites
+## 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)|
Content-Length: 176
"appUserModelId": "App User Model Id value" } ```-----
v1.0 Intune Apps Mobileapp Validatexml https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-mobileapp-validatexml.md
Title: "validateXml action" description: "Not yet documented"-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Not yet documented
-## Prerequisites
+## 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)|
Content-Length: 37
"value": "Validate Xml value" } ```-----
v1.0 Intune Apps Mobileappassignment Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-mobileappassignment-create.md
Title: "Create mobileAppAssignment" description: "Create a new mobileAppAssignment object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [mobileAppAssignment](../resources/intune-apps-mobileappassignment.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1022
"sourceId": "Source Id value" } ```-----
v1.0 Intune Apps Mobileappassignment Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-mobileappassignment-delete.md
Title: "Delete mobileAppAssignment" description: "Deletes a mobileAppAssignment."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [mobileAppAssignment](../resources/intune-apps-mobileappassignment.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Mobileappassignment Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-mobileappassignment-get.md
Title: "Get mobileAppAssignment" description: "Read properties and relationships of the mobileAppAssignment object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [mobileAppAssignment](../resources/intune-apps-mobileappassignment.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1091
} } ```-----
v1.0 Intune Apps Mobileappassignment List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-mobileappassignment-list.md
Title: "List mobileAppAssignments" description: "List properties and relationships of the mobileAppAssignment objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [mobileAppAssignment](../resources/intune-apps-mobileappassignment.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 1155
] } ```-----
v1.0 Intune Apps Mobileappassignment Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-mobileappassignment-update.md
Title: "Update mobileAppAssignment" description: "Update the properties of a mobileAppAssignment object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [mobileAppAssignment](../resources/intune-apps-mobileappassignment.md) object.
-## Prerequisites
+## 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)|
Content-Length: 1022
"sourceId": "Source Id value" } ```-----
v1.0 Intune Apps Mobileappcategory Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-mobileappcategory-create.md
Title: "Create mobileAppCategory" description: "Create a new mobileAppCategory object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [mobileAppCategory](../resources/intune-apps-mobileappcategory.md) object.
-## Prerequisites
+## 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)|
Content-Length: 212
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00" } ```-----
v1.0 Intune Apps Mobileappcategory Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-mobileappcategory-delete.md
Title: "Delete mobileAppCategory" description: "Deletes a mobileAppCategory."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [mobileAppCategory](../resources/intune-apps-mobileappcategory.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Mobileappcategory Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-mobileappcategory-get.md
Title: "Get mobileAppCategory" description: "Read properties and relationships of the mobileAppCategory object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [mobileAppCategory](../resources/intune-apps-mobileappcategory.md) object.
-## Prerequisites
+## 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)|
Content-Length: 239
} } ```-----
v1.0 Intune Apps Mobileappcategory List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-mobileappcategory-list.md
Title: "List mobileAppCategories" description: "List properties and relationships of the mobileAppCategory objects."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
List properties and relationships of the [mobileAppCategory](../resources/intune-apps-mobileappcategory.md) objects.
-## Prerequisites
+## 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)|
Content-Length: 261
] } ```-----
v1.0 Intune Apps Mobileappcategory Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-mobileappcategory-update.md
Title: "Update mobileAppCategory" description: "Update the properties of a mobileAppCategory object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Update the properties of a [mobileAppCategory](../resources/intune-apps-mobileappcategory.md) object.
-## Prerequisites
+## 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)|
Content-Length: 212
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00" } ```-----
v1.0 Intune Apps Mobileappcontent Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-mobileappcontent-create.md
Title: "Create mobileAppContent" description: "Create a new mobileAppContent object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Create a new [mobileAppContent](../resources/intune-apps-mobileappcontent.md) object.
-## Prerequisites
+## 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)|
Content-Length: 107
"id": "fe0bb9a9-b9a9-fe0b-a9b9-0bfea9b90bfe" } ```-----
v1.0 Intune Apps Mobileappcontent Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-mobileappcontent-delete.md
Title: "Delete mobileAppContent" description: "Deletes a mobileAppContent."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Deletes a [mobileAppContent](../resources/intune-apps-mobileappcontent.md).
-## Prerequisites
+## 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)|
Here is an example of the response. Note: The response object shown here may be
``` http HTTP/1.1 204 No Content ```-----
v1.0 Intune Apps Mobileappcontent Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/intune-apps-mobileappcontent-get.md
Title: "Get mobileAppContent" description: "Read properties and relationships of the mobileAppContent object."-+ localization_priority: Normal ms.prod: "intune" doc_type: apiPageType
Namespace: microsoft.graph
Read properties and relationships of the [mobileAppContent](../resources/intune-apps-mobileappcontent.md) object.
-## Prerequisites
+## 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)|
Content-Length: 130
} } ```-----
v1.0