Skip to main content
GET
Get one avatar

Authorizations

Authorization
string
header
required

Your organization's API key, from Settings → MCP. Authorization: Bearer crl_sk_live_…

Path Parameters

id
string
required

Response

The avatar.

A reusable identity: face, voice and optional persona. What a run renders with.

object
enum<string>
required
Available options:
avatar
id
string
required
name
string
required
kind
enum<string>
required

influencer carries a persona (bio, tone); actor is a name, a face and a voice.

Available options:
influencer,
actor
look_version
integer
required

Increments every time the face image changes.

is_influencer
boolean
required

True when the avatar is pinned to at least one connection (it has social media).

pinned_connection_ids
string[]
required
brand_id
string

Home brand. Absent = shared across the workspace.

gender
string
age
integer
archetype
string
bio
string
tone
string
image_url
string<uri>

Signed URL of the face image. Time-limited: download it, do not persist the link.

voice_id
string

The avatar's cloned voice; a run with this avatar_id speaks in it by default.

voice_name
string
created_at
number

Epoch milliseconds.