---
title: "List personalities available to an agent"
method: GET
path: "/test_framework/v2/aiagents/{id}/personalities/"
tags: ["test_framework"]
---

# List personalities available to an agent

`GET /test_framework/v2/aiagents/{id}/personalities/`

## Request

- Base URL: `https://api.cekura.ai`
- URL: `https://api.cekura.ai/test_framework/v2/aiagents/{id}/personalities/`
- Auth: one of:
  - API key in header `X-CEKURA-API-KEY`
  - HTTP bearer
  - HTTP bearer

List the caller/tester personalities available to this agent's project. Filter with query params: type, language, enabled_only=true (only the personalities currently enabled for the project).

## Path parameters

- `id` integer, required

## Query parameters

- `page` integer
- `page_size` integer

## Response `200`

- PaginatedPersonalityList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` Personality[], required
    - `id` integer
    - `forked_from` integer, nullable
    - `organization` integer, nullable
    - `name` string, required: Name of the personality Example: `"Customer Service"`
    - `description` string, required: Description of the personality Example: `"A friendly and helpful customer service agent who is always willing to help"`
    - `prompt` string, required: Prompt of the personality Example: `"You are a friendly and helpful customer service agent who is always willing to help"`
    - `language` 'af' | 'ar' | 'bn' | 'bg' | 'zh' | 'cs' | 'da' | 'nl' | 'en' | 'et' | 'fi' | 'fr' | 'de' | 'el' | 'gu' | 'hi' | 'he' | 'hu' | 'id' | 'it' | 'ja' | 'kn' | 'kk' | 'ko' | 'ms' | 'ml' | 'mr' | 'multi' | 'no' | 'pl' | 'pa' | 'pt' | 'ro' | 'ru' | 'sk' | 'es' | 'sv' | 'th' | 'tr' | 'tl' | 'ta' | 'te' | 'uk' | 'uz' | 'vi': 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 * `kk` - Kazakh * `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 * `tl` - Tagalog * `ta` - Tamil * `te` - Telugu * `uk` - Ukrainian * `uz` - Uzbek * `vi` - Vietnamese
    - `accent` string: Read-only label describing the accent of this personality's voice, as reported by the voice provider. It is derived from `voice_id` and cannot be set directly: speech is synthesised from `voice_id` alone, so changing the accent of a personality means choosing a different voice. Empty when the provider publishes no accent for the voice.
    - `gender` 'male' | 'female' | 'neutral': Gender of the personality * `male` - Male * `female` - Female * `neutral` - Neutral
    - `enabled` boolean
    - `call_service_provider` 'vapi' | 'patronus': Call service provider * `vapi` - VAPI * `patronus` - Patronus
    - `background_noise` string, required
    - `voice_model` string, required
    - `voice_id` string
    - `interruption_level` string
    - `speed` number
    - `generation_config` object
      - `volume` number
      - `emotion` 'neutral' | 'happy' | 'excited' | 'enthusiastic' | 'elated' | 'euphoric' | 'triumphant' | 'amazed' | 'surprised' | 'flirtatious' | 'joking/comedic' | 'curious' | 'content' | 'peaceful' | 'serene' | 'calm' | 'grateful' | 'affectionate' | 'trust' | 'sympathetic' | 'anticipation' | 'mysterious' | 'angry' | 'mad' | 'outraged' | 'frustrated' | 'agitated' | 'threatened' | 'disgusted' | 'contempt' | 'envious' | 'sarcastic' | 'ironic' | 'sad' | 'dejected' | 'melancholic' | 'disappointed' | 'hurt' | 'guilty' | 'bored' | 'tired' | 'rejected' | 'nostalgic' | 'wistful' | 'apologetic' | 'hesitant' | 'insecure' | 'confused' | 'resigned' | 'anxious' | 'panicked' | 'alarmed' | 'scared' | 'proud' | 'confident' | 'distant' | 'skeptical' | 'contemplative' | 'determined'
    - `network_simulation` object
      - `packet_loss` number
      - `jitter` number
      - `latency` number
    - `message_plan` object
      - `idle_messages_enabled` boolean: False disables idle check-ins; true restores the default check-in for the personality language. Omit to preserve the current setting.
      - `idle_timeout_seconds` integer
      - `idle_message_max_spoken_count` integer
    - `start_speaking_plan` number
    - `stop_speaking_plan` object, nullable
      - `num_words` integer
      - `voice_seconds` number
      - `backoff_seconds` number
    - `background_sound_volume` object, nullable
      - `base` number
      - `reduced` number
    - `voice_volume` string, nullable
    - `effective_voice_volume` string
    - `patronus_settings` unknown
    - `provider_agent_id` string: Provider agent ID Example: `"assistant_123"`
    - `is_starred` boolean: Whether the personality is starred
    - `is_hidden` boolean: Whether the personality is hidden

## Changes

- **2026-11-03** `a6fb6a739212`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cekura/apis/cekura-api/changes/test_framework/v2/aiagents/:id/personalities/get.md)

---

[API](https://skmtc.dev/cekura/apis/cekura-api.md) - [All operations](https://skmtc.dev/cekura/apis/cekura-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cekura/apis/cekura-api/revisions/a6fb6a739212?raw)