Bulk removal of offline devices not available in console: use API or request backend removal via ticket merge into #20943

Android

Title: Bulk-remove offline devices — API or Esper Support request

When a fleet of devices goes offline permanently and needs to be deprovisioned, the Esper Console does not provide a bulk-removal option for offline devices. Each device must be removed either through the Esper API or by submitting a removal request to Esper Support.

Why this happens

The Esper Console's device-removal controls are designed for single-device actions and require an active device connection to issue a wipe command. Offline devices cannot receive commands, so bulk removal requires a programmatic or backend approach instead.

Before you begin

Collect the following before proceeding with either option:

• The device IDs you want to remove (export from Devices & Groups if needed)
• Your Enterprise ID, found in Esper Console → Company Settings
• Confirmation that all devices are offline — online devices should be wiped and unprovisioned through the Console before removal

Option 1: Remove devices using the Esper API

1. Navigate to Esper Console → API Key Management and copy your API key. This key authenticates every API request you make against your enterprise.
2. Call the delete endpoint once for each device ID you want to remove:

   DELETE https://YOUR_ENDPOINT.esper.cloud/api/v0/enterprise/{enterprise_id}/device/{device_id}/

   Replace {enterprise_id} and {device_id} with your actual values.
3. For large lists, loop through your device IDs using the Esper Python SDK rather than calling the endpoint manually for each device. Install the SDK and use the delete_device method inside a loop over your device list.
4. Confirm each call returns an HTTP 200 OK response. Any other response code indicates the deletion did not succeed for that device — note those device IDs for follow-up.

Verify: After all API calls complete, open Devices & Groups in the Esper Console. None of the removed device IDs should appear in the list. Allow up to 5 minutes for the Console to reflect the changes.

Option 2: Request removal through Esper Support

1. Export your device list from Devices & Groups as a CSV, or prepare a file that contains one device ID per row. A complete, accurate list prevents partial removals.
2. Submit a support ticket at support.esper.io and include:
   • Your Enterprise ID
   • The CSV file or full list of device IDs
   • Confirmation that all listed devices are offline
   • Your preferred completion timeline
3. Await confirmation from Esper Support that the removal is complete. Large batches — thousands of devices — may take several business days.

Verify: Once Esper Support confirms completion, open Devices & Groups and confirm none of the submitted device IDs remain in the Console.

If this doesn't resolve it

If an API deletion fails, check whether the device is in a Wipe Initiated or Disabled state — these states can block removal. Collect the full API error response body and the affected device IDs, then submit a support ticket at support.esper.io. Include your Enterprise ID, the error response, and the list of device IDs that failed.

Still need help?

If you need to remove multiple offline devices and prefer not to use the API, submit a support ticket with a list of device IDs or serial numbers you'd like removed, and our team can process the bulk removal for you.