Track RIS Changes
ris_track_changesTrack every document added or changed in one RIS application within an exact date window (changed_from/changed_to), optionally including deletions (include_deleted) — the delta-sync and monitoring primitive for mirrors and watchers, and the only surface that reports removals. Unlike the search tools’ coarse, additive-only changed_since intervals, this is exact-dated and deletion-aware. application accepts every RIS application code listed by ris_list_reference topic applications, including BrKons, LrKons, Dsk, and BgblAuth. Each changed document comes back in a compact cross-class record — document_number (for ris_get_document), title, the section_label, law_id, and in-force window (in_force_from/in_force_until) of a consolidated-law row or the case_numbers and decision_date of a court decision, dates, binding_status, and rendition URLs — plus its last-changed date; removed documents come back as deleted records with a deletion timestamp. One application per call; page explicitly for large windows.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"application": "<application>"
},
"name": "ris_track_changes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 1-based result page. Default 1. | |
| page_size | No | Documents per page, 1–100 (default 20). Served as a page of 10 (1–10) or 20 (11–100), with a notice when that differs. For more results, keep the size and raise page. | |
| changed_to | No | Include documents changed on/before this date (YYYY-MM-DD, AenderungenBis). | |
| application | Yes | RIS application whose change feed to read, e.g. BrKons, LrKons, Dsk, or BgblAuth. All supported codes: ris_list_reference topic applications. | |
| changed_from | No | Include documents changed on/after this date (YYYY-MM-DD, AenderungenVon). Exact date, not a coarse interval. | |
| include_deleted | No | true also returns documents removed from RIS in the window, as deleted records — the only way to observe deletions. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 1-based page number RIS served. | |
| error | No | Present when the call failed. Absent on success. | |
| notice | No | The served page size when it differs from page_size, then zero-hit guidance — the likely cause and the concrete next call. A reversed window (changed_from later than changed_to) is answered without a RIS request: 0 changes, and the swapped bounds to retry with in place of the guidance. | |
| results | No | Change-feed entries for the requested page. Totals, paging, and the applied window in enrichment. | |
| pageSize | No | Page size RIS applied. | |
| changedTo | No | The changed_to bound as requested (echo), when set. | |
| truncated | No | Present and true when more pages exist beyond this one — raise page to continue. | |
| totalCount | No | Total change-feed entries across all pages. | |
| application | No | The application whose change feed was read. | |
| changedFrom | No | The changed_from bound as requested (echo), when set. |