Skip to main content

​
vers repo tag get

Print detailed information about a single tag: its ID, reference, the commit it points at, and timestamps.

​
Synopsis

vers repo tag get <repo-name> <tag-name>
vers repo tag get <repo-name> <tag-name> --format json

​
Options

OptionDescription
--formatOutput format: json

​
Examples

​
Default output

vers repo tag get my-app latest
# Tag:         latest
# Tag ID:      …
# Reference:   my-app:latest
# Commit:      c7e4a2f1-1234-5678-9abc-def012345678
# Created:     2026-04-18 14:02:10
# Updated:     2026-04-20 09:14:22
# Description: Current main build

​
JSON

vers repo tag get my-app latest --format json

{
  "tag_id": "…",
  "tag_name": "latest",
  "reference": "my-app:latest",
  "commit_id": "c7e4a2f1-…",
  "created_at": "2026-04-18T14:02:10Z",
  "updated_at": "2026-04-20T09:14:22Z",
  "description": "Current main build"
}

​
Resolving a ref to a commit ID

COMMIT=$(vers repo tag get my-app latest --format json | jq -r .commit_id)
For most uses you’d just pass the ref directly to vers run-commit my-app:latest --ref. Resolving to a raw commit ID is useful when you want to pin the exact commit in a script or config (refs move, commits don’t).

​
Error Cases

​
Repository or tag not found

vers repo tag get ghost latest
# Error: Repository or tag not found

vers repo tag get my-app ghost
# Error: Repository or tag not found

​
See Also