Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Namespace: microsoft.graph
Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.
Create a new managedIOSLobApp 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 managedIOSLobApp object.
The following table shows the properties that are required when you create the managedIOSLobApp.
| 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 |
| 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. |
| appAvailability | managedAppAvailability | The Application's availability. This property is read-only. Inherited from managedApp. Possible values are: global, lineOfBusiness. |
| version | String | The Application's version. Inherited from managedApp |
| committedContentVersion | String | The internal committed content version. Inherited from managedMobileLobApp |
| fileName | String | The name of the main Lob application file. Inherited from managedMobileLobApp |
| size | Int64 | The total size, including all uploaded files. This property is read-only. Inherited from managedMobileLobApp |
| bundleId | String | The Identity Name. |
| applicableDeviceType | iosDeviceType | The iOS architecture for which this app can run on. |
| minimumSupportedOperatingSystem | iosMinimumOperatingSystem | The value for the minimum applicable operating system. |
| expirationDateTime | DateTimeOffset | The expiration time. |
| versionNumber | String | The version number of managed iOS Line of Business (LoB) app. |
| buildNumber | String | The build number of managed iOS Line of Business (LoB) app. |
Response
If successful, this method returns a 201 Created response code and a managedIOSLobApp object in the response body.
Example
Request
Here is an example of the request.
POST https://graph.microsoft.com/v1.0/deviceAppManagement/mobileApps
Content-type: application/json
Content-length: 1347
{
"@odata.type": "#microsoft.graph.managedIOSLobApp",
"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",
"publishingState": "processing",
"appAvailability": "lineOfBusiness",
"version": "Version value",
"committedContentVersion": "Committed Content Version value",
"fileName": "File Name value",
"size": 4,
"bundleId": "Bundle Id value",
"applicableDeviceType": {
"@odata.type": "microsoft.graph.iosDeviceType",
"iPad": true,
"iPhoneAndIPod": true
},
"minimumSupportedOperatingSystem": {
"@odata.type": "microsoft.graph.iosMinimumOperatingSystem",
"v8_0": true,
"v9_0": true,
"v10_0": true,
"v11_0": true,
"v12_0": true,
"v13_0": true,
"v14_0": true,
"v15_0": true
},
"expirationDateTime": "2016-12-31T23:57:57.2481234-08:00",
"versionNumber": "Version Number value",
"buildNumber": "Build Number 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/1.1 201 Created
Content-Type: application/json
Content-Length: 1519
{
"@odata.type": "#microsoft.graph.managedIOSLobApp",
"id": "8f59792d-792d-8f59-2d79-598f2d79598f",
"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",
"publishingState": "processing",
"appAvailability": "lineOfBusiness",
"version": "Version value",
"committedContentVersion": "Committed Content Version value",
"fileName": "File Name value",
"size": 4,
"bundleId": "Bundle Id value",
"applicableDeviceType": {
"@odata.type": "microsoft.graph.iosDeviceType",
"iPad": true,
"iPhoneAndIPod": true
},
"minimumSupportedOperatingSystem": {
"@odata.type": "microsoft.graph.iosMinimumOperatingSystem",
"v8_0": true,
"v9_0": true,
"v10_0": true,
"v11_0": true,
"v12_0": true,
"v13_0": true,
"v14_0": true,
"v15_0": true
},
"expirationDateTime": "2016-12-31T23:57:57.2481234-08:00",
"versionNumber": "Version Number value",
"buildNumber": "Build Number value"
}