Start a web chat session

POST

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

POST

/atoms/v1/conversation/chat

import requests
url = "https://api.smallest.ai/atoms/v1/conversation/chat"
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.eyJtZXRhZGF0YSI6IntcIm9yZ2FuaXphdGlvbklkXCI6XCI2OTU2MTg5NmEzN2ZkMjE0YjlhOGQzM2NcIn0iLCJ2aWRlbyI6eyJyb29tSm9pbiI6dHJ1ZSwicm9vbSI6ImRlZTkyMjNhLTQ3NTEtNDlhOS1iY2JjLWNiMzVjNWE4MzcxZCJ9LCJleHAiOjE3ODYxNTk1NjR9.Tn9KCxhnmnjAFQPRWP6XMkjKYnhBiISI6VqUOIqOsRQ",
    "roomName": "dee9223a-4751-49a9-bcbc-cb35c5a8371d",
    "host": "wss://rtc.example-provider.com",
    "conversationId": "IyF-GCRiprATI5rx4lIdvg",
    "callId": "CALL-1786159503332-8387f2"
  }
}

Mints a short-lived session 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 WebSocket 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.

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