Skip to main content
POST
Create a new persona

Authorizations

Authorization
string
header
required

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

Body

application/json
name
string
required

Name of the persona

Maximum string length: 100
job_title
string
required

Job title of the persona

Maximum string length: 100
voice_id
string

ID of the voice associated with the persona

demeanor
enum<string>

The personality style of the persona

Available options:
friendly,
analytical,
empathetic,
curious,
enthusiastic,
critical,
casual,
blunt,
assertive,
neutral
background
string

Detailed background information about the persona

avatar
string

Raw URL to the persona's avatar image. Prefer avatar_id for catalog avatars.

Maximum string length: 255
avatar_id
string<uuid>

ID of an avatar from GET /avatars. Takes precedence over avatar; the avatar's URL is copied into the persona automatically.

gender
string

Persona gender (used for voice/avatar defaults).

Response

Persona created successfully

id
string
name
string
job_title
string
voice_id
string
user_basic_info_id
string
demeanor
string
background
string
avatar
string
created_at
string<date-time>
updated_at
string<date-time>