Remove AI Agent (Human Takeover)

Remove the AI agent from an active call to allow human takeover. The agent is muted rather than disconnected.

POST /v2/api/active-calls/{roomName}/remove-agent

Remove AI Agent (Human Takeover)

cURL

curl --request POST \
  --url https://api.trillet.ai/v2/api/active-calls/{roomName}/remove-agent \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-workspace-id: <x-workspace-id>' \
  --data '
{
  "participantIdentity": "<string>"
}
'

{
  "success": true,
  "message": "Agent removed from call",
  "roomName": "call-abc123",
  "mutedTracks": ["TR_abc123"]
}

Headers

x-api-key · string · required

API key used for authenticating requests to the API.

x-workspace-id · string · required

Workspace identifier for the API.

Path Parameters

roomName · string · required

The LiveKit room name of the active call.

Request Body

participantIdentity · string · required

Identity of the AI agent participant to remove/mute.

Response Fields

success · boolean

Whether the agent was removed successfully.

message · string

Confirmation message.

roomName · string

The room name of the call.

mutedTracks · array

Array of track SIDs that were muted.

{
  "success": true,
  "message": "Agent removed from call",
  "roomName": "call-abc123",
  "mutedTracks": ["TR_abc123"]
}