4Installing an Enterprise Application on iOS Devices

Description Install an enterprise application on iOS devices.

Resource Path /enterpriseapplication

URL /ios/operation/enterpriseapplication

HTTP Method POST

Request/Response Format application/json

cURL command

curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer <EMM_API_TOKEN>" -d @'<JSON_PAYLOAD>' -k -v https://<EMM_HOST>:<EMM_HTTPS_PORT>/ios/operation/enterpriseapplication

For more information on how to generate the EMM API token, see Generating the EMM API Token.
Define the path to the JSON file as the <JSON_PAYLOAD> value.
By default, <EMM_HOST> is localhost. However, if you are using a public IP, the respective IP address or domain needs to be specified.
By default, <EMM_HTTPS_PORT> has been set to 9443. However, if the port offset has been incremented by n, the default port value needs to be incremented by n.

For example: enterprise_application.json has the device ID's listed as shown under sample request.

curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer 33392fb365b3ac693b405b565ddc8a3a" -d @'enterprise_application.json' -k -v https://<EMM_HOST>:<EMM_HTTPS_PORT>/ios/operation/enterpriseapplication

Sample output

Sample JSON definition

{
  "operation": {
    "identifier": "com.wso2.emm.agent",
    "manifestURL": "https://mydomain.com/manifest",
    "removeAppUponMDMProfileRemoval": true,
    "preventBackupOfAppData": false
  },
  "deviceIDs": [
    "2be702beaaf4ad34fc9e7f8da2b6b808c453fa72b",
    "2ec33430ad456713c633de75b2219376bac45de56"
  ]
}

Property	Description	Required	Default Value	Data Type	Example
`operation`	The attributes required to carry out the operation of installing an enterprise application are defined here.	Yes	N/A	operation	-
`deviceIDs`	The Device ID of the AirPlay destination. This field is not case sensitive.	Yes	N/A	String	2be702beaaf4ad34fc9e7f8da 2b6b808c453fa72b
`identifier`	The bundle identifier of the application.	Yes	N/A	String	com.wso2.emm.agent
`manifestURL`	The https URL where the manifest of an enterprise application can be found. In iOS 7 and later, this URL and the URLs of any assets specified in the manifest must begin with https .	Yes	N/A	String	https://mydomain.com/manifest
`removeAppUponMDM ProfileRemoval`	Remove app when MDM profile is removed.	Yes	true	Boolean	false
`preventBackupOf AppData`	Prevent backup of the app data.	Yes	false	Boolean	true