List a dataset version's changes

The rows a version of a dataset added, changed or removed, so an agent told of a new version (dataset.updated) reads only those instead of the whole dataset. Pass the version the event named; without one it is the latest. An added or changed row of the latest version comes with the row itself (no geometry); a removed row, or one of an older version, comes with its key. When the changes were not recorded (changeLog counts_only, full_refresh or first), the note says so: query the dataset with your own filters instead.

get/v1/datasets/{datasetId}/changes

Request

  • Base URL: https://api.ploti.ai
  • URL: https://api.ploti.ai/v1/datasets/{datasetId}/changes
  • Auth: HTTP bearer

Path parameters

datasetIdstring required

Which dataset, by the id find_data gives for it; list_dataset_watches repeats the ids being watched.

Query parameters

versioninteger

The version, as dataset.updated names it. Defaults to the latest.

limitinteger

How many changes to return; 200 unless given.

cursorstring

The nextCursor the previous page of this list returned, to continue from it. Leave it out for the first page.

Response

Done

datasetIdstring required
versionnumber required
promotedAtstring required

When the version went live.

changeLog'recorded' | 'counts_only' | 'full_refresh' | 'first' nullable required

recorded: every change is listed. counts_only: too many to list, counted. full_refresh: not compared. first: the first version. Null: a version from before changes were kept.

nextCursorstring nullable required

Pass as cursor for the next page; null on the last.

notestring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.