Reference · Error codes

HSX_E_LINK_NOT_CLAIMABLE

Project owner is already attached to a different HS-X account.

What this error means

The current `cloudflare.json` ownerId starts with `acct_`, meaning a prior link claim already attached it to an HS-X account. Re-claiming under a different account would silently rewrite cross-account state.

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_NOT_CLAIMABLE — stable to match on in scripts and agents.

Likely causes

  • Project was previously linked to another HS-X account
  • Pointer file was copied between projects

How to fix it

  • Run hs-x unlink to clear the session, then delete .hs-x/cloudflare.json to reset the local pointer
  • Or contact support to transfer ownership between accounts

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.

Keep going