Method: customers.devices.unclaim
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:
| 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.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-08-07 UTC.
[null,null,["Last updated 2024-08-07 UTC."],[[["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."]]],["This document details how to unclaim a device from a customer using the Android zero-touch enrollment API. The key action is sending a `POST` request to `https://androiddeviceprovisioning.googleapis.com/v1/{parent=customers/*}/devices:unclaim`, where `parent` is the customer ID. The request body requires a `device` object specifying the device to unclaim. Successful unclaiming results in an empty response body. Authorization requires the `https://www.googleapis.com/auth/androidworkzerotouchemm` OAuth scope. Unclaiming removes the device from zero-touch enrollment, requiring the customer to re-register it with their reseller.\n"]]