Skip to main content
PUT
Set a persona's avatar

Authorizations

Authorization
string
header
required

API key from waterr.ai/settings?tab=api-keys. Send as Authorization: Bearer wai_<your_key>.

Path Parameters

id
string
required

Persona ID

Body

application/json
avatar_id
string<uuid>

ID of a catalog or account-owned avatar. Takes precedence over url.

url
string<uri>

Raw image URL escape hatch. Clears any structured catalog link.

sync_voice
boolean
default:false

When true and the avatar has a default_voice_id, the persona's voice switches to it.

Response

Persona updated with the new avatar