Skip to main content
POST
Create and provision the session's one training run.

Authorizations

Authorization
string
header
required

Whitney-issued API key. No organization-selection header is accepted.

Path Parameters

session_id
string
required
Pattern: ^wts_[0-9a-f]{32}$

Body

application/json

Full tuning with a LoRA configuration is invalid. Current qualified v1 capability rows only admit LoRA.

request_id
string
required
Required string length: 1 - 200
base_model
string
required
Required string length: 1 - 256
model_revision
string | null
Required string length: 7 - 128
tuning_mode
enum<string>
default:lora
Available options:
lora,
full
lora
object | null

At least one train_* field must be true.

checkpoint_id
string | null
Pattern: ^wtc_[0-9a-f]{32}$
metadata
object

Response

The run was created or an idempotent equivalent was returned.

id
string
required
Pattern: ^wtr_[0-9a-f]{32}$
session_id
string
required
Pattern: ^wts_[0-9a-f]{32}$
status
enum<string>
required
Available options:
created,
running,
poisoned,
finishing,
finished,
cancel_requested,
cancelled,
failed,
interrupted,
timed_out
base_model
string
required
model_revision
string | null
required
resource_profile
string
required
tuning_mode
enum<string>
required
Available options:
lora,
full
checkpoint_id
string | null
required
Pattern: ^wtc_[0-9a-f]{32}$
next_seq_id
integer
required
Required range: x >= 1
sampler_id
string | null
required
Pattern: ^wtsm_[0-9a-f]{32}$
latest_weight_version
integer
required
Required range: x >= 0
error_code
string | null
required
created_at
string<date-time>
required
updated_at
string<date-time>
required