Skip to main content

​
GET /v1/stream

WebSocket endpoint for live event streaming.

​
Connection

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: 
{
  "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