---
title: "Delete device"
method: DELETE
path: "/{sub_domain}/api/devices/mass-delete"
tags: ["Devices"]
---

# Delete device

`DELETE /{sub_domain}/api/devices/mass-delete`

## Request

- Base URL: `https://api.commpeak.com/pbx`
- URL: `https://api.commpeak.com/pbx/{sub_domain}/api/devices/mass-delete`
- Auth: API key in header `Authorization`

Delete one or more devices by extension.

**When to use.** Remove devices you no longer need. Deleting a device also unassigns it from any users it was linked to.

**Request body.** `extension` (required): a comma-separated list of extensions to delete, for example `113,114,115`.

**Returns.** A map of each requested extension to its result, either `success` or `not exist`.

**Example.** `{ "extension": "113,114,115" }`

## Path parameters

- `sub_domain` string, required: PBX Name (subdomain)

## Request body

- DeleteDevicesInput
  - `extension` string, required: Comma-separated list of extensions to delete (extension1,extension2,extension3...).

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/commpeak/apis/commpeak-pbx-api.md) - [All operations](https://skmtc.dev/commpeak/apis/commpeak-pbx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/commpeak/apis/commpeak-pbx-api/revisions/0b1e8c7fd3f6?raw)