Skip to content

cub tag move

cub tag move

Move tags to another space

Synopsis

Move tags to another space.

A tag keeps its identity: everything that uses it refers to it by ID and keeps using it. Moving requires Manage permission on each tag and CreateChildren permission on the destination space.

The revisions a tag marks keep their marks. A tag that a changeset, changeorder or release made for itself stays with its owner; move a changeset to move its tags.

Every check runs over the whole selection before anything moves, so a move that would collide with a name in the destination moves nothing. Rename first if a name is taken; --dry-run reports what a move would do.

Examples: 

  # Move one tag
  cub tag move --space my-space my-tag other-space

  # Move every tag with a label
  cub tag move --space my-space --where "Labels.team = 'web'" other-space

  # Preview a move across all spaces
  cub tag move --where "Labels.team = 'web'" --dry-run other-space

  # Move specific tags by slug
  cub tag move --space my-space --tag my-tag,another-tag other-space

cub tag move [<tag-slug>] <to-space> [flags]

Options

      --dry-run         report what the move would do without moving anything
      --filter string   Filter entity to apply to the list. Specify as 'space/filter' for cross-space filters or just 'filter' for current space. Supports both slugs and UUIDs. The filter will be combined with any --where clause using AND logic. Examples: "production-filters/security-check", "my-filter-uuid", "validation-rules"
  -h, --help            help for move
  -o, --output string   Output format. One of: json, yaml, name, wide, mutations, jq=<expr>, yq=<expr>, custom-columns=<spec>
      --quiet           No default output.
      --tag strings     move specific tags by slug or UUID (can be repeated or comma-separated)
      --where string    Filter expression using SQL-inspired syntax. Supports conjunctions with AND. String operators: =, !=, <, >, <=, >=, LIKE, NOT LIKE, ILIKE, ~~, !~~, ~, ~*, !~, !~*. Pattern matching with LIKE/ILIKE uses % and _ wildcards. Regex operators (~, ~*, !~, !~*) support POSIX regular expressions. A related entity is referenced by prefix, as in "UpstreamUnit.Slug = 'base'"; when the reference names a list, a * segment matches any element, as in "FromLink.*.Slug = 'upgrade-app'". Examples: "Slug LIKE 'app-%'", "DisplayName ILIKE '%backend%'", "Slug ~ '^[a-z]+-[0-9]+$'"

Options inherited from parent commands

      --context string   The context to use for this command
      --debug            Debug output
      --space string     space to operate in, by slug or UUID. Omitted, a list or bulk operation spans the organization and a single entity is named as <space>/<slug>

SEE ALSO