List Job Events - Archetype AI Documentation

curl "https://api.u1.archetypeai.app/v0.5/batch/jobs/job_2abc3def4ghi5jkl6mno7pqr/events?level=ERROR&limit=20" \
  -H "Authorization: Bearer $ATAI_API_KEY"

import requests
import os

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

response = requests.get(
    f"https://api.u1.archetypeai.app/v0.5/batch/jobs/{job_id}/events",
    headers={"Authorization": f"Bearer {api_key}"},
    params={
        "level": "ERROR",
        "limit": 20
    }
)

data = response.json()
print(f"Total events: {data['total']}")
for event in data["events"]:
    print(f"  [{event['level']}] {event['event_type']}: {event.get('message', '')}")

const jobId = 'job_2abc3def4ghi5jkl6mno7pqr';
const params = new URLSearchParams({ level: 'ERROR', limit: '20' });

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

const data = await response.json();
console.log(`Total events: ${data.total}`);
data.events.forEach(event => {
  console.log(`  [${event.level}] ${event.event_type}: ${event.message || ''}`);
});

{
  "job_id": "job_2abc3def4ghi5jkl6mno7pqr",
  "total": 5,
  "offset": 0,
  "limit": 20,
  "events": [
    {
      "id": 1001,
      "event_type": "inference.success",
      "level": "SUCCESS",
      "message": "Inference completed for input",
      "payload": {
        "duration_ms": 1250
      },
      "input_id": "inp_abc123def456",
      "index": 0,
      "created_at": "2026-04-14T10:05:00Z"
    },
    {
      "id": 1002,
      "event_type": "inference.failed",
      "level": "FAILED",
      "message": "Input file format not supported",
      "payload": {
        "error_code": "UNSUPPORTED_FORMAT"
      },
      "input_id": "inp_ghi789jkl012",
      "index": 1,
      "created_at": "2026-04-14T10:05:30Z"
    }
  ]
}

{
  "code": "NOT_FOUND",
  "message": "Job not found",
  "error_uid": "err_abc123"
}

{
  "detail": "Invalid access with key: api_key_not_found"
}

GET

batch

jobs

{id}

events

curl "https://api.u1.archetypeai.app/v0.5/batch/jobs/job_2abc3def4ghi5jkl6mno7pqr/events?level=ERROR&limit=20" \
  -H "Authorization: Bearer $ATAI_API_KEY"

import requests
import os

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

response = requests.get(
    f"https://api.u1.archetypeai.app/v0.5/batch/jobs/{job_id}/events",
    headers={"Authorization": f"Bearer {api_key}"},
    params={
        "level": "ERROR",
        "limit": 20
    }
)

data = response.json()
print(f"Total events: {data['total']}")
for event in data["events"]:
    print(f"  [{event['level']}] {event['event_type']}: {event.get('message', '')}")

const jobId = 'job_2abc3def4ghi5jkl6mno7pqr';
const params = new URLSearchParams({ level: 'ERROR', limit: '20' });

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

const data = await response.json();
console.log(`Total events: ${data.total}`);
data.events.forEach(event => {
  console.log(`  [${event.level}] ${event.event_type}: ${event.message || ''}`);
});

{
  "job_id": "job_2abc3def4ghi5jkl6mno7pqr",
  "total": 5,
  "offset": 0,
  "limit": 20,
  "events": [
    {
      "id": 1001,
      "event_type": "inference.success",
      "level": "SUCCESS",
      "message": "Inference completed for input",
      "payload": {
        "duration_ms": 1250
      },
      "input_id": "inp_abc123def456",
      "index": 0,
      "created_at": "2026-04-14T10:05:00Z"
    },
    {
      "id": 1002,
      "event_type": "inference.failed",
      "level": "FAILED",
      "message": "Input file format not supported",
      "payload": {
        "error_code": "UNSUPPORTED_FORMAT"
      },
      "input_id": "inp_ghi789jkl012",
      "index": 1,
      "created_at": "2026-04-14T10:05:30Z"
    }
  ]
}

{
  "code": "NOT_FOUND",
  "message": "Job not found",
  "error_uid": "err_abc123"
}

{
  "detail": "Invalid access with key: api_key_not_found"
}

Requires version 1.1.0 or later of the Archetype platform.

Overview

This endpoint returns a paginated list of events emitted during job execution. Events provide observability into what happened during processing, including informational messages, warnings, errors, and terminal outcomes.

Request

string

required

The unique job identifier

string

Filter events by level: INFO, WARN, ERROR, SUCCESS, or FAILED

string

Filter events by type (e.g., inference.success, inference.failed)

string

Filter events associated with a specific input

integer

Number of items to skip for pagination (default: 0)

integer

Maximum number of items to return per page

Response

string

The job identifier

integer

Total number of events matching the filter criteria

integer

Current pagination offset

integer

Maximum number of items returned

array

Array of event objects, each containing:

id — Unique event identifier
event_type — Type of event (e.g., inference.success)
level — Event level: INFO, WARN, ERROR, SUCCESS, or FAILED
message — Optional human-readable message
payload — Event-specific data
input_id — Associated input ID (if applicable)
index — Event index within the input (if applicable)
created_at — Event timestamp

curl "https://api.u1.archetypeai.app/v0.5/batch/jobs/job_2abc3def4ghi5jkl6mno7pqr/events?level=ERROR&limit=20" \
  -H "Authorization: Bearer $ATAI_API_KEY"

import requests
import os

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

response = requests.get(
    f"https://api.u1.archetypeai.app/v0.5/batch/jobs/{job_id}/events",
    headers={"Authorization": f"Bearer {api_key}"},
    params={
        "level": "ERROR",
        "limit": 20
    }
)

data = response.json()
print(f"Total events: {data['total']}")
for event in data["events"]:
    print(f"  [{event['level']}] {event['event_type']}: {event.get('message', '')}")

const jobId = 'job_2abc3def4ghi5jkl6mno7pqr';
const params = new URLSearchParams({ level: 'ERROR', limit: '20' });

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

const data = await response.json();
console.log(`Total events: ${data.total}`);
data.events.forEach(event => {
  console.log(`  [${event.level}] ${event.event_type}: ${event.message || ''}`);
});

{
  "job_id": "job_2abc3def4ghi5jkl6mno7pqr",
  "total": 5,
  "offset": 0,
  "limit": 20,
  "events": [
    {
      "id": 1001,
      "event_type": "inference.success",
      "level": "SUCCESS",
      "message": "Inference completed for input",
      "payload": {
        "duration_ms": 1250
      },
      "input_id": "inp_abc123def456",
      "index": 0,
      "created_at": "2026-04-14T10:05:00Z"
    },
    {
      "id": 1002,
      "event_type": "inference.failed",
      "level": "FAILED",
      "message": "Input file format not supported",
      "payload": {
        "error_code": "UNSUPPORTED_FORMAT"
      },
      "input_id": "inp_ghi789jkl012",
      "index": 1,
      "created_at": "2026-04-14T10:05:30Z"
    }
  ]
}

{
  "code": "NOT_FOUND",
  "message": "Job not found",
  "error_uid": "err_abc123"
}

{
  "detail": "Invalid access with key: api_key_not_found"
}

Get Queue Depths List Inputs

⌘I

​Overview

​Request

​Response

Overview

Request

Response