Update agent in call queue

PUT

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

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

OperationId:UpdateAgent

Changes an agent's settings on one call queue: availability, wrap-up time, dispatch order and priority, call and SMS limits, auto answer, and answer confirmation. Send only the fields you change.

Call Center Supervisor, Office Manager, Route Manager, Reseller, and Super User can change any agent in the domain. Site Manager can change 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: they change only their own status, with the actions in Agent Actions. Office Manager Read-Only and Super User Read Only get 403.

202 means the change was published over the service bus (SBUS), not yet applied. To log an agent in or out, use the actions in Agent Actions, which also record the change in the agent log. An agent that is not on this queue returns 404, as does an agent id from another domain.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Body Params application/json

Examples

Responses

🟢202Accepted

application/json

The change 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

Longer wrap-upMove to front of queue

curl --location --request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//callqueues//agents/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "callqueue-agent-wrap-up-allowance-seconds": 30,
    "callqueue-agent-answer-confirmation-enabled": "no"
}'

Response Example

202 - Accepted

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

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

Add agent to call queue

Remove agent from call queue