v51

OpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-08-01308532588.1 KB
Datasets

Apply changes to dataset items

Apply delta changes (add, edit, delete) to a dataset version with conflict detection.

This endpoint:

  • Creates a new version with the applied changes
  • Validates that baseVersion matches the latest version (unless override=true)
  • Returns 409 Conflict if baseVersion is stale and override is not set

Use override=true query parameter to force version creation even with stale baseVersion.

Set 'copy_from_dataset_id' and 'copy_from_version_id' together on the request body to read carry-forward rows from the supplied (dataset, version) pair instead of the destination's prior version. When the fields are null, carry-forward rows are read from the destination's prior version.

post/v1/private/datasets/{id}/items/changes

Path parameters

idstring uuid required

Query parameters

overrideboolean

Request body

DatasetItemChangesPublic required

Response

Version created successfully

idstring uuid
dataset_idstring uuid
version_hashstring
tagsstring[]
is_latestboolean

Indicates whether this is the latest version of the dataset

version_namestring

Sequential version name formatted as 'v1', 'v2', etc.

items_totalinteger

Total number of items in this version

items_addedinteger

Number of items added since last version

items_modifiedinteger

Number of items modified since last version

items_deletedinteger

Number of items deleted since last version

change_descriptionstring
metadataobject
created_atstring date-time
created_bystring
last_updated_atstring date-time
last_updated_bystring