Start Training (v1)

Start a new v1 training job.

POST /api/v1/training

cURL

curl --request POST \
  --url 'http://localhost:8000/api/v1/training' \
  --header "Authorization: Bearer $STATESET_AGENTS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompts": [
    "string"
  ],
  "strategy": "computational",
  "num_iterations": 1,
  "idempotency_key": "req_01J9X4Q8M2ZK7V3N"
}'

200

{
  "job_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "pending"
}

Start a new v1 training job.

Request body

TrainingRequestV1

prompts · string[] · required

Training prompts

strategy · string

Training strategy

num_iterations · integer

Number of training iterations

idempotency_key · string,null

Optional idempotency key for safe retries

Response

TrainingCreateResponseV1

job_id · string · required

status · string · required

Status codes

Code	Meaning
200	Successful response
202	Successful Response
401	Authentication required
422	Validation Error
429	Rate limit exceeded

cURL

curl --request POST \
  --url 'http://localhost:8000/api/v1/training' \
  --header "Authorization: Bearer $STATESET_AGENTS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompts": [
    "string"
  ],
  "strategy": "computational",
  "num_iterations": 1,
  "idempotency_key": "req_01J9X4Q8M2ZK7V3N"
}'

200

{
  "job_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "pending"
}