Start a web session
Creates the session, its LiveKit room and the agent dispatch, and returns what a browser connects with. The participant token is short-lived and reaches one room only.
Access: workspace_member · API key sessions:write
api-keyAuthorizationBearer <sk_waylo_<lookup><secret><checksum>>Idempotency-Key?stringRetrying with the same key returns the same session and a fresh token.
application/json- body
workspaceId*stringuuidagentId*stringuuidendUser?metadata?useDraft?booleanCreated
application/json- response
sessionId*stringuuidworkspaceId*stringuuidroomName*stringlivekitUrl*stringThe LiveKit server the browser connects to directly.
participantToken*stringOne room, one identity, media grants only.
expiresAt*stringdate-timeturn?curl -X POST 'https://api.poc.app.waylovoice.ai/sessions/web' \ -H 'Authorization: Bearer sk_waylo_...' \ -H 'Content-Type: application/json' \ -d '{ "workspaceId": "ef0efa32-d1c1-43d4-a5e2-fe7b4f00403c", "agentId": "bc309ecf-5f66-4057-93c5-6611cc9cb7b2"}'{ "sessionId": "f6567dd8-e069-418e-8893-7d22fcf12459", "workspaceId": "ef0efa32-d1c1-43d4-a5e2-fe7b4f00403c", "roomName": "string", "livekitUrl": "string", "participantToken": "string", "expiresAt": "2019-08-24T14:15:22Z", "turn": { "urls": [ "turn:turn.poc.example:3478?transport=udp", "turn:turn.poc.example:3478?transport=tcp" ], "username": "string", "credential": "string" }}Get session items GET
The items the caller asked for in one session, in their own words and in the order given. Empty when the session captured none. **Access:** workspace_viewer · API key `sessions:read`
Get session GET
One session with its transcript and the configuration it ran on, by id, within the caller’s tenant. Tools, documents, providers, models and the voice carry their current names. For a key, `transcript` is null without transcripts:read and `config` is null without agents:read. **Access:** workspace_viewer · API key `sessions:read`