Sign in

v1

latestOpenAPI 3.1.0MIT2026-07-13174391.2 KB
Reflex

Retrieve a job

Poll a job until status is succeeded, failed, or cancelled. On success, fine_tuned_model is the name you predict against.

get/v1/fine_tuning/jobs/{job_id}

Path parameters

job_idstring required

Response

The job.

idstring

Job id, prefixed ftjob-.

objectstring
modelstring

What the job trained from: the reflex you warm-started from, or the from-scratch base for a cold start.

created_atinteger

Unix timestamp (seconds) at creation.

finished_atinteger nullable

Unix timestamp at a terminal state, else null.

fine_tuned_modelstring nullable

Served model name once succeeded (the suffix, or the job id if none).

status'queued' | 'validating_files' | 'running' | 'succeeded' | 'failed' | 'cancelled'

validating_files is the data-prep phase for generate/label_data jobs.

labelsstring[]
trained_examplesinteger

Number of training examples.

suffixstring nullable

Example response

{
  "id": "ftjob-a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
  "object": "fine_tuning.job",
  "model": "guardrail",
  "created_at": 1780107000,
  "finished_at": 1780107148,
  "fine_tuned_model": "support-classifier",
  "status": "succeeded",
  "labels": [
    "billing",
    "bug"
  ],
  "trained_examples": 10,
  "hyperparameters": {
    "n_epochs": 3,
    "batch_size": "auto",
    "learning_rate_multiplier": "auto"
  },
  "result": {
    "accuracy": 0.95,
    "f1_score": 0.94
  },
  "suffix": "support-classifier"
}