Start a web chat session

POST

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

POST

/atoms/v1/conversation/chat

1 import requests
2 
3 url = "https://api.smallest.ai/atoms/v1/conversation/chat"
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.eyJtZXRhZGF0YSI6IntcIm9yZ2FuaXphdGlvbklkXCI6XCI2OTU2MTg5NmEzN2ZkMjE0YjlhOGQzM2NcIn0iLCJ2aWRlbyI6eyJyb29tSm9pbiI6dHJ1ZSwicm9vbSI6ImRlZTkyMjNhLTQ3NTEtNDlhOS1iY2JjLWNiMzVjNWE4MzcxZCJ9LCJleHAiOjE3ODYxNTk1NjR9.Tn9KCxhnmnjAFQPRWP6XMkjKYnhBiISI6VqUOIqOsRQ",
5     "roomName": "dee9223a-4751-49a9-bcbc-cb35c5a8371d",
6     "host": "wss://atoms-prod-evcaw70g.livekit.cloud",
7     "conversationId": "IyF-GCRiprATI5rx4lIdvg",
8     "callId": "CALL-1786159503332-8387f2"
9   }
10 }

Mints a short-lived LiveKit access token and creates a room the browser client can join to have a text-first chat with the agent. The response includes the room name, the LiveKit host to connect to, a conversationId for correlation, and a callId that shows up in call logs. Pair with the Web SDK to render the session in-browser.

Mints a short-lived LiveKit access token and creates a room the browser client can join to have a text-first chat with the agent. The response includes the room name, the LiveKit host to connect to, a `conversationId` for correlation, and a `callId` that shows up in call logs. Pair with the [Web SDK](/voice-agents/developer-guide/client-libraries) to render the session 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