POST
/
v1
/
api
/
calls
/
web
/
connect
Connect a Web Call
curl --request POST \
  --url https://api.trillet.ai/v1/api/calls/web/connect \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-workspace-id: <x-workspace-id>' \
  --data '{
  "agentId": "<string>",
  "mode": "<string>"
}'
{
  "status": "success",
  "callId": "call1234",
  "roomName": "web-genericAgent-call1234",
  "token": "<REDACTED_JWT_TOKEN>",
  "agent": {
    "id": "agent12345678",
    "name": "Generic Agent",
    "model": "llm-mini",
    "voice": {
      "provider": "genericVoiceProvider",
      "voiceId": "standard",
      "language": "en"
    }
  }
}
Initiate a web call that runs entirely via WebRTC in the browser (no phone number required). The agent can interact via voice.

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.

Request Body

agentId
string
required
The ID of the agent that will handle this web call.
mode
string
The mode of the call. Defaults to “voice”.
{
  "status": "success",
  "callId": "call1234",
  "roomName": "web-genericAgent-call1234",
  "token": "<REDACTED_JWT_TOKEN>",
  "agent": {
    "id": "agent12345678",
    "name": "Generic Agent",
    "model": "llm-mini",
    "voice": {
      "provider": "genericVoiceProvider",
      "voiceId": "standard",
      "language": "en"
    }
  }
}