test_framework

List test results

Changed on

List 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.

get/test_framework/v2/results/

Request

  • Base URL
    https://api.cekura.ai
  • URL
    https://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

pageinteger

A page number within the paginated result set.

page_sizeinteger

Number of results to return per page.

agent_idinteger

Filter by agent ID

project_idinteger

Filter by project ID

searchstring

Filter by Result name

scenariosstring

Filter by scenario IDs — comma-separated string (e.g. '24270,24271'), not a JSON array.

assistant_idstring

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

countinteger

Only present when the request passes include_count=true. Capped at 10000: when count_capped is true, the true total exceeds 10000.

count_cappedboolean

Only present alongside count.

nextstring uri nullable
previousstring uri nullable

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