Create targetedManagedAppConfiguration
Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.
Create a new targetedManagedAppConfiguration object.
Prerequisites
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.
Permission type | Permissions (from most to least privileged) |
---|---|
Delegated (work or school account) | DeviceManagementApps.ReadWrite.All |
Delegated (personal Microsoft account) | Not supported. |
Application | Not supported. |
HTTP Request
POST /deviceAppManagement/targetedManagedAppConfigurations
Request headers
Header | Value |
---|---|
Authorization | Bearer <token> Required. |
Accept | application/json |
Request body
In the request body, supply a JSON representation for the targetedManagedAppConfiguration object.
The following table shows the properties that are required when you create the targetedManagedAppConfiguration.
Property | Type | Description |
---|---|---|
displayName | String | Policy display name. Inherited from managedAppPolicy |
description | String | The policy's description. Inherited from managedAppPolicy |
createdDateTime | DateTimeOffset | The date and time the policy was created. Inherited from managedAppPolicy |
lastModifiedDateTime | DateTimeOffset | Last time the policy was modified. Inherited from managedAppPolicy |
id | String | Key of the entity. Inherited from managedAppPolicy |
version | String | Version of the entity. Inherited from managedAppPolicy |
customSettings | keyValuePair collection | A set of string key and string value pairs to be sent to apps for users to whom the configuration is scoped, unalterned by this service Inherited from managedAppConfiguration |
deployedAppCount | Int32 | Count of apps to which the current policy is deployed. |
isAssigned | Boolean | Indicates if the policy is deployed to any inclusion groups or not. |
Response
If successful, this method returns a 201 Created
response code and a targetedManagedAppConfiguration object in the response body.
Example
Request
Here is an example of the request.
POST https://graph.microsoft.com/v1.0/deviceAppManagement/targetedManagedAppConfigurations
Content-type: application/json
Content-length: 388
{
"@odata.type": "#microsoft.graph.targetedManagedAppConfiguration",
"displayName": "Display Name value",
"description": "Description value",
"version": "Version value",
"customSettings": [
{
"@odata.type": "microsoft.graph.keyValuePair",
"name": "Name value",
"value": "Value value"
}
],
"deployedAppCount": 0,
"isAssigned": true
}
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/1.1 201 Created
Content-Type: application/json
Content-Length: 560
{
"@odata.type": "#microsoft.graph.targetedManagedAppConfiguration",
"displayName": "Display Name value",
"description": "Description value",
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"id": "2444e029-e029-2444-29e0-442429e04424",
"version": "Version value",
"customSettings": [
{
"@odata.type": "microsoft.graph.keyValuePair",
"name": "Name value",
"value": "Value value"
}
],
"deployedAppCount": 0,
"isAssigned": true
}
Feedback
Loading feedback...