---
title: "Delete a device by serial number"
method: DELETE
path: "/network-monitoring/v1/devices/{serial-number}"
tags: ["Devices"]
---

# Delete a device by serial number

`DELETE /network-monitoring/v1/devices/{serial-number}`

## Request

- Base URL: `https://sso.common.cloud.hpe.com`
- URL: `https://sso.common.cloud.hpe.com/network-monitoring/v1/devices/{serial-number}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://sso.common.cloud.hpe.com/as/token.oauth2`
- TypeScript: <https://skmtc.dev/arubanetworks/apis/authorization/docs/network-monitoring/v1/devices/:serial-number/delete.ts> (a function with typed inputs; its response is checked against the schema)

This API endpoint deletes a network device based on the provided serial number.

## Path parameters

- `serial-number` string, const, required: The device serial number.

## Response `202`

Details of a deleted device, including Access Point or Switch or Gateway.

- DeviceResponseV1
  - `serialNumber` string, const, required: The device serial number.
  - `macAddress` string, mac, required: MAC address for the client.
  - `deviceName` string, const, required: The name of the device.
  - `deviceType` 'ACCESS_POINT' | 'SWITCH' | 'GATEWAY', required: A string indicating the networking device type.
  - `model` string, const: Hardware model of the device.
  - `partNumber` string, const: The part number of the device.
  - `deployment` string, const: The operating mode of the device.
  - `role` string, const: Role of the device in the network-topology.
  - `deviceFunction` string, const: Device function (persona) of the device.
  - `firmwareVersion` string, const: Firmware version currently running on the device.
  - `ipv4` string, ipv4: IPv4 address of the device.
  - `ipv6` string, ipv6: IPv6 address of the device.
  - `status` 'ONLINE' | 'OFFLINE': Status of the device, which can be either ONLINE or OFFLINE.
  - `uptimeInMillis` number, double: Elapsed time in milliseconds since the device's last boot. This value will be null if the device is offline.
  - `lastSeenAt` string, date-time: An RFC 3339 date-time indicating the last detected time of the device in the system. If the device is online, this value will be null.
  - `siteId` string, const, required: ID of the Site in which the device is present.
  - `buildingId` unknown
  - `floorId` unknown
  - `configStatus` string, const: Config status of the device. Possible values are `Synchronized`, `Out of Sync`, `Update in Progress`, and `Synchronized with Limitations`.
  - `configLastModifiedAt` string, date-time: An RFC 3339 date-time indicating the last config modified time of the device.
  - `siteName` string, const: SiteName represents the name of the site where the device is located. This name is used to identify and manage devices based on their physical location, allowing for better organization and tracking.
  - `clusterName` string, const: The name of the cluster to which the device belongs. If the device is not part of any cluster then the cluster name will be null.
  - `notes` string, const: Notes for the device.
  - `id` string, const, required: Primary identifier for the resource.
  - `type` string, const, required: The type of the resource.

## Other responses

- `400`: Invalid input received.
- `401`: Unauthorized. Authentication credentials are required or invalid.
- `403`: Forbidden: Access is denied.
- `404`: Not Found error.
- `429`: Too Many Requests. The user has sent too many requests in a given amount of time.
- `500`: Internal Server Error. An unexpected error occurred on the server.

---

[API](https://skmtc.dev/arubanetworks/apis/authorization.md) - [All operations](https://skmtc.dev/arubanetworks/apis/authorization/llms.txt) - [OpenAPI document](https://skmtc.dev/arubanetworks/apis/authorization/revisions/74c95058b11f?raw)