Skip to main content
POST
/
fine_tuning
/
jobs
/
{id}
/
pause
curl -X POST https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs/your-job-id/pause \
  -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": "PAUSED",
  "checkpoint_id": null,
  "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

Pauses a fine-tuning job, stopping the run; use Resume Job to continue it.
To cancel a job and tear down its resources without the ability to resume the job, use the Cancel Job endpoint instead.

​
Request

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

​
Response

Returns a description of the fine-tuning job’s state after pausing.
​
object
string
required
The object type. Always fine_tuning.job.
​
id
string
required
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 if the job has failed, as the platform error envelope (a list of {code, message, suggestion, error_uid}). Empty while the job is queued, the job is running, or when the job has successfully completed.
​
checkpoint_id
string
The checkpoint ID of the checkpoint from which the job was started, or null if it trained from the base model.
​
fine_tuned_model
string
Name of the model produced by the job. This is available once training has succeeded, and is 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 specifies whether it succeeded fully (SUCCESS), partially (PARTIAL), or produced nothing (FAILED). If the job hasn’t yet completed, this is null.
​
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/pause \
  -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": "PAUSED",
  "checkpoint_id": null,
  "fine_tuned_model": null,
  "finished_at": null,
  "outcome": null,
  "seed": 42,
  "user_provided_suffix": "v2",
  "training_files": ["fil_..."],
  "validation_files": ["fil_..."],
  "errors": []
}