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

# Delete a dataset

`DELETE /v2/datasets/{dataset_id}`

Permanently deletes a dataset and all its datapoints. This action is irreversible.

## Path parameters

- `dataset_id` union, required — The unique identifier of the dataset
  - string
  - string, ulid — The id of the resource

## Response `204`

No content - Dataset successfully deleted

## Other responses

- `404` — Dataset not found - The specified dataset does not exist or has already been deleted

## Changes

> 271 revisions in range; 82 not diffed.

- **2026-08-02** `6f132f005b2a` — 1 breaking
  - for the `path` request parameter `dataset_id`, the format of property `anyOf[subschema #1]/` was specialized from no format to `uuid`
- **2026-07-31** `3128fb112d66` — 1 info
  - for the `path` request parameter `dataset_id`, the format of property `anyOf[subschema #1]/` was generalized from `uuid` to no format
- **2026-07-30** `d1ae9e3491f7` — 1 breaking
  - for the `path` request parameter `dataset_id`, the format of property `anyOf[subschema #1]/` was specialized from no format to `uuid`
- **2026-07-29** `81dd5e8c8ae5` — 1 info
  - for the `path` request parameter `dataset_id`, the format of property `anyOf[subschema #1]/` was generalized from `uuid` to no format
- **2026-07-29** `c165184caee5` — 1 breaking
  - for the `path` request parameter `dataset_id`, the format of property `anyOf[subschema #1]/` was specialized from no format to `uuid`

[Full history](https://skmtc.dev/orq-ai/apis/orq-ai-api/changes/v2/datasets/:dataset_id/delete.md)

---

[API](https://skmtc.dev/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.dev/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/orq-ai/orq-ai-api/revisions/3df7b466d7e5/schema)