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"
}
'

import requests

url = "https://api.cognee.ai/api/v1/datasets"

payload = { "name": "my_dataset" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "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"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

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

⌘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"
}
'

import requests

url = "https://api.cognee.ai/api/v1/datasets"

payload = { "name": "my_dataset" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "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"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Getting Started

auth

add

cognify

memify

search

permissions

datasets

ontologies

settings

visualize

schema

skills

configuration

delete

update

responses

llm

sync

users

checks

health

agent management

agent connections

activity

sessions

remember

recall

improve

forget

slack

integrations

Create New Dataset

Request Parameters

Response

Error Codes

Authorizations

Body

Response