v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-0318386446.4 KB

Start Optimization Job

Start an async job to run GEPA optimization on an arbiter. Uses annotated train/test predictions from ClickHouse to optimize the arbiter. Runs in an isolated Modal Sandbox for clean cancellation support.

The hub_jobs row is created before the sandbox starts so that the sandbox always has a row to update with logs and terminal state.

post/api/v1/jobs/gepa

Headers

authorizationstring nullable

Cookies

modaic_sessionstring nullable

Request body

arbiter_repostring required
arbiter_revisionstring
push_branchstring
push_tagstring nullable

Response

Successful Response

{"stackTrail":"paths:/api/v1/jobs/gepa:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}