Skip to content

The change feed as Server-Sent Events (id = sequence number). Resumes from Last-Event-ID or `since`.

GET
/datanotes/changes/stream
curl --request GET \
--url https://example.com/datanotes/changes/stream \
--header 'Authorization: Bearer <token>'

Same filters as list_changes (tables, kinds, columns: comma-separated; exclude_actor; where: JSON). A comment line every 25 s keeps proxies from closing the connection; event: gap tells the client events were pruned.

since
string
tables
string
kinds
string
columns
string
exclude_actor
string
where
string
Last-Event-ID
string

The events, one data: line (JSON) each.

Media typetext/event-stream
string

where is not a JSON object.

Media typeapplication/json
object
error
required

What went wrong, for a person or an agent.

string

Example generated

{
"error": "example"
}

Missing or wrong bearer token.

Media typeapplication/json
object
error
required

What went wrong, for a person or an agent.

string

Example generated

{
"error": "example"
}

The change feed is not running.

Media typeapplication/json
object
error
required

What went wrong, for a person or an agent.

string

Example generated

{
"error": "example"
}