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": "A helpful assistant",
  "avatarId": "071b0286-4cce-4808-bee2-e642f1062de3",
  "voiceId": "de23e340-1416-4dd8-977d-065a7ca11697",
  "llmId": "a7cf662c-2ace-4de1-a21e-ef0fbf144bb7",
  "systemPrompt": "You are a helpful assistant."
}
'

import requests

url = "https://api.anam.ai/v1/personas"

payload = {
    "name": "Cara",
    "description": "A helpful assistant",
    "avatarId": "071b0286-4cce-4808-bee2-e642f1062de3",
    "voiceId": "de23e340-1416-4dd8-977d-065a7ca11697",
    "llmId": "a7cf662c-2ace-4de1-a21e-ef0fbf144bb7",
    "systemPrompt": "You are a helpful assistant."
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'Cara',
    description: 'A helpful assistant',
    avatarId: '071b0286-4cce-4808-bee2-e642f1062de3',
    voiceId: 'de23e340-1416-4dd8-977d-065a7ca11697',
    llmId: 'a7cf662c-2ace-4de1-a21e-ef0fbf144bb7',
    systemPrompt: 'You are a helpful assistant.'
  })
};

fetch('https://api.anam.ai/v1/personas', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.anam.ai/v1/personas",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Cara',
    'description' => 'A helpful assistant',
    'avatarId' => '071b0286-4cce-4808-bee2-e642f1062de3',
    'voiceId' => 'de23e340-1416-4dd8-977d-065a7ca11697',
    'llmId' => 'a7cf662c-2ace-4de1-a21e-ef0fbf144bb7',
    'systemPrompt' => 'You are a helpful assistant.'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.anam.ai/v1/personas"

	payload := strings.NewReader("{\n  \"name\": \"Cara\",\n  \"description\": \"A helpful assistant\",\n  \"avatarId\": \"071b0286-4cce-4808-bee2-e642f1062de3\",\n  \"voiceId\": \"de23e340-1416-4dd8-977d-065a7ca11697\",\n  \"llmId\": \"a7cf662c-2ace-4de1-a21e-ef0fbf144bb7\",\n  \"systemPrompt\": \"You are a helpful assistant.\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.anam.ai/v1/personas")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Cara\",\n  \"description\": \"A helpful assistant\",\n  \"avatarId\": \"071b0286-4cce-4808-bee2-e642f1062de3\",\n  \"voiceId\": \"de23e340-1416-4dd8-977d-065a7ca11697\",\n  \"llmId\": \"a7cf662c-2ace-4de1-a21e-ef0fbf144bb7\",\n  \"systemPrompt\": \"You are a helpful assistant.\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.anam.ai/v1/personas")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"Cara\",\n  \"description\": \"A helpful assistant\",\n  \"avatarId\": \"071b0286-4cce-4808-bee2-e642f1062de3\",\n  \"voiceId\": \"de23e340-1416-4dd8-977d-065a7ca11697\",\n  \"llmId\": \"a7cf662c-2ace-4de1-a21e-ef0fbf144bb7\",\n  \"systemPrompt\": \"You are a helpful assistant.\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "00000000-0000-0000-0000-000000000000",
  "name": "Cara",
  "description": "A helpful assistant",
  "personaPreset": "",
  "avatar": {
    "id": "071b0286-4cce-4808-bee2-e642f1062de3",
    "displayName": "Liv",
    "variantName": "home",
    "imageUrl": "https://lab.anam.ai/persona_thumbnails/liv_home.png",
    "videoUrl": "https://example.com/avatar-preview.mp4?X-Amz-Signature=...",
    "createdAt": "2026-04-20T10:00:00.000Z",
    "updatedAt": "2026-04-20T10:00:00.000Z",
    "createdByOrganizationId": null,
    "availableVersions": [
      "cara-3"
    ],
    "activeVersion": "cara-3",
    "description": "A friendly professional in a modern office setting, warm expression, business casual attire.",
    "displayTags": [
      "professional",
      "friendly",
      "office"
    ],
    "renderStyle": "realistic"
  },
  "avatarModel": "cara-3",
  "voice": {
    "id": "de23e340-1416-4dd8-977d-065a7ca11697",
    "displayName": "Lucy - Fresh & Casual",
    "provider": "ELEVENLABS",
    "providerVoiceId": "lcMyyd2HUfFzxdCaC4Ta",
    "providerModelId": "eleven_flash_v2_5",
    "sampleUrl": "https://newgxnc1uqs0jnqm.public.blob.vercel-storage.com/voice-samples/de23e340-1416-4dd8-977d-065a7ca11697/1760617899390.mp3",
    "previewSampleUrl": "https://newgxnc1uqs0jnqm.public.blob.vercel-storage.com/voice-samples/de23e340-1416-4dd8-977d-065a7ca11697/1760617899390.mp3",
    "gender": "FEMALE",
    "country": "GB",
    "description": "Energetic and youthful British voice, perfect for narrations and conversational agents.",
    "displayTags": [
      "fast"
    ],
    "isZdr": true,
    "createdByOrganizationId": null,
    "createdAt": "2026-04-20T10:00:00.000Z",
    "updatedAt": "2026-04-20T10:00:00.000Z"
  },
  "voiceSpeed": 1,
  "llmId": "a7cf662c-2ace-4de1-a21e-ef0fbf144bb7",
  "brain": {
    "personality": null,
    "systemPrompt": "You are a helpful assistant."
  },
  "tools": [],
  "knowledge": [],
  "shareLinks": null,
  "primaryShareLink": null,
  "enableAudioPassthrough": false,
  "skipGreeting": false,
  "zeroDataRetention": false,
  "voiceDetectionOptions": null,
  "voiceGenerationOptions": null,
  "widgetConfig": {},
  "createdAt": "2026-04-20T10:00:00.000Z",
  "updatedAt": "2026-04-20T10:00:00.000Z"
}

