Method: customers.devices.unclaim

  • This endpoint unclaims a device from a customer, removing it from zero-touch enrollment, requiring the customer to re-register through their reseller if needed.

  • The HTTP request method is a POST request to a specific URL using gRPC Transcoding syntax, with the customer ID being a required path parameter.

  • The request body is required and must contain an object specifying the device to unclaim, referenced by the DeviceReference resource.

  • The response body will be empty if the request is successful.

  • This API call requires OAuth scope https://www.googleapis.com/auth/androidworkzerotouchemm for authorization.

Unclaims a device from a customer and removes it from zero-touch enrollment.

After removing a device, a customer must contact their reseller to register the device into zero-touch enrollment again.

HTTP request

POST https://androiddeviceprovisioning.googleapis.com/v1/{parent=customers/*}/devices:unclaim

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The customer managing the device. An API resource name in the format customers/[CUSTOMER_ID].

Request body

The request body contains data with the following structure:

JSON representation 
{
  "device": {
    object (DeviceReference)
  }
}
Fields
device

object (DeviceReference)

Required. The device to unclaim.

Response body

If successful, the response body is empty.

Authorization Scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.