create persona

curl --request POST \ --url https://api.anam.ai/v1/personas \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "name": "Cara", "description": "<string>", "avatarId": "30fa96d0-26c4-4e55-94a0-517025942e18", "avatarModel": "cara-3", "voiceId": "6bfbe25a-979d-40f3-a92b-5394170af54b", "llmId": "7736a22f-2d79-4720-952c-25fdca55ad40", "systemPrompt": "You are a helpful assistant", "skipGreeting": false, "zeroDataRetention": false, "voiceDetectionOptions": { "endOfSpeechSensitivity": 0.5, "silenceBeforeSkipTurnSeconds": 5, "silenceBeforeSessionEndSeconds": 60, "silenceBeforeAutoEndTurnSeconds": 5, "speechEnhancementLevel": 0.8 }, "languageCode": "en", "voiceGenerationOptions": { "stability": 0.5, "similarityBoost": 0, "speed": 1 }, "toolIds": [ "tool-id-1", "tool-id-2" ] } '

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

name

string

Name of the persona

Example:

"Cara"

description

string

Description of the persona, for example "A helpful assistant". Does not affect the persona's behavior.

avatarId

string

The avatar to use.

Example:

"30fa96d0-26c4-4e55-94a0-517025942e18"

avatarModel

enum<string>

Avatar model version. Models with the '-latest' suffix are invite only.

Available options:

cara-2,

cara-3,

cara-4-latest

Example:

"cara-3"

voiceId

string

The voice to use.

Example:

"6bfbe25a-979d-40f3-a92b-5394170af54b"

llmId

string

The LLM to use. To disable the LLM, use 'CUSTOMER_CLIENT_V1'.

Example:

"7736a22f-2d79-4720-952c-25fdca55ad40"

systemPrompt

string

System prompt for the LLM

Example:

"You are a helpful assistant"

skipGreeting

boolean

Whether to skip the greeting message when starting a session with this persona.

Example:

false

zeroDataRetention

boolean

When true, session data is not stored after the conversation ends

Example:

false

voiceDetectionOptions

object

Options for voice activity detection during user speech input.

Show child attributes

languageCode

string

ISO 639-1 formatted language code override for transcription, replaces organisation level settings and multilingual (default) mode.

Example:

"en"

voiceGenerationOptions

ElevenLabs V1 · object

Configuration options for voice generation.

ElevenLabs V1
ElevenLabs V2
Cartesia Sonic-3

Show child attributes

toolIds

string[]

Array of tool IDs to attach to the persona.

Example:

["tool-id-1", "tool-id-2"]

Response

Successfully created persona

API Reference

Authorizations

Body

Response