Remove Interface Command

The agent interfaces remove command removes a configured communication interface from an AI Agent, cleaning up associated resources and revoking access.

Usage

xpander agent interfaces remove <agent_id> <interface_name> [--force] [--keep-auth]

Options

OptionDescription
--forceOptional. Skip confirmation prompt
--keep-authOptional. Preserve authentication credentials for future use

Examples

Basic Interface Removal

xpander agent interfaces remove agent_123 slack

Response:

Removing Slack Interface
=======================
Agent: Support Agent (agent_123)
Interface: slack

This will:
- Deactivate the Slack bot
- Remove channel access
- Delete webhook endpoints
- Clean up associated resources

Do you want to proceed? [y/N] y

Step 1/3: Deactivating Interface
✓ Bot deactivated
✓ Channel access removed
✓ Webhooks deleted

Step 2/3: Cleaning Up
✓ Configuration removed
✓ Credentials deleted
✓ Cache cleared

Step 3/3: Verification
✓ Interface access verified as removed
✓ Agent configuration updated

Interface successfully removed!

Force Remove with Preserved Auth

xpander agent interfaces remove agent_123 teams --force --keep-auth

Response:

Removing Teams Interface
=======================
✓ Bot deactivated
✓ Access revoked
✓ Configuration removed
✓ Authentication preserved for future use
✓ Interface removed successfully

Notes

  • The remove command:
    • Deactivates any active bots or services
    • Removes interface-specific configuration
    • Deletes webhook endpoints
    • Cleans up associated resources
    • Updates agent configuration
  • Use --keep-auth if you plan to:
    • Re-add the interface later
    • Use the same authentication with another agent
  • The --force flag:
    • Skips confirmation prompts
    • Useful for scripted operations
    • Use with caution
  • Removal is permanent unless --keep-auth is used
  • Active conversations or sessions will be terminated