diff --git a/Makefile b/Makefile
index 3e2f8916..9008b8e3 100644
--- a/Makefile
+++ b/Makefile
@@ -12,10 +12,10 @@ web: ## runs the docs site locally
 sync-docs: sync-console-crd-docs sync-operator-crd-docs sync-liquid-docs
 
 sync-console-crd-docs:
-	curl -L https://raw.githubusercontent.com/pluralsh/console/master/go/controller/docs/api.md --output pages/deployments/operator/api.md
+	curl -L https://raw.githubusercontent.com/pluralsh/console/master/go/controller/docs/api.md --output pages/01-overview/03-api-reference.md
 
 sync-operator-crd-docs:
-	curl -L https://raw.githubusercontent.com/pluralsh/deployment-operator/main/docs/api.md --output pages/deployments/operator/agent-api.md
+	curl -L https://raw.githubusercontent.com/pluralsh/deployment-operator/main/docs/api.md --output pages/01-overview/04-agent-api.md
 
 sync-liquid-docs:
-	curl -L https://raw.githubusercontent.com/pluralsh/polly/main/docs/liquid-filters.md --output pages/deployments/templating-filters.md
\ No newline at end of file
+	curl -L https://raw.githubusercontent.com/pluralsh/polly/main/docs/liquid-filters.md --output pages/03-plural-features/08-service-templating/01-templating-filters.md
\ No newline at end of file
diff --git a/pages/01-overview/03-api-reference.md b/pages/01-overview/03-api-reference.md
index 23145813..17e69222 100644
--- a/pages/01-overview/03-api-reference.md
+++ b/pages/01-overview/03-api-reference.md
@@ -1,5 +1,5 @@
 ---
-title: API Reference
+title: API Reference (Management)
 description: API reference for Plural
 ---
 
diff --git a/pages-archive/deployments/operator/agent-api.md b/pages/01-overview/04-agent-api.md
similarity index 99%
rename from pages-archive/deployments/operator/agent-api.md
rename to pages/01-overview/04-agent-api.md
index 2ec07dec..553cd7c5 100644
--- a/pages-archive/deployments/operator/agent-api.md
+++ b/pages/01-overview/04-agent-api.md
@@ -1,4 +1,8 @@
-# API Reference
+---
+title: API reference (Agent)
+description: API reference for Plural agent
+---
+
 
 ## Packages
 - [deployments.plural.sh/v1alpha1](#deploymentspluralshv1alpha1)
diff --git a/src/routes/docs.generated.ts b/src/routes/docs.generated.ts
index b709af86..2d541a8d 100644
--- a/src/routes/docs.generated.ts
+++ b/src/routes/docs.generated.ts
@@ -20,10 +20,16 @@ export const docRoutes: DocRouteMap = {
 
   overview_api_reference: {
     path: '/01-overview/03-api-reference',
-    title: 'API Reference',
+    title: 'API Reference (Management)',
     id: 'overview_api_reference',
   },
 
+  overview_agent_api: {
+    path: '/01-overview/04-agent-api',
+    title: 'API reference (Agent)',
+    id: 'overview_agent_api',
+  },
+
   getting_started_first_steps: {
     path: '/02-getting-started/01-first-steps',
     title: 'First steps',
@@ -230,7 +236,7 @@ export const docRoutes: DocRouteMap = {
 
   plural_features_plural_ai: {
     path: '/03-plural-features/06-plural-ai',
-    title: 'Plural AI helper',
+    title: 'Plural AI',
     id: 'plural_features_plural_ai',
   },
 
@@ -329,6 +335,12 @@ export const docRoutes: DocRouteMap = {
     title: 'Release Notes',
     id: 'resources_release_notes',
   },
+
+  deployments_operator_agent_api: {
+    path: '/deployments/operator/agent-api',
+    title: 'Agent API',
+    id: 'deployments_operator_agent_api',
+  },
 } as const
 
 // Type-safe route getter
diff --git a/src/routing/navigation.ts b/src/routing/navigation.ts
index 76de4824..874f338f 100644
--- a/src/routing/navigation.ts
+++ b/src/routing/navigation.ts
@@ -20,9 +20,14 @@ export const docNavigation: NavMenu = [
         "sortPath": "/01-overview/02-architecture"
       },
       {
-        "title": "API Reference",
+        "title": "API Reference (Management)",
         "href": "/overview/api-reference",
         "sortPath": "/01-overview/03-api-reference"
+      },
+      {
+        "title": "API reference (Agent)",
+        "href": "/overview/agent-api",
+        "sortPath": "/01-overview/04-agent-api"
       }
     ]
   },
@@ -213,7 +218,7 @@ export const docNavigation: NavMenu = [
         "sortPath": "/03-plural-features/05-kubernetes-dashboard"
       },
       {
-        "title": "Plural AI helper",
+        "title": "Plural AI",
         "href": "/plural-features/plural-ai",
         "sections": [
           {
@@ -313,5 +318,22 @@ export const docNavigation: NavMenu = [
         "sortPath": "/05-resources/01-release-notes"
       }
     ]
+  },
+  {
+    "title": "Deployments",
+    "href": "/deployments",
+    "sections": [
+      {
+        "title": "Operator",
+        "href": "/deployments/operator",
+        "sections": [
+          {
+            "title": "Agent API",
+            "href": "/deployments/operator/agent-api",
+            "sortPath": "/deployments/operator/agent-api"
+          }
+        ]
+      }
+    ]
   }
 ]
\ No newline at end of file