datasets

Get Datasets

Get all datasets accessible to the authenticated user.

This endpoint retrieves all datasets that the authenticated user has read permissions for. The datasets are returned with their metadata including ID, name, creation time, and owner information.

Response

Returns a list of dataset objects 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 retrieving datasets

GET

api

datasets

Get Datasets

curl --request GET \
  --url https://api.cognee.ai/api/v1/datasets \
  --header 'Authorization: Bearer <token>'

import requests

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

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, 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"
  }
]

Authorizations

Authorization

string

header

required

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

Response

200 - application/json

Successful Response

string<uuid>

required

name

string

required

createdAt

string<date-time>

required

ownerId

string<uuid>

required

updatedAt

string<date-time> | null

Create New DatasetCreate 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

⌘I

Get Datasets

curl --request GET \
  --url https://api.cognee.ai/api/v1/datasets \
  --header 'Authorization: Bearer <token>'

import requests

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

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, 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"
  }
]