Skip to main content
PUT
Update a persona

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

Body

application/json
name
string
Maximum string length: 100
job_title
string
Maximum string length: 100
voice_id
string
demeanor
enum<string>
Available options:
friendly,
analytical,
empathetic,
curious,
enthusiastic,
critical,
casual,
blunt,
assertive,
neutral
background
string
avatar
string

Raw avatar URL. Sending a new URL without avatar_id clears any catalog link.

Maximum string length: 255
avatar_id
string<uuid> | null

Catalog avatar ID (see GET /avatars). Takes precedence over avatar; pass null to clear both.

gender
string

Response

Persona updated successfully