Skip to content

cub revision list

cub revision list

List revisions

Synopsis

List revisions for a unit in a space, or across all spaces when selectedSpaceID is "*". The output includes revision numbers, timestamps, usernames, sources, descriptions, apply gates, and tags. Revisions track the history of changes made to a unit's configuration.

Examples: 

  # List all revisions for a unit
  cub revision list --space my-space my-ns

  # List revisions without headers
  cub revision list --space my-space --no-header my-ns

  # List revisions in JSON format
  cub revision list --space my-space --json my-ns

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

  # List revisions with custom JQ filter
  cub revision list --space my-space --jq '.[].RevisionNum' my-ns

  # List revisions with specific criteria
  cub revision list --space my-space --where 'RevisionNum > 1' my-ns

  # List revisions across all spaces (organization-wide search, at most one revision per unit)
  cub revision list --space '*' --where 'Tags.my-tag-id = "some-value"'

cub revision list [unit] [flags]

Options

      --changeset-endtag string     filter revisions by changeset end tag slug or UUID
      --changeset-starttag string   filter revisions by changeset start tag slug or UUID
      --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"
      --tag string                  filter revisions by tag slug or UUID
      --verbose                     Detailed output, additive with default output
      --web                         Open in web UI instead of executing
      --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