Start a web call session

POST

https://api.smallest.ai/atoms/v1/conversation/webcall

POST

/atoms/v1/conversation/webcall

1 import requests
2 
3 url = "https://api.smallest.ai/atoms/v1/conversation/webcall"
4 
5 payload = { "agentId": "6a75935452c6e5eceaa16edf" }
6 headers = {
7     "Authorization": "Bearer <token>",
8     "Content-Type": "application/json"
9 }
10 
11 response = requests.post(url, json=payload, headers=headers)
12 
13 print(response.json())

1 {
2   "status": true,
3   "data": {
4     "token": "eyJhbGciOiJIUzI1NiJ9.eyJtZXRhZGF0YSI6IntcIm9yZ2FuaXphdGlvbklkXCI6XCI2OTU2MTg5NmEzN2ZkMjE0YjlhOGQzM2NcIn0iLCJ2aWRlbyI6eyJyb29tSm9pbiI6dHJ1ZSwicm9vbSI6IjIwOWNkOGM3LTdmZjQtNGFmYy1iNWQ1LWY3MDQ0OGI1Y2UwNyJ9LCJleHAiOjE3ODYxNTk1ODl9.jf5NM4fH79_d6iBb2xTvX5JIo_PmVpjeXWOugoDLQVc",
5     "roomName": "209cd8c7-7ff4-4afc-b5d5-f70448b5ce07",
6     "host": "wss://atoms-prod-evcaw70g.livekit.cloud",
7     "conversationId": "w3fmaal3fKnzNQJ_CHfosw",
8     "callId": "CALL-1786159527700-838803"
9   }
10 }

Mints a short-lived LiveKit access token and creates a room the browser client can join to have a voice-first call with the agent. Same response shape as /conversation/chat; the difference is the audio track defaults on the client side. Pair with the Web SDK to open the room in-browser.

Authentication

AuthorizationBearer

API key from the console ApiKey collection, sent as Bearer token. Also accepts session cookies for browser-based auth.

Request

This endpoint expects an object.

agentIdstringRequired

The agent to attach the browser client to.

Response

Session minted. Use token + host on the browser client to join roomName.

statusbooleanOptional

dataobjectOptional

Errors

400

Bad Request Error