v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-141531,219979.8 KB

Deletes a dataset version or an entire dataset asynchronously. If <code>datasetVersion</code> is absent, deletes all versions and the dataset record itself. If provided, deletes only that specific version.

delete/datasets/{datasetId}

Path parameters

datasetIdstring required

The unique identifier of the dataset to delete.

Query parameters

datasetVersionstring

Dataset version identifier. Accepts "DRAFT" or a non-negative integer string representing a published version number.

Optional version to delete. If absent, deletes the entire dataset. If provided, deletes only that specific version.

Response

Success

datasetArnstring required

The Amazon Resource Name (ARN) of the dataset.

datasetIdstring required

The unique identifier of the dataset.

status'CREATING' | 'UPDATING' | 'DELETING' | 'ACTIVE' | 'CREATE_FAILED' | 'UPDATE_FAILED' | 'DELETE_FAILED' required

The current status of the dataset after the delete request.

datasetVersionstring required

The version that was deleted.

updatedAtstring date-time required

The timestamp when the delete was initiated.