Sign in

v51

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

Manually run evals for a workforce component (no deploy). Defaults to the env worktree so uncommitted evals are included; pass source=git for a clean extract.

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

Path parameters

org_idstring required
project_idstring required
env_idstring required

Request body

component_idstring nullable

Workforce component by numeric app id (the TIMBAL_APP_ID value; number or string). At least one of component_id / component_uid is required; when both are set, they must resolve to the same component.

component_uidstring nullable

Workforce component by manifest uid (the _id in timbal.yaml).

revstring nullable

Git rev to extract when source = "git" (branch, tag, or SHA). Defaults to the env's tracked branch. Rejected when source = "worktree".

source'worktree' | 'git'

Where to read the component source + eval YAML from for a manual run.

Response

Eval run started

eval_run_idstring required

Id of the created eval run. Stream GET .../evals/runs/{eval_run_id}/events or poll GET .../evals/runs/{eval_run_id}.

statusstring required

Always running at accept time.