datasets

Delete Data

Delete 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.

DELETE

api

datasets

{dataset_id}

data

{data_id}

Delete Data

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

{
  "message": "<string>"
}

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"

data_id

string<uuid>

required

Data item UUID, from GET /api/v1/datasets/{dataset_id}/data

Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

Response

Successful Response

Get Dataset GraphGet the knowledge graph visualization for a dataset. This endpoint retrieves the knowledge graph data for a specific dataset, including nodes and edges that represent the relationships between entities in the dataset. The graph data is formatted for visualization purposes. ## Path Parameters - **dataset_id** (UUID): The unique identifier of the dataset ## Response Returns the graph data containing: - **nodes**: List of graph nodes with id, label, type, and properties - **edges**: List of graph edges with source, target, and label ## Error Codes - **404 Not Found**: Dataset doesn't exist or user doesn't have access - **500 Internal Server Error**: Error retrieving graph data

⌘I

Delete Data

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

{
  "message": "<string>"
}