lb retag

Synopsis

lb retag <node-id> [options]

Description

lb retag modifies the PARA tags on a node. Exactly one of --set, --add, or --remove must be provided per invocation.

• --set performs a full replacement of all tags on the node.
• --add and --remove perform incremental changes. The CLI fetches the node’s current tags first, applies the delta, and writes the result back.

Arguments

Argument	Description
node-id	Required. The ID of the node to retag.

Options

Option	Type	Description
--set <ids>	string	Comma-separated PARA item IDs. Replaces all current tags. Pass an empty string to clear all tags. Mutually exclusive with --add and --remove.
--add <ids>	string	Comma-separated PARA item IDs to add. Current tags not in this list are preserved. Mutually exclusive with --set and --remove.
--remove <ids>	string	Comma-separated PARA item IDs to remove. Other tags are preserved. Mutually exclusive with --set and --add.
--json	flag	Output raw JSON.
--api-url <url>	string	Override the API base URL.

Examples

Replace all tags (full replacement):

lb retag nd_abc123 --set proj_x1,area_y2

Clear all tags:

lb retag nd_abc123 --set ""

Add a tag without affecting others:

lb retag nd_abc123 --add proj_x1

Remove a specific tag:

lb retag nd_abc123 --remove area_y2

Output the updated node as JSON:

lb retag nd_abc123 --add proj_x1 --json | jq '.para_tags'