---
title: "Purge a dataset"
method: POST
path: "/v1/datasets/{datasetId}/purge"
tags: ["Datasets"]
---

# Purge a dataset

`POST /v1/datasets/{datasetId}/purge`

Purges the specified dataset by removing all rows of data it contains. The dataset itself remains intact and can continue to receive new ingestions.

**This operation is irreversible — once purged, the deleted data cannot be restored.**

## Path parameters

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

## Headers

- `Content-Type` string, required

## Response `200`

Successful response indicating that the dataset has been purged.

- 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)