Read a record's change history
heliyos_records_eventsRetrieve a record's audit trail to see who changed what and when, with filters for operation, event type, date range, and text; use detailed mode for changed field paths.
Instructions
Returns the audit trail of one record: who changed what and when (people and workers), newest first, each with a one-line change summary. Filter by operation type, event type, date range or text. "detailed" adds the paths of the changed fields. Use heliyos_records_timeline instead for a narrative of the relationship. Returns structuredContent {events:[{id, at, operation_type, actor, change_summary}], next_cursor}.
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": {
"record_id": "<record_id>"
},
"name": "heliyos_records_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Events per page, 1 to 100. Default 20. | |
| since | No | since as an ISO 8601 date (2026-03-01) or date-time (2026-03-01T09:00:00Z). | |
| until | No | Only events at or before this date; a date alone includes that whole day (UTC). | |
| cursor | No | next_cursor from the previous page, with the same limit. Omit for the first page. | |
| search | No | Plain words matched against the change summaries. Symbols such as + ( ) [ ] * ? can cause an error. | |
| record_id | Yes | record_id: a 24-character hex id. | |
| event_types | No | Only these event types: AUDIT (field changes), INTERACTION (emails, meetings), ENRICHMENT. | |
| operation_types | No | Only these operations: CREATE, UPDATE, DELETE. | |
| response_format | No | "concise" (default) returns one line per change; "detailed" returns the changed field paths too. | concise |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| events | Yes | ||
| next_cursor | No |