Delete fine-tune checkpoint
Permanently delete a saved optimizer checkpoint. Requires write access to the destination model.
/v1/fine-tunes/{jobId}/checkpoints/{checkpointId}Authorization
Send a Modaic bearer token in the Authorization header.
Path Parameters
Fine-tune job ID.
Opaque ID returned by List fine-tune checkpoints. URL-encode it as a single path segment.
Deleting a paused job’s resume checkpoint prevents that job from resuming. A deleted checkpoint also becomes unavailable for new experiments using from_checkpoint.
Response
Returns 204 No Content with an empty body once deletion finishes.
Errors
-
409 checkpoint_in_usewhen a queued, running, or paused experiment still needs this job’s checkpoints. Finish or cancel those experiments before deleting checkpoints. -
409 job_transition_conflictwhile the job is active, except when it is paused. Pause the job or wait for it to finish before deleting a checkpoint. Resume and checkpoint deletion are serialized: deleting the resume checkpoint first prevents resume; resuming first blocks deletion while the job is active.
To stop an active or paused job and delete all its saved optimizer checkpoints, cancel the job.
Cancellation does not delete checkpoints from completed jobs. Delete each checkpoint through this endpoint to remove its retained storage.