Create/update dataset items

PUT

/v1/private/datasets/items

Create/update dataset items based on dataset item id. Each item’s ‘id’ field is the stable identifier and upsert key. Provide it to update an existing item, or omit it to create a new one.

Set ‘copy_from_dataset_id’ and ‘copy_from_version_id’ together 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.

Create/update dataset items based on dataset item id. Each item's 'id' field is the stable identifier and upsert key. Provide it to update an existing item, or omit it to create a new one. Set 'copy_from_dataset_id' and 'copy_from_version_id' together 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.

Request

This endpoint expects an object.

itemslist of objectsRequired

dataset_namestringOptionalformat: "(?s)^\s*(\S.*\S|\S)\s*$"

If null, dataset_id must be provided

dataset_idstringOptionalformat: "uuid"

If null, dataset_name must be provided

project_namestringOptionalformat: "(?s)^\s*(\S.*\S|\S)\s*$"

Optional. Associates the batch with a project by name. Ignored if project_id is provided.

project_idstringOptionalformat: "uuid"

Optional. Associates the batch with a project by ID. Takes precedence over project_name.

batch_group_idstringOptionalformat: "uuid"

Optional batch group ID to group multiple batches into a single dataset version. If null, mutates the latest version instead of creating a new one.

copy_from_dataset_idstringOptionalformat: "uuid"

Optional. Dataset to read carry-forward rows from when materializing the new version. Required together with copy_from_version_id. When null, carry-forward rows are read from the destination dataset’s prior version.

copy_from_version_idstringOptionalformat: "uuid"

Optional. Version within copy_from_dataset_id to read carry-forward rows from. Required together with copy_from_dataset_id.

$	curl -X PUT http://localhost:5173/api/v1/private/datasets/items \
>	-H "Content-Type: application/json" \
>	-d '{
>	"items": [
>	{
>	"source": "manual",
>	"data": {}
>	}
>	]
>	}'