Skip to main content
Unlink this Ultra gateway from its workspace. After unlinking, the gateway stops syncing with Ultra Hub. Local data and configuration are preserved.

Usage

ultra unlink [flags]

Flags

FlagShortDefaultDescription
--force-ffalseSkip confirmation prompt

Examples

# Unlink interactively (with confirmation)
ultra unlink

# Unlink without confirmation
ultra unlink --force

What Happens

  1. Notifies Hub that this gateway is disconnecting
  2. Clears gateway ID and workspace ID from local config
  3. Preserves authentication tokens (for future re-linking)
  4. Keeps all local data intact
If the Hub notification fails (e.g., network error), the local cleanup still proceeds.

Re-Linking

After unlinking, you can link to the same or a different workspace:
ultra link