---
title: "Update an assistant test"
method: PUT
path: "/ai/assistants/tests/{test_id}"
tags: ["Assistants"]
---

# Update an assistant test

`PUT /ai/assistants/tests/{test_id}`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/ai/assistants/tests/{test_id}`
- Auth: HTTP bearer

Updates an existing assistant test configuration with new settings

## Path parameters

- `test_id` string, required

## Request body

- UpdateAssistantTestRequest: Request model for updating an existing assistant test. All fields are optional, allowing partial updates of test configuration. Only provided fields will be updated, others remain unchanged.
  - `name` string: Updated name for the assistant test. Must be unique and descriptive.
  - `description` string: Updated description of the test's purpose and evaluation criteria.
  - `telnyx_conversation_channel` 'phone_call' | 'web_call' | 'sms_chat' | 'web_chat'
  - `destination` string: Updated target destination for test conversations.
  - `max_duration_seconds` integer: Updated maximum test duration in seconds.
  - `test_suite` string: Updated test suite assignment for better organization.
  - `instructions` string: Updated test scenario instructions and objectives.
  - `rubric` object[]: Updated evaluation criteria for assessing assistant performance.
    - `name` string, required: Label for the evaluation criterion, e.g., Empathy, Accuracy, Clarity.
    - `criteria` string, required: Specific guidance on how to assess the assistant’s performance for this rubric item.

## Response `200`

Returns the updated test configuration with all changes applied

- AssistantTestResponse: Response model containing complete assistant test information. Returns all test configuration details including evaluation criteria, scheduling, and metadata. Used when retrieving individual tests or after creating/updating tests.
  - `test_id` string, uuid, required: Unique identifier for the assistant test.
  - `name` string, required: Human-readable name of the test.
  - `description` string: Detailed description of the test's purpose and scope.
  - `telnyx_conversation_channel` 'phone_call' | 'web_call' | 'sms_chat' | 'web_chat', required
  - `destination` string: Target destination for test conversations.
  - `max_duration_seconds` integer: Maximum allowed duration for test execution in seconds.
  - `test_suite` string: Test suite grouping for organizational purposes.
  - `instructions` string: Detailed test scenario instructions and objectives.
  - `rubric` object[], required: Evaluation criteria used to assess test performance.
    - `name` string, required: Label for the evaluation criterion, e.g., Empathy, Accuracy, Clarity.
    - `criteria` string, required: Specific guidance on how to assess the assistant’s performance for this rubric item.
  - `created_at` string, date-time, required: Timestamp when the test was created.

## Other responses

- `422`: Validation Error

---

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