v1

latestOpenAPI 3.0.02026-08-06132933.0 KB
Datasets

Purge a dataset

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.

post/v1/datasets/{datasetId}/purge

Path parameters

datasetIdstring uuid required

Unique identifier for the dataset.

Example:4e1219d8-7fa8-44b7-96c6-a8f2a9cfb0bf

Headers

Content-Typestring required

Must be set to application/json

Response

Successful response indicating that the dataset has been purged.

requestIdstring

Unique identifier for the request.

statusstring

Indicates the status of the request.

messagestring

Human-readable message describing the outcome of the request (for display/logging; not intended for programmatic parsing).

Example response

{
  "requestId": "b0eac937-c25c-47a5-bb7e-552f6b860458",
  "status": "success",
  "message": "Resource deleted successfully"
}