device_Device
Delete a device. Currently supported by iOS, Linux and Windows devices.
Permanently deletes a single device record from Esper.
Takes the device's UUID in the path and removes it from the tenant; supported only for iOS, iPadOs, tvOS, Windows, or Linux devices, not Android.
About Device Deletion
This endpoint removes a device from Esper's device inventory, so treat it as a destructive, hard-to-reverse action. See help documentation on the recommended steps for each device, as removal steps can differ by OS and provisioning method.
Key Fields / Query Parameters
- id — UUID of the device to delete, passed in the path
Common Use Cases
- Removing decommissioned or retired iOS, Windows, or Linux devices from the fleet
- Cleaning up stale device records after a factory reset or hardware swap
Best Practices
- See help documentation on the recommended steps for each OS and provisioning method
- Confirm the device's platform before calling this endpoint, since it does not apply to Android devices
- Verify the device ID via a GET call first if you're not certain it's the correct record
delete/device/v0/devices/{id}/
Path parameters
idstring required
ID of the device
Response
Details of the device