Remove agent from call queue

DELETE

/domains/{domain}/callqueues/{callqueue}/agents/{callqueue-agent-id}

Last modified:2026-10-09 00:26:35

OperationId:DeleteAgent

Removes an agent from one call queue. The user or device is not changed, and stays on its other queues.

Call Center Supervisor, Office Manager, Route Manager, Reseller, and Super User can remove any agent in the domain. Site Manager can remove agents who are users at its own site, on queues at its own site. Call Center Agent, Basic User, Advanced User, and Simple User get 403. Office Manager Read-Only and Super User Read Only get 403.

202 means the removal was published over the service bus (SBUS), not yet applied. The agent is notified that they were removed. An agent that is not on this queue returns 404.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢202Accepted

application/json

The removal was published over the service bus (SBUS) and is applied shortly after: {"code": 202, "message": "Accepted"}.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🔴503Service Unavailable

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//callqueues//agents/' \
--header 'Authorization: Bearer <token>'

Response Example

202 - Accepted

{
    "code": 202,
    "message": "Accepted"
}

Modified at 2026-10-09 00:26:35

Update agent in call queue

Count agents in domain