---
title: "Start a web call session"
method: POST
path: "/conversation/webcall"
tags: ["Web Call"]
---

# Start a web call session

`POST /conversation/webcall`

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.

## Request body

- WebSessionRequest
  - `agentId` string, required — The agent to attach the browser client to.

## Response `200`

Session minted. Use `token` + `host` on the browser client to join `roomName`.

- WebSessionResponse
  - `status` boolean
  - `data` object
    - `token` string — Short-lived LiveKit access token. Pass on the browser client when connecting to `host`.
    - `roomName` string — LiveKit room UUID. Pre-created for this session.
    - `host` string — LiveKit WebSocket URL to connect to.
    - `conversationId` string — Correlates browser events, transcripts, and post-call analytics.
    - `callId` string — Call ID surfaced in call-logs and analytics endpoints.

## Other responses

- `400` — Missing or invalid `agentId`.

---

[API](https://skmtc.net/smallest-inc/apis/agent-management-api.md) · [All operations](https://skmtc.net/smallest-inc/apis/agent-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smallest-inc/agent-management-api/revisions/c2d0eb64b01a/schema)