forget

Forget Endpoint

Remove data from the knowledge graph.

Set everything: true to delete all user data.
Set dataset or datasetId alone to delete an entire dataset.
Set dataset/datasetId + dataId to delete a single item.
Set dataset/datasetId + memoryOnly: true to clear memory (graph + vector), preserving raw files so the dataset can be re-cognified.
Set dataset/datasetId + dataId + memoryOnly: true to clear memory for a single file only.

Request Parameters

dataId (Optional[UUID]): UUID of a single data item to remove. Requires dataset or datasetId to also be set.
dataset (Optional[str]): Name of the dataset to delete or clear.
datasetId (Optional[UUID]): UUID of the dataset, alternative to dataset.
everything (bool): When true, permanently deletes ALL datasets and data the user owns (default: false).
memoryOnly (bool): When true, delete only memory (graph + vector embeddings), preserving raw files and data records (default: false).

Provide either dataset or datasetId, not both. Field names are shown camelCased in the schema; snake_case aliases (data_id, dataset_id, memory_only) are also accepted.

Error Codes

422 Unprocessable Entity: Invalid parameter combination (e.g. both dataset and datasetId, dataId without a dataset, or memoryOnly without a dataset)
500 Internal Server Error: Error during deletion

POST

api

forget

Forget Endpoint

curl --request POST \
  --url https://api.cognee.ai/api/v1/forget \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "dataId": "",
  "dataset": "default_dataset",
  "datasetId": "",
  "everything": false,
  "memoryOnly": false
}
'

import requests

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

payload = {
    "dataId": "",
    "dataset": "default_dataset",
    "datasetId": "",
    "everything": False,
    "memoryOnly": False
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

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

dataId

string<uuid> | null

UUID of a single data item to remove. Requires dataset or datasetId to also be set.

Example:

""

dataset

string | null

Dataset name to delete (or clear with memoryOnly). Provide either dataset or datasetId, not both.

Example:

"default_dataset"

datasetId

string<uuid> | null

Dataset UUID, alternative to dataset. Provide either dataset or datasetId, not both.

Example:

""

everything

boolean

default:false

DANGER: when true, permanently deletes ALL datasets and data the user owns (relational records, graph, vector embeddings, session cache). Ignores dataId/dataset/datasetId.

memoryOnly

boolean

default:false

When True with a dataset, delete only memory (graph nodes/edges and vector embeddings) and reset pipeline status — raw files and data records are preserved. This allows re-cognifying the dataset from scratch.

Response

Successful Response

ImproveEnrich and improve the knowledge graph. This is a memory-oriented alias for the memify endpoint. It runs enrichment tasks on an existing knowledge graph. ## Request Parameters - **extraction_tasks** (Optional[List[str]]): Tasks for graph/data extraction. - **enrichment_tasks** (Optional[List[str]]): Tasks for graph enrichment. - **data** (Optional[str]): Custom input data. Uses existing graph when empty. - **dataset_name** (Optional[str]): Dataset name. - **dataset_id** (Optional[UUID]): Dataset UUID. - **node_name** (Optional[List[str]]): Filter to specific named entities. - **run_in_background** (Optional[bool]): Run asynchronously (default: False). - **build_global_context_index** (Optional[bool]): Build the global context index after enrichment (default: False). Either dataset_name or dataset_id must be provided. ## Error Codes - **400 Bad Request**: Neither dataset_id nor dataset_name provided - **409 Conflict**: Error during processing

⌘I

Forget Endpoint

curl --request POST \
  --url https://api.cognee.ai/api/v1/forget \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "dataId": "",
  "dataset": "default_dataset",
  "datasetId": "",
  "everything": false,
  "memoryOnly": false
}
'

import requests

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

payload = {
    "dataId": "",
    "dataset": "default_dataset",
    "datasetId": "",
    "everything": False,
    "memoryOnly": False
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

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