Live listen

​

Get a token

curl -X POST https://api.upliftai.org/v1/realtime-assistants/sessions/$SESSION_ID/listen \
  -H "Authorization: Bearer $UPLIFT_API_KEY"

{
  "token": "eyJhbGciOiJIUzI1NiJ9…",
  "wsUrl": "wss://upliftai-prod-yd34to8b.livekit.cloud",
  "roomName": "call-25661352-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

​

Play it

import { Room, RoomEvent } from 'livekit-client'

const room = new Room()
room.on(RoomEvent.TrackSubscribed, (track) => {
  if (track.kind === 'audio') document.body.appendChild(track.attach())
})
room.on(RoomEvent.Disconnected, () => console.log('call over'))
await room.connect(wsUrl, token)

​

The limits

• Ten minutes to connect. The token expires after that, but once you are in you stay until the call ends. Mint a fresh one if you waited too long.
• No backfill. You hear from the moment you join. Nothing before that is replayed. For the whole call, take the recording off the session detail once it ends.
• Room ends with the call. When the call ends we delete the room, and your client gets Disconnected.
• One listener per API key. The listener identity comes from your key. A second connect with the same key evicts the first, so give each supervisor their own key.
• On web, wait for state: active. Any session with a room works, phone or web. If you join before the browser does, you create the room, and the browser’s join then dispatches no agent.

​

When it fails

• 400, not live. The session is completed or failed. Every other state gets a token, including a call that is still dialing.
• 404, not found. No such session in your project.