Skip to content
Open Console

tanomis agent rm

1 min readUpdated

Generated from the tanomis command tree on 2026-10-01. Flags and defaults match the binary; run tanomis agent rm –help for the version you have installed.

Usage
tanomis agent rm NAME [flags]

Soft-retire exactly one agent registration while preserving its audit history. The scope selector is mandatory because global and tenant-scoped agents may share a name. Use --scope global, or --scope tenant with --scope-tenant-id TENANT.

Aliases: remove.

Flag Type Description
--scope string Registration scope to retire: global or tenant (required).
--scope-tenant-id string Owning tenant id (required with --scope tenant).
--yes bool Skip the confirmation prompt.
Global flags
Flag Type Description
--config string Config file path.
--context string Config context to use.
-o, --output string Output format: table|json.
--tenant string Tenant id (X-Tenant-ID).
--verbose bool Verbose output.