images

Creates, updates, deletes, gets or lists an images resource.

Overview

Name	images
Type	Resource
Id	vercel.vcr.images

Fields

The following fields are returned by SELECT queries:

get

A single image with its tags, status and resolved Dockerfile layer history.

Name	Datatype	Description
id	string	Internal identifier of the image. (example: img_a1b2c3d4e5f6)
repository_id	string	Identifier of the repository the image belongs to. (example: repo_a1b2c3d4e5f6) (wire: repositoryId)
arch	string	CPU architecture the manifest targets. Only present for single-platform manifests. (example: amd64)
created_at	string	ISO 8601 timestamp of when the image was created. (example: 2026-06-30T10:00:00.000Z) (wire: createdAt)
kind	string	Whether the manifest is a multi-platform image index, a single-platform image manifest or an attestation. (attestation, index, manifest)
layers	array
manifest_digest	string	SHA-256 digest of the image manifest. (example: sha256:2c4e8f3a1b9d0e5c7a6f4b2d8e1c9a0b3d5f7e9c1a2b4d6f8e0c2a4b6d8f0e2c) (wire: manifestDigest)
platform	string	Operating system the manifest targets. Only present for single-platform manifests. (example: linux)
pushed_by	string	Identifier of the actor that pushed the image. (wire: pushedBy)
size_in_bytes	number	Total size in bytes of the image's resources (manifest, config and layer blobs) stored by the registry. (wire: sizeInBytes)
status	string	VHS-readiness status, or null for a multi-platform index. (preparing, ready, unoptimized, )
tags	array	Tags pointing at this image's manifest.

list

An image enriched with its tags and VHS-readiness status, as returned when listing a repository's images.

Name	Datatype	Description
id	string	Internal identifier of the image. (example: img_a1b2c3d4e5f6)
repository_id	string	Identifier of the repository the image belongs to. (example: repo_a1b2c3d4e5f6) (wire: repositoryId)
arch	string	CPU architecture the manifest targets. Only present for single-platform manifests. (example: amd64)
created_at	string	ISO 8601 timestamp of when the image was created. (example: 2026-06-30T10:00:00.000Z) (wire: createdAt)
kind	string	Whether the manifest is a multi-platform image index, a single-platform image manifest or an attestation. (attestation, index, manifest)
manifest_digest	string	SHA-256 digest of the image manifest. (example: sha256:2c4e8f3a1b9d0e5c7a6f4b2d8e1c9a0b3d5f7e9c1a2b4d6f8e0c2a4b6d8f0e2c) (wire: manifestDigest)
platform	string	Operating system the manifest targets. Only present for single-platform manifests. (example: linux)
pushed_by	string	Identifier of the actor that pushed the image. (wire: pushedBy)
size_in_bytes	number	Total size in bytes of the image's resources (manifest, config and layer blobs) stored by the registry. (wire: sizeInBytes)
status	string	VHS-readiness status, or null for a multi-platform index. (preparing, ready, unoptimized, )
tags	array	Tags pointing at this image's manifest.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	project_id, id_or_name, image_id_or_digest	team_id, slug	Fetch an individual image from a repository, including its tags and Dockerfile history entries with discriminated layer details for UI rendering. The image may be addressed by its internal id (image_...) or by its manifest digest (sha256:...).
list	select	project_id, id_or_name	limit, cursor, untagged, team_id, slug	List images for a container registry repository, including their tags.
delete	delete	project_id, id_or_name, image_id	team_id, slug	Schedule an image for deletion. The image is marked so it disappears from list/get immediately; subscriber-vcr reclaims the manifest, blobs, tags and row asynchronously via the VcrManifestRemoved event.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
id_or_name	string
image_id	string
image_id_or_digest	string	The internal image id (image_...) or the image manifest digest (sha256:...).
project_id	string	Project ID. Missing or empty values return HTTP 400. (wire: projectId)
cursor	string	Opaque pagination cursor returned by a previous list response.
limit	integer
slug	string	The Team slug to perform the request on behalf of.
team_id	string	The Team identifier to perform the request on behalf of. (wire: teamId)
untagged	boolean

SELECT examples

get

Fetch an individual image from a repository, including its tags and Dockerfile history entries with discriminated layer details for UI rendering. The image may be addressed by its internal id (image_...) or by its manifest digest (sha256:...).

SELECT
id,
repository_id,
arch,
created_at,
kind,
layers,
manifest_digest,
platform,
pushed_by,
size_in_bytes,
status,
tags
FROM vercel.vcr.images
WHERE project_id = '{{ project_id }}' -- required
AND id_or_name = '{{ id_or_name }}' -- required
AND image_id_or_digest = '{{ image_id_or_digest }}' -- required
AND team_id = '{{ team_id }}'
AND slug = '{{ slug }}'
;

list

List images for a container registry repository, including their tags.

SELECT
id,
repository_id,
arch,
created_at,
kind,
manifest_digest,
platform,
pushed_by,
size_in_bytes,
status,
tags
FROM vercel.vcr.images
WHERE project_id = '{{ project_id }}' -- required
AND id_or_name = '{{ id_or_name }}' -- required
AND limit = '{{ limit }}'
AND cursor = '{{ cursor }}'
AND untagged = '{{ untagged }}'
AND team_id = '{{ team_id }}'
AND slug = '{{ slug }}'
;

DELETE examples

delete

Schedule an image for deletion. The image is marked so it disappears from list/get immediately; subscriber-vcr reclaims the manifest, blobs, tags and row asynchronously via the VcrManifestRemoved event.

DELETE FROM vercel.vcr.images
WHERE project_id = '{{ project_id }}' --required
AND id_or_name = '{{ id_or_name }}' --required
AND image_id = '{{ image_id }}' --required
AND team_id = '{{ team_id }}'
AND slug = '{{ slug }}'
;