# Build

> API reference for Builds (compute.apoxy.dev/v1alpha1)

**API Group:** `compute.apoxy.dev/v1alpha1`

## Operations

### List Build

<APIEndpoint method="GET" path="/apis/compute.apoxy.dev/v1alpha1/builds" />

List Build

**Response**

- `200`: OK

---

### Create Build

<APIEndpoint method="POST" path="/apis/compute.apoxy.dev/v1alpha1/builds" />

Create a Build

**Request Body**

Spec fields (`BuildSpec`):

| Field | Type | Description |
| --- | --- | --- |
| `commit` | string | Commit being built. **(required)** |
| `ref` | string | Ref (branch or tag) the commit came from. **(required)** |
| `serviceRef` | string | ServiceRef is the owning Service. **(required)** |

**Response**

- `200`: OK
- `201`: Created
- `202`: Accepted

---

### Delete All Build

<APIEndpoint method="DELETE" path="/apis/compute.apoxy.dev/v1alpha1/builds" />

Delete collection of Build

**Response**

- `200`: OK

---

### Get Build

<APIEndpoint method="GET" path="/apis/compute.apoxy.dev/v1alpha1/builds/{name}" />

Get the specified Build

**Response**

- `200`: OK

---

### Replace Build

<APIEndpoint method="PUT" path="/apis/compute.apoxy.dev/v1alpha1/builds/{name}" />

Replace the specified Build

**Request Body**

Spec fields (`BuildSpec`):

| Field | Type | Description |
| --- | --- | --- |
| `commit` | string | Commit being built. **(required)** |
| `ref` | string | Ref (branch or tag) the commit came from. **(required)** |
| `serviceRef` | string | ServiceRef is the owning Service. **(required)** |

**Response**

- `200`: OK
- `201`: Created

---

### Update Build

<APIEndpoint method="PATCH" path="/apis/compute.apoxy.dev/v1alpha1/builds/{name}" />

Partially update the specified Build

**Response**

- `200`: OK
- `201`: Created

---

### Delete Build

<APIEndpoint method="DELETE" path="/apis/compute.apoxy.dev/v1alpha1/builds/{name}" />

Delete a Build

**Response**

- `200`: OK
- `202`: Accepted

---

---

**Navigation** (Reference)

- Previous: [EdgeFunction](/docs/reference/extensions/edgefunctions.md)
- Next: [EgressGateway](/docs/reference/compute/egressgateways.md)
- All pages: [index](/docs/llms.txt)