Skip to main content
GET
/
batch
/
jobs
/
{id}
/
inputs
/
progress
/
traces
curl "https://api.u1.archetypeai.app/v0.5/batch/jobs/job_2abc3def4ghi5jkl6mno7pqr/inputs/progress/traces?buckets=50" \
  -H "Authorization: Bearer $ATAI_API_KEY"

{
  "job_id": "job_2abc3def4ghi5jkl6mno7pqr",
  "bucket_seconds": 30.0,
  "latest_event_at": "2026-04-14T10:15:00Z",
  "points": [
    {
      "t": "2026-04-14T10:02:30Z",
      "step": 0,
      "files": { "completed": 0, "failed": 0 },
      "items": {}
    },
    {
      "t": "2026-04-14T10:03:00Z",
      "step": 0,
      "files": { "completed": 0, "failed": 0 },
      "items": { "inference": { "success": 1, "failed": 0 } }
    },
    {
      "t": "2026-04-14T10:15:00Z",
      "step": 9,
      "files": { "completed": 8, "failed": 1 },
      "items": { "inference": { "success": 478, "failed": 12 } }
    }
  ]
}

​
Overview

Returns a fixed-resolution time series of cumulative file completions/failures (from job_inputs) and per-kind cumulative item counters (from job_progress.metrics) over the job’s lifetime. Suitable for backing a job-progress chart. t is the end of each bucket; the last point sits at the job’s terminal timestamp (or now() for live jobs). The response supports If-None-Match — when the cached representation is still current, the endpoint returns 304 Not Modified, letting polling clients short-circuit chart redraws.

​
Request

​
id
string
required
The unique job identifier
​
buckets
integer
Number of bucket points to return. Clamped to [10, 1000]; defaults to 100.

​
Response

​
job_id
string
The job identifier
​
bucket_seconds
number
Width of each bucket, in seconds
​
latest_event_at
string
Timestamp of the most recent underlying event — MAX over job_progress.created_at and job_inputs.completed_at. null when the job has neither finished any inputs nor emitted any progress. Lets polling clients short-circuit redraws when nothing has changed since the previous poll.
​
points
array
Trace points, each containing:
  • t — RFC 3339 timestamp at the bucket end
  • step — Total finished inputs (completed + failed) at the bucket end. Matches the step from List Inputs With Progress — a 1-indexed completion rank across the job
  • files — Cumulative file-level counts at the bucket end: { "completed": int, "failed": int }
  • items — Per-kind cumulative item counters from job_progress.metrics. Keys are the distinct job_progress.kind values observed for the job; values are { "success": int, "failed": int }. Empty when no progress has been emitted yet.
curl "https://api.u1.archetypeai.app/v0.5/batch/jobs/job_2abc3def4ghi5jkl6mno7pqr/inputs/progress/traces?buckets=50" \
  -H "Authorization: Bearer $ATAI_API_KEY"

{
  "job_id": "job_2abc3def4ghi5jkl6mno7pqr",
  "bucket_seconds": 30.0,
  "latest_event_at": "2026-04-14T10:15:00Z",
  "points": [
    {
      "t": "2026-04-14T10:02:30Z",
      "step": 0,
      "files": { "completed": 0, "failed": 0 },
      "items": {}
    },
    {
      "t": "2026-04-14T10:03:00Z",
      "step": 0,
      "files": { "completed": 0, "failed": 0 },
      "items": { "inference": { "success": 1, "failed": 0 } }
    },
    {
      "t": "2026-04-14T10:15:00Z",
      "step": 9,
      "files": { "completed": 8, "failed": 1 },
      "items": { "inference": { "success": 478, "failed": 12 } }
    }
  ]
}
Save latest_event_at between polls and send it via the If-None-Match header. The server returns 304 Not Modified when nothing has changed, letting you skip the chart redraw.