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"]
}

This endpoint is in alpha, read more here.

DELETE /v2/datasets/{dataset_id}/examples

Delete dataset examples

cURL

curl --request DELETE \
  --url https://api.arize.com/v2/datasets/{dataset_id}/examples \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "dataset_version_id": "RGF0YXNldFZlcnNpb246MTIzNDU=",
  "example_ids": [
    "550e8400-e29b-41d4-a716-446655440000",
    "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
  ]
}
'

200

full_success

{
  "completed": true,
  "deleted_example_ids": [
    "550e8400-e29b-41d4-a716-446655440000",
    "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
  ],
  "not_deleted_example_ids": []
}

Authorizations

Authorization · string · header · required

Most Arize AI endpoints require authentication. For those endpoints that require authentication, include your API key in the request header using the format

Path Parameters

dataset_id · string · required

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

Example:

"RW50aXR5OjEyMzQ1"

Body

application/json

Body containing the IDs of dataset examples to delete

Body containing the IDs of dataset examples to delete

dataset_version_id · string · required

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

example_ids · string[] · required

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

Required array length: 1 - 1000 elements

Response

200

application/json

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.

Result of a DELETE dataset examples request.

The delete is partial-tolerant: examples that exist in the selected version are deleted, and every requested ID that was not deleted is reported in not_deleted_example_ids so the caller can act on it.

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 whose deletion did not complete when completed is false.

completed · boolean · 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_ids · string[] · required

Example IDs confirmed deleted in this request.

not_deleted_example_ids · string[] · 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.