Personas

A persona is the AI’s identity: name, job title, personality, background, voice. One persona can power many scenarios.

Most integrations never touch this endpoint directly. The auto-seeded Plus One and Requirement Gathering scenarios already have personas attached, and POST /scenarios/create-with-gpt generates a persona for you. Reach for these endpoints only when you’re building fully custom scenarios by hand.

Create a persona

curl -X POST https://api.waterr.ai/v1/personas \
  -H "Authorization: Bearer wai_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sarah Chen",
    "job_title": "VP of Engineering",
    "demeanor": "analytical",
    "background": "15 years building distributed systems at scale. Led engineering at two startups through Series B.",
    "gender": "female",
    "voice_id": "VOICE_UUID"
  }'

string

required

Full name of the AI persona.

string

required

Professional title (shown to participants).

string

Personality style. Options: friendly, analytical, empathetic, curious, enthusiastic, critical, casual, blunt, assertive, neutral.

string

Detailed background — the more specific, the better the AI’s follow-up questions.

string

male or female — used for default voice and avatar selection.

string

Voice UUID from Voices. If omitted, a default voice is assigned based on gender.

string

Avatar UUID from the avatar catalog. The avatar’s image URL and gender are applied to the persona automatically. You can also set or change it later with PUT /personas/{id}/avatar.

List personas

curl https://api.waterr.ai/v1/personas \
  -H "Authorization: Bearer wai_<your_key>"

All persona endpoints

Method	Endpoint	Use
`POST`	`/personas`	Create
`GET`	`/personas/{id}`	Get one
`GET`	`/personas`	List
`PUT`	`/personas/{id}`	Update
`DELETE`	`/personas/{id}`	Delete
`PUT`	`/personas/{id}/avatar`	Set avatar (catalog)
`DELETE`	`/personas/{id}/avatar`	Clear avatar

Getting Started

Meetings

Scenarios

Embed Scenario

Post-Meeting Data

Goals

Avatars

Voices

Tools

Users

Guides

Integrations

Agent Skills

Personas

Create a persona

List personas

All persona endpoints

​Create a persona

​List personas

​All persona endpoints

Create a persona

List personas

All persona endpoints