---
title: "Retrieve a test agent"
method: GET
path: "/ai/tests/test_framework/v1/aiagents/{id}"
tags: ["AI Tests"]
---

# Retrieve a test agent

`GET /ai/tests/test_framework/v1/aiagents/{id}`

## Request

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

Returns the specified test agent.

## Path parameters

- `id` integer, required

## Response `200`

Test agent detail.

- TestAgent
  - `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/:id/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)