---
title: "Stream build events (SSE)"
method: GET
path: "/builds/{id}/events"
---

# Stream build events (SSE)

`GET /builds/{id}/events`

Streams build events as Server-Sent Events. Events include:
- `log`: Build log lines with timestamp and content
- `status`: Build status changes (queued→building→pushing→ready/failed)
- `heartbeat`: Keep-alive events sent every 30s to prevent connection timeouts

Returns existing logs as events, then continues streaming if follow=true.

## Path parameters

- `id` string, required

## Query parameters

- `follow` boolean

## Response `200`

Event stream (SSE). Each event is a JSON BuildEvent object.

## Other responses

- `404` — Build not found
- `500` — Internal server error

---

[API](https://skmtc.net/kernel/apis/hypeman-api.md) · [All operations](https://skmtc.net/kernel/apis/hypeman-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kernel/hypeman-api/versions/b4642bb950dc/schema)
