diff --git a/README.md b/README.md
index c5415d3..1a62204 100644
--- a/README.md
+++ b/README.md
@@ -404,8 +404,8 @@ For enterprise features, contact [sales@getaxonflow.com](mailto:sales@getaxonflo
 
 ## Documentation
 
-- [Getting Started](https://docs.getaxonflow.com/sdk/python-getting-started)
-- [Gateway Mode Guide](https://docs.getaxonflow.com/sdk/gateway-mode)
+- [Getting Started](https://docs.getaxonflow.com/docs/sdk/python-getting-started)
+- [Gateway Mode Guide](https://docs.getaxonflow.com/docs/sdk/gateway-mode)
 
 ## Support
 
diff --git a/axonflow/telemetry.py b/axonflow/telemetry.py
index c7b61e7..f1413cc 100644
--- a/axonflow/telemetry.py
+++ b/axonflow/telemetry.py
@@ -166,7 +166,7 @@ def send_telemetry_ping(
 
     logger.info(
         "AxonFlow: anonymous telemetry enabled. "
-        "Opt out: AXONFLOW_TELEMETRY=off | https://docs.getaxonflow.com/telemetry"
+        "Opt out: AXONFLOW_TELEMETRY=off | https://docs.getaxonflow.com/docs/telemetry"
     )
 
     url = os.environ.get("AXONFLOW_CHECKPOINT_URL", "").strip() or _DEFAULT_CHECKPOINT_URL
diff --git a/pyproject.toml b/pyproject.toml
index 4540562..c3d3803 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -70,7 +70,7 @@ all = [
 
 [project.urls]
 Homepage = "https://getaxonflow.com"
-Documentation = "https://docs.getaxonflow.com/sdk/python-getting-started"
+Documentation = "https://docs.getaxonflow.com/docs/sdk/python-getting-started"
 Repository = "https://github.com/getaxonflow/axonflow-sdk-python"
 Changelog = "https://github.com/getaxonflow/axonflow-sdk-python/blob/main/CHANGELOG.md"
 Issues = "https://github.com/getaxonflow/axonflow-sdk-python/issues"