Auth: required. Send an ivy_ API key (Authorization: Bearer ivy_… or X-Ivy-Api-Key), a Clerk session JWT (Authorization: Bearer …) or the Clerk __session cookie (browser sessions). See Authentication.

Lists the snapshot images stored for a job you can read, newest first. Each item pairs a PNG with the JSON file stored beside it, when there is one, and gives their storage locations as spaces://<bucket>/<key> URIs. These are storage locations, not download links.

Pass manifestChecksum to list only the snapshots stored under that manifest checksum. With includeContext=1, each item that has a JSON file also carries that file's parsed contents in context, and its checksum_sha256 when the file records one; a JSON file that cannot be read or parsed is skipped without an error. Results are paged: when truncated is true, pass nextCursor as cursor to continue.

includeContextstring

Set to 1 to include each snapshot's JSON contents as context. Any other value leaves it out.

limitinteger

Maximum number of snapshots to return, from 1 to 200. Defaults to 60.

cursorstring

The nextCursor value from a previous response.

Responses

`200` OK

The job's snapshots, with a cursor when more remain

Response shape:

itemsobject[]

Snapshots, newest first

nextCursorstring

Pass as cursor to get the next page; null when there is no more

truncatedboolean

True when more snapshots remain beyond this page

curl -X GET 'https://ivybiosciences.com/api/v1/jobs/{jobId}/snapshots/list' \
  -H "Authorization: Bearer $IVY_API_KEY"

GET /v1/jobs/{jobId}/snapshots/list

Request

Path parameters

Query parameters

Responses

`200` OK

`400` Bad Request

`401` Unauthorized

`404` Not Found

`429` Too Many Requests

`500` Internal Server Error