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

{
  "content": {
    "timezone_string": "America/Los_Angeles"
  }
}