expanso-cli profile delete

`expanso-cli profile delete`

Delete a profile

Synopsis

Delete a connection profile.

What Gets Deleted:

Permanently removes the profile configuration file from: ~/.expanso/cli-client/profiles/PROFILE_NAME.yaml

This includes all settings: endpoint URL, authentication credentials, TLS configuration, and metadata.

When To Delete:

• Decommissioned environment no longer exists • Credentials have been rotated and profile needs to be recreated • Cleaning up old test/temporary profiles • Removing profiles for environments you no longer access

Safety Checks:

• Asks for confirmation before deleting (unless --force is used) • Warns if you're deleting the currently selected profile • After deleting current profile, you'll need to select another

Recovering:

Profile deletion is permanent. If you might need the profile again, consider using 'profile show' to export it before deleting: expanso-cli profile show old-env > backup.json

expanso-cli profile delete PROFILE_NAME [flags]

Examples

  # Delete a profile (asks for confirmation)
  expanso-cli profile delete old-staging

  # Delete without confirmation
  expanso-cli profile delete temp-test --force

  # Backup before deleting
  expanso-cli profile show old-env > old-env-backup.json
  expanso-cli profile delete old-env

Options

  -f, --force   Force deletion without confirmation
  -h, --help    help for delete

Options inherited from parent commands

      --api-key string    API key for authentication (e.g., exp_ak_...). Env: EXPANSO_CLI_AUTH_API_KEY (preferred; flag values show in ps output)
  -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