Get image
⚠️ This endpoint is in public preview.
Retrieve an image by ID. Returns both user-owned and public images. Resource paths follow the latest active version of the name; append @<version> to address one exact version (e.g. sfc:image:sfcompute:public:ubuntu-22.04@2).
Authorizations
Create an API token using sf tokens create or at https://sfcompute.com/account/api-keys.
Path Parameters
Image ID or resource path, optionally pinned with an @ suffix Image ID, or a resource path optionally pinned to one version with an @ suffix (e.g. sfc:image:sfcompute:public:ubuntu-22.04@2). Unpinned paths follow the latest active version of the name.
Response
Image details
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"
A resource path for a image resource. Format: sfc:image:::.
sfc:image:([a-zA-Z0-9._-]+:){2}[a-zA-Z0-9._-]+"sfc:image:<account_id>:<workspace>:<name>"
1 - 255[a-zA-Z0-9][a-zA-Z0-9._-]{0,254}"my-resource-name"
1 - 255[a-zA-Z0-9][a-zA-Z0-9._-]{0,254}"my-resource-name"
The workspace that owns this image.
wksp_[0-9a-zA-Z_-]{1,21}"wksp_k3R-nX9vLm7Qp2Yw5Jd8F"
1 - 255[a-zA-Z0-9][a-zA-Z0-9._-]{0,254}"my-resource-name"
Whether this is an sfc-provided public image.
"image"started, uploading, completed, failed, revoked Unix timestamp.
1738972800
Version of this image within its name. Uploading an existing name creates the next version; each version is immutable. (default tolerates servers that predate the field: 0 = unreported.)
Set when this version is deprecated: it no longer resolves by name and is hidden from default listings, but can still be launched by id.
1738972800
64^[a-f0-9]{64}$