---
title: "Create Embed V2"
method: POST
path: "/v2/embeddings"
tags: ["Embeddings"]
---

# Create Embed V2

`POST /v2/embeddings`

Create an embed avatar with sandbox support.

## Cookies

- `la_session` string

## Request body

- CreateEmbedV2RequestSchema
  - `avatar_id` string, uuid, required
  - `context_id` string, uuid
  - `voice_id` string, uuid
  - `voice_agent_id` string, uuid — Resolve voice / context from a stored voice_agent (the new primitive). Mutually exclusive with voice_id / context_id.
  - `type` 'DEFAULT' | 'WIDGET'
  - `max_session_duration` integer — Max session duration in seconds
  - `default_language` string — Default language code (e.g. 'en', 'es', 'multi')
  - `is_sandbox` boolean — Whether to enable sandbox mode for sessions
  - `orientation` 'horizontal' | 'vertical'

## Response `200`

Successful Response

- ResponseCreateEmbedV2ResponseSchema
  - `code` integer
  - `data` CreateEmbedV2ResponseSchema
    - `embed_id` string, uuid, required
    - `url` string, required
    - `script` string
    - `orientation` 'horizontal' | 'vertical'
  - `message` string

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/liveavatar/apis/live-avatar-api.md) · [All operations](https://skmtc.dev/liveavatar/apis/live-avatar-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/liveavatar/live-avatar-api/revisions/fbfa5cdbd7f9/schema)