tags:assign

Assign or clear tags on a node (atomic replace).

Reference for flywheel tags:assign.

Command Group

Nodes & Graph Commands

Summary

Assign or clear tags on a node (atomic replace).

Usage

flywheel tags:assign <FLAGS>

Required flags

FlagValueDefaultChoicesDescription
--node_idstringTarget node identifier.
--tag_idsstringComma-separated list of tag IDs.
--expected_revisionintegerOptimistic lock revision.

Optional flags

FlagValueDefaultChoicesDescription
--formatFORMATjson, tsv, csv, tableOutput format for command results.
--envPROFILEUse a configured CLI profile for this invocation.
--outPATHWrite output to a file path, or use - for stdout.
--openOpen browser-bound URLs when supported.
--no-retryDisable transient-error retries.
--retry-maxNMaximum transient-error retry attempts.
--waitBlock on async operations until a terminal state is reached.
--wait-timeoutSECONDS600Seconds to wait for --wait before timing out. Defaults to 600.
--allow-selfAllow mutating the currently active credential.
--timeoutSECONDSSet the per-request timeout budget in seconds.
--idempotency-keyKEYReuse an Idempotency-Key so ambiguous write failures can be retried with the same key.
--forceForce safety-gated operations where supported.
--yesSkip confirmation prompts for destructive operations.
--debugPrint structured request debugging with secrets masked.
--verbosePrint verbose progress for long-running operations.
-h, --helpShow this help.

Examples

Assign two tags to a node.

flywheel tags:assign --node_id n_abc --tag_ids t1,t2 --expected_revision 22

Clear all tags.

flywheel tags:assign --node_id n_abc --tag_ids "" --expected_revision 22