---
title: "Get scenario-refinement progress"
method: GET
path: "/test_framework/v2/scenarios/scenario-agent-progress/"
tags: ["test_framework"]
---

# Get scenario-refinement progress

`GET /test_framework/v2/scenarios/scenario-agent-progress/`

## Request

- Base URL: `https://api.cekura.ai`
- URL: `https://api.cekura.ai/test_framework/v2/scenarios/scenario-agent-progress/`
- Auth: one of:
  - API key in header `X-CEKURA-API-KEY`
  - HTTP bearer
  - HTTP bearer

Check the progress of a scenario-instruction clarification request.

After calling POST /scenario-agent/, use the returned `progress_id` to poll this endpoint.

**Status values:**
- `in_progress` - AI is still working (keep polling)
- `completed` - AI finished; read the clarification in the `result` field
- `cancelled` - Request was cancelled
- `failed` - An error occurred; see `error` field

**Typical flow:**
1. POST /scenario-agent/ → receive `progress_id`
2. Poll this endpoint every few seconds
3. When `status == 'completed'`, feed the answers into `scenarios_generate_bg`

## Query parameters

- `progress_id` string, required

## Response `200`

- ScenarioAgentProgress: Response serializer for GET /scenario-agent-progress/?progress_id=... `status` lifecycle: - in_progress → LLM still running; poll again - completed → LLM finished; `result` holds the full response - needs_clarification → LLM needs a follow-up answer from the user - cancelled → user called /cancel-agent/ - failed → unrecoverable error; `error` is set
  - `progress_id` string, required
  - `session_id` integer, nullable, required
  - `mode` string, required: Always 'clarify'.
  - `status` string, required: in_progress | completed | needs_clarification | cancelled | failed
  - `result` object, nullable: ScenarioAgentResponseSerializer payload; null while status is in_progress
  - `error` string, nullable: Error message when status is failed

## Other responses

- `400`

## Changes

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

[Operation history](https://skmtc.dev/cekura/apis/cekura-api/changes/test_framework/v2/scenarios/scenario-agent-progress/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)