List Fine-tuning Jobs - Archetype AI Documentation

curl "https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs?model=newton&status=RUNNING&limit=20" \
  -H "Authorization: Bearer $ATAI_API_KEY"

import requests
import os

api_key = os.environ.get("ATAI_API_KEY")

response = requests.get(
    "https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs",
    headers={"Authorization": f"Bearer {api_key}"},
    params={"model": "newton", "status": "RUNNING", "limit": 20}
)

print(response.json())

const params = new URLSearchParams({ model: 'newton', status: 'RUNNING', limit: '20' });

const response = await fetch(
  `https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs?${params}`,
  {
    headers: {
      'Authorization': `Bearer ${process.env.ATAI_API_KEY}`
    }
  }
);

const data = await response.json();
console.log(data);

{
  "object": "list",
  "data": [
    {
      "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": []
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "prev_cursor": null
}

GET

fine_tuning

jobs

curl "https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs?model=newton&status=RUNNING&limit=20" \
  -H "Authorization: Bearer $ATAI_API_KEY"

import requests
import os

api_key = os.environ.get("ATAI_API_KEY")

response = requests.get(
    "https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs",
    headers={"Authorization": f"Bearer {api_key}"},
    params={"model": "newton", "status": "RUNNING", "limit": 20}
)

print(response.json())

const params = new URLSearchParams({ model: 'newton', status: 'RUNNING', limit: '20' });

const response = await fetch(
  `https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs?${params}`,
  {
    headers: {
      'Authorization': `Bearer ${process.env.ATAI_API_KEY}`
    }
  }
);

const data = await response.json();
console.log(data);

{
  "object": "list",
  "data": [
    {
      "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": []
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "prev_cursor": null
}

Requires version 1.1.5 or later of the Archetype platform.

Overview

Returns a cursor-paginated list of fine-tuning jobs. You can filter by model, method, status, outcome, or a free-text search using the q parameter. The list is ordered on the field identified by sort (created_at by default), in the direction specified by order. Ties are broken on created_at, then id. The page is in sort order whether it was reached with after or before. Cursors are opaque and bound to the sort they were issued under; a cursor from another sort returns an HTTP 400 error. An invalid filter, sort, order, or cursor also returns an HTTP 400 error.

Request

string

Filter by model, e.g. newton.

string

Filter by training method, e.g. lora or head.

string

Filter by lifecycle status, e.g. PENDING, RUNNING, PAUSED, COMPLETED, FAILED, INTERRUPTED, CANCELLED.

string

Filter by completion outcome (SUCCESS/PARTIAL/FAILED). Only completed jobs carry an outcome, so specifying a value for this parameter implicitly limits results to completed jobs. v1.1.5+

string

Case-insensitive search matched against the job name, suffix, and produced model name.

string

default:"created_at"

Specifies the field on which the returned list is ordered. Ties are broken on created_at, then id, so pages are stable. v1.1.12+Must be one of the following:

Value	Description
`created_at`	Sort by the job’s creation timestamp. Default value.
`finished_at`	Sort by the job’s finish timestamp. Jobs with a null `finished_at` sort as the earliest (last under `desc`).
`status`	Sort by lifecycle position, not by the raw status value, in this order: `PENDING`, `ADMITTED`, `RUNNING`, `PAUSED`, `INTERRUPTED`, `PREEMPTED`, `COMPLETED`, `FAILED`, `CANCELLED`

string

Specifies whether sorting is performed in ascending order (asc) or descending order (desc). When sorting by created_at or finished_at, this defaults to desc. When sorting by status, this defaults to asc. A cursor marks a position in the list and stays valid under either direction. v1.1.12+

string

Forward cursor: return the jobs that follow this page’s last job in the sort order. This value is opaque; pass the previous page’s next_cursor. A cursor is bound to the sort it was issued under; using it with a different sort returns an HTTP 400 error. Mutually exclusive with before; sending both returns an HTTP 400 error. v1.1.12+

string

Backward cursor: return the jobs that precede this page’s first job in the sort order. This value is opaque; pass the current page’s prev_cursor. Mutually exclusive with after; sending both returns an HTTP 400 error. v1.1.12+

integer

default:"20"

The maximum number of jobs to return. Minimum 1, maximum 1000. v1.1.11+

Response

Returns a page of fine-tuning jobs.

string

The object type. Always list.

array

An array of the jobs for this page, sorted by the column specified by sort, in the ordering specified by order (newest first by default) in both cursor directions. Each item is a fine-tuning job object.

Show Fine-tuning job

The description of a single fine-tuning job.

string

required

The object type. Always fine_tuning.job.

string

required

The unique identifier of the fine-tuning job.

string

required

The human-readable name supplied when the job was created.

string

required

The base model being fine-tuned.

integer

required

The Unix timestamp (in seconds) at which the job was created.

string

required

The organization that owns the job.

string

required

The job’s current lifecycle stage. One of PENDING, ADMITTED, RUNNING, COMPLETED, FAILED, PREEMPTED, CANCELLED, PAUSED, INTERRUPTED.

string

If and only if the job’s status is COMPLETED, this property’s value indicates how the job completed. It is set once upon completion and is never set for a job which is not completed; for incomplete jobs, this value is always omitted. v1.1.5+For completed jobs, the following values are possible:

Value	Description
`SUCCESS`	None of the job’s inputs failed.
`PARTIAL`	At least one of the job’s inputs failed, but the job still produced at least one artifact (either a `job_outputs` entry or a `checkpoints` entry).
`FAILED`	At least one input failed, and the job produced no artifacts at all (no outputs and no checkpoints).

array

required

Identifiers of the training files used to train the model.

array

required

Identifiers of the files used to evaluate the model during training.

array

required

When the job has failed, this array lists the error(s) that occcurred, as the platform error envelope (a list of {code, message, suggestion, error_uid}). Empty while the job is queued/running or on success.

string

The ID of the checkpoint the job was started from, or null if it trained from the base model.

string

Name of the model produced by the job. This is only available once training has succeeded; until then, this value is null.

integer

The Unix timestamp (in seconds) at which the job finished, or null if it is not yet complete.

string

For a COMPLETED job, this value indicates whether it succeeded fully (SUCCESS), partially (PARTIAL), or produced nothing (FAILED). For any job that hasn’t completed, this value is null.

integer

The random seed used for the job.

string

The suffix supplied on the request, applied to the fine-tuned model’s name.

boolean

Whether more jobs exist beyond this page in the direction of travel.

string

Cursor to continue in the direction of travel — pass it as after when paging forward (the default), or as before when the request used before. null when has_more is false. v1.1.11+

string

Cursor to step back the way this page was reached — pass it as before after a forward page, or as after after a backward one. null when the request carried no cursor (the first page has nothing to step back to). v1.1.12+

curl "https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs?model=newton&status=RUNNING&limit=20" \
  -H "Authorization: Bearer $ATAI_API_KEY"

import requests
import os

api_key = os.environ.get("ATAI_API_KEY")

response = requests.get(
    "https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs",
    headers={"Authorization": f"Bearer {api_key}"},
    params={"model": "newton", "status": "RUNNING", "limit": 20}
)

print(response.json())

const params = new URLSearchParams({ model: 'newton', status: 'RUNNING', limit: '20' });

const response = await fetch(
  `https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs?${params}`,
  {
    headers: {
      'Authorization': `Bearer ${process.env.ATAI_API_KEY}`
    }
  }
);

const data = await response.json();
console.log(data);

{
  "object": "list",
  "data": [
    {
      "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": []
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "prev_cursor": null
}

​Overview

​Request

​Response

Overview

Request

Response