---
raw: true
title: "build_install_failed"
description: "The dependency install step failed during the build run."
---

The dependency install step failed during the build run.

**How to resolve:** Inspect the build logs for the install error, fix the lockfile or install command, and start a new build.

<div data-pagefind-ignore>

## Error shape

Every Spacefast API error is an RFC 9457 problem document, served as
`application/problem+json`.

- `code` is stable and machine-readable.
- `type` links to this page.
- `title` is a short label.
- `status` repeats the HTTP status.
- `detail` explains this occurrence.
- `pointer`, when present, is an RFC 6901 JSON Pointer at the offending field in the request body.
- `details`, when present, carries structured context.

Match on `code`, never on `detail`.

```json
{
  "type": "https://spacefast.com/docs/errors/build_install_failed",
  "title": "Build install failed",
  "status": 400,
  "detail": "The dependency install step failed during the build run.",
  "code": "build_install_failed",
  "requestId": "req_4mz0v8qk"
}
```

See the full list of error codes in the [error reference](/docs/errors).

</div>