List Job Checkpoints - Archetype AI Documentation

curl "https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs/your-job-id/checkpoints?limit=20" \
  -H "Authorization: Bearer $ATAI_API_KEY"

import requests
import os

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

job_id = "your-job-id"

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

print(response.json())

const jobId = 'your-job-id';
const params = new URLSearchParams({ limit: '20' });

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

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

{
  "object": "list",
  "data": [
    {
      "id": "ckp_...",
      "created_at": 1765201323,
      "step": 1000,
      "metrics": {
        "loss": 0.123
      }
    }
  ],
  "has_more": false
}

{
  "code": "not_found",
  "message": "Not found",
  "suggestion": null,
  "error_uid": "err-xxxxxxxx"
}

GET

fine_tuning

jobs

{id}

checkpoints

curl "https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs/your-job-id/checkpoints?limit=20" \
  -H "Authorization: Bearer $ATAI_API_KEY"

import requests
import os

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

job_id = "your-job-id"

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

print(response.json())

const jobId = 'your-job-id';
const params = new URLSearchParams({ limit: '20' });

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

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

{
  "object": "list",
  "data": [
    {
      "id": "ckp_...",
      "created_at": 1765201323,
      "step": 1000,
      "metrics": {
        "loss": 0.123
      }
    }
  ],
  "has_more": false
}

{
  "code": "not_found",
  "message": "Not found",
  "suggestion": null,
  "error_uid": "err-xxxxxxxx"
}

Requires version 1.1.5 or later of the Archetype platform.

Overview

Returns a list of checkpoints produced by the job. The list is cursor-paginated, and is in reverse chronological order (newest-first).

Request

string

required

The fine-tuning job ID of the job for which to list checkpoints. This is a TypeID-encoded identifier with the FineTuningJobId prefix.

after

string

Forward cursor: return items older than the item with this ID. Do not supply both this value and a value for before.

before

string

Backward cursor: return items newer than the item with this ID. Mutually exclusive with after.

limit

integer

The maximum number of items to return, between 1 and 100.

Response

Returns a page of checkpoints.

object

string

The object type of a list response. Always list.

data

array

The checkpoints produced by the training job.

Show FineTuningCheckpoint

string

required

Checkpoint identifier.

created_at

integer

required

The Unix timestamp (in seconds) at which the checkpoint was produced.

step

integer

required

The training step at which the checkpoint was produced.

metrics

object

required

The structured metrics captured with the checkpoint.

has_more

boolean

true if more checkpoints exist beyond this page.

curl "https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs/your-job-id/checkpoints?limit=20" \
  -H "Authorization: Bearer $ATAI_API_KEY"

import requests
import os

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

job_id = "your-job-id"

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

print(response.json())

const jobId = 'your-job-id';
const params = new URLSearchParams({ limit: '20' });

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

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

{
  "object": "list",
  "data": [
    {
      "id": "ckp_...",
      "created_at": 1765201323,
      "step": 1000,
      "metrics": {
        "loss": 0.123
      }
    }
  ],
  "has_more": false
}

{
  "code": "not_found",
  "message": "Not found",
  "suggestion": null,
  "error_uid": "err-xxxxxxxx"
}

Cancel Job List Job Events

⌘I

​Overview

​Request

​Response

Overview

Request

Response