glab(1)

NAME
glab-container-registry-tag-delete - Delete container registry tags.

SYNOPSIS
glab container-registry tag delete [] [flags]

DESCRIPTION
Delete one container registry tag by name, or delete matching tags in bulk by filter.

Deleting a single tag is synchronous. Bulk deletion is scheduled asynchronously by GitLab; matching tags may remain visible until the background deletion job has completed.

To bulk delete tags, omit and provide at least one bulk deletion flag: --name-regex-delete, --name-regex-keep, --keep-n, or --older-than.

The repository ID must belong to the selected project. Use -R/--repo to specify the owning project when running this command outside that project's Git checkout.

OPTIONS
--keep-n=0
    Keep the latest N matching tags. Bulk deletion only; scheduled asynchronously.

--name-regex-delete=""
    Regular expression for tag names to delete. Bulk deletion only; scheduled asynchronously.

--name-regex-keep=""
    Regular expression for tag names to keep. Bulk deletion only; scheduled asynchronously.

--older-than=""
    Delete tags older than the given duration, such as 7d or 1month. Bulk deletion only; scheduled asynchronously.

-y, --yes[=false]
    Skip the confirmation prompt.

OPTIONS INHERITED FROM PARENT COMMANDS
-h, --help[=false]
    Show help for this command.

-R, --repo=""
    Select another repository. You can use either OWNER/REPO or GROUP/NAMESPACE/REPO. The full URL or Git URL is also accepted.

EXAMPLE
    # Delete a container registry tag with a confirmation prompt
    glab container-registry tag delete 123 latest
    # Skip the confirmation prompt
    glab container-registry tag delete 123 latest --yes
    # Schedule tags matching a regular expression for deletion
    glab container-registry tag delete 123 --name-regex-delete '^release-.*' --yes
    # Schedule old tags for deletion, but keep the 10 most recent matching tags
    glab container-registry tag delete 123 --name-regex-delete '.*' --keep-n 10 --older-than 30d --yes
    # Delete a container registry tag in another project
    glab container-registry tag delete 123 latest -R gitlab-org/cli

SEE ALSO
glab-container-registry-tag(1)