> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://platform.bctrl.ai/llms.txt.
> For full documentation content, see https://platform.bctrl.ai/llms-full.txt.

# Organization Updates

> Stream account-level notifications when resources change.

Use organization updates when your application needs realtime notifications across many spaces, runtimes, runs, and resources.

For runtime debugging, use [run activity](/sdk/observability/activity). Activity is the source of truth for what happened inside a runtime. Updates are a notification bus for broad resource changes.

## Stream updates

```ts
const controller = new AbortController();

for await (const event of bctrl.updates.stream(controller.signal)) {
  if (event.type === "runtime.stopped") {
    console.log("Runtime stopped", event.data);
  }
}
```

The stream uses Server-Sent Events with automatic reconnection.

## When to use updates

| Use updates for                       | Use run activity for                   |
| ------------------------------------- | -------------------------------------- |
| Dashboard refreshes                   | Explaining what a runtime did          |
| Runtime started/stopped notifications | Browser navigation and action timeline |
| Invocation completion notifications   | Artifact and recording events          |
| Cross-space monitoring                | Debugging a single run                 |

## Stop listening

```ts
controller.abort();
```

## Related

* [Runs](/sdk/core-concepts/runs)
* [Activity](/sdk/observability/activity)
* [Artifacts](/sdk/observability/run-artifacts)