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.

string

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

string

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

string

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

string

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

integer

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

Response

Returns a page of events.

string

The object type of a list response. Always list.

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.

integer

required

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

string

required

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

string

required

The event type.

integer

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

string

Human-readable message, if any.

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"
}

⌘I

​Overview

​Request

​Response

Overview

Request

Response