---
title: "DELETE /datasets/{datasetId}"
method: DELETE
path: "/datasets/{datasetId}"
---

# DELETE /datasets/{datasetId}

`DELETE /datasets/{datasetId}`

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.

## Path parameters

- `datasetId` string, required

## Query parameters

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

## Response `202`

Success

- DeleteDatasetResponse
  - `datasetArn` string, required — The Amazon Resource Name (ARN) of the dataset.
  - `datasetId` string, 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.
  - `datasetVersion` string, required — The version that was deleted.
  - `updatedAt` string, date-time, required — The timestamp when the delete was initiated.

## Other responses

- `480` — ValidationException
- `481` — ConflictException
- `482` — AccessDeniedException
- `483` — ResourceNotFoundException
- `484` — ThrottlingException
- `485` — InternalServerException

---

[API](https://skmtc.net/aws/apis/bedrock-agentcore-control.md) · [All operations](https://skmtc.net/aws/apis/bedrock-agentcore-control/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/bedrock-agentcore-control/versions/0ebde766792b/schema)