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

# Start a web chat session

`POST /conversation/chat`

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.

## 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)