Skip to main content
POST
/
api
/
v1
/
datasets
Create a new dataset
curl --request POST \
  --url https://app.dimred.com/api/v1/datasets \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "project_id": "proj_abc123",
  "dataset_name": "Training Data",
  "dataset_source": "api"
}'
{
  "id": "<string>",
  "project_id": "<string>",
  "dataset_name": "<string>",
  "dataset_source": "<string>",
  "dataset_source_id": "<string>",
  "is_pinned": true,
  "datapoint_count": 123,
  "created_at": "2023-11-07T05:31:56Z"
}

Authorizations

x-api-key
string
header
required

API key for authentication. Obtain from your DimRed dashboard. The organization context is automatically derived from the API key.

Body

application/json
project_id
string
required

Project identifier this dataset belongs to

dataset_name
string
required

Name of the dataset

dataset_source
string
default:api

Source of the dataset (e.g., 'api', 'csv', 'manual')

Response

Dataset created successfully

id
string

Unique identifier for the dataset

project_id
string

Project identifier

dataset_name
string

Name of the dataset

dataset_source
string

Source of the dataset

dataset_source_id
string | null

External source identifier

is_pinned
boolean

Whether the dataset is pinned

datapoint_count
integer

Number of datapoints in the dataset

created_at
string<date-time>

ISO 8601 timestamp of creation