Create androidForWorkApp
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 for the tenant.
Create a new androidForWorkApp object.
This API is available in the following national cloud deployments.
Global service | US Government L4 | US Government L5 (DOD) | China operated by 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Permissions
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 least to most privileged) |
---|---|
Delegated (work or school account) | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All |
Delegated (personal Microsoft account) | Not supported. |
Application | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All |
HTTP Request
POST /deviceAppManagement/mobileApps
Request headers
Header | Value |
---|---|
Authorization | Bearer {token}. Required. Learn more about authentication and authorization. |
Accept | application/json |
Request body
In the request body, supply a JSON representation for the androidForWorkApp object.
The following table shows the properties that are required when you create the androidForWorkApp.
Property | Type | Description |
---|---|---|
id | String | Key of the entity. This property is read-only. Inherited from mobileApp |
displayName | String | The admin provided or imported title of the app. Inherited from mobileApp |
description | String | The description of the app. Inherited from mobileApp |
publisher | String | The publisher of the app. Inherited from mobileApp |
largeIcon | mimeContent | The large icon, to be displayed in the app details and used for upload of the icon. Inherited from mobileApp |
createdDateTime | DateTimeOffset | The date and time the app was created. This property is read-only. Inherited from mobileApp |
lastModifiedDateTime | DateTimeOffset | The date and time the app was last modified. This property is read-only. Inherited from mobileApp |
isFeatured | Boolean | The value indicating whether the app is marked as featured by the admin. Inherited from mobileApp |
privacyInformationUrl | String | The privacy statement Url. Inherited from mobileApp |
informationUrl | String | The more information Url. Inherited from mobileApp |
owner | String | The owner of the app. Inherited from mobileApp |
developer | String | The developer of the app. Inherited from mobileApp |
notes | String | Notes for the app. Inherited from mobileApp |
uploadState | Int32 | The upload state. Possible values are: 0 - Not Ready , 1 - Ready , 2 - Processing . This property is read-only. Inherited from mobileApp |
publishingState | mobileAppPublishingState | The publishing state for the app. The app cannot be assigned unless the app is published. This property is read-only. Inherited from mobileApp. Possible values are: notPublished , processing , published . |
isAssigned | Boolean | The value indicating whether the app is assigned to at least one group. This property is read-only. Inherited from mobileApp |
roleScopeTagIds | String collection | List of scope tag ids for this mobile app. Inherited from mobileApp |
dependentAppCount | Int32 | The total number of dependencies the child app has. This property is read-only. Inherited from mobileApp |
supersedingAppCount | Int32 | The total number of apps this app directly or indirectly supersedes. This property is read-only. Inherited from mobileApp |
supersededAppCount | Int32 | The total number of apps this app is directly or indirectly superseded by. This property is read-only. Inherited from mobileApp |
packageId | String | The package identifier. This property is read-only. |
appIdentifier | String | The Identity Name. This property is read-only. |
usedLicenseCount | Int32 | The number of VPP licenses in use. |
totalLicenseCount | Int32 | The total number of VPP licenses. |
appStoreUrl | String | The Play for Work Store app URL. |
Response
If successful, this method returns a 201 Created
response code and a androidForWorkApp object in the response body.
Example
Request
Here is an example of the request.
POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps
Content-type: application/json
Content-length: 960
{
"@odata.type": "#microsoft.graph.androidForWorkApp",
"displayName": "Display Name value",
"description": "Description value",
"publisher": "Publisher value",
"largeIcon": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"isFeatured": true,
"privacyInformationUrl": "https://example.com/privacyInformationUrl/",
"informationUrl": "https://example.com/informationUrl/",
"owner": "Owner value",
"developer": "Developer value",
"notes": "Notes value",
"uploadState": 11,
"publishingState": "processing",
"isAssigned": true,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"dependentAppCount": 1,
"supersedingAppCount": 3,
"supersededAppCount": 2,
"packageId": "Package Id value",
"appIdentifier": "App Identifier value",
"usedLicenseCount": 0,
"totalLicenseCount": 1,
"appStoreUrl": "https://example.com/appStoreUrl/"
}
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: 1132
{
"@odata.type": "#microsoft.graph.androidForWorkApp",
"id": "c5010785-0785-c501-8507-01c5850701c5",
"displayName": "Display Name value",
"description": "Description value",
"publisher": "Publisher value",
"largeIcon": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"isFeatured": true,
"privacyInformationUrl": "https://example.com/privacyInformationUrl/",
"informationUrl": "https://example.com/informationUrl/",
"owner": "Owner value",
"developer": "Developer value",
"notes": "Notes value",
"uploadState": 11,
"publishingState": "processing",
"isAssigned": true,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"dependentAppCount": 1,
"supersedingAppCount": 3,
"supersededAppCount": 2,
"packageId": "Package Id value",
"appIdentifier": "App Identifier value",
"usedLicenseCount": 0,
"totalLicenseCount": 1,
"appStoreUrl": "https://example.com/appStoreUrl/"
}