---
title: "List stored images"
method: GET
path: "/images"
---

# List stored images

`GET /images`

## Request

- Base URL: `https://clusters.soleilpictures.com/api/v1`
- URL: `https://clusters.soleilpictures.com/api/v1/images`
- Auth: HTTP bearer

What is already stored, so an interrupted bulk upload can be resumed by diffing against a local manifest rather than re-sending everything. Paged by CURSOR, not offset: offset paging makes the database walk and discard every row it skips, so it degrades exactly when a listing gets long enough to need paging.

## Query parameters

- `workspace` string, uuid
- `board` string, uuid
- `since` string, date-time
- `cursor` string
- `limit` integer

## Response `200`

A page of stored images

- object
  - `images` object[]
    - `image_key` string
    - `bytes` integer, nullable
    - `width` integer, nullable
    - `height` integer, nullable
    - `board_id` string, uuid, nullable
    - `workspace_id` string, uuid
    - `created_at` string, date-time
    - `file_name` string, nullable: The uploaded file's own name, where it was kept.
  - `limit` integer
  - `has_more` boolean
  - `next_cursor` string, nullable

---

[API](https://skmtc.dev/soleilpictures/apis/soleil-clusters-api.md) · [All operations](https://skmtc.dev/soleilpictures/apis/soleil-clusters-api/llms.txt) · [OpenAPI document](https://skmtc.dev/soleilpictures/apis/soleil-clusters-api/revisions/1d426d587bf3?raw)