List images
⚠️ This endpoint is in public preview.
List images in the specified workspace. Pass sfc:workspace:sfcompute:public as the workspace to list sfc-provided public images instead.
Authorizations
Create an API token using sf tokens create or at https://sfcompute.com/account/api-keys.
Query Parameters
Scope the returned list to a single workspace (ID, resource path, or name). Without it, the returned list spans every workspace where the caller has Image:List and Image:Read (granted at either the workspace or organization level). Public images are not included by default - request them by specifying sfc:workspace:sfcompute:public for the workspace query parameter.
A resource path like 'sfc:workspace:acme:my-workspace' or an ID. Resource paths are human-readable but not stable - they change when resources are renamed or moved. IDs are stable and permanent.
(wksp_[0-9a-zA-Z_-]{1,21})|(sfc:workspace:[a-zA-Z0-9._-]+(:[a-zA-Z0-9._-]+){1,1})"wksp_k3R-nX9vLm7Qp2Yw5Jd8F"
Filter by image ID (repeatable).
Accepts the canonical prefix below; additional legacy prefixes are aliased for read compatibility. Writes always emit the canonical form.
image_[0-9a-zA-Z_-]{1,21}"image_k3R-nX9vLm7Qp2Yw5Jd8F"
Return every version of every image name. By default the list collapses to one entry per name — the highest active (completed, non-deprecated) version, falling back to the name's latest version when no active one exists. Public listings hide names whose every version is deprecated unless this is set.
Maximum number of results to return (1-200, default 50).
1 <= x <= 200Cursor for forward pagination (from a previous response's cursor field).
^imagec_[A-Za-z0-9_-]+$"imagec_gqXR7s0Kj5mHvE2wNpLc4Q"
Cursor for backward pagination.
^imagec_[A-Za-z0-9_-]+$"imagec_gqXR7s0Kj5mHvE2wNpLc4Q"