Skip to main content
POST
/
v1
/
repo
/
{repo_name}
/
targets
/
{target_name}
/
stim
Run Stim
curl --request POST \
  --url http://localhost:8080/v1/repo/{repo_name}/targets/{target_name}/stim \
  --header 'Authorization: Bearer <token>'
{
  "config": {
    "generators": [
      {
        "model": "claude-3-5-sonnet-20241022",
        "numq": 10,
        "temperature": 1,
        "type": "oneshot_qs"
      }
    ],
    "u": "system_prompt_v1",
    "v": "user_prompt_v1"
  },
  "lines": 150,
  "status": "complete"
}

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

Stim job execution status

Inherits all fields from JobStatus. Separated from RolloutResponse for future extensibility (e.g., generator-specific metadata).

​
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