Sign in
Datasets

Create/update dataset 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.

put/v1/private/datasets/items

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

Changed in 2 of the 57 revisions of this API.22

  • 3953a50a6a0e2See the full diff
    • ○

      added the new optional request property copy_from_dataset_id

      new-optional-request-property

    • ○

      added the new optional request property copy_from_version_id

      new-optional-request-property

  • d606e84c75e42See the full diff
    • ●

      removed the request property copy_from_dataset_id

      request-property-removed

    • ●

      removed the request property copy_from_version_id

      request-property-removed

    This revision also has 40 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog