Channels

Channels route events within an app. All endpoints require authentication and x-tenant-id header.

POST /channel

Create a channel.

Body:

{
  "name": "events",
  "appId": 1
}

GET /channel/:id

Get a channel by ID.

DELETE /channel/:id

Delete a channel and all its events.

GET /channel/:channelId/subscribe

Subscribe to all events on a channel via SSE (Server-Sent Events).

Query parameters:

Param	Description
agent_id	Filter by agent
event_type	Filter by event type
trace_id	Filter by trace

Response: text/event-stream with events as JSON:

data: {"id":1,"identifier":"task.started","payload":{"task":"search"},...}

data: {"id":2,"identifier":"task.completed","payload":{"result":"done"},...}

GET /channel/:channelId/:eventIdentifier/subscribe

Subscribe to events with a specific identifier via SSE.