---
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}`

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.net/team-telnyx/apis/telnyx-api.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api/revisions/e32d46c5945b/schema)