POST

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": "A helpful assistant",
  "avatarId": "071b0286-4cce-4808-bee2-e642f1062de3",
  "voiceId": "de23e340-1416-4dd8-977d-065a7ca11697",
  "llmId": "a7cf662c-2ace-4de1-a21e-ef0fbf144bb7",
  "systemPrompt": "You are a helpful assistant."
}
'

import requests

url = "https://api.anam.ai/v1/personas"

payload = {
    "name": "Cara",
    "description": "A helpful assistant",
    "avatarId": "071b0286-4cce-4808-bee2-e642f1062de3",
    "voiceId": "de23e340-1416-4dd8-977d-065a7ca11697",
    "llmId": "a7cf662c-2ace-4de1-a21e-ef0fbf144bb7",
    "systemPrompt": "You are a helpful assistant."
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'Cara',
    description: 'A helpful assistant',
    avatarId: '071b0286-4cce-4808-bee2-e642f1062de3',
    voiceId: 'de23e340-1416-4dd8-977d-065a7ca11697',
    llmId: 'a7cf662c-2ace-4de1-a21e-ef0fbf144bb7',
    systemPrompt: 'You are a helpful assistant.'
  })
};

fetch('https://api.anam.ai/v1/personas', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.anam.ai/v1/personas",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Cara',
    'description' => 'A helpful assistant',
    'avatarId' => '071b0286-4cce-4808-bee2-e642f1062de3',
    'voiceId' => 'de23e340-1416-4dd8-977d-065a7ca11697',
    'llmId' => 'a7cf662c-2ace-4de1-a21e-ef0fbf144bb7',
    'systemPrompt' => 'You are a helpful assistant.'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.anam.ai/v1/personas"

	payload := strings.NewReader("{\n  \"name\": \"Cara\",\n  \"description\": \"A helpful assistant\",\n  \"avatarId\": \"071b0286-4cce-4808-bee2-e642f1062de3\",\n  \"voiceId\": \"de23e340-1416-4dd8-977d-065a7ca11697\",\n  \"llmId\": \"a7cf662c-2ace-4de1-a21e-ef0fbf144bb7\",\n  \"systemPrompt\": \"You are a helpful assistant.\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.anam.ai/v1/personas")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Cara\",\n  \"description\": \"A helpful assistant\",\n  \"avatarId\": \"071b0286-4cce-4808-bee2-e642f1062de3\",\n  \"voiceId\": \"de23e340-1416-4dd8-977d-065a7ca11697\",\n  \"llmId\": \"a7cf662c-2ace-4de1-a21e-ef0fbf144bb7\",\n  \"systemPrompt\": \"You are a helpful assistant.\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.anam.ai/v1/personas")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"Cara\",\n  \"description\": \"A helpful assistant\",\n  \"avatarId\": \"071b0286-4cce-4808-bee2-e642f1062de3\",\n  \"voiceId\": \"de23e340-1416-4dd8-977d-065a7ca11697\",\n  \"llmId\": \"a7cf662c-2ace-4de1-a21e-ef0fbf144bb7\",\n  \"systemPrompt\": \"You are a helpful assistant.\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "00000000-0000-0000-0000-000000000000",
  "name": "Cara",
  "description": "A helpful assistant",
  "personaPreset": "",
  "avatar": {
    "id": "071b0286-4cce-4808-bee2-e642f1062de3",
    "displayName": "Liv",
    "variantName": "home",
    "imageUrl": "https://lab.anam.ai/persona_thumbnails/liv_home.png",
    "videoUrl": "https://example.com/avatar-preview.mp4?X-Amz-Signature=...",
    "createdAt": "2026-04-20T10:00:00.000Z",
    "updatedAt": "2026-04-20T10:00:00.000Z",
    "createdByOrganizationId": null,
    "availableVersions": [
      "cara-3"
    ],
    "activeVersion": "cara-3",
    "description": "A friendly professional in a modern office setting, warm expression, business casual attire.",
    "displayTags": [
      "professional",
      "friendly",
      "office"
    ],
    "renderStyle": "realistic"
  },
  "avatarModel": "cara-3",
  "voice": {
    "id": "de23e340-1416-4dd8-977d-065a7ca11697",
    "displayName": "Lucy - Fresh & Casual",
    "provider": "ELEVENLABS",
    "providerVoiceId": "lcMyyd2HUfFzxdCaC4Ta",
    "providerModelId": "eleven_flash_v2_5",
    "sampleUrl": "https://newgxnc1uqs0jnqm.public.blob.vercel-storage.com/voice-samples/de23e340-1416-4dd8-977d-065a7ca11697/1760617899390.mp3",
    "previewSampleUrl": "https://newgxnc1uqs0jnqm.public.blob.vercel-storage.com/voice-samples/de23e340-1416-4dd8-977d-065a7ca11697/1760617899390.mp3",
    "gender": "FEMALE",
    "country": "GB",
    "description": "Energetic and youthful British voice, perfect for narrations and conversational agents.",
    "displayTags": [
      "fast"
    ],
    "isZdr": true,
    "createdByOrganizationId": null,
    "createdAt": "2026-04-20T10:00:00.000Z",
    "updatedAt": "2026-04-20T10:00:00.000Z"
  },
  "voiceSpeed": 1,
  "llmId": "a7cf662c-2ace-4de1-a21e-ef0fbf144bb7",
  "brain": {
    "personality": null,
    "systemPrompt": "You are a helpful assistant."
  },
  "tools": [],
  "knowledge": [],
  "shareLinks": null,
  "primaryShareLink": null,
  "enableAudioPassthrough": false,
  "skipGreeting": false,
  "zeroDataRetention": false,
  "voiceDetectionOptions": null,
  "voiceGenerationOptions": null,
  "widgetConfig": {},
  "createdAt": "2026-04-20T10:00:00.000Z",
  "updatedAt": "2026-04-20T10:00:00.000Z"
}

