Method: enterprises.devices.delete

Deletes a device. This operation attempts to wipe the device but this is not guaranteed to succeed if the device is offline for an extended period. Deleted devices do not show up in enterprises.devices.list calls and a 404 is returned from enterprises.devices.get.

HTTP request

DELETE https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

The name of the device in the form enterprises/{enterpriseId}/devices/{deviceId}.

Query parameters

Parameters
wipeDataFlags[]

enum (WipeDataFlag)

Optional flags that control the device wiping behavior.
wipeReasonMessage

string

Optional. A short message displayed to the user before wiping the work profile on personal devices. This has no effect on company owned devices. The maximum message length is 200 characters.

Request body

The request body must be empty.

Response body

If successful, the response body is an empty JSON object.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/androidmanagement

For more information, see the OAuth 2.0 Overview.

WipeDataFlag

Flags used to control data wiping behavior when a device is deleted. By default all user data and factory reset protection data is wiped.

Enums
WIPE_DATA_FLAG_UNSPECIFIED This value is ignored.
PRESERVE_RESET_PROTECTION_DATA Preserve the factory reset protection data on the device.
WIPE_EXTERNAL_STORAGE Additionally wipe the device's external storage (such as SD cards).