Skip Navigation
Web Service Endpoint

Erase a Device

Remotely and immediately erase a device.

URL

PUT https://yourmdmhost.example.com/mdm#EraseDeviceCommand

HTTP Body

The command to erase a device.

Content-Type: application/x-apple-aspen-mdm

Response Codes

OK

A response from the device after it processes the command to erase.

Content-Type: application/xml

Discussion

This command allows the server to immediately erase a device, even a locked device, without warning the user. The device sends a response to the server, but it doesn’t retry if it isn’t successful the first time.

Refer to the following sections to determine supported channels and requirements, and to see an example request and response.

Command Availability

Device Channel

iOS, macOS, Shared iPad, tvOS, watchOS

User Channel

-

Requires Supervision

-

Allowed in User Enrollment

-

Required Access Right

AllowDeviceErase

Example Request and Response

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Command</key>
    <dict>
        <key>DisallowProximitySetup</key>
        <false/>
        <key>PreserveDataPlan</key>
        <true/>
        <key>RequestType</key>
        <string>EraseDevice</string>
    </dict>
    <key>CommandUUID</key>
    <string>0001_EraseDevice</string>
</dict>
</plist>

Topics

See Also

Current page is Erase a Device