Run call action

POST

/domains/{domain}/users/{user}/calls/{callid}/{action}

Last modified:2026-10-03 17:36:27

OperationId:PerformCallActionForUser

Runs a call control action, named in the path, on one of the user's calls in progress. PATCH on the same path does the same.

Requires Basic User scope for your own user, Office Manager scope for a user in your own domain, Site Manager scope for a user in your own site, or Reseller or Super User scope.

The actions:

answer: answer a ringing call on the device in call-term-user

hold and unhold: hold or resume the other party

transfer (or xfer): blind transfer to call-term-user, or attended with hostname and call-destination-session-id

transferPeer: transfer the other party to call-term-user, or park it with valid

recording: set call recording to state

reject and disconnect: turn away a ringing call, or end the call

Each action also has its own page with its fields. Any other action returns 400. GET on this path returns 405, and DELETE is accepted only for reject and disconnect.

The user in the path must be a party on the call, on any leg; otherwise the request returns 404. A call that has not reached the platform yet also returns 404, so retry briefly after starting one.

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 command was accepted and is applied shortly after.

Bodyapplication/json

🟢200OK

🟠400Bad Request

🟠401Authentication Required

🟠403Forbidden

🟠404Record not found

Request Example

Shell

JavaScript

Java

Swift

cURL

HoldTransferStart recordingPark the peer

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains/example.com/users/1001/calls/k3m9xq2wz7pd4rtv/hold' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'

Response Example

202 - Hold

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

Modified at 2026-10-03 17:36:27

List active call history

Count shared contacts