---
title: "POST /datasetsv2"
method: POST
path: "/datasetsv2"
---

# POST /datasetsv2

`POST /datasetsv2`

Creates a new FinSpace Dataset.

## Request body

- object
  - `clientToken` string — Idempotence Token for API operations
  - `datasetTitle` string, required — Title for a given Dataset
  - `kind` 'TABULAR' | 'NON_TABULAR', required — Dataset Kind
  - `datasetDescription` string — Description of a dataset
  - `ownerInfo` object — A structure for Dataset owner info.
    - `name` string — The name of the Dataset owner.
    - `phoneNumber` string — Phone number for the Dataset owner.
    - `email` string, password — Email address for the Dataset owner.
  - `permissionGroupParams` object, required — <p>Permission group parameters for Dataset permissions.</p> <p>Here is an example of how you could specify the <code>PermissionGroupParams</code>:</p> <p> <code> { "permissionGroupId": "0r6fCRtSTUk4XPfXQe3M0g", "datasetPermissions": [ {"permission": "ViewDatasetDetails"}, {"permission": "AddDatasetData"}, {"permission": "EditDatasetMetadata"}, {"permission": "DeleteDataset"} ] } </code> </p>
    - `permissionGroupId` string — The unique identifier for the <code>PermissionGroup</code>.
    - `datasetPermissions` ResourcePermission[] — List of resource permissions.
      - `permission` string — Permission for a resource.
  - `alias` string — The unique resource identifier for a Dataset.
  - `schemaDefinition` object — A union of schema types.
    - `tabularSchemaConfig` object — The configuration for a schema on a tabular Dataset.
      - `columns` ColumnDefinition[] — List of column definitions.
        - `dataType` 'STRING' | 'CHAR' | 'INTEGER' | 'TINYINT' | 'SMALLINT' | 'BIGINT' | 'FLOAT' | 'DOUBLE' | 'DATE' | 'DATETIME' | 'BOOLEAN' | 'BINARY' — <p>Data type of a column.</p> <ul> <li> <p> <code>STRING</code> – A String data type.</p> <p> <code>CHAR</code> – A char data type.</p> <p> <code>INTEGER</code> – An integer data type.</p> <p> <code>TINYINT</code> – A tinyint data type.</p> <p> <code>SMALLINT</code> – A smallint data type.</p> <p> <code>BIGINT</code> – A bigint data type.</p> <p> <code>FLOAT</code> – A float data type.</p> <p> <code>DOUBLE</code> – A double data type.</p> <p> <code>DATE</code> – A date data type.</p> <p> <code>DATETIME</code> – A datetime data type.</p> <p> <code>BOOLEAN</code> – A boolean data type.</p> <p> <code>BINARY</code> – A binary data type.</p> </li> </ul>
        - `columnName` string — The name of a column.
        - `columnDescription` string — Description for a column.
      - `primaryKeyColumns` ColumnName[] — List of column names used for primary key.

## Response `200`

Success

- CreateDatasetResponse — The response from a CreateDataset operation
  - `datasetId` string — The unique identifier for the created Dataset.

## Other responses

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

---

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