cognee 0.2.1.dev6__tar.gz → 0.2.2.dev0__tar.gz

{cognee-0.2.1.dev6 → cognee-0.2.2.dev0}/.gitguardian.yml

@@ -17,10 +17,15 @@ secret-scan:
   # Ignore by commit (if needed)
   excluded-commits:
     - '782bbb4'
+    - 'f857e07'
 
   # Custom rules for template files
   paths-ignore:
     - path: '.env.template'
       comment: 'Template file with placeholder values'
     - path: '.github/workflows/search_db_tests.yml'
-      comment: 'Test workflow with test credentials'
+      comment: 'Test workflow with test credentials'
+    - path: 'docker-compose.yml'
+      comment: 'Development docker compose with test credentials (neo4j/pleaseletmein, postgres cognee/cognee)'
+    - path: 'deployment/helm/docker-compose-helm.yml'
+      comment: 'Helm deployment docker compose with test postgres credentials (cognee/cognee)'

{cognee-0.2.1.dev6 → cognee-0.2.2.dev0}/.gitignore

@@ -37,6 +37,7 @@ share/python-wheels/
 .installed.cfg
 *.egg
 .python-version
+cognee-mcp/.python-version
 MANIFEST
 
 # PyInstaller

{cognee-0.2.1.dev6 → cognee-0.2.2.dev0}/CONTRIBUTING.md

