---
title: "List test personalities"
method: GET
path: "/ai/tests/test_framework/v1/personalities"
tags: ["AI Tests"]
---

# List test personalities

`GET /ai/tests/test_framework/v1/personalities`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/ai/tests/test_framework/v1/personalities`
- Auth: HTTP bearer

Returns the catalogue of test personalities available to your organization. A personality describes how a simulated caller speaks: prompt, language, accent, voice, interruption level, and call-behaviour settings.

## Response `200`

List of test personalities.

- TestPersonality[]
  - `id` integer, required
  - `forked_from` integer, nullable: ID of the personality this one was forked from.
  - `organization` integer, nullable
  - `project` integer, nullable
  - `name` string, required: Display name of the personality.
  - `prompt` string, required: Instructions the simulated caller follows.
  - `language` string, required: ISO language code the simulated caller speaks.
  - `accent` string
  - `background_noise` string, nullable
  - `interruption_level` string, nullable: How aggressively the personality interrupts the assistant.
  - `speed` union
    - number
    - string
  - `generation_config` object, nullable
  - `network_simulation` object, nullable
  - `message_plan` object, nullable: Idle-timeout plan for messages during a call.
  - `start_speaking_plan` union
    - number
    - object
  - `stop_speaking_plan` object, nullable
  - `background_sound_volume` number, nullable
  - `voice_volume` number, nullable
  - `effective_voice_volume` number, nullable
  - `end_call_enabled` boolean, required

## Other responses

- `400`: Bad Request. The AI Tests service rejected the request.
- `401`: Unauthorized. Missing or invalid API key.
- `404`: Not Found. The requested resource does not exist or is not enabled for your account.
- `422`: Unprocessable Entity. A validation error occurred.
- `429`: Too Many Requests. The AI Tests service rate-limited the request.
- `503`: Service Unavailable. The AI Tests service is unavailable.

## Changes

> 152 revisions in range; 1 not diffed.

- **2026-10-22** `09b2e45a88da`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/ai/tests/test_framework/v1/personalities/get.md)

---

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