tags

Creates, updates, deletes, gets or lists a tags resource.

Overview

Name	tags
Type	Resource
Id	vercel.vcr.tags

Fields

The following fields are returned by SELECT queries:

get

A tag pointing at an image in a Vercel Container Registry repository, enriched with the backing image's metadata and VHS-readiness status.

Name	Datatype	Description
image_id	string	Internal identifier of the image the tag points at. (example: img_a1b2c3d4e5f6) (wire: imageId)
arch	string	CPU architecture the manifest targets. Only present for single-platform manifests. (example: amd64)
created_at	string	ISO 8601 timestamp of when the tag 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 the tag points at. (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, )
tag	string	The tag name. (example: latest)
updated_at	string	ISO 8601 timestamp of when the tag was last updated. (example: 2026-06-30T10:00:00.000Z) (wire: updatedAt)

list

Name	Datatype	Description
image_id	string	(wire: imageId)
arch	string
created_at	string	(wire: createdAt)
kind	string	(attestation, index, manifest)
manifest_digest	string	(wire: manifestDigest)
platform	string
pushed_by	string	(wire: pushedBy)
size_in_bytes	number	(wire: sizeInBytes)
status	string	(preparing, ready, unoptimized, )
tag	string
updated_at	string	(wire: updatedAt)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	project_id, id_or_name, tag	team_id, slug	Fetch a single tag from a repository, including the backing image's metadata and VHS-readiness status.
list	select	project_id, id_or_name	limit, cursor, sort_by, sort_order, team_id, slug	List a repository's tags.

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
project_id	string	Project ID. Missing or empty values return HTTP 400. (wire: projectId)
tag	string
cursor	string
limit	integer
slug	string	The Team slug to perform the request on behalf of.
sort_by	string	Field to sort the non-pinned tags by. (wire: sortBy)
sort_order	string	Sort direction. Defaults to desc. (wire: sortOrder)
team_id	string	The Team identifier to perform the request on behalf of. (wire: teamId)

SELECT examples

get

Fetch a single tag from a repository, including the backing image's metadata and VHS-readiness status.

SELECT
image_id,
arch,
created_at,
kind,
manifest_digest,
platform,
pushed_by,
size_in_bytes,
status,
tag,
updated_at
FROM vercel.vcr.tags
WHERE project_id = '{{ project_id }}' -- required
AND id_or_name = '{{ id_or_name }}' -- required
AND tag = '{{ tag }}' -- required
AND team_id = '{{ team_id }}'
AND slug = '{{ slug }}'
;

list

List a repository's tags.

SELECT
image_id,
arch,
created_at,
kind,
manifest_digest,
platform,
pushed_by,
size_in_bytes,
status,
tag,
updated_at
FROM vercel.vcr.tags
WHERE project_id = '{{ project_id }}' -- required
AND id_or_name = '{{ id_or_name }}' -- required
AND limit = '{{ limit }}'
AND cursor = '{{ cursor }}'
AND sort_by = '{{ sort_by }}'
AND sort_order = '{{ sort_order }}'
AND team_id = '{{ team_id }}'
AND slug = '{{ slug }}'
;