test-runs

Get sanitized step-by-step execution trace for a test run

Return the ordered list of user-facing actions the agent performed during a test run. Internal agent reasoning, supervisor bookkeeping, and raw screenshot/overlay artifacts are filtered out — this is the same subset the app.qualgent.ai test-run detail page renders as "steps".

**Path Parameters:**
- `test_run_id`: The unique identifier of the test run

**Returns:**
- Ordered array of step objects (`step_number`, `action`, `result`,
  `error_message`, `timestamp`).
- Empty array if the run is queued/running with no steps recorded yet.

**Authorization:**
- Only returns steps for test runs belonging to your organization.

get/v1/test-runs/{test_run_id}/steps

Path parameters

test_run_idstring required

Headers

x-api-keystring

Response

Successfully retrieved test run steps

step_numberinteger required

1-indexed position of this step in the sanitized trace

actionstring required

Human-readable description of what the agent did

resultstring required

Outcome of the step

error_messagestring nullable

Error text if the step failed; null otherwise.

timestampstring required

ISO-8601 timestamp when the step was recorded.

Example response

[
  {
    "step_number": 1,
    "action": "Tapped at (540, 1944)",
    "result": "success",
    "error_message": "Element not found: 'Submit'",
    "timestamp": "2026-04-13T12:34:56.789Z"
  }
]

Changes

No recorded changes to this endpoint across all 1 revision of this API.