List Job Events - Archetype AI Documentation

curl "https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs/your-job-id/events?level=INFO&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}/events",
    headers={"Authorization": f"Bearer {api_key}"},
    params={"level": "INFO", "limit": 20}
)

print(response.json())

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

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

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

{
  "object": "list",
  "data": [
    {
      "id": "your-event-id",
      "created_at": 1765201323,
      "level": "INFO",
      "type": "job.started",
      "index": null,
      "message": "Training started."
    }
  ],
  "has_more": false
}

{
  "code": "invalid_cursor",
  "message": "Invalid cursor",
  "suggestion": null,
  "error_uid": "err-xxxxxxxx"
}

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

GET

fine_tuning

jobs

{id}

events

curl "https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs/your-job-id/events?level=INFO&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}/events",
    headers={"Authorization": f"Bearer {api_key}"},
    params={"level": "INFO", "limit": 20}
)

print(response.json())

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

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

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

{
  "object": "list",
  "data": [
    {
      "id": "your-event-id",
      "created_at": 1765201323,
      "level": "INFO",
      "type": "job.started",
      "index": null,
      "message": "Training started."
    }
  ],
  "has_more": false
}

{
  "code": "invalid_cursor",
  "message": "Invalid cursor",
  "suggestion": null,
  "error_uid": "err-xxxxxxxx"
}

{
  "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 cursor-paginated list of job-level (lifecycle) events for the specified job, with the newest event first.

To get a list of all job events, including those from workers, use the List Job Logs endpoint.

Request

string

required

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

level

string

Filter by severity. Permitted values include INFO, WARN, ERROR, SUCCESS, FAILED.

string

Case-insensitive search matched against the event message and type.

after

string

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

before

string

Backward cursor: return events newer than the event with this ID. Mutually exclusive with after.

limit

integer

The maximum number of events to return (1–100).

Response

Returns a page of events.

object

string

The object type of a list response. Always list.

data

array

The contents of the page of events emitted for the job.

Show FineTuningEvent

string

required

The event ID. Pass as the after cursor to page.

created_at

integer

required

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

level

string

required

Severity. One of INFO, WARN, ERROR, SUCCESS, FAILED.

type

string

required

The event type.

index

integer

Worker index that emitted the event; null for job-level events.

message

string

Human-readable message, if any.

has_more

boolean

true if more events exist beyond this page.

curl "https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs/your-job-id/events?level=INFO&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}/events",
    headers={"Authorization": f"Bearer {api_key}"},
    params={"level": "INFO", "limit": 20}
)

print(response.json())

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

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

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

{
  "object": "list",
  "data": [
    {
      "id": "your-event-id",
      "created_at": 1765201323,
      "level": "INFO",
      "type": "job.started",
      "index": null,
      "message": "Training started."
    }
  ],
  "has_more": false
}

{
  "code": "invalid_cursor",
  "message": "Invalid cursor",
  "suggestion": null,
  "error_uid": "err-xxxxxxxx"
}

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

List Job Checkpoints List Job Logs

⌘I

​Overview

​Request

​Response

Overview

Request

Response