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

# List test agents

`GET /ai/tests/test_framework/v1/aiagents`

## Request

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

Returns a paginated list of test agents in your organization. A test agent wraps the Telnyx AI assistant under test and drives simulated callers against it.

## Query parameters

- `page` integer
- `page_size` integer

## Response `200`

Paginated list of test agents.

- TestAgentListResponse
  - `count` integer, required
  - `next` string, uri, nullable, required: Link to the next page of results, or null.
  - `previous` string, uri, nullable, required: Link to the previous page of results, or null.
  - `results` TestAgent[], required
    - `id` integer, required
    - `agent_name` string, required: Name of the test agent.
    - `contact_number` string: Contact phone number for the test agent.
    - `inbound` boolean: Whether the test agent accepts inbound calls.
    - `description` string
    - `language` string: ISO language code the test agent converses in.
    - `assistant_id` string, required: ID of the Telnyx AI assistant under test.
    - `chat_assistant_id` string: ID of the chat assistant under test, when testing text channels.
    - `llm_system_prompt` string
    - `llm_model` string: Model used to drive the test agent's side of the conversation.
    - `llm_temperature` number
    - `llm_max_tokens` integer
    - `outbound_auto_call` boolean
    - `sip_endpoint` string
    - `sip_auth` object, nullable
    - `knowledge_base_files` unknown[]: Knowledge-base files associated with the test agent.
      - unknown
    - `enabled_personalities` integer[]: IDs of the test personalities enabled for this agent.
    - `auto_update_dropoff_nodes` boolean
    - `auto_update_topic_nodes` boolean
    - `hallucination_metric_kb_files` integer[]
    - `outbound_numbers` unknown[], nullable: Outbound numbers associated with the test agent.
      - unknown
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, 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/aiagents/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)