EdictumEdictum Control PlaneReference
SSE Events
Current server-sent event streams for workspace decision events and server-backed ruleset updates.
AI Assistance
Right page if: you need the current SSE paths, event names, and query parameters. Wrong page if: you only need the REST endpoints -- see https://docs.edictum.ai/docs/control-plane/reference/api. Gotcha: the browser event stream and the SDK combined stream are different surfaces.
Edictum currently exposes two SSE surfaces:
GET /v1/events/streamfor workspace decision eventsGET /v1/streamfor the combined stream used by server-backed SDKs
Workspace Event Stream
Path:
GET /v1/events/streamQuery params:
| Param | Required | Meaning |
|---|---|---|
agent_id | No | Filter to one agent |
session_id | No | Filter to one session |
Auth:
- bearer token
- browser
edictum_sessioncookie when the caller is the app
Behavior:
- streams the same decision-event shape returned by
GET /v1/events - uses SSE
data:frames - sends keepalive comments while idle
Combined SDK Stream
Path:
GET /v1/streamThis is the server-backed SDK stream for ruleset updates and live decision events.
Current event names:
| Event | Payload |
|---|---|
decision | one decision event |
ruleset_updated | one ruleset summary/update payload |
Query params commonly used by SDKs:
| Param | Required | Meaning |
|---|---|---|
env | Yes | Environment filter |
bundle_name | No | Ruleset name filter |
policy_version | No | Version/revision hint from the client |
session_id | No | Optional session filter |
tags | No | Optional assignment/filter metadata |
Keepalive
Both streams emit keepalive comments while idle:
:keepaliveRelated
Last updated on