---
title: "GET /test_framework/v1/personalities/"
method: GET
path: "/test_framework/v1/personalities/"
tags: ["test_framework"]
---

# GET /test_framework/v1/personalities/

`GET /test_framework/v1/personalities/`

List personalities available for use in your evaluators.

Returns personalities owned by your organization plus globally available personalities.

**Filters:**
- `language` — filter by language code (e.g. `en`, `es`)
- `project_id` — filter to personalities owned by a specific project

**Using personality IDs in evaluators:** globally available personalities (those with no project or organization owner) work across all projects. Organization-specific personalities are only usable within their own organization.

Performance tip: this endpoint can return large payloads. When you know the language of the agent in scope, try passing `language` (e.g. `en`, `es`) to narrow the result. Passing `project_id` from your workspace context also helps when you only need scoped personalities. If you genuinely need every personality, you can omit filters.

## Query parameters

- `language` string
- `project_id` integer

## Response `200`

- CreatePersonality[]
  - `id` integer
  - `project` integer — Project that will own the personality. Optional when using a project-scoped API key (it is inferred from the key); required otherwise. Example: `1`
  - `name` string, required — Name of the personality Example: `"Customer Service"`
  - `prompt` string — 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' | 'ko' | 'ms' | 'ml' | 'mr' | 'multi' | 'no' | 'pl' | 'pa' | 'pt' | 'ro' | 'ru' | 'sk' | 'es' | 'sv' | 'th' | 'tr' | 'tl' | 'ta' | 'te' | 'uk' | '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 * `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 * `vi` - Vietnamese
  - `accent` string — Accent of the personality Example: `"American"`
  - `background_noise` string, required — Background noise
  - `voice_model` string, required — 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.5". 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, nullable — 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, nullable — 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 — Whether the end call is enabled
  - `provider` '11labs' | 'cartesia' — Provider of the voice * `11labs` - Elevenlabs * `cartesia` - Cartesia

---

[API](https://skmtc.net/cekura/apis/cekura-api.md) · [All operations](https://skmtc.net/cekura/apis/cekura-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cekura/cekura-api/versions/d08e85615b58/schema)