Stay organized with collectionsSave and categorize content based on your preferences.
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 callgetOperationto check the status of the operation periodically.
Extra fields, vendor specified key-value pair. Note: Requests from theResellerServiceclass created bySamsungResellerServiceFactorymust specify acustomerIdinvendorParams.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eThis API provides an asynchronous method to unclaim up to 100,000 devices from one or more customers.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eunclaimDevicesAsync\u003c/code\u003e method is used to initiate the unclaiming process, and it allows your application to remain responsive during long operations.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eResellerService\u003c/code\u003e only allows unclaiming for one customer per request and will fail with \u003ccode\u003eINTERNAL_SERVER_ERROR\u003c/code\u003e if multiple customer IDs are in a single request.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eUnclaimDevicesRequest\u003c/code\u003e requires a list of \u003ccode\u003eDeviceUnclaim\u003c/code\u003e objects and may include vendor-specific parameters, while requests from the \u003ccode\u003eSamsungResellerServiceFactory\u003c/code\u003e must specify a \u003ccode\u003ecustomerId\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egetOperation\u003c/code\u003e method can be used to check the status of the \u003ccode\u003eUnclaimDevices\u003c/code\u003e operation, which can return a list of error codes if an issue happens.\u003c/p\u003e\n"]]],["The `unclaimDevicesAsync` method facilitates asynchronous unclaiming of up to 100,000 devices. It requires a list of `DeviceUnclaim` objects and optionally accepts `vendorParams`, which must contain a `customerId` for requests from `SamsungResellerServiceFactory`. The API returns an `UnclaimDevicesResponse` with a list of `Operation` instances to track the status, and users need to periodically use `getOperation` to check progress. The method can return the errors: `DEVICE_UPLOAD_COUNT_EXCEEDED`, `INTERNAL_SERVER_ERROR`, `INVALID_DEVICE_IMEI`, `INVALID_DEVICE_MEID`, `INVALID_DEVICE_SERIAL` and `INVALID_IDENTIFIER_SET`.\n"],null,["# unclaimDevicesAsync\n\nAsynchronous request to unclaim up to 100,000 devices for one or more customers.\n| **Note:** The `ResellerService` class created by `SamsungResellerServiceFactory` only supports claiming devices for one customer per request. If devices for multiple customers are put into a single request, the operation will fail and return `INTERNAL_SERVER_ERROR`.\n\nAsynchronous API methods return a result before the processing is complete. They\nalso help your app (or tool) remain responsive for your users while they wait\nfor a long-running operation to complete. Your app should call\n[`getOperation`](/zero-touch/reseller-library/reference/methods/getoperation)\nto check the status of the operation periodically.\n\nMethod signature\n----------------\n\n public UnclaimDevicesResponse unclaimDevicesAsync(UnclaimDevicesRequest request);\n\nUnclaimDevicesRequest\n---------------------\n\n| Property name | Value | Required | Description |\n|----------------|---------------------------------|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `unclaims` | List of `object(DeviceUnclaim)` | Yes | The device unclaims to be processed. |\n| `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`. |\n\nUnclaimDevicesResponse\n----------------------\n\n| Property name | Value | Description |\n|---------------|---------------------------------------------------------------------------------------------|-----------------------------------------------------|\n| `operations` | List of `object(`[`Operation`](/zero-touch/reseller-library/reference/objects#operation)`)` | One or more `UnclaimDevices` `Operation` instances. |\n\nError behavior\n--------------\n\nIf an error occurs, the [`Operation`](/zero-touch/reseller-library/reference/objects#operation)\nobject returns one of the following error codes:\n\n| Error code |\n|--------------------------------|\n| `DEVICE_UPLOAD_COUNT_EXCEEDED` |\n| `INTERNAL_SERVER_ERROR` |\n| `INVALID_DEVICE_IMEI` |\n| `INVALID_DEVICE_MEID` |\n| `INVALID_DEVICE_SERIAL` |\n| `INVALID_IDENTIFIER_SET` |"]]
