prune

Here's the command-line help for this action in the most recent version of borgmatic. If you're using an older version, some of these flags may not work, and you should instead run the action with --help to see the flags specific to your borgmatic version.

usage: borgmatic prune [--repository REPOSITORY] [-a PATTERN] [--stats]
                       [--list] [--oldest TIMESPAN] [--newest TIMESPAN]
                       [--older TIMESPAN] [--newer TIMESPAN] [-h]

Prune archives according to the retention policy (with Borg 1.2+, you must run
compact afterwards to actually free space)

prune arguments:
  --repository REPOSITORY
                        Path of specific existing repository to prune (must be
                        already specified in a borgmatic configuration file),
                        quoted globs supported
  -a PATTERN, --match-archives PATTERN, --glob-archives PATTERN
                        When pruning, only consider archives with names,
                        hashes, or series matching this pattern
  --stats               Display statistics of the pruned archive [Borg 1 only]
  --list                List archives kept/pruned
  --oldest TIMESPAN     Prune archives within a specified time range starting
                        from the timestamp of the oldest archive (e.g. 7d or
                        12m) [Borg 2.x+ only]
  --newest TIMESPAN     Prune archives within a time range that ends at
                        timestamp of the newest archive and starts a specified
                        time range ago (e.g. 7d or 12m) [Borg 2.x+ only]
  --older TIMESPAN      Prune archives that are older than the specified time
                        range (e.g. 7d or 12m) from the current time [Borg
                        2.x+ only]
  --newer TIMESPAN      Prune archives that are newer than the specified time
                        range (e.g. 7d or 12m) from the current time [Borg
                        2.x+ only]
  -h, --help            Show this help message and exit