Skip to content

Suggested searches

    Search all documentation ↑↓ to navigate Enter to open Esc to close

    prb tag command reference

    Reference for 7 commands under prb tag, including usage, flag types and defaults, required flags, source examples, and implementation links

    Markdown

    Manage tags. This page documents 7 commands under prb tag.

    Flags and examples below come from the command definitions. A Required flag is explicitly marked required by Cobra; an unmarked flag can still be needed by runtime validation or a non-interactive workflow. Empty strings and empty lists are registered defaults, not sample values.

    Every command also inherits the global flags. Run prb <command> --help to check your installed version. Replace placeholder IDs and names in source examples before running them. Return to the complete CLI command reference to browse another command.

    CommandDescriptionUsageSource
    prb tagManage tags.prb tag <command>View implementation
    prb tag attachAttach a tag to a resource.prb tag attachView implementation
    prb tag createCreate a tag.prb tag createView implementation
    prb tag deleteDelete a tag.prb tag deleteView implementation
    prb tag detachDetach a tag from a resource.prb tag detachView implementation
    prb tag listList tags in an organization or on a resource.prb tag listView implementation
    prb tag updateUpdate a tag.prb tag updateView implementation

    Manage tags.

    prb tag <command>

    View command implementation.

    Attach a tag to a resource.

    prb tag attach

    Accepts no positional arguments.

    Attach a tag to a resource. Attaching a tag that is already present is a no-op.
    FlagTypeDefaultRequiredDescription
    --resource-idstring""—ID of the resource to tag
    --tag-idstring""—ID of the tag to attach
    Terminal window
    # Attach a tag interactively
    prb tag attach --resource-id prbdoc_...
    # Attach a tag non-interactively
    prb tag attach --resource-id prbdoc_... --tag-id prbrtg_...

    View command implementation.

    Create a tag.

    prb tag create

    Accepts no positional arguments.

    FlagTypeDefaultRequiredDescription
    --colorstring""—Optional hex color (#RGB or #RRGGBB)
    --namestring""—Tag name; unique within the organization
    --orgstring""—Organization ID
    Terminal window
    # Create a tag interactively
    prb tag create
    # Create a tag non-interactively
    prb tag create --org prborg_... --name Production --color "#FF0000"

    View command implementation.

    Delete a tag.

    prb tag delete

    Accepts no positional arguments.

    FlagTypeDefaultRequiredDescription
    --idstring""—Tag ID
    --tag-idstring""—Tag ID
    --yes, -ybooleanfalse—Skip confirmation prompt
    Terminal window
    # Delete a tag interactively
    prb tag delete --id prbrtg_...
    # Delete without confirmation
    prb tag delete --tag-id prbrtg_... --yes

    View command implementation.

    Detach a tag from a resource.

    prb tag detach

    Accepts no positional arguments.

    FlagTypeDefaultRequiredDescription
    --resource-idstring""—ID of the resource to untag
    --tag-idstring""—ID of the tag to detach
    Terminal window
    # Detach a tag interactively
    prb tag detach --resource-id prbdoc_...
    # Detach a tag non-interactively
    prb tag detach --resource-id prbdoc_... --tag-id prbrtg_...

    View command implementation.

    List tags in an organization or on a resource.

    prb tag list

    Accepts no positional arguments.

    FlagTypeDefaultRequiredDescription
    --afterstring""—Cursor to continue listing from
    --jsonbooleanfalse—Output JSON (same as —output json)
    --limit, -Linteger30—Maximum number of tags to list
    --order-bystring""—Order by field (CREATED_AT, NAME)
    --order-directionstring"DESC"—Sort direction (ASC, DESC)
    --orgstring""—Organization ID
    --output, -ostring""—Output format: json, table (default)
    --resourcestring""—Resource ID whose attached tags to list
    Terminal window
    # List tags in the default organization
    prb tag list
    # List tags for a specific organization
    prb tag list --org prborg_... --output json
    # List tags attached to a resource
    prb tag list --resource prbdoc_...

    View command implementation.

    Update a tag.

    prb tag update

    Accepts no positional arguments.

    FlagTypeDefaultRequiredDescription
    --colorstring""—Hex color (#RGB or #RRGGBB); pass an empty value to clear it
    --idstring""—Tag ID
    --namestring""—Tag name; unique within the organization
    Terminal window
    # Update a tag interactively
    prb tag update --id prbrtg_...
    # Update the name
    prb tag update --id prbrtg_... --name Staging
    # Remove the color
    prb tag update --id prbrtg_... --color ""

    View command implementation.