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

Overview

This endpoint returns a cursor-paginated list of input files associated with a job, newest first. You can filter by port name or processing status.

Request

string
required
The unique job identifier
string
Filter inputs by port name
string
Filter inputs by processing status: pending, processing, completed, failed, or reference. reference is a terminal sentinel applied to inputs attached to non-tracked ports (e.g. n-shot example files) — they’re persisted for visibility but never transition through the pending → processing → completed/failed lifecycle.
Case-insensitive substring search matched against the input’s filename and file_id. Composes with other filters using AND logic. v1.1.10+
integer
default:"100"
Page size, between 1 and 1000. Clamped server-side.
string
Forward cursor: return inputs tracked before the input with this ID. Pass the previous page’s next_cursor. Mutually exclusive with before — sending both returns 400. v1.1.11+
string
Backward cursor: return inputs tracked after the input with this ID. Pass the current page’s prev_cursor. Mutually exclusive with after. v1.1.11+

Response

string
The job identifier
array
Array of input objects, newest first (created_at descending) in both cursor directions, each containing:
  • id — Unique input identifier
  • job_id — Parent job identifier
  • port_name — Input port name
  • file_id — Original file ID
  • data — Resolved data reference (DataRef) with required ref (URL) and filename, plus optional file_type, file_extension, num_bytes, metadata, file_tags, file_attributes. When emitted in per-worker JSONL manifests, also includes the input_id so containers can do per-input progress tracking.
  • status — Processing status: pending, processing, completed, failed, or reference (terminal sentinel for inputs on non-tracked ports such as n-shot examples)
  • error_message — Error details (if failed)
  • created_at — Creation timestamp
  • completed_at — Completion timestamp (if completed)
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+