Sign in

v51

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

Enqueue a background eval job (today: generate_initial — Claude-generate an initial eval suite for a workforce component, written to the env branch's worktree).

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

Path parameters

org_idstring required
project_idstring required
env_idstring required

Request body

commitboolean

Commit the generated file to the env branch when the job succeeds. Default false: the file lands uncommitted in the worktree for review (manual runs see it; the deploy gate needs a commit).

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

guidancestring nullable

Optional steer for the generator, e.g. "focus on the refund flow".

kindstring nullable

Job kind. Defaults to "generate_initial" (the only kind today; the vocabulary grows server-side without new endpoints).

Response

Job enqueued

job_uidstring uuid required
kindstring required

Job kind (e.g. "generate_initial").

statusstring required

Always queued at accept time.