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

# Delete a dataset

`DELETE /v1/datasets/{datasetId}`

Deletes the specified dataset. This action permanently removes all associated data and **cannot be reversed**.

## Path parameters

- `datasetId` string, uuid, required — Unique identifier for the dataset.

## Response `200`

Successful response indicating that the data source and all contained datasets were permanently deleted.

- object
  - `requestId` string — Unique identifier for the request.
  - `status` string — Indicates the status of the request.
  - `message` string — Human-readable message describing the outcome of the request (for display/logging; not intended for programmatic parsing).

## Other responses

- `400` — Error response indicating one or more request parameters are invalid.
- `401` — Error response indicating that the API key is missing or invalid.

---

[API](https://skmtc.net/databox/apis/databox-api.md) · [All operations](https://skmtc.net/databox/apis/databox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/databox/databox-api/versions/8e7a3a444e6b/schema)