Skip to main content
POST
Create Video Agent Avatar

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

team_id
string<uuid>
required

Body

application/json

Create a Video Agent (text-to-video stock-avatar) avatar config.

The avatar is a curated stock preset (NOT the user's likeness), selected by name from avatar_catalog.VIDEO_AGENT_AVATARS. Phase-1 routes through the fal-argil provider (argil/avatars/text-to-video).

avatar_name
string
required
Minimum string length: 1
voice_id
string | null
provider
string
default:fal-argil
Allowed value: "fal-argil"
default_prompt
string | null
Maximum string length: 5000

Response

Successful Response