Start a web call session

POST

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

POST

/atoms/v1/conversation/webcall

import requests
url = "https://api.smallest.ai/atoms/v1/conversation/webcall"
payload = { "agentId": "6a75935452c6e5eceaa16edf" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "status": true,
  "data": {
    "token": "eyJhbGciOiJIUzI1NiJ9.eyJtZXRhZGF0YSI6IntcIm9yZ2FuaXphdGlvbklkXCI6XCI2OTU2MTg5NmEzN2ZkMjE0YjlhOGQzM2NcIn0iLCJ2aWRlbyI6eyJyb29tSm9pbiI6dHJ1ZSwicm9vbSI6IjIwOWNkOGM3LTdmZjQtNGFmYy1iNWQ1LWY3MDQ0OGI1Y2UwNyJ9LCJleHAiOjE3ODYxNTk1ODl9.jf5NM4fH79_d6iBb2xTvX5JIo_PmVpjeXWOugoDLQVc",
    "roomName": "209cd8c7-7ff4-4afc-b5d5-f70448b5ce07",
    "host": "wss://rtc.example-provider.com",
    "conversationId": "w3fmaal3fKnzNQJ_CHfosw",
    "callId": "CALL-1786159527700-838803"
  }
}

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.

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](/voice-agents/developer-guide/client-libraries) 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