Skip to main content

Delete

expanso-cli node delete

Delete a node

Synopsis

Soft-delete a node and mark it as deleted. The node data is preserved for audit purposes and will be permanently removed after the garbage collection retention period.

expanso-cli node delete NODE_ID_OR_NAME [flags]

Examples

  # Delete a disconnected node
expanso-cli node delete my-node

# Delete a node by ID
expanso-cli node delete node-abc123

# Skip confirmation prompt
expanso-cli node delete my-node --yes

# Force delete a connected node (dangerous - node will reconnect if still online)
expanso-cli node delete my-node --force

# Skip confirmation and force deletion
expanso-cli node delete my-node --yes --force

# Delete with a custom reason
expanso-cli node delete my-node --reason "Hardware decommissioned"

# View deleted nodes
expanso-cli node list --state deleted

Options

  -f, --force           Force deletion even if node is connected
-h, --help help for delete
--reason string Reason for deletion
-y, --yes Skip confirmation prompt

Options inherited from parent commands

      --auth-token string   API bearer authentication token
-e, --endpoint string API endpoint URL
-k, --insecure Skip TLS certificate verification
-p, --profile string Profile to use for configuration
--timeout string Request timeout duration
-v, --verbose Enable verbose logging

SEE ALSO

Auto generated by spf13/cobra on 19-Nov-2025