HSX_E_CLOUDFLARE_RESOURCE_ID_REQUIRED

01 · Meaning

What this error means

HS-X refused to create or adopt a tenant resource by an ambiguous legacy-truncated name.

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

02 · Causes

Likely causes

• The deterministic INSTALL_KV, tenant D1, or FLAGS_KV name exceeds Cloudflare's 63-character limit
• The local and control-plane bindings do not contain the exact existing resource id

03 · Fix

How to fix it

• Restore the project's local tenant-state binding or its control-plane runtime metadata
• Do not manually adopt a same-named resource unless its account/project/environment/app ownership is independently proven

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.