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,
  "next_cursor": null,
  "prev_cursor": null
}

{
  "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,
  "next_cursor": null,
  "prev_cursor": null
}

{
  "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. Pass the next_cursor of the previous page. Do not supply a value for both this and before.

string

Backward cursor: return events newer than the event with this ID. Pass the prev_cursor of the current page. Mutually exclusive with after.

integer

default:"20"

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

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.

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.

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,
  "next_cursor": null,
  "prev_cursor": null
}

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

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

​Overview

​Request

​Response

Overview

Request

Response