fine-tuning

Cancel a job

Stop a queued or running job. status becomes cancelled.

post/v1/fine_tuning/jobs/{job_id}/cancel

Path parameters

job_idstring required

The ftjob- prefixed id of a queued or running job.

Example:ftjob-a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d

Identifies the job to stop.

Response

The cancelled job.

idstring required

Job id, prefixed ftjob-.

objectstring required

Always fine_tuning.job.

modelstring required

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

created_atinteger required

Unix timestamp (seconds) at creation.

finished_atinteger nullable required

Unix timestamp at a terminal state, else null.

fine_tuned_modelstring nullable required

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

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

labelsstring[] required

The classes this job trained on.

trained_examplesinteger required

Number of training examples.

suffixstring nullable required

The suffix supplied at creation, else null.

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
  },
  "error": null,
  "suffix": "support-classifier"
}

Changes

Changed in 1 of the 3 revisions of this API.232

Aug 13, 2026b9a74274b2ab232See the full diff
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ○
  api operation id cancelReflexJob removed and replaced with cancelFineTuningJob
  api-operation-id-removed
- ○
  the endpoint scheme security bearerAuth was added to the API
  api-security-added
- ○
  api tag fine-tuning added
  api-tag-added
- ○
  api tag Reflex removed
  api-tag-removed
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  the response property became required for the status
  response-property-became-required
- ○
  the response property became required for the status
  response-property-became-required
- ○
  the response property / became required for the status
  response-property-became-required
- ○
  the response property / became required for the status
  response-property-became-required
- ○
  the response property / became required for the status
  response-property-became-required
- ○
  the response property / became required for the status
  response-property-became-required
- ○
  the response property / became required for the status
  response-property-became-required
- ○
  the response property / became required for the status
  response-property-became-required
- ○
  the response property / became required for the status
  response-property-became-required
- ○
  the response property became required for the status
  response-property-became-required
- ○
  the response property became required for the status
  response-property-became-required
- ○
  the response property became required for the status
  response-property-became-required
- ○
  the response property / became required for the status
  response-property-became-required
- ○
  the response property / became required for the status
  response-property-became-required
- ○
  the response property / became required for the status
  response-property-became-required
- ○
  the response property became required for the status
  response-property-became-required
- ○
  the response property became required for the status
  response-property-became-required
- ○
  the response property became required for the status
  response-property-became-required
- ○
  the response property became required for the status
  response-property-became-required
- ○
  the response property became required for the status
  response-property-became-required
- ○
  the response property / became required for the status
  response-property-became-required
- ○
  the response property / became required for the status
  response-property-became-required
- ○
  the response property became required for the status
  response-property-became-required
- ○
  the response property became required for the status
  response-property-became-required
- ○
  the response property became required for the status
  response-property-became-required
This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history