List test results
Changed onList test results.
To filter by status, use results_retrieve(id=result_id) and inspect status directly (running while in progress; completed, failed, timeout or cancelled once finished) — there is no list-level status filter.
Result status: a result marked failed indicates infrastructure failures (e.g. connection errors, websocket handshake failures), not metric evaluation failures. success_runs_count counts completed runs that passed; failed_runs_count counts completed runs that failed evaluation, so runs that errored, timed out or were cancelled are in neither. See results_retrieve().failed_reasons for the breakdown.
Scenarios filter note: filtering by scenarios may return duplicate result rows when a result contains multiple runs of the same scenario — deduplicate by result.id if needed.
After triggering a run, poll results_retrieve(id=result_id) until status is completed, failed, timeout or cancelled. A result stays non-terminal until every run has ended, then becomes completed if any run completed — even if runs failed their checks or others errored. To gate, require success_runs_count == total_runs_count (failed_runs_count counts only completed runs that failed evaluation). For outbound runs, each run's outbound_dial_window_closes_at shows the deadline by which your agent must dial in.
Request
- Base URLhttps://api.cekura.ai
- URLhttps://api.cekura.ai/test_framework/v2/results/
- Auth
- API key in header X-CEKURA-API-KEY
- or HTTP bearer
- or HTTP bearer
- or API key in header X-VOCERA-SHAREABLE-LINK-TOKEN
- or HTTP bearer
Query parameters
A page number within the paginated result set.
Number of results to return per page.
Filter by agent ID
Filter by project ID
Filter by Result name
Filter by scenario IDs — comma-separated string (e.g. '24270,24271'), not a JSON array.
Tenant scope. Supply one of agent_id, assistant_id, project_id when authenticating with a user session or OAuth bearer token; omit when using an API key already scoped to the tenant.
Response
Example response
{
"count": 123,
"next": "https://api.cekura.ai/example/v1/example-external/?page=4",
"previous": "https://api.cekura.ai/example/v1/example-external/?page=3"
}Changes
- info
endpoint added
- info