Skip to main content
POST
/
fine_tuning
/
jobs
/
{id}
/
resume
curl -X POST https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs/your-job-id/resume \
  -H "Authorization: Bearer $ATAI_API_KEY"

{
  "object": "fine_tuning.job",
  "id": "your-job-id",
  "name": "my-tune",
  "model": "newton",
  "created_at": 1765201323,
  "org_id": "your-org",
  "status": "PENDING",
  "checkpoint_id": "ckp_...",
  "fine_tuned_model": null,
  "finished_at": null,
  "outcome": null,
  "seed": 42,
  "user_provided_suffix": "v2",
  "training_files": ["fil_..."],
  "validation_files": ["fil_..."],
  "errors": []
}
Requires version 1.1.5 or later of the Archetype platform.

​
Overview

Resumes a paused or failed fine-tuning job, continuing from the most recent checkpoint.

​
Request

​
id
string
required
The ID of the fine-tuning job to resume. This is a TypeID-encoded identifier with the FineTuningJobId prefix.

​
Response

Returns a description of the fine-tuning job after resuming it.
​
object
string
required
The object type. Always fine_tuning.job.
​
id
string
required
The unique identifier of the fine-tuning job.
​
name
string
required
The human-readable name supplied when the job was created.
​
model
string
required
The base model being fine-tuned.
​
created_at
integer
required
The Unix timestamp (in seconds) at which the job was created.
​
org_id
string
required
The organization that owns the job.
​
status
string
required
The job’s current lifecycle stage. One of PENDING, ADMITTED, RUNNING, COMPLETED, FAILED, PREEMPTED, CANCELLED, PAUSED, INTERRUPTED.
​
training_files
array
required
Identifiers of the files used to train the model.
​
validation_files
array
required
Identifiers of the files used to evaluate the model during training.
​
errors
array
required
Failure details when the job has failed, as the platform error envelope (a list of {code, message, suggestion, error_uid}). Empty while the job is queued or running, or on success.
​
checkpoint_id
string
The checkpoint ID of the checkpoint from which the job was started (not the checkpoint from which the job was resumed), or null if it trained from the base model.
​
fine_tuned_model
string
The name of the model produced by the job, available once training has succeeded; null until then.
​
finished_at
integer
The Unix timestamp (in seconds) at which the job finished, or null if it is not yet complete.
​
outcome
string
For a COMPLETED job, this indicates whether it succeeded fully (SUCCESS), partially (PARTIAL), or produced nothing (FAILED). This is null for any non-completed status.
​
seed
integer
The random seed used for the job.
​
user_provided_suffix
string
The suffix supplied on the request, applied to the fine-tuned model’s name.
curl -X POST https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs/your-job-id/resume \
  -H "Authorization: Bearer $ATAI_API_KEY"

{
  "object": "fine_tuning.job",
  "id": "your-job-id",
  "name": "my-tune",
  "model": "newton",
  "created_at": 1765201323,
  "org_id": "your-org",
  "status": "PENDING",
  "checkpoint_id": "ckp_...",
  "fine_tuned_model": null,
  "finished_at": null,
  "outcome": null,
  "seed": 42,
  "user_provided_suffix": "v2",
  "training_files": ["fil_..."],
  "validation_files": ["fil_..."],
  "errors": []
}