POST
/
v1
/
api
/
calls
/
web
/
connect
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"
    }
  }
}