Sign in
felix

Get Training Job

Get a specific training job by ID.

get/felix/training-jobs/{job_id}

Path parameters

job_idstring required

Response

Successful Response

idstring required
user_idstring required
project_idstring nullable

Project ID this training job is associated with

model_namestring nullable
base_modelstring required
validation_data_percentagenumber required
nr_epochsinteger required
learning_ratenumber required
batch_sizeinteger required
seedinteger nullable

Effective reproducibility seed for Modal decoder training. Null for Fireworks, unknown, and other providers that cannot honor this contract.

trained_model_pathstring nullable
job_referencestring nullable
instance_typestring nullable
statusstring required
normalized_statusstring nullable

Canonical status alias for compatibility handling (requested, running, complete, deployed, failed, cancelled)

is_terminal_statusboolean nullable

Whether this status is terminal for polling loops

error_messagestring nullable
created_atstring required
updated_atstring required
started_atstring nullable
completed_atstring nullable
model_auto_selectedboolean nullable
model_selection_reasonstring nullable
task_typestring nullable

Task type derived from training datasets: 'ner', 'classification', 'custom', or 'decoder'

training_typestring nullable

Raw training method as persisted: 'lora', 'qlora', or 'full'.

model_kind'lora' | 'full' nullable

Normalized fine-tune kind: 'lora' for adapters (lora/qlora) or 'full' for merged weights. Null when the persisted training type is unrecognised -- clients must not claim a kind in that case.

artifact_readyboolean nullable

Whether an artifact location is recorded, so there is something to serve.

provider_readyboolean nullable

Whether a provider is already serving this artifact. False is not a deployment blocker: promotion provisions or re-warms a provider.

is_deployableboolean nullable

Whether this job passes server-side deployability validation for its own project. Authoritative -- the same check the deployment endpoints enforce.

deployability_reasonstring nullable

Why the job is not deployable (e.g. 'job_incomplete', 'missing_artifact', 'provider_incompatible'). Null when deployable.

labelsstring[] nullable

Merged labels from training datasets (entity types for NER, class labels for classification)

examplestring nullable

Sample text to pre-load into inference input

metricsobject nullable

Training and evaluation metrics dictionary. Contains final_training_loss, final_validation_loss, best_validation_loss from training logs, and optional evaluation metrics (f1_score, precision_score, recall_score, accuracy) if an evaluation has been run.

version_numberstring nullable

Version number for this training job (e.g., '1', '2', '3')

root_job_idstring nullable

ID of the original/root training job this version derives from

provider_deploymentsobject nullable

Provider-specific deployment metadata written by the training monitor, keyed by provider: {"modal": {...}}.

provider_namestring nullable

Training provider that handled this job (e.g. 'modal'). Jobs predating a provider removal carry an 'archived_<provider>' label.

progress_percentinteger nullable

Overall training completion percentage (0-100). Updated live during training.

current_epochinteger nullable

Epoch currently in progress (1-indexed). Updated live during training.

deployment_statusstring nullable required

Deprecated. Always returns None -- deployment_status no longer exists.

Kept for backward compat with clients that read this field.