Skip to main content
GET
Session events (WebSocket).

Authorizations

Authorization
string
header
required

The token from api.json on the loopback listener; the remote token from remote.json (rakumux remote token) on the remote listener.

Headers

X-Rakumux-Session-Id
string

Act as this session (with X-Rakumux-Session-Token).

X-Rakumux-Session-Token
string

The session's RAKUMUX_SESSION_TOKEN.

X-Rakumux-Agent
string

Act for the session that bound this agent's conversation (with X-Rakumux-Agent-Conversation), e.g. opencode. Not with the session headers.

Pattern: ^[a-z0-9_-]{1,32}$
X-Rakumux-Agent-Conversation
string

The agent's conversation id, e.g. OpenCode's ses_….

Response

Switching to the WebSocket protocol; messages are EventMessage (text).

A text message of GET /v1/events (server → client).

type
string
required

Sent once

Allowed value: "subscribed"