Skip to main content
PUT
/
v1
/
personas
/
{id}
update persona
curl --request PUT \
  --url https://api.anam.ai/v1/personas/{id} \
  --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.

Path Parameters

​
id
string
required

Persona id

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.

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

​
toolIds
string[]

Array of tool IDs to attach to the persona. Replaces any existing tool associations.

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

Response

Successfully updated persona

Last modified on April 15, 2026