> ## Documentation Index
> Fetch the complete documentation index at: https://docs.provenlog.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Stream

> Real-time WebSocket event stream

## GET /v1/stream

WebSocket endpoint for live event streaming.

### Connection

```javascript theme={null}
const ws = new WebSocket("ws://localhost:7600/v1/stream");

ws.onmessage = (event) => {
  const provenlogEvent = JSON.parse(event.data);
  console.log(provenlogEvent);
};
```

### Message format

Each WebSocket message is a JSON-encoded `ProvenLogEvent`:

```json theme={null}
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "agent_id": "my-agent",
  "action_type": "TOOL_CALL",
  "action_name": "search_database",
  "action_status": "success",
  "sequence": 42,
  "hash": "sha256...",
  "timestamp": "2026-02-17T10:30:00Z"
}
```

Events are sent as they're ingested — there's no buffering or batching on the server side.

### Use cases

* **Live monitoring** — watch agent activity in real time
* **Alerting** — trigger alerts on specific event patterns
* **Dashboard** — the built-in dashboard uses this endpoint for its Live Stream page