v51

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01206322659.2 KB
projects

List eval runs (deploy-gate and manual executions) for an environment.

get/orgs/{org_id}/projects/{project_id}/envs/{env_id}/evals/runs

Path parameters

org_idstring required
project_idstring required
env_idstring required

Query parameters

component_idstring nullable

Filter to a single workforce component by its numeric app id (the value the SDK reads from TIMBAL_APP_ID, also returned as component.id on each run). Combines with component_uid: when both are set, rows must match both.

component_uidstring nullable

Filter to a single workforce component by its manifest uid (the _id field in timbal.yaml, also returned as component.uid on each run). Display name is deliberately not accepted as a filter — it's user-editable and not guaranteed unique within a project.

triggerstring nullable

Optional trigger filter. Accepts:

  • latest — runs from the env's most recent deploy batch.
  • a UUID — runs from that deploy batch.
trigger_typestring nullable

Filter by what started the run: deploy (gate), manual (POST .../evals/runs), or push (deploy_config.evals_on_push CI runs). Orthogonal to trigger (a deploy-batch selector).

statusstring nullable

Filter by run status: running, passed, failed, or error.

include_logsboolean

Include the captured CLI stdout/stderr in each run. Off by default — logs can be hundreds of KB per run.

include_resultsboolean

Include the structured per-eval results document in each run. Off by default for the same size reason as include_logs; the single-run GET always returns it.

limitinteger nullable

Max rows returned, newest first. Defaults to 50, capped at 200.

Response

Eval runs listed successfully