---
title: "Dispatch Widget Avatar"
method: POST
path: "/api/livechat/public/{widget_key}/video/dispatch"
tags: ["livechat", "livechat"]
---

# Dispatch Widget Avatar

`POST /api/livechat/public/{widget_key}/video/dispatch`

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/api/livechat/public/{widget_key}/video/dispatch`
- Auth: none declared

Mint a LiveKit room + token for a widget VIDEO (avatar) call.

Server-side degrade: returns 200 with `avatar` discriminator. Fleet-full =>
avatar:false (plain voice), NOT 429. The voice_sessions row is always
source='avatar' (degraded calls tagged metadata.degraded_reason).

## Path parameters

- `widget_key` string, required

## Headers

- `X-Session-Token` string, nullable

## Request body

- AvatarDispatchRequest
  - `page_context` object, nullable

## Response `200`

Successful Response

- AvatarDispatchResponse
  - `url` string, required
  - `token` string, required
  - `room` string, required
  - `call_id` string, required
  - `avatar` boolean, required
  - `avatar_identity` string, nullable
  - `avatar_wait_timeout_s` number, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway.md) · [All operations](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/revisions/77bef09a9209?raw)