Console API Guide

The following sections illustrate the console operation APIs that are used in EMM:

Getting device operations

Error rendering macro 'excerpt-include' : No link could be created for 'Getting Device Operations'.

Getting application details of a device

Error rendering macro 'excerpt-include' : No link could be created for 'Getting Application Details of a Device'.

Getting pagination details of operations on a device

Error rendering macro 'excerpt-include' : No link could be created for 'Getting Paginations Details of Operations on a Device'.

Install an application on a device

Description Install a selected application on a device.

Resource Path /installApp/{tenantDomain}

URL /mdm-admin/operations/installApp/{tenantDomain}

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>/mdm-admin/operation/installApp/{tenantDomain}

For more information on how to generate the <EMM_API_TOKEN>, see Generating the EMM API Token.
Define the path to the JSON file, which includes the required properties to install an application as the <JSON_PAYLOAD> value. For more information, see the Sample JSON Definition.
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.
Provide the tenant domain as the value for {tenantDomain}. The default tenant domain of WSO2 EMM is carbon.super. For more information on adding a tenant, see Managing Tenants.

Example:

curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer 33392fb365b3ac693b405b565ddc8a3a" -d @'device_id.json' -k -v https://localhost:9443/mdm-admin/operations/installApp/carbon.super

Sample output

> POST /mdm-admin/operations/installApp/carbon.super HTTP/1.1
> Host: localhost:9443
> User-Agent: curl/7.43.0
> Accept: */*
> Content-Type: application/json
> Authorization: Bearer 33392fb365b3ac693b405b565ddc8a3a
> Content-Length: 23
< HTTP/1.1 201 Created
< Cache-Control: private
< Expires: Thu, 01 Jan 1970 06:35:00 IST
< Date: Thu, 25 Feb 2016 14:06:57 GMT
< Content-Type: application/json
< Content-Length: 80
< Server: WSO2 Carbon Server
{"statusCode": 201, "messageFromServer": "Application installation request has been sent to the device."}

Sample JSON
Definition

[
  "2be702beaaf4ad34fc9e7f8da2b6b808c453fa72b", 
  "2ec33430ad456713c633de75b2219376bac45de56"
]

Property Value	Description	Required	Default Value	Data Type	Example
device id	ID of the device. Multiple device IDs can be added by using comma separated values.	Yes	N/A	String	2be702beaaf4ad34fc9e 7f8da2b6b808c453fa72b

Uninstall an application on a device

Description Uninstall a selected application from a device.

Resource Path /uninstallApp/{tenantDomain}

URL /mdm-admin/operations/uninstallApp/{tenantDomain}