Skip to main content
POST
/
v1
/
repo
/
{repo_name}
/
targets
/
{target_name}
/
rollout
Run Rollout
curl --request POST \
  --url http://localhost:8080/v1/repo/{repo_name}/targets/{target_name}/rollout \
  --header 'Authorization: Bearer <token>'
{
  "config": {
    "max_concurrency": 50,
    "max_tokens": 150,
    "model_name": "Qwen/Qwen3-32B",
    "num_traj_per_stimulus": 5,
    "temperature": 1
  },
  "lines": 75,
  "status": "running",
  "total_expected": 150
}

Authorizations

​
Authorization
string
header
required

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

Headers

​
X-User-Id
string | null

User ID override via header (requires master API key)

Path Parameters

​
repo_name
string
required
​
target_name
string
required

Query Parameters

​
user_id
string | null

User ID override (requires master API key)

Response

Successful Response

Rollout job execution status

Inherits all fields from JobStatus. Separated from StimResponse for future extensibility (e.g., model checkpoint paths, inference metrics).

​
status
string
required

Job status: not_started, running, complete, failed

​
lines
integer | null

Number of output lines (not applicable for bakes)

​
config
Config · object

Job config parameters

​
error
string | null

Error message if job failed

​
job_id
integer | null

Coordinator job ID (if job is queued/running)

​
progress_percent
number | null

Job progress percentage (0-100) if job is running

​
total_expected
integer | null

Total expected number of rollouts (num_stimuli * num_traj_per_stimulus). Used for progress calculation.