Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Excerpt
DescriptionUninstall an application from Android devices.
Resource Path/uninstall-application
URL

/mdm-android-agent/operation/uninstall-application

HTTP MethodPOST
Request/Response Formatapplication/json
cURL command
Code Block
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-android-agent/operation/uninstall-application
  • For more information on how to generate the EMM API token, see Generating the OAuth 2.0 Access Token.
  • Define the path to the <JSON_PAYLOAD>, which includes the required properties to carry out the operation, 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.

Example:

Code Block
curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer e56974e8bf5df15748f89c6c5da9835d" -d @'operation.json' -k -v https://localhost:9443/mdm-android-agent/operation/uninstall-application
 Sample output
Code Block
> POST /mdm-android-agent/operation/uninstall-application HTTP/1.1
> User-Agent: curl/7.24.0 (x86_64-apple-darwin12.0) libcurl/7.24.0 OpenSSL/0.9.8| zlib/1.2.5
> Host: localhost:9443
> Accept: */*
> Content-Type: application/json
> Authorization: Bearer e56974e8bf5df15748f89c6c5da9835d
> Content-Length: 110
< HTTP/1.1 201 Created
< Date: Wed, 10 Jun 2015 12:38:42 GMT
< Content-Length: 0
< Server: WSO2 Carbon Server
Anchor
sampleUninstallApp
sampleUninstallApp
Sample JSON Definition 
Localtabgroup
Localtab
activetrue
titleEnterprise app
Code Block
{
  "operation": {
    "appIdentifier": "com.wso2.test1",
    "type": "enterprise",
    "url": "https://localhost:9443/store/test1.apk",
    "name": "test1",
	"schedule":"04-30-2016 11:25 am"
  },
"deviceIDs": [
    "d8:50:e6:2f:6a:8b",
    "a5:60:e6:2g:6a:5b"
  ]
}
Localtab
titleStore app
Code Block
{  
   "operation":{  
      "appIdentifier":"com.facebook.katana",
      "type":"public",
      "name":"facebook"
   },
   "deviceIDs":[  
      "d8:50:e6:2f:6a:8b",
      "a5:60:e6:2g:6a:5b"
   ]
}
Localtab
titleWeb app
Code Block
{  
   "operation":{  
	  "type":"webapp", 
      "url":"google.lk",     
      "name":"Google"
   },
   "deviceIDs":[  
      "d8:50:e6:2f:6a:8b",
      "a5:60:e6:2g:6a:5b"
   ]
} 

Property Value

Description

Data
Type
operation
This specifies the operation that is to be applied on the Android device.-

appIdentifier

The package name of the application to be uninstalled. For more information on how to identify the package name of the application, see Retrieving the App Identifier of an Application.

Note

This property is not applicable for web apps (web clips) as a web app is a browser bookmark for an application.

String
type

The type of the application. The following types of applications are supported: enterprise, public and webapp.

String
url

The URL of the application.

Note

This property is not applicable for public apps, because public apps are specifically searched via the respective application API in the Android market (e.g., Google API) using its app identifier.

String
name

The name of the application.

Note

This field is mandatory when adding web apps (web clips), and optional when adding enterprise apps and public apps (store apps).

String
schedule

The date and time for a scheduled installation. This should be in the format of "MM-DD-YYYY hh:mm am/pm".

Note
 This field is not mandatory.
String

deviceIDS

ID of the Android device. Multiple device IDs can be added by using comma separated values. 
For more information on retrieving the device ID, see Retrieving the ID of an Android device.

String