Set agent to single call mode

PATCH

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

Last modified:2026-10-30 21:07:12

OperationId:AgentSingleCall

Puts an agent in single call mode on one call queue, or on every queue with all: the agent takes one call, then goes offline until made available again. The agent log records Manual-avail, shown as Single Call. The request has no body. Any scope in the domain but the read-only ones can call it. Call Center Agent and user scopes act only on their own entries (use ~ as the agent), and a Site Manager on users at its own site.

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 change is accepted and applied shortly after. The action is also written to the agent log, which GET /domains/{domain}/agents/{callqueue-agent-id}/status reads back. This call takes about half a second longer than the other actions, because the platform makes the agent available again after the mode change.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🟠405Method Not Allowed

🔴503Service Unavailable

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

202 - Accepted

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

Modified at 2026-10-30 21:07:12

Log agent out

Set agent offline reason