Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Overview

...

Excerpt
Description

Factory rest or erases all the data stored in the Android devices to restore them back to the original system.

Resource Path/wipe-data
URL/mdm-android-agent/operation/wipe-data
HTTP MethodPOST
Request/Response Formatapplication/json

...

Sample request

...

cURL
Localtab
activetrue
title
Localtabgroup
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/wipe-data
lists the devices that this operation is applied on
  • 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.
For example

Example:

Code Block
curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer 
Mkk2R0hVaFpGdUtnTlZhY3pZbWJjWmJ0Rlo0YTpQMEh1QmpscXc4dEJIZ2FNMUN5OEdGRmRzV29h
e56974e8bf5df15748f89c6c5da9835d" -d @'
testtitleHTTP
operation.json' -k -v https://localhost:9443/mdm-android-agent/operation/wipe-data
Localtab
 Sample output
Code Block
> POST /mdm-android-agent/operation/wipe-data 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 
Mkk2R0hVaFpGdUtnTlZhY3pZbWJjWmJ0Rlo0YTpQMEh1QmpscXc4dEJIZ2FNMUN5OEdGRmRzV29h
e56974e8bf5df15748f89c6c5da9835d
> Content-Length: 21
< HTTP/1.1 201 Created
< Date: Wed, 10 Jun 2015 09:20:44 GMT
< Content-Length: 0
< Server: WSO2 Carbon Server
Anchor
sampleFactoryReset
sampleFactoryReset
Sample JSON Definition 
Code Block
{  
   "operation":{  
      "pin":"4566"
   },
   "deviceIDs":[  
      "d8:50:e6:2f:6a:8b"
   ]
}

Property Value

Description

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

 

...

The passcode to enable the factory reset operation. This is the passcode that the Android agent prompts the device owner to set at the time of device enrollment.Integer

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