Event Stream

Allternit exposes two real-time channels for observing beta session events:

Server-Sent Events (SSE) at GET /api/v1/beta/sessions/:id/events
WebSocket at GET /api/v1/beta/sessions/:id/events/ws

Both streams emit the same underlying events. Use SSE for simple one-way observation. Use WebSockets when you need bidirectional communication, such as closing the connection from the client side or sending an interrupt through a separate HTTP call.

Authentication

Both endpoints require a valid bearer token. See Authentication.

Event types

Event	Description
`session_created`	The session was created.
`budget_updated`	The session budget was created or changed.
`thinking_delta`	A reasoning delta appended by a caller.
`content_block_delta`	A content delta appended by a caller.
`tool_calls`	One or more tool calls were appended.
`refusal`	A refusal event was appended.
`context_warning`	Projected usage crossed 80% of `context_window`.
`budget_exceeded`	A hard budget limit was exceeded.
`user_interrupt`	A user interrupt was posted.
`context_summary`	Events were summarized during context editing.
`session_archived`	The session was archived.

Only thinking_delta, content_block_delta, tool_calls, and refusal may be appended directly by callers. All other event types are emitted by the platform.

SSE example

curl -N -H "Authorization: Bearer $ALLTERNIT_API_KEY" \
  https://api.allternit.com/v1/beta/sessions/sess_123/events

Add ?after=<sequence> to resume from a known sequence number.

Stream format

event: tool_calls
id: 7
data: {"calls":[{"name":"bash","input":{"command":"cargo test"}}]}

WebSocket example

websocat -H "Authorization: Bearer $ALLTERNIT_API_KEY" \
  wss://api.allternit.com/v1/beta/sessions/sess_123/events/ws

Each message is a JSON object:

{
  "sequence": 7,
  "type": "tool_calls",
  "data": { "calls": [{ "name": "bash", "input": { "command": "cargo test" } }] }
}

Overview

LLM Gateway

Agents & Runtime

Work Queue & Deployments

Files, Webhooks & Sandbox

Tools & Connectors

Collaboration & Workflows

Infrastructure & Platform

Canvases

Onboarding

A Labs

Playground

Users & Profiles

Event Stream

Event Stream

Authentication

Event types

SSE example

Stream format

WebSocket example

​Event Stream

​Authentication

​Event types

​SSE example

​Stream format

​WebSocket example

​Related pages

Event Stream

Authentication

Event types

SSE example

Stream format

WebSocket example

Related pages