Overview

The Board Streams API exposes a lightweight SSE channel for observing board item changes within a workspace. Clients connect to a workspace-specific endpoint and receive periodic board_update events containing the latest items.
This namespace is served by the Allternit API data-plane node (http://127.0.0.1:8013 on the same machine, or your paired or provisioned node). The hosted Cloud API at https://api.allternit.com does not route it; it relays only agent sessions, canvases, office and beta research/sessions. See Cloud API.

Base URL

Authentication

All requests require a valid bearer token in the Authorization header. See Authentication for details.

Endpoints

Stream status

Response

Subscribe to workspace updates

SSE event format

Events are unnamed SSE data: frames (no event: line). The stream emits a board_update frame every five seconds for the requested workspace, and keeps the connection alive with SSE keep-alives every fifteen seconds. If the database connection fails on a tick, the frame is {"ping":true} instead.

Error codes