Sign in

v2

latestOpenAPI 3.0.3Apache-2.02026-08-07119359591.9 KB
Datasets

Delete dataset examples

Delete a collection of examples from a dataset by their IDs.

The delete is partial-tolerant: examples that exist in the selected version are deleted, and every requested ID that was not deleted is reported back.

A 200 OK response always includes:

  • completed — true if the operation finished and no retry is needed; false if it could not fully complete (retry the full request).
  • deleted_example_ids — example IDs confirmed deleted in this request.
  • not_deleted_example_ids — requested IDs not deleted: either not found in the selected version (never added, or already deleted), or not completed when completed is false.

The delete operation is idempotent — re-submitting already-deleted IDs is safe.

Payload Requirements

  • dataset_version_id is required and identifies the version to delete from.
  • example_ids must contain at least one ID and at most 1000 IDs.
  • example_ids must not contain duplicate or empty IDs.

Valid example

{
  "dataset_version_id": "RGF0YXNldFZlcnNpb246MTIzNDU=",
  "example_ids": [
    "550e8400-e29b-41d4-a716-446655440000",
    "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
  ]
}

Invalid example (missing dataset_version_id)

{
  "example_ids": ["550e8400-e29b-41d4-a716-446655440000"]
}

<Note>This endpoint is in beta, read more here.</Note>

delete/v2/datasets/{dataset_id}/examples

Path parameters

dataset_idstring required

A universally unique identifier (base64-encoded opaque string).

Example:RW50aXR5OjEyMzQ1

The unique dataset identifier (base64)

Request body

dataset_version_idstring required

Version to delete the examples from. Required. Examples are removed in place from this version; no new version is created.

example_idsstring[] required

IDs of the examples to delete. Up to 1000 per request.

Response

Dataset examples deleted. The delete is partial-tolerant: existing examples are deleted and every requested ID not deleted is reported back. The response body always includes:

  • completed: true if the operation finished; false if it could not fully complete (retry the full request).
  • deleted_example_ids: IDs confirmed deleted.
  • not_deleted_example_ids: requested IDs not deleted — not found in the selected version, or not completed when completed is false.
completedboolean required

true when the operation finished and no retry is needed. false when the operation could not fully complete — retry the original full request (the delete is idempotent).

deleted_example_idsstring[] required

Example IDs confirmed deleted in this request.

not_deleted_example_idsstring[] required

Requested example IDs that were not deleted: either not found in the selected version (never added, or already deleted), or whose deletion did not complete when completed is false.