---
title: "BuildWithSteps"
description: "The `BuildWithSteps` entity."
section: "Reference"
group: "Types"
order: 42
---

## Definition

```ts
interface BuildWithSteps {
  id: string;
  workspaceId: string;
  entityId: string;
  sequenceNumber: number;
  status: "pending" | "failed" | "running" | "completed" | "cancelled";
  trigger: "manual" | "auto" | "redeploy";
  sourceEventId: string | null;
  error: string | null;
  metadata: Record<string, unknown> | null;
  createdBy: string | null;
  startedAt: string | null;
  completedAt: string | null;
  createdAt: string;
  steps: Array<{
    id: string;
    buildId: string;
    name: string;
    status: "pending" | "failed" | "running" | "completed" | "skipped";
    order: number;
    error: string | null;
    log: string | null;
    metadata: Record<string, unknown> | null;
    startedAt: string | null;
    completedAt: string | null;
    createdAt: string;
  }>;
}
```

## Fields

| Field            | Type                                                                                                                                                                                                                                                                                                             | Notes                                                              |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
| `id`             | `string`                                                                                                                                                                                                                                                                                                         | `readonly` `required`                                              |
| `workspaceId`    | `string`                                                                                                                                                                                                                                                                                                         | `required`                                                         |
| `entityId`       | `string`                                                                                                                                                                                                                                                                                                         | `required`                                                         |
| `sequenceNumber` | `number`                                                                                                                                                                                                                                                                                                         | `required`                                                         |
| `status`         | `"pending" \| "failed" \| "running" \| "completed" \| "cancelled"`                                                                                                                                                                                                                                               | `required`                                                         |
| `trigger`        | `"manual" \| "auto" \| "redeploy"`                                                                                                                                                                                                                                                                               | `required`                                                         |
| `sourceEventId`  | `string \| null`                                                                                                                                                                                                                                                                                                 | `required`                                                         |
| `error`          | `string \| null`                                                                                                                                                                                                                                                                                                 | `required`                                                         |
| `metadata`       | `Record<string, unknown> \| null`                                                                                                                                                                                                                                                                                | `required`                                                         |
| `createdBy`      | `string \| null`                                                                                                                                                                                                                                                                                                 | `required`                                                         |
| `startedAt`      | `string \| null`                                                                                                                                                                                                                                                                                                 | `required`                                                         |
| `completedAt`    | `string \| null`                                                                                                                                                                                                                                                                                                 | `required`                                                         |
| `createdAt`      | `string`                                                                                                                                                                                                                                                                                                         | `readonly` `required`                                              |
| `steps`          | `Array<{ id: string; buildId: string; name: string; status: "pending" \| "failed" \| "running" \| "completed" \| "skipped"; order: number; error: string \| null; log: string \| null; metadata: Record<string, unknown> \| null; startedAt: string \| null; completedAt: string \| null; createdAt: string; }>` | `required` — Ordered list of steps executed as part of this build. |