Streaming events (SSE)

Every endpoint on this page requires either a Clerk-issued JWT (Authorization: Bearer <token>) or an organization API key (x-api-key: pk_…). Anonymous calls return 401 Unauthorized. See Authentication for the full setup.

Connect

const es = new EventSource(
  "https://api.agntix.ai/v1/chat/events/stream",
  { withCredentials: true } // or use ?token=… for environments without cookie support
);

es.addEventListener("message.added", (e) => {
  const payload = JSON.parse(e.data);
  console.log("new message in", payload.sessionId, payload);
});

Event types

Event	Triggered when
`session.started`	A new chat or voice session is created
`session.updated`	Session state, agent assignment, or analytics change
`session.ended`	Session is closed (manually, expired, or call ended)
`message.added`	A new message is added to a session
`usage.updated`	Usage metrics for the org change
`subscription.updated`	Plan change, cancel, or resume
`knowledge_store.updated`	A knowledge store document finishes processing
`heartbeat`	Sent every 30s; use to detect a dead connection

Reconnecting

The browser’s EventSource reconnects automatically with the Last-Event-ID header. Keep your client side-effect-free with respect to event order — at least one delivery is guaranteed, ordering is not.

Looking for at-least-once delivery with replay? Subscribe via Webhooks instead. SSE is fire-and-forget; webhooks are durable.

Getting Started

Build

Real-time

SDKs & Examples

Operate

Streaming events (SSE)

Connect

Event types

Reconnecting

​Connect

​Event types

​Reconnecting

Connect

Event types

Reconnecting