Skip to main content
Version: Next

VersionChangeRecord

from_valuenullable

Value at path before the save; null when the field did not exist.

kindstring

Semantic category of the change. First-class values in V1: 'filter', 'metric', 'dimension', 'column', 'chart', 'time_range', 'color_palette'. Falls back to 'field' for generic scalar changes that don't map to a named kind.

operationstring

The verb for this change: 'add', 'remove', 'move', 'edit', 'update' (a collapsed-summary record for a field whose per-leaf changes exceeded the cap), or 'announce' (a synthetic headline record). Surfaced explicitly so consumers need not infer the verb from from_value/to_value null-tests — 'move' in particular cannot be derived that way.

path

Array of segments locating the change in the entity's state. Example: ['params', 'adhoc_filters', 'country'].

to_valuenullable

Value at path after the save; null when the field was removed.

VersionChangeRecord
{
"kind": "string",
"operation": "string"
}