> ## Documentation Index > Fetch the complete documentation index at: https://docs.cognee.ai/llms.txt > Use this file to discover all available pages before exploring further. # Forget data: one item, a dataset, its memory only, or everything > 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 - **404 Not Found**: Dataset name does not exist or is not accessible - **403 Forbidden**: Caller lacks delete permission on the dataset - **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 ## OpenAPI ````yaml /cognee_openapi_spec.json post /api/v1/forget openapi: 3.1.0 info: title: Cognee API description: Cognee API with Bearer token and Cookie auth version: 1.0.0 servers: - url: https://{tenant}.aws.cognee.ai description: 'Cognee Cloud: your tenant pod, named in the platform.cognee.ai dashboard' variables: tenant: default: your-tenant description: Your tenant name, shown in the Cognee Cloud dashboard - url: http://localhost:8000 description: 'Self-hosted: a locally running cognee server' security: - BearerAuth: [] - ApiKeyAuth: [] tags: - name: activity description: >- Activity endpoints for inspecting pipeline runs, traced spans, tenant users, agents, and dataset exports. - name: add description: Data ingestion endpoints for adding text, files, and structured data. - name: agent connections description: >- Endpoints for registering, unregistering, and inspecting agent connections to the instance. - name: agent management description: Endpoints for creating, listing, retrieving, and deleting agents. - name: auth description: >- Authentication endpoints for user registration, login, and token management. - name: checks description: >- Diagnostic endpoint for validating a Cognee Cloud API key supplied in the X-Api-Key header. - name: cognify description: >- Knowledge processing endpoints to transform raw data into knowledge graphs. - name: configuration description: >- Endpoints for storing, retrieving, and listing a user's saved configurations. - name: datasets description: Dataset management endpoints for listing, creating, and deleting datasets. - name: delete description: Data deletion endpoints (deprecated — use datasets endpoints instead). - name: forget description: Endpoint for removing data from the knowledge graph. - name: health description: Liveness, readiness, and component health checks. - name: improve description: Endpoint for enriching and improving an existing knowledge graph. - name: integrations description: >- Endpoints for connecting, provisioning, and disconnecting OAuth providers and plugins. - name: llm description: >- LLM-backed endpoints for inferring graph schemas and generating custom extraction prompts. - name: memify description: >- Endpoint for running enrichment pipelines over existing graphs or supplied data. - name: ontologies description: >- Endpoints for uploading, listing, and deleting ontology files used during cognify. - name: permissions description: Permission management for multi-user access control. - name: recall description: >- Endpoints for querying the knowledge graph and reviewing past recall history. - name: remember description: >- Endpoints for ingesting data into the knowledge graph and storing session memory entries. - name: responses description: Response generation endpoints using the knowledge graph. - name: schema description: >- Schema inspection endpoints for a dataset's derived schema inventory and the caller-wide memory provenance graph. - name: search description: Search endpoints for querying the knowledge graph. - name: sessions description: >- Endpoints for listing sessions and reporting usage, cost, and token statistics. - name: settings description: Configuration endpoints for managing Cognee settings. - name: skills description: >- Skill management endpoints for ingesting, listing, retrieving, and deleting dataset skills, plus read-only retrieval of improvement proposals. - name: slack description: >- Endpoints for listing workspace channels, setting channel allowlists, and linking Slack accounts. - name: sync description: Endpoints for syncing local data to Cognee Cloud and checking sync status. - name: update description: Endpoint for updating existing data in a dataset. - name: users description: User management endpoints. - name: validate description: >- Diagnostic endpoint for checking consistency between a dataset's graph and vector stores. - name: visualize description: Graph visualization endpoints. paths: /api/v1/forget: post: tags: - forget summary: 'Forget data: one item, a dataset, its memory only, or everything' description: >- 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 - **404 Not Found**: Dataset name does not exist or is not accessible - **403 Forbidden**: Caller lacks delete permission on the dataset - **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 operationId: forget_endpoint_api_v1_forget_post requestBody: content: application/json: schema: $ref: '#/components/schemas/ForgetPayloadDTO' required: true responses: '200': description: Successful Response content: application/json: schema: additionalProperties: true type: object title: Response Forget Endpoint Api V1 Forget Post '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/cognee__api__DTO__ErrorResponse' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/cognee__api__DTO__ErrorResponse' '422': description: Unprocessable Content content: application/json: schema: $ref: '#/components/schemas/cognee__api__DTO__ErrorResponse' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/cognee__api__DTO__ErrorResponse' security: - BearerAuth: [] - ApiKeyAuth: [] components: schemas: ForgetPayloadDTO: properties: dataId: anyOf: - type: string format: uuid - type: 'null' title: Dataid description: >- UUID of a single data item to remove. Requires `dataset` or `datasetId` to also be set. examples: - '' dataset: anyOf: - type: string - type: 'null' title: Dataset description: >- Dataset name to delete (or clear with memoryOnly). Provide either `dataset` or `datasetId`, not both. examples: - default_dataset datasetId: anyOf: - type: string format: uuid - type: 'null' title: Datasetid description: >- Dataset UUID, alternative to `dataset`. Provide either `dataset` or `datasetId`, not both. examples: - '' everything: type: boolean title: Everything description: >- DANGER: when true, permanently deletes ALL datasets and data the user owns (relational records, graph, vector embeddings, session cache). Ignores dataId/dataset/datasetId. default: false memoryOnly: type: boolean title: Memoryonly description: >- 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. default: false type: object title: ForgetPayloadDTO examples: - dataset: main_dataset memoryOnly: true cognee__api__DTO__ErrorResponse: properties: error: type: string title: Error detail: anyOf: - type: string - type: 'null' title: Detail type: object required: - error title: ErrorResponse description: >- Error body returned by routers that answer 4xx/5xx themselves. ``error`` is the human-readable message. Errors raised as ``CogneeApiError`` are rendered instead by the app-level handler in ``cognee/api/client.py`` as ``{"detail": " []"}`` plus ``"remediation"`` when a fix is known. securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT ApiKeyAuth: type: apiKey in: header name: X-Api-Key ````