tags:create

Create a reusable tag on a graph root.

Reference for flywheel tags:create.

Command Group

Nodes & Graph Commands

Summary

Create a reusable tag on a graph root.

Usage

flywheel tags:create <FLAGS>

Required flags

FlagValueDefaultChoicesDescription
--root_node_idstringRoot node (graph) identifier.
--namestringTag display name.
--expected_revisionintegerRoot revision to optimistically lock against.
--bg_colorstringBackground color (e.g. #ff0000).
--text_colorstringForeground text color (e.g. #ffffff).

Optional flags

FlagValueDefaultChoicesDescription
--one_onlyEnforce at most one assignment of this tag per node.
--track_historyKeep a history record when this one_only tag is reassigned.
--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

Create a new tag with colors.

flywheel tags:create --root_node_id r_root --name urgent --expected_revision 12 --bg_color "#ff0000" --text_color "#ffffff"