DocsError codesBUILD_FAILEDFor AI agents
Error code

BUILD_FAILED

1 minute to read

What it means. The build failed.

What to do. Fix the first error in details.excerpt, then re-run deploy. If there is no excerpt, run the project's own build command on this machine (for example npm run build), fix the first error it prints, then re-run deploy.

  • 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": "BUILD_FAILED",
  "message": "The build failed.",
  "fix": "Fix the first error in details.excerpt, then re-run deploy. If there is no excerpt, run the project's own build command on this machine (for example npm run build), fix the first error it prints, then re-run deploy.",
  "file": "<where to edit, when known>",
  "retryable": true,
  "docs": "https://docs.uarpie.app/errors/BUILD_FAILED"
}

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

This page as Markdown: /docs/errors/BUILD_FAILED.mdllms.txt
↑ ↓ to moveEnter to open