HSX_E_LINK_PREFLIGHT_NAMESPACE

01 · Meaning

What this error means

A runtime binding references an INSTALL_KV namespace that no longer exists on the Cloudflare account, or whose id/name no longer match the binding record. Link made no changes.

When this error stops a command, hs-x exits with code 10. With --json, the failure is reported as a structured error whose code field is HSX_E_LINK_PREFLIGHT_NAMESPACE — stable to match on in scripts and agents.

02 · Causes

Likely causes

• The INSTALL_KV namespace was deleted in the Cloudflare dashboard
• The binding record points at a namespace from a different Cloudflare account or environment
• The namespace was renamed outside of hs-x

03 · Fix

How to fix it

• Check the namespace in the Cloudflare dashboard (Workers → KV) against the id/name in the error
• If the namespace is gone, existing installs are already broken — re-deploy (hs-x deploy) to provision a fresh install surface, then re-run hs-x link

Still stuck? Re-run the command with --debug for the wire-level detail, or hs-x doctor to check accounts, link state, and connectivity in one pass.