Upgrading Firmware of Android Devices via the REST API

Description Upgrade the firmware of Android devices.

Resource Path /upgrade-firmware

URL /mdm-android-agent/operation/upgrade-firmware

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-android-agent/operation/upgrade-firmware

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 update the policy 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:

curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer 33392fb365b3ac693b405b565ddc8a3a" -d @'operation.json' -k -v https://localhost:9443/mdm-android-agent/operation/upgrade-firmware

Sample output

> POST /mdm-android-agent/operation/upgrade-firmware HTTP/1.1
> Host: localhost:9443
> User-Agent: curl/7.43.0
> Accept: */*
> Content-Type: application/json
> Authorization: Bearer 33392fb365b3ac693b405b565ddc8a3a
> Content-Length: 19
< HTTP/1.1 201 Created
< Date: Sun, 06 Mar 2016 19:04:15 GMT
< Content-Length: 0
< Server: WSO2 Carbon Server

Sample JSON Definition

{  
   "operation":{  
      "schedule":"2016-04-25T12:00:00+0530",
      "server":"http://ota.wso2.com"
   },
   "deviceIDs":[  
      867115026844132,
      347115025644446
   ]
}

Property Value	Description	Data Type
`operation`	This specifies the operation that is to be applied on the Android device.	-
`schedule`	Provide the date and time to schedule the firmware update in the following ISO 8601 format: `yyyy-MM-dd'T'HH:mm:ssZ`	String
`server`	Provide the OTA upgrade server URL in one of the following formats. Example: `http://abc.com` `http://abc.com/ota`	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