hs-xdocs
HS-X on GitHub
Reference · Error codes

HSX_E_CLOUDFLARE_AUTH_FAILED

Cloudflare rejected the API credential.

What this error means

The Worker Versions/Deployments API returned an authentication error (401/403).

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

Likely causes

  • Token expired or revoked
  • Token lacks Workers Scripts:Edit on this account

How to fix it

  • Re-run hs-x connect cloudflare to refresh the credential
  • Verify the token grants Workers Scripts:Edit for the target account

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