datasets

Delete Dataset

Delete a dataset by its ID.

This endpoint permanently deletes a dataset and all its associated data. The user must have delete permissions on the dataset to perform this operation.

Path Parameters

dataset_id (UUID): The unique identifier of the dataset to delete

Response

No content returned on successful deletion.

Error Codes

401/403 Unauthorized/Forbidden: Dataset doesn’t exist or user lacks delete permission
500 Internal Server Error: Error during deletion

DELETE

api

datasets

{dataset_id}

Delete Dataset

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

import requests

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

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

response = requests.delete(url, headers=headers)

print(response.text)

{
  "message": "<string>"
}

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

Path Parameters

dataset_id

string<uuid>

required

Dataset UUID, the id field from GET /api/v1/datasets (not the name)

Example:

"b8a7c3de-4f5a-4b6c-8d9e-0f1a2b3c4d5e"

Response

Successful Response

Delete DataDelete a specific data item from a dataset. This endpoint removes a specific data item from a dataset while keeping the dataset itself intact. The user must have delete permissions on the dataset to perform this operation. ## Path Parameters - **dataset_id** (UUID): The unique identifier of the dataset containing the data - **data_id** (UUID): The unique identifier of the data item to delete ## Response No content returned on successful deletion. ## Error Codes - **401 Unauthorized**: Dataset doesn't exist or user lacks delete permission - **500 Internal Server Error**: Error during deletion ## Notes Deleting a data_id not tracked in the dataset is treated as a custom-graph-model deletion and returns success.

⌘I

Delete Dataset

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

import requests

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

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

response = requests.delete(url, headers=headers)

print(response.text)

{
  "message": "<string>"
}

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