cub revision list

List revisions

Synopsis

List revisions for a unit in a space, or across all spaces when selectedSpaceID is "*". Revisions track the history of changes made to a unit's configuration.

The default output identifies each revision and shows what change management put on it: its ChangeSet, the ChangeOrders it belongs to, and its Tags, with the change description last and truncated. -o wide adds the timestamp, the user, the apply gates, and the Releases the revision has been bundled into, and shows the whole description. The ChangeOrders, Tags, and Releases columns are truncated in either layout, since each is a set; "cub revision get" and -o json show them in full.

Examples:

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

  # Include the timestamp, user, and apply gates, with untruncated descriptions
  cub revision list --space my-space -o wide my-ns

  # List the revisions a change order landed on, across every space it reached
  cub revision list --space '*' --change-order my-base/release-42

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

  # List revisions in JSON format
  cub revision list --space my-space -o 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 -o 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

      --change-order string         filter revisions by change order slug, space/slug, or UUID: the revisions the change landed on, in whichever space they are in
      --changeset-endtag string     filter revisions by changeset end tag slug or UUID
      --changeset-starttag string   filter revisions by changeset start tag slug or UUID
      --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"
      --tag string                  filter revisions by tag slug or UUID
      --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. 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 ID to perform command on

cub revision list