Agenttests

Get Suite Run

Retrieve a suite run by ID with its child runs and the derived aggregate status and pass/fail/error counts.

Authentication

AuthorizationBearer

Enter your API key with the Bearer prefix, e.g. ‘Bearer sk_…’.

Path parameters

idstringRequired

Response

The suite run with its child runs.
idstring

Prefixed wire identifier (srun_<26 char Crockford base32>).

triggerenum

Which entry point created a suite run.

  • run_all - POST /v1/agents/{id}/tests/runs.
  • batch - POST /v1/agents/tests/runs/batch.
  • resubmit - POST /v1/agents/tests/suite-runs/{id}/resubmit.
statusenum

Lifecycle of a test run: queued - running - terminal.

Terminal states:

  • passed - the agent behaviour met the success criteria.
  • failed - the agent behaviour did not meet the success criteria.
  • error - the runner itself could not complete (LLM outage, network error, etc.), distinct from failed which means the agent behaviour was judged and found lacking.
total_runsinteger
Number of child runs in the suite.
passed_countinteger
failed_countinteger
errored_countinteger
pending_countinteger
Child runs still queued or running.
created_atdatetime
runslist of objects
agent_idstring or null

Prefixed agent_<crockford> id of the agent whose suite was run. Set for the run_all trigger; null for batch, which can span many agents.

agent_namestring or null

Display name of agent_id’s agent, resolved at read time. Null whenever agent_id is null, and on the suite run embedded in run/resubmit creation responses.

parent_suite_run_idstring or null

Set on a resubmit: the prefixed srun_<crockford> id of the suite run whose failed/errored tests this one re-ran. Null for run_all and batch.

completed_atdatetime or null

Newest child-run completion; null until every child run is terminal.

config_overrideobject or null

The run-level config override this suite was run with, or null for an ordinary Run All / batch.

flow_version_idstring or null

The flow version (agent_versions row) this suite targeted, or null for the agent’s active / synthesized flow.

flow_version_numberinteger or null

Human-facing version number of flow_version_id; null when no version was targeted.

Errors

401
Unauthorized Error
404
Not Found Error