Skip to content

cub mutation list

cub mutation list

List mutations

Synopsis

List mutations for a unit in a space. Mutations track the history of detailed mutations made to a unit's configuration.

Examples: 

  # List all mutations for a unit
  cub mutation list --space my-space my-ns

  # List mutations without headers
  cub mutation list --space my-space --no-header my-ns

  # List mutations in JSON format
  cub mutation list --space my-space --json my-ns

  # List mutations using unit ID instead of slug
  cub mutation list --space my-space --by-unit-id 61f26b06-3c34-4363-8b9d-7d0a7c2b5f1c

  # List mutations with custom JQ filter
  cub mutation list --space my-space --jq '.[].MutationNum' my-ns

  # List mutations with specific criteria
  cub mutation list --space my-space --where 'MutationNum > 1' my-ns

cub mutation list <unit> [flags]

Options

      --contains string   Free text search for entities containing the specified text. Searches across string fields (like Slug, DisplayName) and map fields (like Labels, Annotations). Case-insensitive matching. Can be combined with --where using AND logic. Example: "backend" to find entities with backend in any searchable field
      --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 list
      --jq string         jq expression, suppressing default output
      --json              JSON output, suppressing default output
      --names             Only output names, suppressing default output
      --no-header         No header for lists
      --quiet             No default output.
      --select string     Comma-separated list of fields to retrieve and display. Entity IDs and Slug are always included. Example: "DisplayName,CreatedAt,Labels"
      --verbose           Detailed output, additive with default output
      --where string      Filter expression using SQL-inspired syntax. Supports conjunctions with AND. String operators: =, !=, <, >, <=, >=, LIKE, ILIKE, ~~, !~~, ~, ~*, !~, !~*. Pattern matching with LIKE/ILIKE uses % and _ wildcards. Regex operators (~, ~*, !~, !~*) support POSIX regular expressions. Examples: "Slug LIKE 'app-%'", "DisplayName ILIKE '%backend%'", "Slug ~ '^[a-z]+-[0-9]+$'"
      --yaml              YAML output, suppressing default output
      --yq string         yq expression, suppressing default output

Options inherited from parent commands

      --context string   The context to use for this command
      --debug            Debug output
      --space string     space ID to perform command on

SEE ALSO