REreplicas
Replica

Stream events

Streams replica events as server-sent events (data: <JSON>). Each event has id, ts, type, payload, and on current engines a seq; see EngineEvent for types. The stream opens with an engine.stream.opened event, and each SSE id: line is <epoch>:<seq>: reconnect with that value in Last-Event-ID to receive only the events you missed. A ping is sent every 15 seconds. The replica must be active, so send a message or wake it first.

get/v1/replica/{id}/events

Request

  • Base URL
    https://api.replicas.dev
  • URL
    https://api.replicas.dev/v1/replica/{id}/events
  • Auth
    HTTP bearer

Path parameters

idstring uuid required

The unique identifier of the replica

Headers

Last-Event-IDstring
Example:0b6f4c1e-8d2a-4f3e-9c1b-2a7d5e6f8a90:1042

The SSE id of the last event received. When the engine still holds every event after it, they are replayed and engine.stream.opened reports resumed: true; otherwise it reports resumed: false and only live events follow.

X-Replicas-Api-Version'2026-10-07'

API version. 2026-10-07 returns snake_case responses. See versioning.

Response

SSE event stream opened successfully. Each line is a JSON-encoded EngineEvent.

Changes

No recorded changes to this operation across all 1 revision of this API.