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": "images",
      "file_id": "file_abc123",
      "data": {
        "ref": "https://storage.example.com/files/image1.jpg",
        "filename": "image1.jpg",
        "file_type": "image/jpeg",
        "file_extension": ".jpg",
        "num_bytes": 245760,
        "metadata": {}
      },
      "status": "completed",
      "error_message": null,
      "created_at": "2026-04-14T10:00:00Z",
      "completed_at": "2026-04-14T10:05:00Z"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.archetypeai.app/llms.txt

Use this file to discover all available pages before exploring further.

​
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, or failed
​
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 with ref (URL), filename, file_type, file_extension, num_bytes, and optional metadata
  • status — Processing status: pending, processing, completed, or failed
  • 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": "images",
      "file_id": "file_abc123",
      "data": {
        "ref": "https://storage.example.com/files/image1.jpg",
        "filename": "image1.jpg",
        "file_type": "image/jpeg",
        "file_extension": ".jpg",
        "num_bytes": 245760,
        "metadata": {}
      },
      "status": "completed",
      "error_message": null,
      "created_at": "2026-04-14T10:00:00Z",
      "completed_at": "2026-04-14T10:05:00Z"
    }
  ]
}