BUILD_IMAGE_TOO_LARGE

What it means. The built app is larger than the runtime limit.

What to do. Move large files out of the app into its file storage (upload with POST /_platform/upload-url, read with GET /_platform/file-url) and remove unused dependencies, 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:

{
  "ok": false,
  "code": "BUILD_IMAGE_TOO_LARGE",
  "message": "The built app is larger than the runtime limit.",
  "fix": "Move large files out of the app into its file storage (upload with POST /_platform/upload-url, read with GET /_platform/file-url) and remove unused dependencies, then re-run deploy.",
  "file": "<where to edit, when known>",
  "retryable": true,
  "docs": "https://docs.uarpie.app/errors/BUILD_IMAGE_TOO_LARGE"
}

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