get_record_history
Trace the audit history of a Gramps record: who added, edited, or deleted it and when, newest first; filter by field for before/after values.
Instructions
Who added, edited or deleted one record, and when, newest first.
Each change names its transaction: get_transaction shows what it changed. Before gramps-webapi 3.22 the whole transaction log is read instead: slower, and the result says so.
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": {
"object_type": "<object_type>",
"ref": "<ref>"
},
"name": "get_record_history"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ref | Yes | Handle or gramps_id. A deleted record by its handle. | |
| field | No | Only the changes to this field of the stored record, each with its value before and after: 'parent_family_list', 'primary_name.first_name'. | |
| limit | No | Most recent changes to return. | |
| object_type | Yes | person, family, event, place, source, citation, repository, media, note, or tag. |