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

# PUT /datasets/{datasetId}

`PUT /datasets/{datasetId}`

Updates a dataset's metadata. Synchronous operation. Only provided fields are updated; omitted fields remain unchanged. To modify dataset content, use <code>AddDatasetExamples</code>, <code>UpdateDatasetExamples</code>, or <code>DeleteDatasetExamples</code>.

## Path parameters

- `datasetId` string, required

## Request body

- object
  - `clientToken` string — A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If you don't specify this field, a value is randomly generated for you. If this token matches a previous request, the service ignores the request, but doesn't return an error. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring idempotency</a>.
  - `description` string — The updated description for the dataset.

## Response `200`

Success

- UpdateDatasetResponse
  - `datasetArn` string, required — The Amazon Resource Name (ARN) of the updated dataset.
  - `datasetId` string, required — The unique identifier of the updated dataset.
  - `updatedAt` string, date-time, required — The timestamp when the dataset was updated.

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