HSX_E_CUTOVER_CONFIRM_REQUIRED

Cutover needs an interactive confirmation.

What this error means

Cutover is a one-way, in-place change, so it must be confirmed interactively; a non-TTY run without --yes is refused. 2023.2/2025.1 sources always need a terminal to answer HubSpot’s own feature prompts.

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

Likely causes

  • Ran hs-x migrate cutover --execute without a TTY and without --yes
  • A 2023.2/2025.1 cutover was run outside an interactive terminal

How to fix it

  • Re-run in an interactive terminal and type the project name to confirm
  • For automation of a 2025.2 cutover, pass --yes to skip the prompt

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.