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'