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

Returns details about a fine-tuning job, given its TypeID-encoded ID.

​
Request

​
id
string
required
The fine-tuning job ID for which to return details. This is a TypeID-encoded identifier with the FineTuningJobId prefix.

​
Response

Returns a description of the specified fine-tuning job.
​
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 name of 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 detail when the job has failed, as the platform error envelope (a list of {code, message, suggestion, error_uid}). Empty while the job is queued/running or on success.
​
checkpoint_id
string
The ID of checkpoint the job was started from, 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, but 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 indicates whether it succeeded fully (SUCCESS), partially (PARTIAL), or produced nothing (FAILED); 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 https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs/your-job-id \
  -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": "RUNNING",
  "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": []
}