AI-generated Key Takeaways
-
This API provides an asynchronous method to unclaim up to 100,000 devices from one or more customers.
-
The
unclaimDevicesAsyncmethod is used to initiate the unclaiming process, and it allows your application to remain responsive during long operations. -
The
ResellerServiceonly allows unclaiming for one customer per request and will fail withINTERNAL_SERVER_ERRORif multiple customer IDs are in a single request. -
The
UnclaimDevicesRequestrequires a list ofDeviceUnclaimobjects and may include vendor-specific parameters, while requests from theSamsungResellerServiceFactorymust specify acustomerId. -
The
getOperationmethod can be used to check the status of theUnclaimDevicesoperation, which can return a list of error codes if an issue happens.
Asynchronous request to unclaim up to 100,000 devices for one or more customers.
Asynchronous API methods return a result before the processing is complete. They
also help your app (or tool) remain responsive for your users while they wait
for a long-running operation to complete. Your app should call getOperation
to check the status of the operation periodically.
Method signature
public
UnclaimDevicesResponse
unclaimDevicesAsync
(
UnclaimDevicesRequest
request
);
UnclaimDevicesRequest
| Property name | Value | Required | Description |
|---|---|---|---|
unclaims
|
List of object(DeviceUnclaim)
|
Yes | The device unclaims to be processed. |
vendorParams
|
map
|
No | Extra fields, vendor specified key-value pair. Note: Requests from the ResellerService
class created by SamsungResellerServiceFactory
must specify a customerId
in vendorParams
. |
UnclaimDevicesResponse
| Property name | Value | Description |
|---|---|---|
operations
|
List of object(
Operation
)
|
One or more UnclaimDevices
Operation
instances. |
Error behavior
If an error occurs, the Operation
object returns one of the following error codes:
| Error code |
|---|
DEVICE_UPLOAD_COUNT_EXCEEDED
|
INTERNAL_SERVER_ERROR
|
INVALID_DEVICE_IMEI
|
INVALID_DEVICE_MEID
|
INVALID_DEVICE_SERIAL
|
INVALID_IDENTIFIER_SET
|

