Skip to main content
GET
/
batch
/
jobs
/
{id}
/
inputs
curl "https://api.u1.archetypeai.app/v0.5/batch/jobs/job_2abc3def4ghi5jkl6mno7pqr/inputs?status=completed&limit=10" \
  -H "Authorization: Bearer $ATAI_API_KEY"

{
  "job_id": "job_2abc3def4ghi5jkl6mno7pqr",
  "total": 2,
  "offset": 0,
  "limit": 10,
  "inputs": [
    {
      "id": "inp_abc123def456",
      "job_id": "job_2abc3def4ghi5jkl6mno7pqr",
      "port_name": "worker.inference",
      "file_id": "file_abc123",
      "data": {
        "ref": "https://storage.example.com/files/tep_inference.csv",
        "filename": "tep_inference.csv",
        "file_type": "text/csv",
        "file_extension": ".csv",
        "num_bytes": 245760,
        "metadata": {},
        "file_tags": null,
        "file_attributes": null
      },
      "status": "completed",
      "error_message": null,
      "created_at": "2026-04-14T10:00:00Z",
      "completed_at": "2026-04-14T10:05:00Z"
    }
  ]
}

​
Overview

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

​
Request

​
id
string
required
The unique job identifier
​
port_name
string
Filter inputs by port name
​
status
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.
​
offset
integer
Number of items to skip for pagination (default: 0)
​
limit
integer
Maximum number of items to return per page

​
Response

​
job_id
string
The job identifier
​
total
integer
Total number of inputs matching the filter criteria
​
offset
integer
Current pagination offset
​
limit
integer
Maximum number of items returned
​
inputs
array
Array of input objects, 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)
curl "https://api.u1.archetypeai.app/v0.5/batch/jobs/job_2abc3def4ghi5jkl6mno7pqr/inputs?status=completed&limit=10" \
  -H "Authorization: Bearer $ATAI_API_KEY"

{
  "job_id": "job_2abc3def4ghi5jkl6mno7pqr",
  "total": 2,
  "offset": 0,
  "limit": 10,
  "inputs": [
    {
      "id": "inp_abc123def456",
      "job_id": "job_2abc3def4ghi5jkl6mno7pqr",
      "port_name": "worker.inference",
      "file_id": "file_abc123",
      "data": {
        "ref": "https://storage.example.com/files/tep_inference.csv",
        "filename": "tep_inference.csv",
        "file_type": "text/csv",
        "file_extension": ".csv",
        "num_bytes": 245760,
        "metadata": {},
        "file_tags": null,
        "file_attributes": null
      },
      "status": "completed",
      "error_message": null,
      "created_at": "2026-04-14T10:00:00Z",
      "completed_at": "2026-04-14T10:05:00Z"
    }
  ]
}