List Personalities

GET /test_framework/v1/personalities

cURL

cURL

curl --request GET \
  --url https://api.cekura.ai/test_framework/v1/personalities/ \
  --header 'X-CEKURA-API-KEY: <api-key>'

200

[
  {
    "id": 123,
    "name": "<string>",
    "prompt": "<string>",
    "language": "af",
    "accent": "<string>",
    "background_noise": "<string>",
    "voice_model": "<string>",
    "voice_id": "<string>",
    "interruption_level": "<string>",
    "speed": "<string>",
    "generation_config": "<string>",
    "network_simulation": "<string>",
    "message_plan": "<string>",
    "start_speaking_plan": "<string>",
    "stop_speaking_plan": "<string>",
    "background_sound_volume": "<string>",
    "patronus_settings": null,
    "provider_agent_id": "<string>",
    "end_call_enabled": true,
    "provider": "11labs"
  }
]

Authorizations

X-CEKURA-API-KEY · string · header · required

API Key Authentication. It should be included in the header of each request.

Query Parameters

project_id · integer

Filter by project ID

Response

200 - application/json

id · integer

name · string

Name of the personality Example: "Customer Service"

Maximum string length: 255

prompt · string

Prompt of the personality Example: "You are a friendly and helpful customer service agent who is always willing to help"

language · enum<string>

Language of the personality

• af - Afrikaans
• ar - Arabic
• bn - Bengali
• bg - Bulgarian
• zh - Chinese Simplified
• cs - Czech
• da - Danish
• nl - Dutch
• en - English
• et - Estonian
• fi - Finnish
• fr - French
• de - German
• el - Greek
• gu - Gujarati
• hi - Hindi
• he - Hebrew
• hu - Hungarian
• id - Indonesian
• it - Italian
• ja - Japanese
• kn - Kannada
• ko - Korean
• ms - Malay
• ml - Malayalam
• mr - Marathi
• multi - Multilingual
• no - Norwegian
• pl - Polish
• pa - Punjabi
• pt - Portuguese
• ro - Romanian
• ru - Russian
• sk - Slovak
• es - Spanish
• sv - Swedish
• th - Thai
• tr - Turkish
• ta - Tamil
• te - Telugu
• uk - Ukrainian
• vi - Vietnamese

Available options: af, ar, bn, bg, zh, cs, da, nl, en, et, fi, fr, de, el, gu, hi, he, hu, id, it, ja, kn, ko, ms, ml, mr, multi, no, pl, pa, pt, ro, ru, sk, es, sv, th, tr, ta, te, uk, vi

accent · string

Accent of the personality Example: "American"

Maximum string length: 255

background_noise · string

Background noise

voice_model · string

Voice model name

voice_id · string

Voice ID Example: "TX3LPaxmHKxFdv7VOQHJ"

interruption_level · string

Interruption level

speed · string

Speed of the voice

generation_config · string

Generation config for Cartesia Sonic-3 voice model. Only valid when provider is "cartesia" and voice_model is "sonic-3". Supports volume and emotion Example: {"volume": 1.5, "emotion": "happy"}

network_simulation · string

Network simulation configuration for testing network impairments.

message_plan · string

Message plan configuration for idle timeout behavior. Supports idle_timeout_seconds (positive int) and idle_message_max_spoken_count (positive int). Example: {"idle_timeout_seconds": 15, "idle_message_max_spoken_count": 2}

start_speaking_plan · string

Wait seconds before the bot starts speaking (float >= 0). Ignored if interruption_level is also set in the same request (preset takes precedence). Example: 0.7

stop_speaking_plan · string | null

Stop speaking plan configuration. Controls when the bot stops speaking. Supports num_words (int >= 0), voice_seconds (float >= 0), backoff_seconds (float >= 0). Ignored if interruption_level is also set in the same request (preset takes precedence). Example: {"num_words": 3, "voice_seconds": 0.3, "backoff_seconds": 0}

background_sound_volume · string | null

Background sound volume levels (0.0 to 1.0). base sets both the base and normal volume; reduced sets the quieter level during bot speech. Example: {"base": 0.05, "reduced": 0.02}

patronus_settings · unknown

provider_agent_id · string

Provider agent ID Example: "assistant_123"

end_call_enabled · boolean · default: true

Whether the end call is enabled

provider · enum<string>

Provider of the voice

• 11labs - Elevenlabs
• cartesia - Cartesia

Available options: 11labs, cartesia