Delete dataset items | Opik Documentation

Delete dataset items using one of two modes:

Delete by IDs: Provide ‘item_ids’ to delete specific items by their IDs
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.

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.

Request

This endpoint expects an object.

item_idslist of stringsOptional

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_idstringOptionalformat: "uuid"

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

filterslist of objectsOptional

Filters to select dataset items to delete within the specified dataset. Must be used with ‘dataset_id’. Mutually exclusive with ‘item_ids’. Empty array means ‘delete all items in the dataset’.

batch_group_idstringOptionalformat: "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

Request

Response

Errors