Authorizations

Authorization

string

header

required

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

Body

application/json

Configuration for the new persona. avatarId, voiceId, and llmId are references to existing resources in your organization. systemPrompt, if provided, is merged into the brain field server-side. Setting zeroDataRetention to true requires the voice, LLM and voiceDetectionOptions.sttProvider to be ZDR-compatible and an enterprise plan.

name

string

required

Name of the persona

Maximum string length: 191

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:

"071b0286-4cce-4808-bee2-e642f1062de3"

avatarModel

enum<string>

Avatar model version. cara-4 is pinned to a stable checkpoint; cara-4-latest tracks the newest Cara 4 checkpoint and may change between sessions. cara-5-latest is an early-access preview that tracks the newest Cara 5 checkpoint; it is available only to organizations that have been granted it, and other organizations get 403.

Available options:

cara-3,

cara-4,

cara-4.1-express,

cara-4-latest,

cara-5-latest

Example:

"cara-4"

voiceId

string

The voice to use.

Example:

"de23e340-1416-4dd8-977d-065a7ca11697"

llmId

string

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

Example:

"a7cf662c-2ace-4de1-a21e-ef0fbf144bb7"

systemPrompt

string

System prompt for the LLM.

Example:

"You are a helpful assistant"

skipGreeting

boolean

Skip the greeting when a session starts.

Example:

false

uninterruptibleGreeting

boolean

The user can't interrupt the greeting.

Example:

false

initialMessage

string | null

What the persona says first. Empty or left out, it greets in its own words.

Example:

"Hi there! I'm excited to chat with you today."

zeroDataRetention

boolean

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

Example:

false

maxSessionLengthSeconds

integer | null

Longest session with this persona, in seconds; it can only shorten the plan's limit. Omit or send null for no persona limit.

Required range: 60 <= x <= 7200

Example:

600

voiceDetectionOptions

object

Options for voice activity detection during user speech input.

Show child attributes

languageCode

string

Supported ISO 639 language code override (including "yue" for Cantonese) for transcription, replaces organisation level settings and multilingual (default) mode.

Example:

"en"

voiceGenerationOptions

ElevenLabs V1 · object

Configuration options for voice generation.

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

Full persona shape returned by the create, get, and update endpoints.

string<uuid>

Unique identifier for the persona.

name

string

Human-readable name of the persona.

description

string | null

Free-form description of the persona.

personaPreset

string

deprecated

Deprecated. Name of the legacy preset an older persona was created from, if any. Presets can no longer be set; use avatarId and voiceId.

avatar

object | null

Avatar currently attached to the persona.

Show child attributes

avatarModel

string | null

Public model version (e.g. cara-3, cara-4) used when rendering the avatar.

voice

object | null

Voice currently attached to the persona.

Show child attributes

voiceSpeed

number | null

Speech rate multiplier applied to the voice.

llmId

string<uuid> | null

ID of the LLM the persona uses, or null for presets that don't run an LLM.

brain

object

Persona behaviour configuration applied on top of the raw LLM.

Show child attributes

tools

object[]

Tool configurations currently attached to the persona.

knowledge

object[]

Knowledge group attachments currently active on the persona.

All share links ever issued for this persona.

Show child attributes

The primary share link attached to the persona, if one has been created.

Show child attributes

enableAudioPassthrough

boolean

Whether audio is passed through from the client instead of being generated server-side.

skipGreeting

boolean

Whether the persona skips the greeting message at the start of a session.

zeroDataRetention

boolean

Whether session data is discarded instead of stored after the conversation ends.

maxSessionLengthSeconds

integer | null

Maximum length in seconds of every session with this persona, or null when only the plan's session limit applies.

voiceDetectionOptions

object | null

Voice activity detection tuning for user speech.

Show child attributes

voiceGenerationOptions

ElevenLabs V1 · object

Provider-specific voice generation tuning.

Show child attributes

Widget rendering overrides (e.g. removing the watermark).

createdAt

string<date-time>

Timestamp when the persona was created.

updatedAt

string<date-time>

Timestamp when the persona was last updated.

Use the API

Sessions

Meetings

Avatar Videos

Personas

Avatars

Voices

Pronunciation Dictionaries

LLMs

Knowledge

Tools

Share Links

Engine

create persona

Authorizations

Body

Response