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

# GET /datasets/{datasetId}

`GET /datasets/{datasetId}`

Retrieves dataset metadata. Use the <code>datasetVersion</code> query parameter to retrieve a specific version's metadata. If absent, defaults to DRAFT. For paginated example content, use <code>ListDatasetExamples</code>.

## 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 `200`

Success

- GetDatasetResponse
  - `datasetArn` string, required — The Amazon Resource Name (ARN) of the dataset.
  - `datasetId` string, required — The unique identifier of the dataset.
  - `datasetVersion` string, required — The resolved version: "DRAFT" (default) or the requested version number.
  - `datasetName` string, required — The name of the dataset.
  - `description` string — The description of the dataset.
  - `status` 'CREATING' | 'UPDATING' | 'DELETING' | 'ACTIVE' | 'CREATE_FAILED' | 'UPDATE_FAILED' | 'DELETE_FAILED', required — The current status of the dataset.
  - `draftStatus` 'MODIFIED' | 'UNMODIFIED' — Publish synchronization state. Only authoritative when status is ACTIVE. MODIFIED indicates DRAFT has unpublished changes. UNMODIFIED indicates DRAFT matches the latest published version.
  - `failureReason` string — Populated when status is CREATE_FAILED, UPDATE_FAILED, or DELETE_FAILED. Describes the reason for the failure.
  - `schemaType` 'AGENTCORE_EVALUATION_PREDEFINED_V1' | 'AGENTCORE_EVALUATION_SIMULATED_V1', required — The schema type declared at create time. Immutable after creation.
  - `kmsKeyArn` string — KMS key ARN used for server-side encryption on service Amazon S3 writes, if configured.
  - `exampleCount` integer, required — The number of examples in the DRAFT.
  - `downloadUrl` string, password — Presigned Amazon S3 URL to download the consolidated dataset file for the resolved version. Expires after 5 minutes. Omitted if the file does not yet exist.
  - `downloadUrlExpiresAt` string, date-time — Expiry timestamp for the download URL.
  - `createdAt` string, date-time, required — The timestamp when the dataset was created.
  - `updatedAt` string, date-time, required — The timestamp when the dataset was last updated.
  - `tags` object — The tags associated with the dataset.

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