List a job's items
One page of a job's items, in item order (index, from 0) — the number the rest of the API names an item by, in events and in a resume.
GET /api/v1/jobs/{id} carries the first 100 items inline and sets itemsTruncated when there are more; this is how to read the rest. A batch takes up to 10000 assets, each times its variants, so the whole list is not something to hold in a context or re-read on every poll.
USE THIS WHEN:
- A job says itemsTruncated and you need an item past the first page
- You want only the failed ones, to decide whether a resume is worth its price (status=FAILED)
DO NOT USE WHEN:
- You want the assets the job produced → GET /api/v1/assets?jobId={id}, which is the run's products without the items around them
Request
- Base URL: https://api.imagestep.dev
- URL: https://api.imagestep.dev/api/v1/jobs/{id}/items
- Auth: API key in header Authorization
Path parameters
The job's id, job_…
Query parameters
Page number (0-indexed). Leave it out when you send cursor
Items per page (max 100; out of range is clamped)
The meta.nextCursor of the previous page: the rows after it, read without counting — the way to walk a long listing. Send it unchanged, with the same filters; it cannot be combined with page
Only items in this status
Response
One page of items, with meta
Changes
No recorded changes to this operation across all 1 revision of this API.