Changes actions
2 actions. Each action calls the same API route with the same scopes on every surface.
changes_delta
Section titled “changes_delta”Establish a baseline, or drain at most 100 records and 64 KiB at a fixed head. The route also requires unrestricted data scope; scoped resources cannot read this journal. Continuation: Pass cursor unchanged while has_more is true. On HTTP 410, clear retained data and reload bounded visible windows..
| Route | GET /api/v1/changes |
| Tool name | calternal_api_changes_delta |
| Surfaces | cli, mcp, webmcp |
| Scopes | account, data |
| Effect | read only |
| Encoding | request none, response json |
query
| Field | Type | Required | Description |
|---|---|---|---|
cursor |
string |
no |
calternal action run changes_delta --input '{}' --jsonchanges_events
Section titled “changes_events”Push only the User’s sequence. Each stream holds one User/IP permit and a targeted signal. One-second safety checks repair crashes between commit and notification and detect access changes; duplicate hints are safe to combine. The route also requires unrestricted data scope; scoped resources cannot read this journal. Continuation: Reduce poll_ms after an overflow. Read current snapshots after reconnect; this stream does not replay events..
| Route | GET /api/v1/changes/events |
| Tool name | calternal_api_changes_events |
| Surfaces | cli, mcp, webmcp |
| Scopes | account, data |
| Effect | read only |
| Encoding | request none, response sse |
calternal action run changes_events --input '{}' --json