Get Conversation Token

Generate a LiveKit token to start a conversation with an agent. Works with or without authentication: with auth → dashboard/SDK flow (verifies agent ownership); without auth → widget/embed flow (public, credits billed to agent owner).

GET /v1/voiceai/conversations/token

Get Conversation Token

cURL

curl --request GET \
  --url https://api.threetone.in/v1/voiceai/conversations/token \
  --header 'x-api-key: <api-key>'

200

{
  "token": "<string>",
  "livekit_url": "<string>"
}

Authorizations

APIKeyHeaderHTTPBearer

x-api-key · string · header · required

API key for programmatic access

Query Parameters

agent_id · string · required

The id of the agent to start a conversation with

participant_name · string | null

Optional participant name (authenticated requests only)

Response

200

application/json

Successful Response

Response model for conversation token endpoint.

Works for both authenticated (dashboard) and public (widget) requests.

token · string · required

LiveKit JWT token to connect to the conversation

livekit_url · string · required

LiveKit WebSocket URL to connect to (wss://...)