@@ -12,6 +12,7 @@ This guide will help you get started and ensure your contributions can be effici
 - [Code of Conduct](CODE_OF_CONDUCT.md)
 - [Discord Community](https://discord.gg/bcy8xFAtfd)  
 - [Issue Tracker](https://github.com/topoteretes/cognee/issues)
+- [Cognee Docs](https://docs.cognee.ai)
 
 ## 1. 🚀 Ways to Contribute
 
@@ -69,6 +70,13 @@ Looking for a place to start? Try filtering for [good first issues](https://gith
 git clone https://github.com/<your-github-username>/cognee.git
 cd cognee
 ```
+In case you are working on Vector and Graph Adapters
+1. Fork the [**cognee**](https://github.com/topoteretes/cognee-community) repository
+2. Clone your fork:
+```shell
+git clone https://github.com/<your-github-username>/cognee-community.git
+cd cognee-community
+```
 
 ### Create a Branch
 

{cognee-0.2.1.dev6 → cognee-0.2.2.dev0}/Dockerfile

@@ -31,7 +31,7 @@ COPY README.md pyproject.toml uv.lock entrypoint.sh ./
 
 # Install the project's dependencies using the lockfile and settings
 RUN --mount=type=cache,target=/root/.cache/uv \
-    uv sync --extra debug --extra api --extra postgres --extra weaviate --extra qdrant --extra neo4j --extra llama-index --extra gemini --extra ollama --extra mistral --extra groq --extra anthropic --frozen --no-install-project --no-dev --no-editable
+    uv sync --extra debug --extra api --extra postgres --extra qdrant --extra neo4j --extra llama-index --extra gemini --extra ollama --extra mistral --extra groq --extra anthropic --frozen --no-install-project --no-dev --no-editable
 
 # Copy Alembic configuration
 COPY alembic.ini /app/alembic.ini
@@ -41,7 +41,7 @@ COPY alembic/ /app/alembic
 # Installing separately from its dependencies allows optimal layer caching
 COPY ./cognee /app/cognee
 RUN --mount=type=cache,target=/root/.cache/uv \
-uv sync --extra debug --extra api --extra postgres --extra weaviate --extra qdrant --extra neo4j --extra llama-index --extra gemini --extra ollama --extra mistral --extra groq --extra anthropic --frozen --no-dev --no-editable
+uv sync --extra debug --extra api --extra postgres --extra qdrant --extra neo4j --extra llama-index --extra gemini --extra ollama --extra mistral --extra groq --extra anthropic --frozen --no-dev --no-editable
 
 FROM python:3.12-slim-bookworm
 

{cognee-0.2.1.dev6 → cognee-0.2.2.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cognee
-Version: 0.2.1.dev6
+Version: 0.2.2.dev0
 Summary: Cognee - is a library for enriching LLM context with a semantic layer for better understanding and reasoning.
 Project-URL: Homepage, https://www.cognee.ai
 Project-URL: Repository, https://github.com/topoteretes/cognee
@@ -24,7 +24,6 @@ Requires-Dist: dlt[sqlalchemy]<2,>=1.9.0
 Requires-Dist: fastapi-users[sqlalchemy]<15.0.0,>=14.0.1
 Requires-Dist: fastapi<1.0.0,>=0.115.7
 Requires-Dist: filetype<2.0.0,>=1.2.0
-Requires-Dist: graphistry<0.34,>=0.33.5
 Requires-Dist: instructor<2.0.0,>=1.9.1
 Requires-Dist: jinja2<4,>=3.1.3
 Requires-Dist: kuzu==0.11.0
@@ -35,7 +34,7 @@ Requires-Dist: litellm<1.71.0,>=1.57.4
 Requires-Dist: matplotlib<4,>=3.8.3
 Requires-Dist: networkx<4,>=3.4.2
 Requires-Dist: nltk<4.0.0,>=3.9.1
-Requires-Dist: numpy<=2.3.1,>=1.26.4
+Requires-Dist: numpy<=4.0.0,>=1.26.4
 Requires-Dist: onnxruntime<2.0.0,>=1.0.0
 Requires-Dist: openai<2,>=1.80.1
 Requires-Dist: pandas<3.0.0,>=2.2.2
@@ -131,13 +130,10 @@ Provides-Extra: postgres-binary
 Requires-Dist: asyncpg<1.0.0,>=0.30.0; extra == 'postgres-binary'
 Requires-Dist: pgvector<0.4,>=0.3.5; extra == 'postgres-binary'
 Requires-Dist: psycopg2-binary<3.0.0,>=2.9.10; extra == 'postgres-binary'
-Requires-Dist: psycopg2<3,>=2.9.10; extra == 'postgres-binary'
 Provides-Extra: posthog
 Requires-Dist: posthog<4,>=3.5.0; extra == 'posthog'
 Provides-Extra: qdrant
 Requires-Dist: qdrant-client<2,>=1.14.2; extra == 'qdrant'
-Provides-Extra: weaviate
-Requires-Dist: weaviate-client<5.0.0,>=4.9.6; extra == 'weaviate'
 Description-Content-Type: text/markdown
 
 <div align="center">
@@ -158,7 +154,7 @@ Description-Content-Type: text/markdown
   ·
   <a href="https://www.reddit.com/r/AIMemory/">Join r/AIMemory</a>
   .
-  <a href="https://www.docs.cognee.ai">Docs</a>
+  <a href="https://docs.cognee.ai/">Docs</a>
   .
   <a href="https://github.com/topoteretes/cognee-community">cognee community repo</a>
   </p>
@@ -185,7 +181,7 @@ Description-Content-Type: text/markdown
 
 
 
-**🚀 We are launching Cognee SaaS: Sign up [here](https://www.cognee.ai/waitlist) for the hosted beta!**
+**🚀 We launched Cogwit beta (Fully-hosted AI Memory): Sign up [here](https://platform.cognee.ai/)! 🚀** 
 
 Build dynamic memory for Agents and replace RAG using scalable, modular ECL (Extract, Cognify, Load) pipelines.
 
@@ -327,9 +323,9 @@ Try cognee UI out locally [here](https://docs.cognee.ai/how-to-guides/cognee-ui)
 
 ## Demos
 
-1. What is AI memory:
+1. Cogwit Beta demo:
 
-[Learn about cognee](https://github.com/user-attachments/assets/8b2a0050-5ec4-424c-b417-8269971503f0)
+[Cogwit Beta](https://github.com/user-attachments/assets/fa520cd2-2913-4246-a444-902ea5242cb0)
 
 2. Simple GraphRAG demo
 

{cognee-0.2.1.dev6 → cognee-0.2.2.dev0}/README.md

@@ -16,7 +16,7 @@
   ·
   <a href="https://www.reddit.com/r/AIMemory/">Join r/AIMemory</a>
   .
-  <a href="https://www.docs.cognee.ai">Docs</a>
+  <a href="https://docs.cognee.ai/">Docs</a>
   .
   <a href="https://github.com/topoteretes/cognee-community">cognee community repo</a>
   </p>
@@ -43,7 +43,7 @@
 
 
 
-**🚀 We are launching Cognee SaaS: Sign up [here](https://www.cognee.ai/waitlist) for the hosted beta!**
+**🚀 We launched Cogwit beta (Fully-hosted AI Memory): Sign up [here](https://platform.cognee.ai/)! 🚀** 
 
 Build dynamic memory for Agents and replace RAG using scalable, modular ECL (Extract, Cognify, Load) pipelines.
 
@@ -185,9 +185,9 @@ Try cognee UI out locally [here](https://docs.cognee.ai/how-to-guides/cognee-ui)
 
 ## Demos
 
-1. What is AI memory:
+1. Cogwit Beta demo:
 
-[Learn about cognee](https://github.com/user-attachments/assets/8b2a0050-5ec4-424c-b417-8269971503f0)
+[Cogwit Beta](https://github.com/user-attachments/assets/fa520cd2-2913-4246-a444-902ea5242cb0)
 
 2. Simple GraphRAG demo
 

cognee-0.2.2.dev0/cognee/api/.env.example

@@ -0,0 +1,5 @@
+# Comma-separated list of allowed origins for CORS (leave empty to block all cross-origin requests)
+# Example:
+# CORS_ALLOWED_ORIGINS="https://yourdomain.com,https://another.com"
+# For local development, you might use:
+# CORS_ALLOWED_ORIGINS="http://localhost:3000"

{cognee-0.2.1.dev6 → cognee-0.2.2.dev0}/cognee/api/client.py

@@ -67,13 +67,26 @@ async def lifespan(app: FastAPI):
 app = FastAPI(debug=app_environment != "prod", lifespan=lifespan)
 
 
+# Read allowed origins from environment variable (comma-separated)
+CORS_ALLOWED_ORIGINS = os.getenv("CORS_ALLOWED_ORIGINS")
+if CORS_ALLOWED_ORIGINS:
+    allowed_origins = [
+        origin.strip() for origin in CORS_ALLOWED_ORIGINS.split(",") if origin.strip()
+    ]
+else:
+    allowed_origins = [
+        "http://localhost:3000",
+    ]  # Block all except explicitly set origins
+
 app.add_middleware(
     CORSMiddleware,
-    allow_origins=["http://localhost:3000", "http://127.0.0.1:3000"],
+    allow_origins=allowed_origins,  # Now controlled by env var
     allow_credentials=True,
     allow_methods=["OPTIONS", "GET", "POST", "DELETE"],
     allow_headers=["*"],
 )
+# To allow origins, set CORS_ALLOWED_ORIGINS env variable to a comma-separated list, e.g.:
+# CORS_ALLOWED_ORIGINS="https://yourdomain.com,https://another.com"
 
 
 def custom_openapi():

{cognee-0.2.1.dev6 → cognee-0.2.2.dev0}/cognee/api/v1/add/add.py

@@ -14,7 +14,7 @@ async def add(
     node_set: Optional[List[str]] = None,
     vector_db_config: dict = None,
     graph_db_config: dict = None,
-    dataset_id: UUID = None,
+    dataset_id: Optional[UUID] = None,
 ):
     """
     Add data to Cognee for knowledge graph processing.

{cognee-0.2.1.dev6 → cognee-0.2.2.dev0}/cognee/api/v1/add/routers/get_add_router.py

@@ -1,16 +1,17 @@
 import os
+import requests
+import subprocess
 from uuid import UUID
 
-from fastapi import Form, UploadFile, Depends
-from fastapi.responses import JSONResponse
 from fastapi import APIRouter
-from typing import List, Optional
-import subprocess
-from cognee.shared.logging_utils import get_logger
-import requests
+from fastapi.responses import JSONResponse
+from fastapi import Form, File, UploadFile, Depends
+from typing import List, Optional, Union, Literal
 
 from cognee.modules.users.models import User
 from cognee.modules.users.methods import get_authenticated_user
+from cognee.shared.utils import send_telemetry
+from cognee.shared.logging_utils import get_logger
 
 logger = get_logger()
 
@@ -20,9 +21,9 @@ def get_add_router() -> APIRouter:
 
     @router.post("", response_model=dict)
     async def add(
-        data: List[UploadFile],
+        data: List[UploadFile] = File(default=None),
         datasetName: Optional[str] = Form(default=None),
-        datasetId: Optional[UUID] = Form(default=None),
+        datasetId: Union[UUID, Literal[""], None] = Form(default=None, examples=[""]),
         user: User = Depends(get_authenticated_user),
     ):
         """
@@ -38,7 +39,7 @@ def get_add_router() -> APIRouter:
           - GitHub repository URLs (will be cloned and processed)
           - Regular file uploads
         - **datasetName** (Optional[str]): Name of the dataset to add data to
-        - **datasetId** (Optional[UUID]): UUID of the dataset to add data to
+        - **datasetId** (Optional[UUID]): UUID of an already existing dataset
 
         Either datasetName or datasetId must be provided.
 
@@ -58,7 +59,16 @@ def get_add_router() -> APIRouter:
         - GitHub repositories are cloned and all files are processed
         - HTTP URLs are fetched and their content is processed
         - The ALLOW_HTTP_REQUESTS environment variable controls URL processing
+        - datasetId value can only be the UUID of an already existing dataset
         """
+        send_telemetry(
+            "Add API Endpoint Invoked",
+            user.id,
+            additional_properties={
+                "endpoint": "POST /v1/add",
+            },
+        )
+
         from cognee.api.v1.add import add as cognee_add
 
         if not datasetId and not datasetName:

{cognee-0.2.1.dev6 → cognee-0.2.2.dev0}/cognee/api/v1/cognify/routers/get_cognify_router.py

@@ -1,7 +1,7 @@
 import os
 import asyncio
 from uuid import UUID
-from pydantic import BaseModel
+from pydantic import Field
 from typing import List, Optional
 from fastapi.responses import JSONResponse
 from fastapi import APIRouter, WebSocket, Depends, WebSocketDisconnect
@@ -10,7 +10,6 @@ from starlette.status import WS_1000_NORMAL_CLOSURE, WS_1008_POLICY_VIOLATION
 from cognee.api.DTO import InDTO
 from cognee.modules.pipelines.methods import get_pipeline_run
 from cognee.modules.users.models import User
-from cognee.shared.data_models import KnowledgeGraph
 from cognee.modules.users.methods import get_authenticated_user
 from cognee.modules.users.get_user_db import get_user_db_context
 from cognee.modules.graph.methods import get_formatted_graph_data
@@ -24,15 +23,16 @@ from cognee.modules.pipelines.queues.pipeline_run_info_queues import (
     remove_queue,
 )
 from cognee.shared.logging_utils import get_logger
+from cognee.shared.utils import send_telemetry
 
 
 logger = get_logger("api.cognify")
 
 
 class CognifyPayloadDTO(InDTO):
-    datasets: Optional[List[str]] = None
-    dataset_ids: Optional[List[UUID]] = None
-    run_in_background: Optional[bool] = False
+    datasets: Optional[List[str]] = Field(default=None)
+    dataset_ids: Optional[List[UUID]] = Field(default=None, examples=[[]])
+    run_in_background: Optional[bool] = Field(default=False)
 
 
 def get_cognify_router() -> APIRouter:
@@ -57,8 +57,7 @@ def get_cognify_router() -> APIRouter:
 
         ## Request Parameters
         - **datasets** (Optional[List[str]]): List of dataset names to process. Dataset names are resolved to datasets owned by the authenticated user.
-        - **dataset_ids** (Optional[List[UUID]]): List of dataset UUIDs to process. UUIDs allow processing of datasets not owned by the user (if permitted).
-        - **graph_model** (Optional[BaseModel]): Custom Pydantic model defining the knowledge graph schema. Defaults to KnowledgeGraph for general-purpose processing.
+        - **dataset_ids** (Optional[List[UUID]]): List of existing dataset UUIDs to process. UUIDs allow processing of datasets not owned by the user (if permitted).
         - **run_in_background** (Optional[bool]): Whether to execute processing asynchronously. Defaults to False (blocking).
 
         ## Response
@@ -84,6 +83,14 @@ def get_cognify_router() -> APIRouter:
         ## Next Steps
         After successful processing, use the search endpoints to query the generated knowledge graph for insights, relationships, and semantic search.
         """
+        send_telemetry(
+            "Cognify API Endpoint Invoked",
+            user.id,
+            additional_properties={
+                "endpoint": "POST /v1/cognify",
+            },
+        )
+
         if not payload.datasets and not payload.dataset_ids:
             return JSONResponse(
                 status_code=400, content={"error": "No datasets or dataset_ids provided"}

{cognee-0.2.1.dev6 → cognee-0.2.2.dev0}/cognee/api/v1/config/config.py

@@ -182,15 +182,3 @@ class config:
     def set_vector_db_url(db_url: str):
         vector_db_config = get_vectordb_config()
         vector_db_config.vector_db_url = db_url
-
-    @staticmethod
-    def set_graphistry_config(graphistry_config: dict[str, str]):
-        base_config = get_base_config()
-
-        if "username" not in graphistry_config or "password" not in graphistry_config:
-            raise InvalidValueError(
-                message="graphistry_config dictionary must contain 'username' and 'password' keys."
-            )
-
-        base_config.graphistry_username = graphistry_config.get("username")
-        base_config.graphistry_password = graphistry_config.get("password")

{cognee-0.2.1.dev6 → cognee-0.2.2.dev0}/cognee/api/v1/datasets/routers/get_datasets_router.py

@@ -22,6 +22,7 @@ from cognee.modules.users.permissions.methods import (
 )
 from cognee.modules.graph.methods import get_formatted_graph_data
 from cognee.modules.pipelines.models import PipelineRunStatus
+from cognee.shared.utils import send_telemetry
 
 logger = get_logger()
 
@@ -92,6 +93,14 @@ def get_datasets_router() -> APIRouter:
         ## Error Codes
         - **418 I'm a teapot**: Error retrieving datasets
         """
+        send_telemetry(
+            "Datasets API Endpoint Invoked",
+            user.id,
+            additional_properties={
+                "endpoint": "GET /v1/datasets",
+            },
+        )
+
         try:
             datasets = await get_all_user_permission_datasets(user, "read")
 
@@ -130,6 +139,14 @@ def get_datasets_router() -> APIRouter:
         ## Error Codes
         - **418 I'm a teapot**: Error creating dataset
         """
+        send_telemetry(
+            "Datasets API Endpoint Invoked",
+            user.id,
+            additional_properties={
+                "endpoint": "POST /v1/datasets",
+            },
+        )
+
         try:
             datasets = await get_datasets_by_name([dataset_data.name], user.id)
 
@@ -175,6 +192,15 @@ def get_datasets_router() -> APIRouter:
         - **404 Not Found**: Dataset doesn't exist or user doesn't have access
         - **500 Internal Server Error**: Error during deletion
         """
+        send_telemetry(
+            "Datasets API Endpoint Invoked",
+            user.id,
+            additional_properties={
+                "endpoint": f"DELETE /v1/datasets/{str(dataset_id)}",
+                "dataset_id": str(dataset_id),
+            },
+        )
+
         from cognee.modules.data.methods import get_dataset, delete_dataset
 
         dataset = await get_dataset(user.id, dataset_id)
@@ -210,6 +236,16 @@ def get_datasets_router() -> APIRouter:
         - **404 Not Found**: Dataset or data item doesn't exist, or user doesn't have access
         - **500 Internal Server Error**: Error during deletion
         """
+        send_telemetry(
+            "Datasets API Endpoint Invoked",
+            user.id,
+            additional_properties={
+                "endpoint": f"DELETE /v1/datasets/{str(dataset_id)}/data/{str(data_id)}",
+                "dataset_id": str(dataset_id),
+                "data_id": str(data_id),
+            },
+        )
+
         from cognee.modules.data.methods import get_data, delete_data
         from cognee.modules.data.methods import get_dataset
 
@@ -254,7 +290,7 @@ def get_datasets_router() -> APIRouter:
         if dataset is None:
             raise DatasetNotFoundError(message=f"Dataset ({str(dataset_id)}) not found.")
 
-        graph_data = await get_formatted_graph_data(dataset)
+        graph_data = await get_formatted_graph_data(dataset.id, user.id)
 
         return graph_data
 
@@ -288,6 +324,15 @@ def get_datasets_router() -> APIRouter:
         - **404 Not Found**: Dataset doesn't exist or user doesn't have access
         - **500 Internal Server Error**: Error retrieving data
         """
+        send_telemetry(
+            "Datasets API Endpoint Invoked",
+            user.id,
+            additional_properties={
+                "endpoint": f"GET /v1/datasets/{str(dataset_id)}/data",
+                "dataset_id": str(dataset_id),
+            },
+        )
+
         from cognee.modules.data.methods import get_dataset_data, get_dataset
 
         # Verify user has permission to read dataset
@@ -308,7 +353,7 @@ def get_datasets_router() -> APIRouter:
 
     @router.get("/status", response_model=dict[str, PipelineRunStatus])
     async def get_dataset_status(
-        datasets: Annotated[List[UUID], Query(alias="dataset")] = None,
+        datasets: Annotated[List[UUID], Query(alias="dataset")] = [],
         user: User = Depends(get_authenticated_user),
     ):
         """
@@ -331,6 +376,15 @@ def get_datasets_router() -> APIRouter:
         ## Error Codes
         - **500 Internal Server Error**: Error retrieving status information
         """
+        send_telemetry(
+            "Datasets API Endpoint Invoked",
+            user.id,
+            additional_properties={
+                "endpoint": "GET /v1/datasets/status",
+                "datasets": [str(dataset_id) for dataset_id in datasets],
+            },
+        )
+
         from cognee.api.v1.datasets.datasets import datasets as cognee_datasets
 
         try:
@@ -367,6 +421,16 @@ def get_datasets_router() -> APIRouter:
         - **404 Not Found**: Dataset or data item doesn't exist, or user doesn't have access
         - **500 Internal Server Error**: Error accessing the raw data file
         """
+        send_telemetry(
+            "Datasets API Endpoint Invoked",
+            user.id,
+            additional_properties={
+                "endpoint": f"GET /v1/datasets/{str(dataset_id)}/data/{str(data_id)}/raw",
+                "dataset_id": str(dataset_id),
+                "data_id": str(data_id),
+            },
+        )
+
         from cognee.modules.data.methods import get_data
         from cognee.modules.data.methods import get_dataset_data
 

{cognee-0.2.1.dev6 → cognee-0.2.2.dev0}/cognee/api/v1/delete/routers/get_delete_router.py

@@ -5,6 +5,7 @@ from uuid import UUID
 from cognee.shared.logging_utils import get_logger
 from cognee.modules.users.models import User
 from cognee.modules.users.methods import get_authenticated_user
+from cognee.shared.utils import send_telemetry
 
 logger = get_logger()
 
@@ -31,6 +32,16 @@ def get_delete_router() -> APIRouter:
             JSON response indicating success or failure
 
         """
+        send_telemetry(
+            "Delete API Endpoint Invoked",
+            user.id,
+            additional_properties={
+                "endpoint": "DELETE /v1/delete",
+                "dataset_id": str(dataset_id),
+                "data_id": str(data_id),
+            },
+        )
+
         from cognee.api.v1.delete import delete as cognee_delete
 
         try:

{cognee-0.2.1.dev6 → cognee-0.2.2.dev0}/cognee/api/v1/permissions/routers/get_permissions_router.py

@@ -6,12 +6,13 @@ from fastapi.responses import JSONResponse
 
 from cognee.modules.users.models import User
 from cognee.modules.users.methods import get_authenticated_user
+from cognee.shared.utils import send_telemetry
 
 
 def get_permissions_router() -> APIRouter:
     permissions_router = APIRouter()
 
-    @permissions_router.post("/datasets/{principal_id}/")
+    @permissions_router.post("/datasets/{principal_id}")
     async def give_datasets_permission_to_principal(
         permission_name: str,
         dataset_ids: List[UUID],
@@ -40,6 +41,16 @@ def get_permissions_router() -> APIRouter:
         - **403 Forbidden**: User doesn't have permission to grant access
         - **500 Internal Server Error**: Error granting permission
         """
+        send_telemetry(
+            "Permissions API Endpoint Invoked",
+            user.id,
+            additional_properties={
+                "endpoint": f"POST /v1/permissions/datasets/{str(principal_id)}",
+                "dataset_ids": str(dataset_ids),
+                "principal_id": str(principal_id),
+            },
+        )
+
         from cognee.modules.users.permissions.methods import authorized_give_permission_on_datasets
 
         await authorized_give_permission_on_datasets(
@@ -72,6 +83,15 @@ def get_permissions_router() -> APIRouter:
         - **400 Bad Request**: Invalid role name or role already exists
         - **500 Internal Server Error**: Error creating the role
         """
+        send_telemetry(
+            "Permissions API Endpoint Invoked",
+            user.id,
+            additional_properties={
+                "endpoint": "POST /v1/permissions/roles",
+                "role_name": role_name,
+            },
+        )
+
         from cognee.modules.users.roles.methods import create_role as create_role_method
 
         await create_role_method(role_name=role_name, owner_id=user.id)
@@ -104,6 +124,16 @@ def get_permissions_router() -> APIRouter:
         - **404 Not Found**: User or role doesn't exist
         - **500 Internal Server Error**: Error adding user to role
         """
+        send_telemetry(
+            "Permissions API Endpoint Invoked",
+            user.id,
+            additional_properties={
+                "endpoint": f"POST /v1/permissions/users/{str(user_id)}/roles",
+                "user_id": str(user_id),
+                "role_id": str(role_id),
+            },
+        )
+
         from cognee.modules.users.roles.methods import add_user_to_role as add_user_to_role_method
 
         await add_user_to_role_method(user_id=user_id, role_id=role_id, owner_id=user.id)
@@ -136,6 +166,16 @@ def get_permissions_router() -> APIRouter:
         - **404 Not Found**: User or tenant doesn't exist
         - **500 Internal Server Error**: Error adding user to tenant
         """
+        send_telemetry(
+            "Permissions API Endpoint Invoked",
+            user.id,
+            additional_properties={
+                "endpoint": f"POST /v1/permissions/users/{str(user_id)}/tenants",
+                "user_id": str(user_id),
+                "tenant_id": str(tenant_id),
+            },
+        )
+
         from cognee.modules.users.tenants.methods import add_user_to_tenant
 
         await add_user_to_tenant(user_id=user_id, tenant_id=tenant_id, owner_id=user.id)
@@ -161,6 +201,15 @@ def get_permissions_router() -> APIRouter:
         - **400 Bad Request**: Invalid tenant name or tenant already exists
         - **500 Internal Server Error**: Error creating the tenant
         """
+        send_telemetry(
+            "Permissions API Endpoint Invoked",
+            user.id,
+            additional_properties={
+                "endpoint": "POST /v1/permissions/tenants",
+                "tenant_name": tenant_name,
+            },
+        )
+
         from cognee.modules.users.tenants.methods import create_tenant as create_tenant_method
 
         await create_tenant_method(tenant_name=tenant_name, user_id=user.id)