Skip to content

bb tag

Create, list, view and delete tags

4 commands.

bb tag create
Create repository tag
bb tag delete
Delete repository tag
bb tag list
List repository tags
bb tag view
View repository tag

bb tag create

Create repository tag

bb tag create <name> [flags]

# Tag the tip of main
bb tag create v1.2.0 --start-point main --repo PROJ/repo

# An annotated tag on a commit
bb tag create v1.2.0 --start-point a1b2c3d --message "Release 1.2.0" --repo PROJ/repo
--message string
Optional annotated tag message
--start-point string
Commit ID or ref to tag

Inherited from bb tag:

--repo string
Repository as PROJECT/slug (defaults to the repository of the git checkout you are in, then BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)

Also takes the global flags.

Dry run: Checks your permission and the current state this depends on, without changing anything (preconditions-checked)

Output with --json, where ? marks a field that can be absent 
data
  id?               string             Full tag ref name, for example refs/tags/v1.0.0.
  displayId?        string             Short tag name, for example v1.0.0.
  type?             TAG|ANNOTATED_TAG  TAG for a lightweight tag, ANNOTATED_TAG for one carrying its own object.
  latestCommit?     string             SHA1 of the commit the tag points at.
  latestChangeset?  string             SHA1 of the tagged changeset.
  hash?             string             SHA1 of the tag object itself.

bb tag delete

Delete repository tag

bb tag delete <tag> [flags]

# Delete a tag; at a terminal bb asks first
bb tag delete v1.2.0 --repo PROJ/repo

# In a script, where nobody can be asked
bb tag delete v1.2.0 --repo PROJ/repo --yes
-y, --yes
Confirm without being asked; applies only when the target is named with --repo PROJECT/slug

Inherited from bb tag:

--repo string
Repository as PROJECT/slug (defaults to the repository of the git checkout you are in, then BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)

Also takes the global flags.

Dry run: Checks your permission and the current state this depends on, without changing anything (preconditions-checked)

Output with --json, where ? marks a field that can be absent 
data
  status  string  Always ok when the command succeeds; a failure reports an error envelope instead.
  tag     string  Short name of the tag that was deleted.

bb tag list

List repository tags

bb tag list [flags]

# A repository's tags
bb tag list --repo PROJ/repo

# The 1.x releases, most recently changed first
bb tag list --repo PROJ/repo --filter v1. --order-by MODIFICATION
--all
Return every result rather than the first --limit
--filter string
Filter text for tag names
--limit int
Maximum number of results to return (default 25)
--order-by string
Tag ordering (one of: ALPHABETICAL, MODIFICATION)
--start int
Start offset for list operations

Inherited from bb tag:

--repo string
Repository as PROJECT/slug (defaults to the repository of the git checkout you are in, then BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)

Also takes the global flags.

Dry run: Runs as usual: this command changes nothing, so there is nothing to hold back

Output with --json, where ? marks a field that can be absent 
data                list of object
  id?               string             Full tag ref name, for example refs/tags/v1.0.0.
  displayId?        string             Short tag name, for example v1.0.0.
  type?             TAG|ANNOTATED_TAG  TAG for a lightweight tag, ANNOTATED_TAG for one carrying its own object.
  latestCommit?     string             SHA1 of the commit the tag points at.
  latestChangeset?  string             SHA1 of the tagged changeset.
  hash?             string             SHA1 of the tag object itself.

bb tag view

View repository tag

bb tag view <tag>

# The commit a tag points at
bb tag view v1.2.0 --repo PROJ/repo

Inherited from bb tag:

--repo string
Repository as PROJECT/slug (defaults to the repository of the git checkout you are in, then BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG)

Also takes the global flags.

Dry run: Runs as usual: this command changes nothing, so there is nothing to hold back

Output with --json, where ? marks a field that can be absent 
data
  id?               string             Full tag ref name, for example refs/tags/v1.0.0.
  displayId?        string             Short tag name, for example v1.0.0.
  type?             TAG|ANNOTATED_TAG  TAG for a lightweight tag, ANNOTATED_TAG for one carrying its own object.
  latestCommit?     string             SHA1 of the commit the tag points at.
  latestChangeset?  string             SHA1 of the tagged changeset.
  hash?             string             SHA1 of the tag object itself.