Skip to content

Delete a device. Currently supported by iOS, Linux and Windows devices.
Stable

Request

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
Security
device_apiKey
Path
idstringrequired

ID of the device

cURL
curl -i -X DELETE \
  'https://api.esper.io/_mock/openapi/device/v0/devices/{id}/' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Details of the device

Bodyapplication/json
codeinteger
messagestring
contentdevice_AppleDevice (object) or device_LinuxDevice (object) or device_WindowsDevice (object)
One of:
Response
{
  "code": 0,
  "message": "string",
  "content": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string",
    "alias": "string",
    "os": "iOS",
    "state": 0,
    "platform": "APPLE",
    "serial": "string",
    "os_version": "string",
    "global_device_id": "string",
    "tenant_id": "34f5c98e-f430-457b-a812-92637d0c6fd0",
    "group_id": "306db4e0-7449-4501-b76f-075576fe2d8f",
    "hardware_info": { … },
    "software_info": { … },
    "network_info": { … },
    "memory_info": { … },
    "blueprint_info": { … },
    "udid": "string",
    "dep_profile": "string",
    "dep_profile_push_time": "2019-08-24T14:15:22Z",
    "dep_profile_assign_time": "2019-08-24T14:15:22Z",
    "dep_profile_status": "empty",
    "enrolment_info": { … },
    "last_seen": "2019-08-24T14:15:22Z",
    "tokens": { … },
    "device_source": "ABM",
    "is_supervised": true,
    "is_ddm_enabled": true,
    "managed_by": "BLUEPRINT",
    "onboarded_on": "2019-08-24T14:15:22Z",
    "provisioned_on": "2019-08-24T14:15:22Z",
    "is_seamless": true,
    "app_mode_meta": { … },
    "created_by": "string",
    "updated_by": "string",
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
  }
}