vers repo tag update <repo-name> <tag-name> --commit <new-commit-id>
vers repo tag update <repo-name> <tag-name> --description "new text"
vers repo tag update <repo-name> <tag-name> --commit <id> --description "text"

vers commit              # → new commit c9e4…
vers repo tag update my-app latest --commit c9e4…
# ✓ Tag 'latest' in 'my-app' updated

vers commit
# ✓ Commit c9e4… created

vers repo tag update my-app latest --commit c9e4…

# Your team's latest is broken; pin it to the previous known-good commit.
OLD=$(vers repo tag get my-app known-good --format json | jq -r .commit_id)
vers repo tag update my-app latest --commit "$OLD"

vers repo tag update my-app known-good -d "2026-04-17 release candidate"

vers repo tag update my-app staging --commit c9e4… -d "Rebuilt after migration 0042"

vers repo tag update ghost latest --commit c9e4…
# Error: Repository, tag, or commit not found

vers repo tag update my-app latest --commit 00000000-…
# Error: commit not found
# or: forbidden   (commit exists in another org)

vers repo tag update my-app latest
# Error: at least one of --commit or --description must be provided