prb tag command reference
Reference for 7 commands under prb tag, including usage, flag types and defaults, required flags, source examples, and implementation links
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.
Commands
Section titled “Commands”| Command | Description | Usage | Source |
|---|---|---|---|
prb tag | Manage tags. | prb tag <command> | View implementation |
prb tag attach | Attach a tag to a resource. | prb tag attach | View implementation |
prb tag create | Create a tag. | prb tag create | View implementation |
prb tag delete | Delete a tag. | prb tag delete | View implementation |
prb tag detach | Detach a tag from a resource. | prb tag detach | View implementation |
prb tag list | List tags in an organization or on a resource. | prb tag list | View implementation |
prb tag update | Update a tag. | prb tag update | View implementation |
prb tag
Section titled “prb tag”Manage tags.
prb tag <command>prb tag attach
Section titled “prb tag attach”Attach a tag to a resource.
prb tag attachAccepts no positional arguments.
Additional help
Section titled “Additional help”Attach a tag to a resource. Attaching a tag that is already present is a no-op.| Flag | Type | Default | Required | Description |
|---|---|---|---|---|
--resource-id | string | "" | — | ID of the resource to tag |
--tag-id | string | "" | — | ID of the tag to attach |
Examples
Section titled “Examples”# Attach a tag interactivelyprb tag attach --resource-id prbdoc_...
# Attach a tag non-interactivelyprb tag attach --resource-id prbdoc_... --tag-id prbrtg_...prb tag create
Section titled “prb tag create”Create a tag.
prb tag createAccepts no positional arguments.
| Flag | Type | Default | Required | Description |
|---|---|---|---|---|
--color | string | "" | — | Optional hex color (#RGB or #RRGGBB) |
--name | string | "" | — | Tag name; unique within the organization |
--org | string | "" | — | Organization ID |
Examples
Section titled “Examples”# Create a tag interactivelyprb tag create
# Create a tag non-interactivelyprb tag create --org prborg_... --name Production --color "#FF0000"prb tag delete
Section titled “prb tag delete”Delete a tag.
prb tag deleteAccepts no positional arguments.
| Flag | Type | Default | Required | Description |
|---|---|---|---|---|
--id | string | "" | — | Tag ID |
--tag-id | string | "" | — | Tag ID |
--yes, -y | boolean | false | — | Skip confirmation prompt |
Examples
Section titled “Examples”# Delete a tag interactivelyprb tag delete --id prbrtg_...
# Delete without confirmationprb tag delete --tag-id prbrtg_... --yesprb tag detach
Section titled “prb tag detach”Detach a tag from a resource.
prb tag detachAccepts no positional arguments.
| Flag | Type | Default | Required | Description |
|---|---|---|---|---|
--resource-id | string | "" | — | ID of the resource to untag |
--tag-id | string | "" | — | ID of the tag to detach |
Examples
Section titled “Examples”# Detach a tag interactivelyprb tag detach --resource-id prbdoc_...
# Detach a tag non-interactivelyprb tag detach --resource-id prbdoc_... --tag-id prbrtg_...prb tag list
Section titled “prb tag list”List tags in an organization or on a resource.
prb tag listAccepts no positional arguments.
| Flag | Type | Default | Required | Description |
|---|---|---|---|---|
--after | string | "" | — | Cursor to continue listing from |
--json | boolean | false | — | Output JSON (same as —output json) |
--limit, -L | integer | 30 | — | Maximum number of tags to list |
--order-by | string | "" | — | Order by field (CREATED_AT, NAME) |
--order-direction | string | "DESC" | — | Sort direction (ASC, DESC) |
--org | string | "" | — | Organization ID |
--output, -o | string | "" | — | Output format: json, table (default) |
--resource | string | "" | — | Resource ID whose attached tags to list |
Examples
Section titled “Examples”# List tags in the default organizationprb tag list
# List tags for a specific organizationprb tag list --org prborg_... --output json
# List tags attached to a resourceprb tag list --resource prbdoc_...prb tag update
Section titled “prb tag update”Update a tag.
prb tag updateAccepts no positional arguments.
| Flag | Type | Default | Required | Description |
|---|---|---|---|---|
--color | string | "" | — | Hex color (#RGB or #RRGGBB); pass an empty value to clear it |
--id | string | "" | — | Tag ID |
--name | string | "" | — | Tag name; unique within the organization |
Examples
Section titled “Examples”# Update a tag interactivelyprb tag update --id prbrtg_...
# Update the nameprb tag update --id prbrtg_... --name Staging
# Remove the colorprb tag update --id prbrtg_... --color ""