hs-xdocs
Reference · Error codes

HSX_E_CLOUDFLARE_ANALYTICS_ENGINE_DISABLED

Workers Analytics Engine is not enabled.

What this error means

HS-X stopped before mutating Cloudflare because Workers Analytics Engine is disabled for the selected account.

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

Likely causes

  • Workers Analytics Engine has not been enabled for this Cloudflare account

How to fix it

  • Open the account-specific Analytics Engine page printed by the CLI and enable the product
  • Run hs-x deploy again after Cloudflare reports Analytics Engine as enabled

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