---
title: "Delete dataset examples"
method: DELETE
path: "/v2/datasets/{dataset_id}/examples"
tags: ["Datasets"]
---

# Delete dataset examples

`DELETE /v2/datasets/{dataset_id}/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**
```json
{
  "dataset_version_id": "RGF0YXNldFZlcnNpb246MTIzNDU=",
  "example_ids": [
    "550e8400-e29b-41d4-a716-446655440000",
    "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
  ]
}
```

**Invalid example** (missing `dataset_version_id`)
```json
{
  "example_ids": ["550e8400-e29b-41d4-a716-446655440000"]
}
```

  <Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note>

## Path parameters

- `dataset_id` string, required — A universally unique identifier (base64-encoded opaque string).

## Request body

- DeleteDatasetExamplesRequest — 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.

## Response `200`

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`.

- DeleteDatasetExamplesResponse — 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`.

## Other responses

- `400` — Invalid request
- `401` — Authentication is required
- `403` — Insufficient permissions to access this resource
- `404` — Not found
- `422` — Unprocessable entity
- `429` — Rate limit exceeded
- `503` — Returned as `503 Service Unavailable` when the request fails after partially completing. `deleted_example_ids` lists what was already deleted and `not_deleted_example_ids` lists what still needs deletion. The caller should retry the original full request — the delete operation is idempotent.

---

[API](https://skmtc.net/arize-ai/apis/arize-rest-api.md) · [All operations](https://skmtc.net/arize-ai/apis/arize-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arize-ai/arize-rest-api/versions/1e87d8a4cf69/schema)