Error code
HEALTHCHECK_FAILED
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.
This page as Markdown: /docs/errors/HEALTHCHECK_FAILED.mdllms.txt