DocsError codesHEALTHCHECK_FAILEDFor AI agents
Error code

HEALTHCHECK_FAILED

1 minute to read

What it means. The new version started but did not answer a request.

What to do. Make sure the server listens on process.env.PORT and answers GET / soon after it starts. Read the app's startup output with the logs command or tool, then re-run deploy. If an earlier version was live, it still is.

  • HTTP status: 422
  • Retryable after applying the fix: yes

Every failure from the CLI or an MCP tool has this shape:

JSON
{
  "ok": false,
  "code": "HEALTHCHECK_FAILED",
  "message": "The new version started but did not answer a request.",
  "fix": "Make sure the server listens on process.env.PORT and answers GET / soon after it starts. Read the app's startup output with the logs command or tool, then re-run deploy. If an earlier version was live, it still is.",
  "file": "<where to edit, when known>",
  "retryable": true,
  "docs": "https://docs.uarpie.app/errors/HEALTHCHECK_FAILED"
}

Apply fix (edit file when it is given), then run the same command again.

↑ ↓ to moveEnter to open