Get assistant test by ID

GET 
/ai/assistants/tests/:test_id

Retrieves detailed information about a specific assistant test

Path Parameters

test_id Test Idrequired

200: Returns complete test configuration including rubric, schedule, and metadata

application/json

• Schema
• Example (from schema)

Schema

test_id uuidrequired

Unique identifier for the assistant test.

name Name (string)required

Human-readable name of the test.

description Description (string)

Detailed description of the test's purpose and scope.

telnyx_conversation_channel TelnyxConversationChannel (string)required

Possible values: [phone_call, web_call, sms_chat, web_chat]

destination Destination (string)

Target destination for test conversations.

max_duration_seconds Max Duration Seconds (integer)

Maximum allowed duration for test execution in seconds.

test_suite Test Suite (string)

Test suite grouping for organizational purposes.

instructions Instructions (string)

Detailed test scenario instructions and objectives.

rubric

object[]

required

Evaluation criteria used to assess test performance.

Array [

name stringrequired

Label for the evaluation criterion, e.g., Empathy, Accuracy, Clarity.

criteria stringrequired

Specific guidance on how to assess the assistant’s performance for this rubric item.

]

Evaluation criteria used to assess test performance.

created_at date-timerequired

Timestamp when the test was created.

{
  "test_id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Customer Support Bot Test",
  "description": "string",
  "telnyx_conversation_channel": "phone_call",
  "destination": "string",
  "max_duration_seconds": 0,
  "test_suite": "string",
  "instructions": "string",
  "rubric": [
    [
      {
        "criteria": "Responds within 30 seconds",
        "name": "Response Time"
      }
    ]
  ],
  "created_at": [
    "2024-01-15T09:00:00Z"
  ]
}

422: Validation Error

application/json

• Schema
• Example (from schema)

Schema

detail

object[]

Array [

loc

object[]

required

Array [

anyOf

• MOD1
• MOD2

string

integer

]

msg Message (string)required

type Error Type (string)required

]

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Request samples

• cURL

---

curl -L 'https://api.telnyx.com/v2/ai/assistants/tests/:test_id' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

Response samples

• 200
• 422

---

{
  "test_id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Customer Support Bot Test",
  "description": "string",
  "telnyx_conversation_channel": "phone_call",
  "destination": "string",
  "max_duration_seconds": 0,
  "test_suite": "string",
  "instructions": "string",
  "rubric": [
    [
      {
        "criteria": "Responds within 30 seconds",
        "name": "Response Time"
      }
    ]
  ],
  "created_at": [
    "2024-01-15T09:00:00Z"
  ]
}

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}