# Create a Dataset

Create a Dataset in the environment associated with your API key.
If a Dataset already exists by that name (or slug), then the existing dataset will be returned.


Endpoint: POST /1/datasets
Version: 1.0.0
Security: configuration_key

## Request fields (application/json):

  - `name` (string, required)
    The name of the dataset.

  - `description` (string)
    A description for the dataset.
    Example: "A nice description of my dataset"

  - `expand_json_depth` (integer)
    The maximum unpacking depth of nested JSON fields.
    Example: 3

## Response 200 fields (application/json):

  - `name` (string, required)
    The name of the dataset.
    Example: "My Dataset!"

  - `description` (string)
    A description for the dataset.
    Example: "A nice description of my dataset"

  - `settings` (object)

  - `settings.delete_protected` (boolean)
    If true, the dataset cannot be deleted.

  - `expand_json_depth` (integer)
    The maximum unpacking depth of nested JSON fields.
    Example: 3

  - `slug` (string)
    The 'slug' of the dataset to be used in URLs.
    Example: "my-dataset-"

  - `regular_columns_count` (null,integer)
    The total number of unique fields for this Dataset. The value will be null if the dataset does not contain any fields yet.
    Example: 100

  - `last_written_at` (null,string)
    The ISO8601-formatted time when the dataset last received event data. The value will be null if no data has been received yet.
    Example: "2022-07-21T18:39:23Z"

  - `created_at` (string)
    The ISO8601-formatted time when the dataset was created.
    Example: "2022-09-22T17:32:11Z"

## Response 201 fields (application/json):

  - `name` (string, required)
    The name of the dataset.
    Example: "My Dataset!"

  - `description` (string)
    A description for the dataset.
    Example: "A nice description of my dataset"

  - `settings` (object)

  - `settings.delete_protected` (boolean)
    If true, the dataset cannot be deleted.

  - `expand_json_depth` (integer)
    The maximum unpacking depth of nested JSON fields.
    Example: 3

  - `slug` (string)
    The 'slug' of the dataset to be used in URLs.
    Example: "my-dataset-"

  - `regular_columns_count` (null,integer)
    The total number of unique fields for this Dataset. The value will be null if the dataset does not contain any fields yet.
    Example: 100

  - `last_written_at` (null,string)
    The ISO8601-formatted time when the dataset last received event data. The value will be null if no data has been received yet.
    Example: "2022-07-21T18:39:23Z"

  - `created_at` (string)
    The ISO8601-formatted time when the dataset was created.
    Example: "2022-09-22T17:32:11Z"

## Response 401 fields (application/json):

  - `error` (string)

## Response 403 fields (application/json):

  - `error` (string)

## Response 409 fields (application/json):

  - `error` (string)

## Response 422 fields (application/problem+json):

  - `error` (string, required)

  - `status` (number, required)
    The HTTP status code of the error.

  - `type` (string, required)
    Type is a URI used to uniquely identify the type of error.

  - `title` (string, required)
    Title is a human-readable summary that explains the  of the problem.

  - `detail` (string)
    The general, human-readable error message.

  - `instance` (string)
    The unique identifier (ID) for this specific error.

  - `type_detail` (array)

  - `type_detail.field` (string)

  - `type_detail.code` (string)
    Enum: "invalid", "missing", "incorrect_type", "already_exists"

  - `type_detail.description` (string)

## Response 429 fields (application/json):

  - `error` (string)

## Response default fields (application/json):

  - `error` (string)