Channels
Channels route events within an app. All endpoints require authentication and x-tenant-id header.
POST /channel
Section titled “POST /channel”Create a channel.
Body:
{ "name": "events", "appId": 1}GET /channel/:id
Section titled “GET /channel/:id”Get a channel by ID.
DELETE /channel/:id
Section titled “DELETE /channel/:id”Delete a channel and all its events.
GET /channel/:channelId/subscribe
Section titled “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
Section titled “GET /channel/:channelId/:eventIdentifier/subscribe”Subscribe to events with a specific identifier via SSE.