Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

aasm admin

Gateway administrative operations. The current scope is manual retention; more admin subcommands are added as the operator surface grows.

Synopsis

aasm admin <SUBCOMMAND> [OPTIONS]
SubcommandPurpose
run-retentionTrigger one manual retention pass against the running gateway.

The subcommand accepts the global options, honoring --output yaml (defaults to pretty JSON).


aasm admin run-retention

Trigger one manual retention pass (POST /api/v1/admin/retention-policy/run). Exits 0 on a successful pass, non-zero when the gateway is unreachable or returns a non-2xx status (the error chain is printed to stderr).

FlagTypeDefaultDescription
--dry-runflagoffLog what would be retained/dropped without taking any action.
aasm admin run-retention --dry-run
{
  "dry_run": true,
  "audit_events_scanned": 14293,
  "audit_events_dropped": 0
}

Last updated: 2026-06-11 by Chisanan232