> ## Documentation Index
> Fetch the complete documentation index at: https://docs.liveavatar.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Product updates and announcements for LiveAvatar API

<Update label="May 13, 2026" description="New Endpoint">
  ## Delete Session Events endpoint

  * **`DELETE /v1/sessions/{session_id}/events`** — New endpoint to hard-delete all events for a given session. Accepts `session_id` path parameter; authenticated via API key or bearer token.
</Update>

<Update label="May 7, 2026" description="SDK Update">
  ## JavaScript SDK v0.0.18 — ElevenLabs Agent improvements

  * **[`@heygen/liveavatar-web-sdk` v0.0.18](https://github.com/heygen-com/liveavatar-web-sdk)** — Includes a set of ElevenLabs Agent connector improvements, notably bidirectional passthrough of raw ElevenLabs Conversational AI events. Frontends can now both receive every ElevenLabs server event (via [`elevenlabs_agent_event`](/docs/lite-mode/connectors/elevenlabs-agent#elevenlabs-passthrough-outbound-server-client)) and send raw ElevenLabs client events (via [`elevenlabs_agent_command`](/docs/lite-mode/connectors/elevenlabs-agent#elevenlabs-passthrough-inbound-client-server)) without per-feature plumbing.
</Update>

<Update label="May 4, 2026" description="API Changes">
  ## 1080p avatars, ElevenLabs voice override & expanded Gemini voices

  * **1080p avatars** — Added support for 1080p avatars on the new payment plan. **`AvatarSchema`** exposes an **`is_1080p`** boolean to identify them.
  * **Session token improvements** — Hardened JWT payload to strip sensitive fields from the token, also reducing payload size. Sandbox mode keeps fields visible for testing.
  * **ElevenLabs voice override** — **`ElevenLabsAgentConfigSchema`** accepts an optional **`voice_id`** that is forwarded as `conversation_config_override.tts.voice_id` to the ElevenLabs Agent WebSocket, overriding the agent's default voice for the session.
  * **Expanded Gemini Realtime voices** — **`GeminiVoiceEnum`** adds Achernar, Achird, Algenib, Algieba, Alnilam, Autonoe, Callirrhoe, Despina, Enceladus, Erinome, Gacrux, Iapetus, Laomedeia, Pulcherrima, Rasalgethi, Sadachbia, Sadaltager, Schedar, Sulafat, Umbriel, Vindemiatrix, and Zubenelgenubi.
</Update>

<Update label="April 22, 2026" description="New Features">
  ## Gemini Realtime, Vertical Embeds & Dynamic Variables

  * **Gemini Realtime agent** — LITE sessions can now be configured with **`gemini_realtime_config`**, running on Gemini Live API with configurable model, voice, and temperature. Supported voices include **Aoede**, **Charon**, **Fenrir**, **Kore**, **Leda**, **Orus**, **Puck**, and **Zephyr**. Requires a new **`GEMINI_API_KEY`** secret type.
  * **Embed orientation** — `/v2/embeddings` now accepts an **`orientation`** field (`horizontal` for 16:9 or `vertical` for 9:16). The response also returns the new **`embed_id`** field.
  * **Session dynamic variables** — Session creation now accepts a **`dynamic_variables`** object for filling `${var}` placeholders in the context's opening text and prompt (max 50 entries).
  * **New session filters** — `GET /v1/sessions` now supports **`embed_id`** and **`context_id`** query parameters.
  * **New `AGENT_HANG_UP` session end reason** — Added to **`SessionEndReasonEnum`** to indicate the agent itself terminated the call. Currently only emitted by the ElevenLabs agent.
</Update>

<Update label="April 9, 2026" description="New Features">
  ## ElevenLabs Events, Embed Transcripts & SDK Update

  * **ElevenLabs agent events** — underlying ElevenLabs server events are now forwarded via the [`elevenlabs_agent_event`](/docs/lite-mode/connectors/elevenlabs-agent#events) event type, giving you access to raw ElevenLabs Conversational AI events
  * **Transcript on embed** — Transcripts are now available directly on embed sessions
  * **JavaScript SDK updated** — Updated the [`@heygen/liveavatar-web-sdk`](https://github.com/heygen-com/liveavatar-web-sdk) package with new event types and improvements
</Update>

<Update label="April 6, 2026" description="API Changes">
  ## Auth Simplification & Session Filtering

  * **Authentication** — Cleaned up documentation for which endpoints require which auth specifications
  * **New `avatar_id` filter on `/v1/sessions`** — List sessions can now be filtered by an optional **avatar\_id** query parameter
</Update>

<Update label="April 2, 2026" description="New Features">
  ## Embeds, Image Avatars & More

  * New **`/v2/embeddings`** endpoint with sandbox support — Embeds can now be created with Sandbox Mode available
  * Built **Image Avatar** pipeline — Create a fully animated avatar from just a photo using the new validate and submit endpoints

  ### Improvements

  * [**Update avatar endpoint**](/api-reference/avatar/update-avatar) — You can now change an avatar's default voice
  * **Avatar and voice deletion untangled** — Deleting a voice no longer affects its associated avatar, and vice versa
  * **ElevenLabs agent dynamic variables** — Configure dynamic variables for ElevenLabs-powered agents that get replaced at session start
  * **Source events fixed in FULL Mode** — `avatar.say` and `avatar.repeat` events now correctly return `source_event_id`
</Update>

<Update label="March 26, 2026" description="New Features">
  ## ElevenLabs Scribe, Embed Improvements

  * Added support for **ElevenLabs Scribe**, expanding ASR capabilities
  * **Embed Improvements**
    * Default language selection, letting users set the language for their embed experience
    * Time limits, giving creators control over session duration
</Update>

<Update label="March 18, 2026" description="API Changes">
  ## Voice Settings & Fish Audio

  * Added additional voice settings for more granular control over avatar speech
  * Added access to **Fish Audio** as a TTS provider
  * New `[GET] /v1/languages` endpoint to clarify which languages are currently supported

  We will continue clarifying how the `language` parameter interacts with FULL Mode systems.
</Update>

<Update label="February 20, 2026" description="API Changes">
  ## ElevenLabs Integration

  * The `v1/secrets` endpoint now accepts **ElevenLabs API keys**
  * FULL Mode sessions can now start with your own ElevenLabs keys and voices
  * Added integration with **ElevenLabs Agent** functionality
</Update>

<Update label="February 17, 2026" description="API Changes">
  ## LLM Plugin & Session Controls

  * Introduced **LLM Plugin** for custom LLM configurations
  * Added customizable **session duration** controls
  * Transcription chunk events are now emitted in **real time**
  * New endpoint to track **user credit balances**
</Update>

<Update label="February 3, 2026" description="API Changes">
  ## Session Configuration & LITE Mode

  * New session configuration options for **video codec selection** (H.264 / VP8)
  * Added **video quality** control settings
  * Added **voice customization** options
  * CUSTOM Mode has been renamed to **LITE Mode** (backward-compatible)
  * Bug fix: resolved opening line speech issues
</Update>

<Update label="January 26, 2026" description="API Changes">
  ## Push-to-Talk

  * Released **Push-to-Talk** functionality for avatar sessions
  * Added accompanying documentation and integration guides
</Update>

<Update label="January 13, 2026" description="API Changes">
  ## Sandbox Mode & FULL Mode Improvements

  * Introduced **Sandbox Mode** for testing without credit charges
  * Made `context` optional in FULL Mode configurations, reducing required setup
</Update>

<Update label="January 8, 2026" description="API Changes">
  ## Custom Mode & Session List Updates

  * Custom Mode now exposes **LiveKit Agent token** for developers to integrate their own agents
  * Session List endpoint updated to use **query parameters**
</Update>

<Update label="November 2025" description="New Endpoint">
  ## Transcription Endpoint

  * New `[GET] /v1/sessions/{session_id}/transcript` endpoint
  * Enables developers to retrieve transcriptions between users and avatars in FULL Mode sessions
</Update>

<Update label="November 2025" description="New Endpoint">
  ## Sessions List Endpoint

  * New `[GET] /v1/sessions` endpoint
  * Allows listing of both active and previously active sessions
</Update>
