> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cekura.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Scenario Improvement Sessions

> List scenario-improvement sessions. Each session groups a multi-step scenario-agent improvement workflow and can be resumed via `scenario-improvement-sessions/{id}/`.



## OpenAPI

````yaml get /test_framework/v1/scenario-improvement-sessions/
openapi: 3.1.0
info:
  title: Cekura API
  version: v1
  description: >-
    Complete API documentation for the Cekura platform. This API provides
    endpoints for testing, observing, and evaluating AI voice agents — including
    managing agents, running evaluators, defining metrics, and analyzing call
    quality.
servers:
  - url: https://api.cekura.ai
security: []
paths:
  /test_framework/v1/scenario-improvement-sessions/:
    get:
      tags:
        - Scenarios
      summary: List scenario improvement sessions
      description: >-
        List scenario-improvement sessions for a project. Each session tracks an
        AI-assisted refinement run over the project's scenarios. Requires
        `project_id`.
      operationId: scenario-improvement-sessions-list
      responses:
        '200':
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ScenarioImprovementSessionList'
          description: ''
      security:
        - api_key: []
components:
  schemas:
    ScenarioImprovementSessionList:
      type: object
      description: ''
      properties:
        id:
          type: integer
          readOnly: true
        title:
          type: string
          description: Title for the session (auto-generated from first user message)
          maxLength: 255
        project:
          type:
            - integer
            - 'null'
        scenario_ids:
          description: List of scenario IDs being improved in this session
        status:
          enum:
            - pending
            - in_progress
            - completed
            - cancelled
            - failed
          type: string
          x-spec-enum-id: 834f792e06398501
          description: |-
            Current status of the improvement session

            * `pending` - Pending
            * `in_progress` - In Progress
            * `completed` - Completed
            * `cancelled` - Cancelled
            * `failed` - Failed
        created_at:
          type: string
          format: date-time
          readOnly: true
        updated_at:
          type: string
          format: date-time
          readOnly: true
        message_count:
          type: string
          readOnly: true
  securitySchemes:
    api_key:
      type: apiKey
      name: X-CEKURA-API-KEY
      in: header
      description: >-
        API Key Authentication. It should be included in the header of each
        request.

````