---
title: "List scenario improvement sessions"
method: GET
path: "/test_framework/v1/scenario-improvement-sessions/"
tags: ["Scenarios"]
---

# List scenario improvement sessions

`GET /test_framework/v1/scenario-improvement-sessions/`

## Request

- Base URL: `https://api.cekura.ai`
- URL: `https://api.cekura.ai/test_framework/v1/scenario-improvement-sessions/`
- Auth: one of:
  - API key in header `X-CEKURA-API-KEY`
  - HTTP bearer
  - HTTP bearer

List scenario-improvement sessions for a project. Each session tracks an AI-assisted refinement run over the project's scenarios. Requires `project_id`.

## Query parameters

- `project_id` integer

## Response `200`

- ScenarioImprovementSessionList[]
  - `id` integer
  - `title` string: Title for the session (auto-generated from first user message)
  - `project` integer, nullable
  - `scenario_ids` unknown
  - `status` 'pending' | 'in_progress' | 'completed' | 'cancelled' | 'failed': Current status of the improvement session * `pending` - Pending * `in_progress` - In Progress * `completed` - Completed * `cancelled` - Cancelled * `failed` - Failed
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `message_count` string

## Changes

- **2026-11-03** `a6fb6a739212`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cekura/apis/cekura-api/changes/test_framework/v1/scenario-improvement-sessions/get.md)

---

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