Stream global durable state (SSE)

GET

/v1/durable/sse

const url = 'https://app.everruns.com/api/v1/durable/sse';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://app.everruns.com/api/v1/durable/sse

Establishes a Server-Sent Events (SSE) connection for real-time durable system monitoring.

Connection Lifecycle Events

connected: Sent immediately when the stream is established.
snapshot: Sent when system state changes (health, workers, workflows, tasks, DLQ, circuit breakers).
disconnecting: Sent before the server closes the connection for graceful cycling. Data: {"reason":"connection_cycle","retry_ms":1000}

Connection Cycling

Connections are automatically cycled every 10 minutes. Before closing, the server sends a disconnecting event so clients can reconnect seamlessly.

Retry Hints

Each SSE event includes a retry: field (in milliseconds) that hints reconnection timing:

During active updates: 1000ms
During idle periods: increases with backoff up to 20000ms
After disconnecting event: 1000ms

Responses

200

SSE event stream with ‘connected’, ‘snapshot’, and ‘disconnecting’ events

text/event-stream

503

Durable store not available