HSX_E_CUTOVER_EXECUTE_GATED
Cutover execution is gated.
What this error means
Cutover migrates the ORIGINAL app in place (one-way). Execution is refused until the plan has no open decisions, the source is a project tree, and the era is supported (2023.2/2025.1/2025.2).
When this error stops a command, hs-x exits with code 1. With --json, the failure is reported as a structured error whose code field is HSX_E_CUTOVER_EXECUTE_GATED — stable to match on in scripts and agents.
Likely causes
- The plan still lists open decisions
- Pointed at a migration.json input instead of the original project tree
- A non-project legacy app (use HubSpot’s
hs app migratedirectly)
How to fix it
- Run the dry-run plan and resolve every open decision it lists
- Point --execute at the ORIGINAL project tree (the directory with hsproject.json)
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.