Storage

List blobs

List blobs in the project. Requires the apikey header to carry a project service_key or project_admin JWT.

get/storage/v1/blobs

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/storage/v1/blobs
  • Auth: API key in header apikey

Query parameters

prefixstring
limitinteger

Strict positive integer. Malformed, fractional, zero, or negative values return 400.

cursorstring

Opaque pagination cursor: echo the previous page's next_cursor with the same sort, prefix and filters. A cursor that is unusable under this request (issued for another sort, or malformed) answers the first page with reset: true, never a 4xx.

sort'key:asc' | 'createdAt:asc' | 'createdAt:desc'

v1.50 — result ordering. key:asc is the legacy default. createdAt:desc is the canonical media-picker view (newest first).

filter_uploaded_bystring

v1.50 — equality filter on metadata->>'uploaded_by'. Hits the partial btree index.

filter_tagstring

v1.50 — array-contains filter on metadata->'tags'. Hits the partial GIN index.

filter_formatstring

v1.50 — equality filter on image_format (one of jpeg|png|webp|avif|heic|tiff|svg|bmp). Hits the partial btree index.

filter_is_imageboolean

v1.50 — true filters to rows where image_format IS NOT NULL; false filters to non-images.

filter_min_widthinteger

v1.50 — width_px >= N (inclusive). Combine with maxWidth for ranges.

filter_max_widthinteger

v1.50 — width_px <= N (inclusive).

filter_min_heightinteger

v1.50 — height_px >= N (inclusive).

filter_max_heightinteger

v1.50 — height_px <= N (inclusive).

Response

{ blobs: [...], next_cursor }

next_cursorstring nullable required

Opaque cursor for the next page, under the same sort and filters; null on the last page.

has_moreboolean required

True when rows remain past this page; next_cursor is then set.

resetboolean required

True when the request's cursor was unusable under its sort (issued for another sort, or malformed) and this response is the listing's first page instead. False otherwise.

Example response

{
  "blobs": [
    {
      "sha256": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.