Datasets

Create/update dataset items

Changed on

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.

put/v1/private/datasets/items

Request

  • Base URL
    http://localhost:5173/api
  • URL
    http://localhost:5173/api/v1/private/datasets/items
  • Auth
    none declared

Request body

dataset_namestring

If null, dataset_id must be provided

dataset_idstring uuid

If null, dataset_name must be provided

project_namestring

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

project_idstring uuid

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

batch_group_idstring 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_idstring 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_idstring uuid

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

Response

No content

Changes

  • 3953a50a6a0eRevision changes
    • info

      added the new optional request property

    • info

      added the new optional request property

  • d606e84c75e4Revision changes
    • warning

      removed the request property

    • warning

      removed the request property