datasets

Create New Dataset

Create a new dataset or return existing dataset with the same name.

This endpoint creates a new dataset with the specified name. If a dataset with the same name already exists for the user, it returns the existing dataset instead of creating a duplicate. The user is automatically granted all permissions (read, write, share, delete) on the created dataset.

Request Parameters

dataset_data (DatasetCreationPayload): Dataset creation parameters containing:
- name: The name for the new dataset

Response

Returns the created or existing dataset object containing:

id: Unique dataset identifier
name: Dataset name
created_at: When the dataset was created
updated_at: When the dataset was last updated
owner_id: ID of the dataset owner

Error Codes

418 I’m a teapot: Error creating dataset

POST

api

datasets

Create New Dataset

curl --request POST \
  --url https://api.cognee.ai/api/v1/datasets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "my_dataset"
}
'

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "ownerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

name

string

required

Name of the dataset to create. If a dataset with this name already exists for the user, the existing dataset is returned instead of creating a duplicate.

Example:

"main_dataset"

Response

Successful Response

string<uuid>

required

name

string

required

createdAt

string<date-time>

required

ownerId

string<uuid>

required

updatedAt

string<date-time> | null

Delete AllDelete all user's data. This endpoint permanently deletes all datasets that user created and all its associated data. The user must have delete permissions on the dataset to perform this operation. ## Response No content returned on successful deletion. If no datasets exist for the users, nothing happens.

⌘I

Create New Dataset

curl --request POST \
  --url https://api.cognee.ai/api/v1/datasets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "my_dataset"
}
'

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "ownerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "updatedAt": "2023-11-07T05:31:56Z"
}