Sign in
Datasets

Delete dataset items

Delete dataset items using one of two modes:

  1. Delete by IDs: Provide 'item_ids' to delete specific items by their IDs
  2. Delete by filters: Provide 'dataset_id' with optional 'filters' to delete items matching criteria

When using filters, an empty 'filters' array will delete all items in the specified dataset.

post/v1/private/datasets/items/delete

Request body

item_idsstring[]

List of dataset item IDs to delete (max 1000). Use this to delete specific items by their IDs. Mutually exclusive with 'dataset_id' and 'filters'.

dataset_idstring uuid

Dataset ID to scope the deletion. Required when using 'filters'. Mutually exclusive with 'item_ids'.

batch_group_idstring uuid

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

Response

No content

Changes

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

  • b9100cf75dd32See the full diff
    • ○

      added the new in enum value to the request property filters/items/operator

      request-property-enum-value-added

    • ○

      added the new not_in enum value to the request property filters/items/operator

      request-property-enum-value-added

  • d606e84c75e42See the full diff
    • ▲

      removed the enum value in of the request property filters/items/operator

      request-property-enum-value-removed

    • ▲

      removed the enum value not_in of the request property filters/items/operator

      request-property-enum-value-removed

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