POST

/datasets

http://databrew.{region}.amazonaws.com/datasets

Creates a new DataBrew dataset.

Access Token Required: API Key

Body Params

Namestringrequired

The name of the dataset to be created. Valid characters are alphanumeric (A-Z, a-z, 0-9), hyphen (-), period (.), and space.

Tagsobject

Metadata tags to apply to this dataset.

Inputobjectrequired

Represents information on how DataBrew can find data, in either the Glue Data Catalog or Amazon S3.

Formatstring

The file format of a dataset that is created from an Amazon S3 file or folder.

PathOptionsobject

Represents a set of options that define how DataBrew selects files for a given Amazon S3 path in a dataset.

FormatOptionsobject

Represents a set of options that define the structure of either comma-separated value (CSV), Excel, or JSON input.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request POST \
2     --url 'http://databrew.{region}.amazonaws.com/datasets' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}