Training Jobs

List Training Jobs

get

List training jobs

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

pageinteger · min: 1OptionalDefault: 1

limitinteger · min: 1 · max: 100OptionalDefault: 10

statusany ofOptional

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

total_countintegerRequired

422

Validation Error

application/json

get

/training-jobs

HTTPcURLJavaScriptPython

GET /api/public/v1/training-jobs HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "jobs": [
    {
      "id": "text",
      "name": "text",
      "organization_id": "text",
      "status": "STARTING",
      "config": {
        "dataset": {
          "id": "text",
          "sample_ids": [
            "text"
          ],
          "prompt_template": "text"
        },
        "base_model": "text",
        "training_steps": 1,
        "batch_size": 1,
        "lora_rank": 1,
        "learning_rate": 1,
        "adam_beta1": 1,
        "adam_beta2": 1,
        "num_rollouts": 1,
        "max_response_length": 1,
        "start_idx": 1
      },
      "model_id": "text",
      "reward_history": [
        1
      ],
      "current_step": 1,
      "total_steps": 1,
      "cost_dollars": 1,
      "dataset_hf_repo": "text",
      "error_message": "text",
      "created_at": "2026-05-16T01:32:08.012Z",
      "updated_at": "2026-05-16T01:32:08.012Z"
    }
  ],
  "total_count": 1
}

Create Training Job

post

Create a new training job

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

nameany ofOptional

stringOptional

or

nullOptional

Responses

201

Successful Response

application/json

422

Validation Error

application/json

post

/training-jobs

HTTPcURLJavaScriptPython

POST /api/public/v1/training-jobs HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 268

{
  "name": "text",
  "config": {
    "dataset": {
      "id": "text",
      "sample_ids": [
        "text"
      ],
      "prompt_template": "text"
    },
    "base_model": "text",
    "training_steps": 1,
    "batch_size": 1,
    "lora_rank": 1,
    "learning_rate": 1,
    "adam_beta1": 1,
    "adam_beta2": 1,
    "num_rollouts": 1,
    "max_response_length": 1,
    "start_idx": 1
  }
}

{
  "id": "text",
  "name": "text",
  "organization_id": "text",
  "status": "STARTING",
  "config": {
    "dataset": {
      "id": "text",
      "sample_ids": [
        "text"
      ],
      "prompt_template": "text"
    },
    "base_model": "text",
    "training_steps": 1,
    "batch_size": 1,
    "lora_rank": 1,
    "learning_rate": 1,
    "adam_beta1": 1,
    "adam_beta2": 1,
    "num_rollouts": 1,
    "max_response_length": 1,
    "start_idx": 1
  },
  "model_id": "text",
  "reward_history": [
    1
  ],
  "current_step": 1,
  "total_steps": 1,
  "cost_dollars": 1,
  "dataset_hf_repo": "text",
  "error_message": "text",
  "created_at": "2026-05-16T01:32:08.012Z",
  "updated_at": "2026-05-16T01:32:08.012Z"
}

Estimate Training Cost

post

Estimate training cost before execution

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

Responses

200

Successful Response

application/json

total_cost_dollarsnumberRequired

prefill_tokensintegerRequired

sample_tokensintegerRequired

train_tokensintegerRequired

effective_stepsintegerRequired

notesstringRequired

warning_messageany ofOptional

stringOptional

or

nullOptional

422

Validation Error

application/json

post

/training-jobs/cost-estimation

HTTPcURLJavaScriptPython

POST /api/public/v1/training-jobs/cost-estimation HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 254

{
  "config": {
    "dataset": {
      "id": "text",
      "sample_ids": [
        "text"
      ],
      "prompt_template": "text"
    },
    "base_model": "text",
    "training_steps": 1,
    "batch_size": 1,
    "lora_rank": 1,
    "learning_rate": 1,
    "adam_beta1": 1,
    "adam_beta2": 1,
    "num_rollouts": 1,
    "max_response_length": 1,
    "start_idx": 1
  }
}

{
  "total_cost_dollars": 1,
  "prefill_tokens": 1,
  "sample_tokens": 1,
  "train_tokens": 1,
  "effective_steps": 1,
  "notes": "text",
  "warning_message": "text"
}

Get Training Job

get

Get a training job by ID

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

job_idstringRequired

Responses

200

Successful Response

application/json

idstringRequired

nameany ofOptional

stringOptional

or

nullOptional

organization_idstringRequired

statusstring · enumRequiredPossible values:

model_idany ofOptional

stringOptional

or

nullOptional

reward_historyany ofOptional

number[]Optional

or

nullOptional

current_stepany ofOptional

integerOptional

or

nullOptional

total_stepsany ofOptional

integerOptional

or

nullOptional

cost_dollarsany ofOptional

numberOptional

or

nullOptional

dataset_hf_repoany ofOptional

stringOptional

or

nullOptional

error_messageany ofOptional

stringOptional

or

nullOptional

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

422

Validation Error

application/json

get

/training-jobs/{job_id}

HTTPcURLJavaScriptPython

GET /api/public/v1/training-jobs/{job_id} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "text",
  "name": "text",
  "organization_id": "text",
  "status": "STARTING",
  "config": {
    "dataset": {
      "id": "text",
      "sample_ids": [
        "text"
      ],
      "prompt_template": "text"
    },
    "base_model": "text",
    "training_steps": 1,
    "batch_size": 1,
    "lora_rank": 1,
    "learning_rate": 1,
    "adam_beta1": 1,
    "adam_beta2": 1,
    "num_rollouts": 1,
    "max_response_length": 1,
    "start_idx": 1
  },
  "model_id": "text",
  "reward_history": [
    1
  ],
  "current_step": 1,
  "total_steps": 1,
  "cost_dollars": 1,
  "dataset_hf_repo": "text",
  "error_message": "text",
  "created_at": "2026-05-16T01:32:08.012Z",
  "updated_at": "2026-05-16T01:32:08.012Z"
}