Skip to content

cub unit-action list

cub unit-action list

List unit actions

Synopsis

List unit actions for a specific unit, or across all units when no unit is specified. When listing across units, at most one unit action is returned per unit (the latest one, ordered by UnitActionNum). Use --space '*' to search across all spaces in the Organization.

Examples: 

  # List unit actions for a specific unit
  cub unit-action list --space my-space my-unit

  # List the latest Apply unit action per unit in the space
  cub unit-action list --space my-space --where "Action = 'Apply'"

  # List the latest Apply unit actions started within the past 15 minutes across all spaces
  cub unit-action list --space '*' --where "Action = 'Apply' AND CreatedAt > '2026-04-15T12:00:00Z'"

cub unit-action list [unit-slug] [flags]

Options

      --columns strings   columns to display; can be repeated or comma-separated (e.g., Slug,Labels.Environment)
      --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
      --no-headers        Don't print headers for table output
  -o, --output string     Output format. One of: json, yaml, name, wide, mutations, jq=<expr>, yq=<expr>, custom-columns=<spec>
      --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, NOT 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]+$'"

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