Call Action

Perform a real-time control action on an active call. Use this to mute or unmute the agent, put the call on hold, resume it, or hang up.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

call_idstringRequiredformat: "uuid"

The call UUID returned by POST /calls/initiate.

Request

This endpoint expects an object.
actionenumRequired

The action to perform. mute — mutes the agent’s audio track. unmute — unmutes the agent’s audio track. hold — puts the call on hold. unhold — resumes a held call. hangup — disconnects all call participants.

Allowed values:
room_namestringRequired

The LiveKit room name returned in the POST /calls/initiate response.

Response

Action performed successfully.
msgstringOptional
Confirmation message for the action performed.

Errors

400
Bad Request Error
401
Unauthorized Error