Always include the API version in the request URL, e.g. GET /v2/changefeed?startTime=2024-01-01T00:00:00Z&endTime=2024-01-02T00:00:00Z&limit=100.
On v2, scope queries to a time window using the startTime (inclusive) and endTime (exclusive) parameters; this improves performance compared to the offset-only approach required by v1.
Paginate within the time window by incrementing the offset parameter by the limit value on each subsequent call until fewer events than the limit are returned.
Inspect the Action field in each change feed entry; possible values are 'create', 'update', and 'delete'. The update action is present in the change feed object model and is surfaced for instance-level changes.
Use GET /v2/changefeed/latest to retrieve the most recent event sequence number when initializing polling state.
Known gotchas
The v2 API adds startTime and endTime query parameters and the 'update' action to the change feed object model; v1 supports only offset-based pagination and does not expose update events in the same way.
Always specify the version segment (v1 or v2) in the URL path; the service does not fall back to a default version, and omitting it returns an error.
The offset in v2 is relative to the time window defined by startTime/endTime, not the global sequence; reusing a v1 offset value with v2 time-range queries will return incorrect results.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp