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

codeinteger
messagestring

Changes