Skip to main content
GET
Fetch a workflow-eval run by run_id. Use this while polling for lifecycle.status, then fetch the child results with List Eval Run Results.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

run_id
string
required

Response

Successful Response

A batch execution of a workflow's evals, with overall lifecycle, timing, and pass/fail counts.

id
string
required
workflow_id
string
required
workflow_version_id
string
required
trigger
EvalRunTrigger · object
required
lifecycle
PendingWorkflowEvalRun · object
required

The eval run has been created but execution has not started.

timing
WorkflowEvalRunTiming · object
required
total_evals
integer
required
target
EvalRunBlockTarget · object | null

Public workflow-eval target.

The storage layer remains block-scoped today, but the API shape names the tested entity explicitly so workflow-level targets can be added later.

eval_id
string | null
counts
BlockEvalBatchExecutionCounts · object

Aggregate counts for a batch of block-eval runs.

Each individual run contributes to exactly one lifecycle_counts bucket, and additionally to one outcome bucket when lifecycle_counts.completed is incremented.

freshness
EvalRunFreshness · object

Compatibility envelope only. WorkflowEval.freshness is the authoritative read-time staleness verdict for saved eval definitions.