Method: customers.devices.unclaim
Stay organized with collections
Save and categorize content based on your preferences.
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."],[[["\u003cp\u003eThis endpoint unclaims a device from a customer, removing it from zero-touch enrollment, requiring the customer to re-register through their reseller if needed.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request method is a \u003ccode\u003ePOST\u003c/code\u003e request to a specific URL using gRPC Transcoding syntax, with the customer ID being a required path parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe request body is required and must contain an object specifying the \u003ccode\u003edevice\u003c/code\u003e to unclaim, referenced by the DeviceReference resource.\u003c/p\u003e\n"],["\u003cp\u003eThe response body will be empty if the request is successful.\u003c/p\u003e\n"],["\u003cp\u003eThis API call requires OAuth scope \u003ccode\u003ehttps://www.googleapis.com/auth/androidworkzerotouchemm\u003c/code\u003e for authorization.\u003c/p\u003e\n"]]],["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"],null,["# Method: customers.devices.unclaim\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization Scopes](#body.aspect)\n\nUnclaims a device from a customer and removes it from zero-touch enrollment.\n\nAfter removing a device, a customer must contact their reseller to register the device into zero-touch enrollment again.\n\n### HTTP request\n\n`POST https://androiddeviceprovisioning.googleapis.com/v1/{parent=customers/*}/devices:unclaim`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|--------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The customer managing the device. An API resource name in the format `customers/[CUSTOMER_ID]`. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation ||\n|-------------------------------------------------------------------------------------------|---|\n| ``` { \"device\": { object (/zero-touch/reference/customer/rest/v1/DeviceReference) } } ``` |\n\n| Fields ||\n|----------|-------------------------------------------------------------------------------------------------------------------------|\n| `device` | `object (`[DeviceReference](/zero-touch/reference/customer/rest/v1/DeviceReference)`)` Required. The device to unclaim. |\n\n### Response body\n\nIf successful, the response body is empty.\n\n### Authorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidworkzerotouchemm`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]