---
title: "Delete a device. Currently supported by iOS, Linux and Windows devices."
method: DELETE
path: "/device/v0/devices/{id}/"
tags: ["device_Device"]
---

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

`DELETE /device/v0/devices/{id}/`

## Path parameters

- `id` string, required

## Response `200`

Details of the device

- object
  - `code` integer
  - `message` string
  - `content` union
    - DeviceAppleDevice
      - `id` string, uuid
      - `name` string — Esper generated name for the device
      - `alias` string — Alias/alternate name for the device
      - `os` 'iOS' | 'iPadOS' | 'tvOS' — Operating system for the device
      - `state` 0 | 1 | 20 | 70 | 80 | 90 | 100 | 200 — The following are the device states and their descriptions: ``` * 0 = Device State is Unspecified * 1 = Online/Active * 20 = Disabled (device has been factory reset or removed from the Esper Dashboard) * 70 = Device is undergoing a Factory Reset (reset started from Dashboard) * 80 = Device Onboarding in Progress * 90 = Device Onboarding Failed * 100 = Device Onboarded in Esper * 200 = Device is Registered ```
      - `platform` 'APPLE' — Platform for the device
      - `serial` string — Serial number the device
      - `os_version` string — OS version the device
      - `global_device_id` string — Esper generated unique id for the device
      - `tenant_id` string, uuid
      - `group_id` string, uuid
      - `hardware_info` DeviceHardwareInfo
        - `brand` string — The brand of the device
        - `model` string — The model of the device
        - `model_number` string — The model number of the device
        - `serial` string — The serial number of the device
        - `manufacturer` string — The manufacturer number of the device
        - `hardware` string — The hardware information of the device
        - `device_baseband_version` string — The device baseband version of the device
      - `software_info` DeviceSoftwareInfo
        - `os_version` string — The OS version number of the device
        - `os_build_number` string — The OS build number of the device
        - `bootloader_version` string — The bootloader version of the device
        - `security_path_level` string — The security path level of the device
        - `device_kernel_version` string — The kernel version of the device
        - `eea_version` string — EEA (Esper Enterprise Android) version
        - `esper_agent_info` object
          - `version_code` string — Esper agent version code
          - `version_name` string — Esper agent version name
        - `foundation_info` DeviceFoundationInfo
          - `major_version` string — The foundation OS build major version of the device
          - `minor_version` string — The foundation OS build minor version of the device
          - `build_number` string — The foundation OS build number of the device
          - `project_name` string — The foundation project name of the device
          - `build_flavor` string — The foundation OS build flavor of the device
          - `variant` string — The foundation variant of the device
          - `foundation_device_model_id` string — The foundation device model id of the device
        - `airwave_info` DeviceAirwaveInfo
          - `build_number` integer — The airwave OS build number of the device
          - `tenant_model_id` string — The airwave tenant model id of the device
          - `build_id` string — The airwave build id of the device
          - `esper_ota_manager_version_code` integer — The Esper OTA Manager version code
          - `esper_ota_manager_version_name` string — The Esper OTA Manager version name
      - `network_info` DeviceNetworkInfo
        - `imei1` string — The IMEI number of the device
        - `imei2` string — The IMEI number of the device
        - `wifi_mac_address` string — The wifi mac address of the device
        - `ethernet_mac_address` string — The ethernet mac address of the device
        - `iccid1` string — The ICCID number of the device
        - `iccid2` string — The ICCID number of the device
        - `phone_number_1` string — The phone number of the device
        - `phone_number_2` string — The phone number of the device
        - `network_type` 'CELLULAR' | 'ETHERNET' | 'WI-FI' | 'OTHER' — The network type of the device
      - `memory_info` DeviceMemoryInfo
        - `total_ram` string — Total ram capacity for the device
        - `total_internal_storage` string — The total internal storage capacity of the device
        - `units` string — The units used for the storage capacity
        - `internal_storage_binary_prefix` string — (Specific to Android devices)
      - `blueprint_info` DeviceBlueprintInfo
        - `assigned_blueprint_id` string — Assigned blueprint id of the device
        - `current_blueprint_id` string — Current blueprint id of the blueprint assigned to the device
        - `current_blueprint_version_id` string — Current Version id of the blueprint assigned to the device
        - `blueprint_upgrade_status` 'UPGRADABLE' | 'UPGRADE_INITIATED' | 'UPGRADE_FAILED' | 'UPGRADED' | 'NOT_UPGRADABLE' | 'NOT_APPLICABLE' — The status of the blueprint upgrade on the device
      - `udid` string — UDID as provided by apple
      - `dep_profile` string — DEP profile applied to device
      - `dep_profile_push_time` string, date-time
      - `dep_profile_assign_time` string, date-time
      - `dep_profile_status` 'empty' | 'assigned' | 'pushed' | 'removed' — DEP profile applied to device
      - `enrolment_info` object
        - `enrolment_id` string — The per-enrollment identifier for the device
        - `enrolment_user_id` string — The per-enrollment identifier for the user
      - `last_seen` string, date-time
      - `tokens` object
        - `push_magic` string
        - `push_token` string
        - `device_token` string
      - `device_source` 'ABM' | 'NON_ABM' — Source of device onboarding
      - `is_supervised` boolean
      - `is_ddm_enabled` boolean — Whether Declarative Device Management is enabled for this device
      - `managed_by` 'BLUEPRINT' — Whether the device is managed by blueprint or template
      - `onboarded_on` string, date-time
      - `provisioned_on` string, date-time
      - `is_seamless` boolean
      - `app_mode_meta` union
        - unknown
        - unknown
        - unknown
      - `created_by` string
      - `updated_by` string
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - DeviceLinuxDevice
      - `id` string, uuid
      - `name` string — Esper generated name for the device
      - `os` 'Ubuntu' — Operating system for the device
      - `state` 0 | 1 | 20 | 70 | 80 | 90 | 100 | 200 — The following are the device states and their descriptions: ``` * 0 = Device State is Unspecified * 1 = Online/Active * 20 = Disabled (device has been factory reset or removed from the Esper Dashboard) * 70 = Device Wipe in Progress * 80 = Device Onboarding in Progress * 90 = Device Onboarding Failed * 100 = Device Onboarded in Esper * 200 = Device is Registered ```
      - `platform` 'LINUX' — Operating system for the device
      - `serial` string — Serial number the device
      - `os_version` string — OS version the device
      - `global_device_id` string — Esper generated unique id for the device
      - `tenant_id` string, uuid
      - `group_id` string, uuid
      - `onboarded_on` string, date-time
      - `provisioned_on` string, date-time
      - `blueprint_info` DeviceLinuxBlueprintInfo
        - `assigned_blueprint_id` string — Assigned blueprint id of the device
        - `current_blueprint_id` string — Current blueprint id of the blueprint assigned to the device
        - `current_blueprint_version_id` string — Current Version id of the blueprint assigned to the device
        - `blueprint_upgrade_status` 'NOT_APPLICABLE' — The status of the blueprint upgrade on the device
      - `managed_by` 'BLUEPRINT' — Whether the device is managed by blueprint or template
      - `is_seamless` boolean
      - `created_by` string
      - `updated_by` string
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - DeviceWindowsDevice
      - `id` string, uuid
      - `name` string — Esper generated name for the device
      - `os` 'Windows' — Operating system of the device
      - `state` 0 | 1 | 20 | 70 | 80 | 90 | 100 | 200 — The following are the device states and their descriptions: ``` * 0 = Device State is Unspecified * 1 = Online/Active * 20 = Disabled (device has been factory reset or removed from the Esper Dashboard) * 70 = Device Wipe in Progress * 80 = Device Onboarding in Progress * 90 = Device Onboarding Failed * 100 = Device Onboarded in Esper * 200 = Device is Registered ```
      - `platform` 'WINDOWS' — Operating system of the device
      - `serial` string — Serial number of the device
      - `os_version` string — OS version of the device
      - `global_device_id` string — Windows generated unique id for the device
      - `tenant_id` string, uuid
      - `group_id` string, uuid
      - `onboarded_on` string, date-time
      - `provisioned_on` string, date-time
      - `blueprint_info` DeviceBlueprintInfo
        - `assigned_blueprint_id` string — Assigned blueprint id of the device
        - `current_blueprint_id` string — Current blueprint id of the blueprint assigned to the device
        - `current_blueprint_version_id` string — Current Version id of the blueprint assigned to the device
        - `blueprint_upgrade_status` 'UPGRADABLE' | 'UPGRADE_INITIATED' | 'UPGRADE_FAILED' | 'UPGRADED' | 'NOT_UPGRADABLE' | 'NOT_APPLICABLE' — The status of the blueprint upgrade on the device
      - `hardware_info` DeviceWindowsHardwareInfo
        - `brand` string — Device brand
        - `model` string — Device model
        - `serial` string — Device serial number
        - `manufacturer` string — Device manufacturer
        - `hardware` string — Hardware information
      - `software_info` DeviceWindowsSoftwareInfo
        - `supported_abi` string — Supported ABI
        - `os_build_time` string — OS build time
        - `os_build_number` string — OS build number
        - `os_version` string — OS version
        - `os` string — OS name
        - `os_platform` string — OS platform
        - `os_distribution` string — OS distribution
        - `bootloader_version` string — Bootloader version
        - `kernel_architecture` string — Kernel architecture
        - `device_kernel_version` string — Device kernel version
        - `last_boot_time` string — Last boot time
        - `display_resolution` string — Display resolution
        - `display_refresh_rate` string — Display refresh rate
        - `host_name` string — Device host name
        - `esper_agent_info` object
          - `version_code` string — Esper agent version code
          - `version_name` string — Esper agent version name
      - `network_info` DeviceWindowsNetworkInfo
        - `wifi_mac_address` string — Wi-Fi MAC address
        - `ethernet_mac_address` string — Ethernet MAC address
      - `memory_info` DeviceWindowsMemoryInfo
        - `total_ram` string — Total RAM in bytes
        - `total_internal_storage` string — Total internal storage in bytes
        - `total_swap_memory` string — Total swap memory in bytes
        - `units` string — Units used for the storage capacity
      - `managed_by` 'BLUEPRINT' — Whether the device is managed by blueprint or template
      - `is_seamless` boolean
      - `windows_config` object
        - `channel_uri` string — Channel URI for the device
        - `channel_updated_at` string, date-time — Last updated time of the channel URI
      - `app_mode_meta` union
        - unknown
        - unknown
        - unknown
      - `created_by` string
      - `updated_by` string
      - `created_at` string, date-time
      - `updated_at` string, date-time

## Other responses

- `400` — Bad Request
- `401` — Authorization information is missing or invalid.
- `404` — Device not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/esper/apis/esper-api-reference.md) · [All operations](https://skmtc.net/esper/apis/esper-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/esper/esper-api-reference/revisions/e1f64cbb488e/schema)