Fine-tuning

Pause a fine-tune job.

post/fine_tuning/jobs/{fine_tuning_job_id}/pause

Path parameters

fine_tuning_job_idstring required

Example:ft-AF1WoRqd3aJAHsqc9NY7iL8F

The ID of the fine-tuning job to pause.

Response

idstring required

The object identifier, which can be referenced in the API endpoints.

created_atinteger required

The Unix timestamp (in seconds) for when the fine-tuning job was created.

fine_tuned_modelstring nullable required

The name of the fine-tuned model that is being created. The value will be null if the fine-tuning job is still running.

finished_atinteger nullable required

The Unix timestamp (in seconds) for when the fine-tuning job was finished. The value will be null if the fine-tuning job is still running.

modelstring required

The base model that is being fine-tuned.

object'fine_tuning.job' required

The object type, which is always "fine_tuning.job".

organization_idstring required

The organization that owns the fine-tuning job.

result_filesstring[] required

The compiled results file ID(s) for the fine-tuning job. You can retrieve the results with the Files API.

The current status of the fine-tuning job, which can be either validating_files, queued, running, succeeded, failed, or cancelled.

trained_tokensinteger nullable required

The total number of billable tokens processed by this fine-tuning job. The value will be null if the fine-tuning job is still running.

training_filestring required

The file ID used for training. You can retrieve the training data with the Files API.

validation_filestring nullable required

The file ID used for validation. You can retrieve the validation results with the Files API.

seedinteger required

The seed used for the fine-tuning job.

estimated_finishinteger nullable

The Unix timestamp (in seconds) for when the fine-tuning job is estimated to finish. The value will be null if the fine-tuning job is not running.

metadataMetadata nullable

Set of 16 key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format, and querying for objects via API or the dashboard.

Keys are strings with a maximum length of 64 characters. Values are strings with a maximum length of 512 characters.

Changes

Changed in 2 of the 90 revisions of this API.27

Aug 5, 2026ab0c5306e39026See the full diff
- ●
  added the new max enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new max enum value to the //////// response property for the response status
  response-property-enum-value-added
- ○
  added the optional property ///////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property //////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property //////////// to the response with the status
  response-optional-property-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 13, 202674cbcf73838f1See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 40 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history