---
title: "Run evaluator scenarios"
method: POST
path: "/ai/tests/test_framework/v1/scenarios/run_scenarios"
tags: ["AI Tests"]
---

# Run evaluator scenarios

`POST /ai/tests/test_framework/v1/scenarios/run_scenarios`

## Request

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

Runs the selected evaluator scenarios against their test agents and creates a run batch. Returns the ID of the created batch, whose results can be listed with the test-run-results endpoints.

## Request body

- RunScenariosRequest
  - `agent_id` integer
  - `assistant_id` string
  - `scenarios` union: Scenario IDs to run, or the literal string 'all'.
    - unknown[]
      - unknown
    - string
  - `tags` string[]
  - `frequency` integer
  - `name` string
  - `outbound_phone_number` string
  - `personality_ids` integer[]
  - `test_profile_ids` integer[]
  - `mode` 'same_number' | 'different_numbers'
  - `agent_number` string
  - `concurrency_limit` integer: Maximum number of concurrent simulated calls.

## Response `200`

Run batch created.

- RunScenariosResponse
  - `status` string, required: Initial status of the run batch.
  - `id` integer, required: ID of the created test-run batch whose results can be polled.

## 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/scenarios/run_scenarios/post.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)