Skip to main content
POST
https://api.trillet.ai
/
v2
/
api
/
active-calls
/
{roomName}
/
remove-agent
Remove AI Agent (Human Takeover)
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"]
}