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