Skip to content

cub filter list

cub filter list

List filters

Synopsis

List filters you have access to in a space or across all spaces.

Examples: 

  # List all filters in a space with headers
  cub filter list --space my-space

  # List filters across all spaces (requires --space "*")
  cub filter list --space "*" --where "From = 'Unit'"

  # List filters without headers for scripting
  cub filter list --space my-space --no-header

  # List filters in JSON format
  cub filter list --space my-space --json

  # List only filter names
  cub filter list --space my-space --no-header --names

  # List filters with a specific From type
  cub filter list --space my-space --where "From = 'Unit'"

  # List filters with resource type
  cub filter list --space my-space --where "ResourceType LIKE 'apps/v1/%'"

  # List filters that match a specific entity
  cub filter list --space my-space --entity-type Unit --entity-id my-unit

  # List filters that match a space (works across all spaces)
  cub filter list --space "*" --entity-type Space --entity-id my-space

cub filter list [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
      --entity-id string     Entity ID or slug to filter for. Must be specified together with --entity-type.
      --entity-type string   Entity type to filter for (e.g., Space). Must be specified together with --entity-id.
      --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