---
title: "Get improve-scenarios progress"
method: GET
path: "/ai/tests/test_framework/v1/scenarios/scenario-agent-progress"
tags: ["AI Tests"]
---

# Get improve-scenarios progress

`GET /ai/tests/test_framework/v1/scenarios/scenario-agent-progress`

## Request

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

Returns the status of an improve-scenarios session started with the improve-evaluator-scenarios endpoint.

## Query parameters

- `progress_id` string, required

## Response `200`

Improvement session status.

- ImproveScenariosProgress
  - `progress_id` string
  - `session_id` integer, nullable
  - `mode` string
  - `status` string
  - `result` object, nullable
    - `success` boolean
    - `session_id` integer
    - `message` string
    - `cancelled` boolean
    - `needs_clarification` boolean
    - `clarification_questions` object[]
      - `question` string
    - `conversation_history` object[]
      - `role` string
      - `content` string
      - `timestamp` string
    - `updated_scenarios` object[]
  - `error` string, nullable

## 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/scenario-agent-progress/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)