---
title: "Delete tenant device"
method: DELETE
path: "/v1/Devices/{deviceId}"
tags: ["Devices"]
---

# Delete tenant device

`DELETE /v1/Devices/{deviceId}`

## Path parameters

- `deviceId` string, uuid, required

## Query parameters

- `Account` unknown

## Response `200`

Success

- DeviceResponse
  - `id` string, uuid
  - `name` string, nullable
  - `ioid` string, nullable
  - `type` 0 | 1 | 2 | 3 | 4
  - `token` string, nullable
  - `osVersion` string, nullable
  - `appVersion` string, nullable
  - `received` string, date-time, nullable
  - `batteryPercentage` integer, nullable
  - `batteryStatus` string, nullable
  - `unsentSessions` integer, nullable
  - `unfinishedSessions` integer, nullable
  - `status` string, nullable
  - `lastSeenSecAgo` integer, nullable
  - `userInfo` DeviceHeartbeatUserInfo[], nullable
    - `id` integer
    - `domainEvents` IDomainEvent[], nullable
      - `id` string, uuid
      - `occurredOn` string, date-time
    - `heartbeatId` integer
    - `unfinishedScans` integer
    - `unfinishedSessions` integer
    - `unsentSessions` integer
    - `unsentScans` integer
    - `username` string, nullable
    - `deviceHeartbeat` DeviceHeartbeat
      - `id` integer
      - `domainEvents` IDomainEvent[], nullable
        - `id` string, uuid
        - `occurredOn` string, date-time
      - `deviceId` string, uuid
      - `osVersion` string, nullable
      - `appVersion` string, nullable
      - `batteryPercentage` integer
      - `batteryCurrentNow` integer
      - `batteryCurrentAverage` integer
      - `batteryVoltage` integer
      - `batteryStatus` string, nullable
      - `unsentSessions` integer
      - `unfinishedSessions` integer
      - `received` string, date-time
      - `device` Device
        - `id` string, uuid
        - `domainEvents` IDomainEvent[], nullable
          - `id` string, uuid
          - `occurredOn` string, date-time
        - `createdOn` string, date-time, nullable
        - `modifiedOn` string, date-time, nullable
        - `name` string, nullable
        - `token` string, nullable
        - `iccid` string, nullable
        - `dedicatedDeviceId` string, uuid, nullable
        - `sbNumber` string, nullable
        - `ioid` string, nullable
        - `externalId` string, nullable
        - `isDeleted` boolean
        - `type` 0 | 1 | 2 | 3 | 4
        - `deletedOn` string, date-time, nullable
        - `deviceTenants` TenantDevice[], nullable
          - `tenantId` string, uuid
          - `deviceId` string, uuid
          - `device` Device — recursive
        - `deviceEvents` DeviceEvent[], nullable
          - `deviceId` string, uuid
          - `name` string, nullable
          - `content` string, nullable
          - `received` string, date-time
          - `domainEvents` IDomainEvent[], nullable
            - `id` string, uuid
            - `occurredOn` string, date-time
        - `deviceHeartbeats` DeviceHeartbeat[], nullable
        - `deviceEventNotifications` DeviceEventNotification[], nullable
          - `id` integer
          - `deviceId` string, uuid
          - `eventName` string, nullable
          - `eventContent` string, nullable
          - `receivers` NotificationsReceiver[], nullable
            - `id` integer
            - `notificationId` integer
            - `value` string, nullable
            - `type` integer
            - `deviceEventNotification` DeviceEventNotification — recursive
        - `deviceRegistrationStates` DeviceRegistrationState[], nullable
          - `id` integer
          - `domainEvents` IDomainEvent[], nullable
            - `id` string, uuid
            - `occurredOn` string, date-time
          - `createdOn` string, date-time, nullable
          - `modifiedOn` string, date-time, nullable
          - `deviceId` string, uuid
          - `pairingCode` string, nullable
          - `state` 0 | 1 | 2 | 3 | 4
          - `tenantId` string, uuid, nullable
          - `deviceName` string, nullable
        - `deviceSIMStatuses` DeviceSIMStatus[], nullable
          - `id` integer
          - `domainEvents` IDomainEvent[], nullable
            - `id` string, uuid
            - `occurredOn` string, date-time
          - `iccid` string, nullable
          - `dataLimit` number, double
          - `dataUsage` number, double
          - `statusDate` string, date-time
        - `deviceShelfStatuses` DeviceShelfStatus[], nullable
          - `id` integer
          - `domainEvents` IDomainEvent[], nullable
            - `id` string, uuid
            - `occurredOn` string, date-time
          - `deviceId` string, uuid
          - `spineHWVer` string, nullable
          - `shelfHWVer` string, nullable
          - `pcbhwVer` string, nullable
          - `compartment` integer
          - `slot` integer
          - `binCount` integer
          - `statusDate` string, date-time
        - `cabinetProdData` CabinetProdData
          - `id` integer
          - `domainEvents` IDomainEvent[], nullable
            - `id` string, uuid
            - `occurredOn` string, date-time
          - `deviceId` string, uuid
          - `batchNumber` string, nullable
          - `verdinSN` string, nullable
          - `cabinetType` 0 | 1
          - `comment` string, nullable
          - `region` string, nullable
        - `currentRegistrationState` DeviceRegistrationState
          - `id` integer
          - `domainEvents` IDomainEvent[], nullable
            - `id` string, uuid
            - `occurredOn` string, date-time
          - `createdOn` string, date-time, nullable
          - `modifiedOn` string, date-time, nullable
          - `deviceId` string, uuid
          - `pairingCode` string, nullable
          - `state` 0 | 1 | 2 | 3 | 4
          - `tenantId` string, uuid, nullable
          - `deviceName` string, nullable
      - `ioid` string, nullable
      - `userInfo` DeviceHeartbeatUserInfo[], nullable
      - `linkedDevices` string[], nullable
  - `serialNumber` string, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/invendor/apis/io-commonapi.md) · [All operations](https://skmtc.net/invendor/apis/io-commonapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/invendor/io-commonapi/versions/0e4626e69155/schema)