Skip to main content
POST
/
v1
/
personas
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
  }
}
'

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 to use. If not provided, the avatar's default version will be used. Set to null to clear and use default.

Available options:
cara-2,
cara-3
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.

​
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.

Response

Successfully created persona