---
title: "POST /v1/data-sets"
method: POST
path: "/v1/data-sets"
---

# POST /v1/data-sets

`POST /v1/data-sets`

This operation creates a data set.

## Request body

- object
  - `AssetType` 'S3_SNAPSHOT' | 'REDSHIFT_DATA_SHARE' | 'API_GATEWAY_API' | 'S3_DATA_ACCESS' | 'LAKE_FORMATION_DATA_PERMISSION', required — The type of asset that is added to a data set.
  - `Description` string, required — A description for the data set. This value can be up to 16,348 characters long.
  - `Name` string, required — The name of the data set.
  - `Tags` object — A data set tag is an optional label that you can assign to a data set when you create it. Each tag consists of a key and an optional value, both of which you define. When you use tagging, you can also use tag-based access control in IAM policies to control access to these data sets and revisions.

## Response `201`

Success

- CreateDataSetResponse
  - `Arn` string — The ARN for the data set.
  - `AssetType` 'S3_SNAPSHOT' | 'REDSHIFT_DATA_SHARE' | 'API_GATEWAY_API' | 'S3_DATA_ACCESS' | 'LAKE_FORMATION_DATA_PERMISSION' — The type of asset that is added to a data set.
  - `CreatedAt` string, date-time — The date and time that the data set was created, in ISO 8601 format.
  - `Description` string — The description for the data set.
  - `Id` string — The unique identifier for the data set.
  - `Name` string — The name of the data set.
  - `Origin` 'OWNED' | 'ENTITLED' — A property that defines the data set as OWNED by the account (for providers) or ENTITLED to the account (for subscribers).
  - `OriginDetails` object — If the origin of this data set is ENTITLED, includes the details for the product on AWS Marketplace.
    - `ProductId` string, required — The product ID of the origin of the data set.
  - `SourceId` string — The data set ID of the owned data set corresponding to the entitled data set being viewed. This parameter is returned when a data set owner is viewing the entitled copy of its owned data set.
  - `Tags` object — The tags for the data set.
  - `UpdatedAt` string, date-time — The date and time that the data set was last updated, in ISO 8601 format.

## Other responses

- `480` — ServiceLimitExceededException
- `481` — ThrottlingException
- `482` — AccessDeniedException
- `483` — ValidationException
- `484` — InternalServerException

---

[API](https://skmtc.net/aws/apis/dataexchange.md) · [All operations](https://skmtc.net/aws/apis/dataexchange/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/dataexchange/versions/8430cce2f89e/schema)