---
title: "Delete Agent"
method: POST
path: "/api/deleteAgent"
tags: ["Manage Agents"]
---

# Delete Agent

`POST /api/deleteAgent`

## Request

- Base URL: `https://your-instance.stats.pbx.commpeak.com`
- URL: `https://your-instance.stats.pbx.commpeak.com/api/deleteAgent`
- Auth: API key in header `X-API-KEY`

### Delete Agent API

This API endpoint is used to delete an agent.

#### Request Body

- `userExtension` (text, required): The extension number to dial to reach this user.
    
- `format` (text): The format of the response.
    

#### Response

The response for this request is a JSON object with the following properties:

- `success` (string): Indicates the success status of the operation.
    
- `message` (string): Provides additional information or error message.
    

#### Example

``` json
{
    "success": "",
    "message": ""
}

 ```

## Request body `application/x-www-form-urlencoded`

- object
  - `format` string
  - `userExtension` string

## Response `200`

successful

- object
  - `message` string
  - `success` string

## Other responses

- `400`: Error: Bad Request
- `401`: Unauthorized

---

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