Get what changed in a run
get_changesReport what changed in a project run against the run just before it, or against any run you name: pages added, modified and removed, field changes, and coverage. Use it to answer 'what changed on the site', or 'since last month' with against. list_pages shows every page whether or not it changed, and list_pages with url one page's text and versions. Inputs: project_id from list_projects. run_id from list_runs picks the run; empty means the latest finished full run -- a newer start_run re-crawl of listed pages is not the default, and is named as newerPartialRun with the id to pass as run_id. against, another run's id from list_runs, compares the two directly instead of with the run just before. A run still going answers 409. Safeguards: removals are withheld when a run reached under 90% of the site, so a blocked crawl never reports pages as gone. A project's first run is a baseline with nothing to compare. Read-only and free: it reads stored data and never fetches.
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": {
"project_id": "<project_id>"
},
"name": "get_changes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| run_id | No | A run's id, from list_runs; empty means the project's latest finished run. | |
| against | No | Another run's id, from list_runs, to compare with directly; omit to compare with the run just before. | |
| project_id | Yes | The project's 32-character hex id, from list_projects. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | No | Only on a failure: a machine-readable reason, e.g. read_only, validation, plan_limit or not_found. | |
| runs | No | The finished runs a record exists for, newest first, for picking another run_id. | |
| error | No | Only when the call failed: what went wrong, in words an assistant can act on. | |
| change | No | {runId, prevRunId, baseline, rebaselined, coverage, degraded, counts {added, modified, removed}, summary, feed, fields, withheld}. feed: each changed page as {url, path, kind (added, modified or removed), added and removed (words, e.g. '+12'), wordsBefore, wordsAfter}. fields: head and extracted field changes as {url, field, before, after}. withheld: removals held back because coverage was under 90%. Each list holds up to 200. | |
| detail | No | Only on a failure: the API's own wording, when the error was rephrased. | |
| status | No | Only on a failure: the HTTP status code. |