Skip to main content
GET
Requires version 1.1.0 or later of the Archetype platform.

Overview

This endpoint returns tracked inputs for a job, each paired with its most recent job_progress row (if any). Use it to drive per-input progress UIs without N+1 fetches against the progress endpoint. Inputs attached to non-tracked ports (e.g. n-shot reference files) are always excluded. The page is cursor-paginated and comes back in display order: processing inputs first, then pending, then finished (completed/failed) ones, each group sorted by its activity time in the direction order gives. Unlike the other batch lists, this order is not newest first.

Request

string
required
The unique job identifier
string
Scope results to a single input port (e.g. worker.inference)
array
Statuses to include. Repeat this parameter to specify several statuses to filter on (?status=pending&status=processing). Accepts pending, processing, completed, and failed. The reference status is always excluded.
string
Sort direction within each status bucket. asc (the default) puts the oldest first; desc puts the most recently active inputs at the top. A cursor marks a position in the list and stays valid under either direction.
integer
default:"100"
Page size, between 1 and 1000. Clamped server-side.
string
Forward cursor: return the inputs that follow this page’s last input in the display order. This value is opaque and doesn’t correspond to any identifier you can rely upon. Instead, pass the previous page’s next_cursor back verbatim. This parameter is mutually exclusive with before; including both returns an HTTP 400 error. A malformed cursor also returns 400. v1.1.11+
string
Backward cursor: return the inputs that precede this page’s first input in the display order. Just like after, this parameter’s value is opaque and doesn’t correspond reliably to a specific input. This parameter is mutually exclusive with after. v1.1.11+

Response

string
The job identifier
array
Array of InputWithLatestProgress objects, in the display order described above in both cursor directions, each containing:
  • input — The InputResponse (same shape as the response for List Inputs)
  • latest_progress — The most recent job_progress row for this input, or null if none yet
  • step — 1-indexed completion rank across the whole job, ordered by completed_at. null for inputs still in pending or processing — assigned only when the input reaches completed or failed. Ties (same completed_at) are broken by input id. Distinct from latest_progress.step, which is the container-reported training/inference step inside a single input.
boolean
true when more inputs exist beyond this page in the direction of travel. v1.1.11+
string
Cursor for the next page in the same direction — pass it as after when paging forward, 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. v1.1.11+
The cursor is a snapshot of the position it was issued at, so an input that changes status between two page requests is neither skipped nor repeated.