elizaOS · yungalgo · Oct 22, 2025 · Oct 22, 2025 · Oct 22, 2025
diff --git a/README.md b/README.md
@@ -9,7 +9,7 @@ This repository contains the comprehensive documentation for ElizaOS, including:
 - **Getting Started** - Quick setup guides and tutorials
 - **Core Concepts** - Understanding agents, plugins, and the architecture
 - **Deep Dive** - Advanced topics like memory systems, services, and event handling
-- **API Reference** - Complete API documentation for all modules
+- **REST Reference** - Complete REST API documentation for all modules
 - **Examples** - Real-world implementations and patterns
 
 ## Development
@@ -41,7 +41,7 @@ This will start a local development server at `http://localhost:3000` where you
 
 ```
 docs/
-├── api-reference/      # API documentation
+├── rest-reference/      # REST API documentation
 ├── core-concepts/      # Core concepts and architecture
 ├── deep-dive/         # Advanced topics
 ├── images/            # Documentation images

diff --git a/docs.json b/docs.json
@@ -95,136 +95,136 @@
         ]
       },
       {
-        "tab": "API Reference",
-        "pages": ["api-reference/index"],
+        "tab": "REST Reference",
+        "pages": ["rest-reference/index"],
         "groups": [
           {
             "group": "AGENTS",
             "pages": [
-              "api-reference/agents/create-a-new-agent",
-              "api-reference/agents/get-agent-details",
-              "api-reference/agents/list-all-agents",
-              "api-reference/agents/update-agent",
-              "api-reference/agents/delete-an-agent",
-              "api-reference/agents/start-an-agent",
-              "api-reference/agents/stop-an-agent",
-              "api-reference/agents/get-agent-panels",
-              "api-reference/agents/create-a-world-for-an-agent",
-              "api-reference/agents/get-all-worlds",
-              "api-reference/agents/update-a-world"
+              "rest-reference/agents/create-a-new-agent",
+              "rest-reference/agents/get-agent-details",
+              "rest-reference/agents/list-all-agents",
+              "rest-reference/agents/update-agent",
+              "rest-reference/agents/delete-an-agent",
+              "rest-reference/agents/start-an-agent",
+              "rest-reference/agents/stop-an-agent",
+              "rest-reference/agents/get-agent-panels",
+              "rest-reference/agents/create-a-world-for-an-agent",
+              "rest-reference/agents/get-all-worlds",
+              "rest-reference/agents/update-a-world"
             ]
           },
           {
             "group": "AUDIO",
             "pages": [
-              "api-reference/audio/generate-speech-from-text",
-              "api-reference/audio/synthesize-speech-from-text",
-              "api-reference/audio/transcribe-audio",
-              "api-reference/audio/process-audio-message",
-              "api-reference/audio/convert-conversation-to-speech"
+              "rest-reference/audio/generate-speech-from-text",
+              "rest-reference/audio/synthesize-speech-from-text",
+              "rest-reference/audio/transcribe-audio",
+              "rest-reference/audio/process-audio-message",
+              "rest-reference/audio/convert-conversation-to-speech"
             ]
           },
           {
             "group": "MESSAGING",
             "pages": [
-              "api-reference/messaging/create-server",
-              "api-reference/messaging/create-channel",
-              "api-reference/messaging/create-central-channel",
-              "api-reference/messaging/create-group-channel",
-              "api-reference/messaging/get-or-create-dm-channel",
-              "api-reference/messaging/send-message-to-channel",
-              "api-reference/messaging/get-channel-messages",
-              "api-reference/messaging/get-channel-details",
-              "api-reference/messaging/get-channel-info",
-              "api-reference/messaging/get-channel-participants",
-              "api-reference/messaging/update-channel",
-              "api-reference/messaging/delete-channel",
-              "api-reference/messaging/delete-channel-message",
-              "api-reference/messaging/delete-all-channel-messages",
-              "api-reference/messaging/delete-all-channel-messages-by-user",
-              "api-reference/messaging/add-agent-to-server",
-              "api-reference/messaging/add-agent-to-channel",
-              "api-reference/messaging/remove-agent-from-server",
-              "api-reference/messaging/get-server-agents",
-              "api-reference/messaging/get-server-channels",
-              "api-reference/messaging/get-central-servers",
-              "api-reference/messaging/get-central-server-channels",
-              "api-reference/messaging/process-external-message",
-              "api-reference/messaging/ingest-messages-from-external-platforms",
-              "api-reference/messaging/submit-a-message-to-the-central-messaging-system",
-              "api-reference/messaging/mark-message-processing-as-complete"
+              "rest-reference/messaging/create-server",
+              "rest-reference/messaging/create-channel",
+              "rest-reference/messaging/create-central-channel",
+              "rest-reference/messaging/create-group-channel",
+              "rest-reference/messaging/get-or-create-dm-channel",
+              "rest-reference/messaging/send-message-to-channel",
+              "rest-reference/messaging/get-channel-messages",
+              "rest-reference/messaging/get-channel-details",
+              "rest-reference/messaging/get-channel-info",
+              "rest-reference/messaging/get-channel-participants",
+              "rest-reference/messaging/update-channel",
+              "rest-reference/messaging/delete-channel",
+              "rest-reference/messaging/delete-channel-message",
+              "rest-reference/messaging/delete-all-channel-messages",
+              "rest-reference/messaging/delete-all-channel-messages-by-user",
+              "rest-reference/messaging/add-agent-to-server",
+              "rest-reference/messaging/add-agent-to-channel",
+              "rest-reference/messaging/remove-agent-from-server",
+              "rest-reference/messaging/get-server-agents",
+              "rest-reference/messaging/get-server-channels",
+              "rest-reference/messaging/get-central-servers",
+              "rest-reference/messaging/get-central-server-channels",
+              "rest-reference/messaging/process-external-message",
+              "rest-reference/messaging/ingest-messages-from-external-platforms",
+              "rest-reference/messaging/submit-a-message-to-the-central-messaging-system",
+              "rest-reference/messaging/mark-message-processing-as-complete"
             ]
           },
           {
             "group": "SESSIONS API",
             "pages": [
-              "api-reference/messaging/create-session",
-              "api-reference/messaging/get-session",
-              "api-reference/messaging/send-session-message",
-              "api-reference/messaging/get-session-messages",
-              "api-reference/messaging/renew-session",
-              "api-reference/messaging/update-session-timeout",
-              "api-reference/messaging/session-heartbeat",
-              "api-reference/messaging/end-session",
-              "api-reference/messaging/list-sessions",
-              "api-reference/messaging/sessions-health-check"
+              "rest-reference/messaging/create-session",
+              "rest-reference/messaging/get-session",
+              "rest-reference/messaging/send-session-message",
+              "rest-reference/messaging/get-session-messages",
+              "rest-reference/messaging/renew-session",
+              "rest-reference/messaging/update-session-timeout",
+              "rest-reference/messaging/session-heartbeat",
+              "rest-reference/messaging/end-session",
+              "rest-reference/messaging/list-sessions",
+              "rest-reference/messaging/sessions-health-check"
             ]
           },
           {
             "group": "MEMORY",
             "pages": [
-              "api-reference/memory/get-agent-memories",
-              "api-reference/memory/get-room-memories",
-              "api-reference/memory/create-a-room",
-              "api-reference/memory/update-a-memory",
-              "api-reference/memory/delete-all-agent-memories",
-              "api-reference/memory/delete-all-memories-for-a-room"
+              "rest-reference/memory/get-agent-memories",
+              "rest-reference/memory/get-room-memories",
+              "rest-reference/memory/create-a-room",
+              "rest-reference/memory/update-a-memory",
+              "rest-reference/memory/delete-all-agent-memories",
+              "rest-reference/memory/delete-all-memories-for-a-room"
             ]
           },
           {
             "group": "ROOMS",
             "pages": [
-              "api-reference/rooms/create-a-room",
-              "api-reference/rooms/get-room-details",
-              "api-reference/rooms/get-agent-rooms",
-              "api-reference/rooms/update-a-room",
-              "api-reference/rooms/delete-a-room"
+              "rest-reference/rooms/create-a-room",
+              "rest-reference/rooms/get-room-details",
+              "rest-reference/rooms/get-agent-rooms",
+              "rest-reference/rooms/update-a-room",
+              "rest-reference/rooms/delete-a-room"
             ]
           },
           {
             "group": "MEDIA",
             "pages": [
-              "api-reference/media/upload-media-for-agent",
-              "api-reference/media/upload-media-to-channel"
+              "rest-reference/media/upload-media-for-agent",
+              "rest-reference/media/upload-media-to-channel"
             ]
           },
           {
             "group": "LOGS",
             "pages": [
-              "api-reference/logs/get-agent-logs",
-              "api-reference/logs/get-system-logs",
-              "api-reference/logs/get-system-logs-post",
-              "api-reference/logs/delete-a-specific-log-entry",
-              "api-reference/logs/clear-system-logs"
+              "rest-reference/logs/get-agent-logs",
+              "rest-reference/logs/get-system-logs",
+              "rest-reference/logs/get-system-logs-post",
+              "rest-reference/logs/delete-a-specific-log-entry",
+              "rest-reference/logs/clear-system-logs"
             ]
           },
           {
             "group": "SYSTEM",
             "pages": [
-              "api-reference/system/basic-health-check",
-              "api-reference/system/health-check-endpoint",
-              "api-reference/system/ping-health-check",
-              "api-reference/system/get-system-status",
-              "api-reference/system/get-server-debug-info",
-              "api-reference/system/get-server-debug-info-1",
-              "api-reference/system/get-local-environment-variables",
-              "api-reference/system/update-local-environment-variables",
-              "api-reference/system/stop-the-server"
+              "rest-reference/system/basic-health-check",
+              "rest-reference/system/health-check-endpoint",
+              "rest-reference/system/ping-health-check",
+              "rest-reference/system/get-system-status",
+              "rest-reference/system/get-server-debug-info",
+              "rest-reference/system/get-server-debug-info-1",
+              "rest-reference/system/get-local-environment-variables",
+              "rest-reference/system/update-local-environment-variables",
+              "rest-reference/system/stop-the-server"
             ]
           },
           {
             "group": "WEBSOCKET",
-            "pages": ["api-reference/websocket/socketio-real-time-connection"]
+            "pages": ["rest-reference/websocket/socketio-real-time-connection"]
           }
         ]
       },

diff --git a/index.mdx b/index.mdx
@@ -35,9 +35,9 @@ Get started with one of the quick links below, or read on to learn more about el
     horizontal
   />
   <Card
-    title="API Reference"
+    title="REST Reference"
     icon="terminal"
-    href="/api-reference/agents/create-a-new-agent"
+    href="/rest-reference/agents/create-a-new-agent"
     horizontal
   />
   <Card

diff --git a/projects/environment-variables.mdx b/projects/environment-variables.mdx
@@ -154,7 +154,7 @@ For a complete list of all available environment variables including database co
     Manage environment variables with the CLI
   </Card>
 
-  <Card title="API Reference" icon="code" href="/api-reference">
+  <Card title="REST Reference" icon="code" href="/rest-reference">
     Explore the REST API that these variables protect
   </Card>
 

diff --git a/projects/overview.mdx b/projects/overview.mdx
@@ -415,7 +415,7 @@ See the [Deploy a Project](/guides/deploy-a-project) guide for detailed instruct
     Complete command reference
   </Card>
 
-  <Card title="API Reference" icon="code" href="/api-reference">
+  <Card title="REST Reference" icon="code" href="/rest-reference">
     REST API documentation
   </Card>
 </CardGroup>
diff --git a/api-reference/agents/create-a-new-agent.mdx → rest-reference/agents/create-a-new-agent.mdx b/api-reference/agents/create-a-new-agent.mdx → rest-reference/agents/create-a-new-agent.mdx
diff --git a/...ce/agents/create-a-world-for-an-agent.mdx → ...ce/agents/create-a-world-for-an-agent.mdx b/...ce/agents/create-a-world-for-an-agent.mdx → ...ce/agents/create-a-world-for-an-agent.mdx
diff --git a/api-reference/agents/delete-an-agent.mdx → rest-reference/agents/delete-an-agent.mdx b/api-reference/agents/delete-an-agent.mdx → rest-reference/agents/delete-an-agent.mdx
diff --git a/api-reference/agents/get-agent-details.mdx → rest-reference/agents/get-agent-details.mdx b/api-reference/agents/get-agent-details.mdx → rest-reference/agents/get-agent-details.mdx
diff --git a/api-reference/agents/get-agent-panels.mdx → rest-reference/agents/get-agent-panels.mdx b/api-reference/agents/get-agent-panels.mdx → rest-reference/agents/get-agent-panels.mdx
diff --git a/api-reference/agents/get-all-worlds.mdx → rest-reference/agents/get-all-worlds.mdx b/api-reference/agents/get-all-worlds.mdx → rest-reference/agents/get-all-worlds.mdx
diff --git a/api-reference/agents/list-all-agents.mdx → rest-reference/agents/list-all-agents.mdx b/api-reference/agents/list-all-agents.mdx → rest-reference/agents/list-all-agents.mdx
diff --git a/api-reference/agents/start-an-agent.mdx → rest-reference/agents/start-an-agent.mdx b/api-reference/agents/start-an-agent.mdx → rest-reference/agents/start-an-agent.mdx
diff --git a/api-reference/agents/stop-an-agent.mdx → rest-reference/agents/stop-an-agent.mdx b/api-reference/agents/stop-an-agent.mdx → rest-reference/agents/stop-an-agent.mdx
diff --git a/api-reference/agents/update-a-world.mdx → rest-reference/agents/update-a-world.mdx b/api-reference/agents/update-a-world.mdx → rest-reference/agents/update-a-world.mdx
diff --git a/api-reference/agents/update-agent.mdx → rest-reference/agents/update-agent.mdx b/api-reference/agents/update-agent.mdx → rest-reference/agents/update-agent.mdx
diff --git a/.../audio/convert-conversation-to-speech.mdx → .../audio/convert-conversation-to-speech.mdx b/.../audio/convert-conversation-to-speech.mdx → .../audio/convert-conversation-to-speech.mdx
diff --git a/...rence/audio/generate-speech-from-text.mdx → ...rence/audio/generate-speech-from-text.mdx b/...rence/audio/generate-speech-from-text.mdx → ...rence/audio/generate-speech-from-text.mdx
diff --git a/...reference/audio/process-audio-message.mdx → ...reference/audio/process-audio-message.mdx b/...reference/audio/process-audio-message.mdx → ...reference/audio/process-audio-message.mdx
diff --git a/...nce/audio/synthesize-speech-from-text.mdx → ...nce/audio/synthesize-speech-from-text.mdx b/...nce/audio/synthesize-speech-from-text.mdx → ...nce/audio/synthesize-speech-from-text.mdx
diff --git a/api-reference/audio/transcribe-audio.mdx → rest-reference/audio/transcribe-audio.mdx b/api-reference/audio/transcribe-audio.mdx → rest-reference/audio/transcribe-audio.mdx
diff --git a/api-reference/index.mdx → rest-reference/index.mdx b/api-reference/index.mdx → rest-reference/index.mdx
@@ -1,49 +1,49 @@
 ---
-title: "API Reference"
-description: "Complete API documentation for the elizaOS platform"
+title: "REST Reference"
+description: "Complete REST API documentation for the elizaOS platform"
 ---
 
-Welcome to the elizaOS API Reference. This comprehensive guide covers all available endpoints and services for building and managing AI agents.
+Welcome to the elizaOS REST Reference. This comprehensive guide covers all available REST endpoints and services for building and managing AI agents.
 
 ## Core APIs
 
-<Card title="Agents" icon="robot" href="/api-reference/agents/create-a-new-agent">
+<Card title="Agents" icon="robot" href="/rest-reference/agents/create-a-new-agent">
   Create, manage, and control AI agents. Handle agent lifecycle, configuration, and world management.
 </Card>
 
-<Card title="Messaging" icon="message" href="/api-reference/messaging/create-server">
+<Card title="Messaging" icon="message" href="/rest-reference/messaging/create-server">
   Real-time messaging system for agent communication. Create servers, channels, and manage conversations.
 </Card>
 
-<Card title="Memory" icon="brain" href="/api-reference/memory/get-agent-memories">
+<Card title="Memory" icon="brain" href="/rest-reference/memory/get-agent-memories">
   Agent memory management. Store, retrieve, and organize agent memories and contextual information.
 </Card>
 
-<Card title="Rooms" icon="users" href="/api-reference/rooms/create-a-room">
+<Card title="Rooms" icon="users" href="/rest-reference/rooms/create-a-room">
   Virtual spaces for agent interactions. Create and manage rooms for organized conversations.
 </Card>
 
 ## Media & Audio
 
-<Card title="Audio" icon="microphone" href="/api-reference/audio/generate-speech-from-text">
+<Card title="Audio" icon="microphone" href="/rest-reference/audio/generate-speech-from-text">
   Speech synthesis, transcription, and audio processing capabilities.
 </Card>
 
-<Card title="Media" icon="image" href="/api-reference/media/upload-media-for-agent">
+<Card title="Media" icon="image" href="/rest-reference/media/upload-media-for-agent">
   Media upload and management for agents and channels.
 </Card>
 
 ## System & Monitoring
 
-<Card title="System" icon="server" href="/api-reference/system/basic-health-check">
+<Card title="System" icon="server" href="/rest-reference/system/basic-health-check">
   System status, health checks, and server management endpoints.
 </Card>
 
-<Card title="Logs" icon="file-text" href="/api-reference/logs/get-agent-logs">
+<Card title="Logs" icon="file-text" href="/rest-reference/logs/get-agent-logs">
   Logging and debugging tools for agents and system operations.
 </Card>
 
-<Card title="WebSocket" icon="wifi" href="/api-reference/websocket/socketio-real-time-connection">
+<Card title="WebSocket" icon="wifi" href="/rest-reference/websocket/socketio-real-time-connection">
   Real-time WebSocket connections for live agent interactions.
 </Card>
 
@@ -54,13 +54,13 @@ Welcome to the elizaOS API Reference. This comprehensive guide covers all availa
     Set up your API credentials and authentication tokens.
   </Step>
   <Step title="Create an Agent">
-    Use the [Create Agent endpoint](/api-reference/agents/create-a-new-agent) to start building.
+    Use the [Create Agent endpoint](/rest-reference/agents/create-a-new-agent) to start building.
   </Step>
   <Step title="Configure Messaging">
-    Set up [messaging channels](/api-reference/messaging/create-channel) for agent communication.
+    Set up [messaging channels](/rest-reference/messaging/create-channel) for agent communication.
   </Step>
   <Step title="Test Integration">
-    Use [health check endpoints](/api-reference/system/basic-health-check) to verify your setup.
+    Use [health check endpoints](/rest-reference/system/basic-health-check) to verify your setup.
   </Step>
 </Steps>
 

diff --git a/api-reference/logs/clear-system-logs.mdx → rest-reference/logs/clear-system-logs.mdx b/api-reference/logs/clear-system-logs.mdx → rest-reference/logs/clear-system-logs.mdx
diff --git a/...ence/logs/delete-a-specific-log-entry.mdx → ...ence/logs/delete-a-specific-log-entry.mdx b/...ence/logs/delete-a-specific-log-entry.mdx → ...ence/logs/delete-a-specific-log-entry.mdx
diff --git a/api-reference/logs/get-agent-logs.mdx → rest-reference/logs/get-agent-logs.mdx b/api-reference/logs/get-agent-logs.mdx → rest-reference/logs/get-agent-logs.mdx
diff --git a/api-reference/logs/get-system-logs-post.mdx → rest-reference/logs/get-system-logs-post.mdx b/api-reference/logs/get-system-logs-post.mdx → rest-reference/logs/get-system-logs-post.mdx
diff --git a/api-reference/logs/get-system-logs.mdx → rest-reference/logs/get-system-logs.mdx b/api-reference/logs/get-system-logs.mdx → rest-reference/logs/get-system-logs.mdx
diff --git a/...eference/media/upload-media-for-agent.mdx → ...eference/media/upload-media-for-agent.mdx b/...eference/media/upload-media-for-agent.mdx → ...eference/media/upload-media-for-agent.mdx
diff --git a/...ference/media/upload-media-to-channel.mdx → ...ference/media/upload-media-to-channel.mdx b/...ference/media/upload-media-to-channel.mdx → ...ference/media/upload-media-to-channel.mdx
diff --git a/api-reference/memory/create-a-room.mdx → rest-reference/memory/create-a-room.mdx b/api-reference/memory/create-a-room.mdx → rest-reference/memory/create-a-room.mdx
diff --git a/...ence/memory/delete-all-agent-memories.mdx → ...ence/memory/delete-all-agent-memories.mdx b/...ence/memory/delete-all-agent-memories.mdx → ...ence/memory/delete-all-agent-memories.mdx
diff --git a/...memory/delete-all-memories-for-a-room.mdx → ...memory/delete-all-memories-for-a-room.mdx b/...memory/delete-all-memories-for-a-room.mdx → ...memory/delete-all-memories-for-a-room.mdx
diff --git a/api-reference/memory/get-agent-memories.mdx → rest-reference/memory/get-agent-memories.mdx b/api-reference/memory/get-agent-memories.mdx → rest-reference/memory/get-agent-memories.mdx
diff --git a/api-reference/memory/get-room-memories.mdx → rest-reference/memory/get-room-memories.mdx b/api-reference/memory/get-room-memories.mdx → rest-reference/memory/get-room-memories.mdx
diff --git a/api-reference/memory/update-a-memory.mdx → rest-reference/memory/update-a-memory.mdx b/api-reference/memory/update-a-memory.mdx → rest-reference/memory/update-a-memory.mdx
diff --git a/...erence/messaging/add-agent-to-channel.mdx → ...erence/messaging/add-agent-to-channel.mdx b/...erence/messaging/add-agent-to-channel.mdx → ...erence/messaging/add-agent-to-channel.mdx
diff --git a/...ference/messaging/add-agent-to-server.mdx → ...ference/messaging/add-agent-to-server.mdx b/...ference/messaging/add-agent-to-server.mdx → ...ference/messaging/add-agent-to-server.mdx
diff --git a/...ence/messaging/create-central-channel.mdx → ...ence/messaging/create-central-channel.mdx b/...ence/messaging/create-central-channel.mdx → ...ence/messaging/create-central-channel.mdx
diff --git a/api-reference/messaging/create-channel.mdx → rest-reference/messaging/create-channel.mdx b/api-reference/messaging/create-channel.mdx → rest-reference/messaging/create-channel.mdx
diff --git a/...erence/messaging/create-group-channel.mdx → ...erence/messaging/create-group-channel.mdx b/...erence/messaging/create-group-channel.mdx → ...erence/messaging/create-group-channel.mdx
diff --git a/api-reference/messaging/create-server.mdx → rest-reference/messaging/create-server.mdx b/api-reference/messaging/create-server.mdx → rest-reference/messaging/create-server.mdx
diff --git a/api-reference/messaging/create-session.mdx → rest-reference/messaging/create-session.mdx b/api-reference/messaging/create-session.mdx → rest-reference/messaging/create-session.mdx
diff --git a/...g/delete-all-channel-messages-by-user.mdx → ...g/delete-all-channel-messages-by-user.mdx b/...g/delete-all-channel-messages-by-user.mdx → ...g/delete-all-channel-messages-by-user.mdx
diff --git a/...messaging/delete-all-channel-messages.mdx → ...messaging/delete-all-channel-messages.mdx b/...messaging/delete-all-channel-messages.mdx → ...messaging/delete-all-channel-messages.mdx
diff --git a/...ence/messaging/delete-channel-message.mdx → ...ence/messaging/delete-channel-message.mdx b/...ence/messaging/delete-channel-message.mdx → ...ence/messaging/delete-channel-message.mdx
diff --git a/api-reference/messaging/delete-channel.mdx → rest-reference/messaging/delete-channel.mdx b/api-reference/messaging/delete-channel.mdx → rest-reference/messaging/delete-channel.mdx
diff --git a/api-reference/messaging/end-session.mdx → rest-reference/messaging/end-session.mdx b/api-reference/messaging/end-session.mdx → rest-reference/messaging/end-session.mdx
diff --git a/...messaging/get-central-server-channels.mdx → ...messaging/get-central-server-channels.mdx b/...messaging/get-central-server-channels.mdx → ...messaging/get-central-server-channels.mdx
diff --git a/...ference/messaging/get-central-servers.mdx → ...ference/messaging/get-central-servers.mdx b/...ference/messaging/get-central-servers.mdx → ...ference/messaging/get-central-servers.mdx
diff --git a/...ference/messaging/get-channel-details.mdx → ...ference/messaging/get-channel-details.mdx b/...ference/messaging/get-channel-details.mdx → ...ference/messaging/get-channel-details.mdx
diff --git a/api-reference/messaging/get-channel-info.mdx → ...-reference/messaging/get-channel-info.mdx b/api-reference/messaging/get-channel-info.mdx → ...-reference/messaging/get-channel-info.mdx
diff --git a/...erence/messaging/get-channel-messages.mdx → ...erence/messaging/get-channel-messages.mdx b/...erence/messaging/get-channel-messages.mdx → ...erence/messaging/get-channel-messages.mdx
diff --git a/...ce/messaging/get-channel-participants.mdx → ...ce/messaging/get-channel-participants.mdx b/...ce/messaging/get-channel-participants.mdx → ...ce/messaging/get-channel-participants.mdx
diff --git a/...ce/messaging/get-or-create-dm-channel.mdx → ...ce/messaging/get-or-create-dm-channel.mdx b/...ce/messaging/get-or-create-dm-channel.mdx → ...ce/messaging/get-or-create-dm-channel.mdx
diff --git a/...reference/messaging/get-server-agents.mdx → ...reference/messaging/get-server-agents.mdx b/...reference/messaging/get-server-agents.mdx → ...reference/messaging/get-server-agents.mdx
diff --git a/...ference/messaging/get-server-channels.mdx → ...ference/messaging/get-server-channels.mdx b/...ference/messaging/get-server-channels.mdx → ...ference/messaging/get-server-channels.mdx
diff --git a/...erence/messaging/get-session-messages.mdx → ...erence/messaging/get-session-messages.mdx b/...erence/messaging/get-session-messages.mdx → ...erence/messaging/get-session-messages.mdx
diff --git a/api-reference/messaging/get-session.mdx → rest-reference/messaging/get-session.mdx b/api-reference/messaging/get-session.mdx → rest-reference/messaging/get-session.mdx
diff --git a/...gest-messages-from-external-platforms.mdx → ...gest-messages-from-external-platforms.mdx b/...gest-messages-from-external-platforms.mdx → ...gest-messages-from-external-platforms.mdx
diff --git a/api-reference/messaging/list-sessions.mdx → rest-reference/messaging/list-sessions.mdx b/api-reference/messaging/list-sessions.mdx → rest-reference/messaging/list-sessions.mdx
diff --git a/...g/mark-message-processing-as-complete.mdx → ...g/mark-message-processing-as-complete.mdx b/...g/mark-message-processing-as-complete.mdx → ...g/mark-message-processing-as-complete.mdx
diff --git a/...ce/messaging/process-external-message.mdx → ...ce/messaging/process-external-message.mdx b/...ce/messaging/process-external-message.mdx → ...ce/messaging/process-external-message.mdx
diff --git a/...ce/messaging/remove-agent-from-server.mdx → ...ce/messaging/remove-agent-from-server.mdx b/...ce/messaging/remove-agent-from-server.mdx → ...ce/messaging/remove-agent-from-server.mdx
diff --git a/api-reference/messaging/renew-session.mdx → rest-reference/messaging/renew-session.mdx b/api-reference/messaging/renew-session.mdx → rest-reference/messaging/renew-session.mdx
diff --git a/...nce/messaging/send-message-to-channel.mdx → ...nce/messaging/send-message-to-channel.mdx b/...nce/messaging/send-message-to-channel.mdx → ...nce/messaging/send-message-to-channel.mdx
diff --git a/...erence/messaging/send-session-message.mdx → ...erence/messaging/send-session-message.mdx b/...erence/messaging/send-session-message.mdx → ...erence/messaging/send-session-message.mdx
diff --git a/...reference/messaging/session-heartbeat.mdx → ...reference/messaging/session-heartbeat.mdx b/...reference/messaging/session-heartbeat.mdx → ...reference/messaging/session-heartbeat.mdx
diff --git a/...rence/messaging/sessions-health-check.mdx → ...rence/messaging/sessions-health-check.mdx b/...rence/messaging/sessions-health-check.mdx → ...rence/messaging/sessions-health-check.mdx
diff --git a/...ssage-to-the-central-messaging-system.mdx → ...ssage-to-the-central-messaging-system.mdx b/...ssage-to-the-central-messaging-system.mdx → ...ssage-to-the-central-messaging-system.mdx
diff --git a/api-reference/messaging/update-channel.mdx → rest-reference/messaging/update-channel.mdx b/api-reference/messaging/update-channel.mdx → rest-reference/messaging/update-channel.mdx
diff --git a/...ence/messaging/update-session-timeout.mdx → ...ence/messaging/update-session-timeout.mdx b/...ence/messaging/update-session-timeout.mdx → ...ence/messaging/update-session-timeout.mdx
diff --git a/api-reference/openapi.yaml → rest-reference/openapi.yaml b/api-reference/openapi.yaml → rest-reference/openapi.yaml
diff --git a/api-reference/rooms/create-a-room.mdx → rest-reference/rooms/create-a-room.mdx b/api-reference/rooms/create-a-room.mdx → rest-reference/rooms/create-a-room.mdx
diff --git a/api-reference/rooms/delete-a-room.mdx → rest-reference/rooms/delete-a-room.mdx b/api-reference/rooms/delete-a-room.mdx → rest-reference/rooms/delete-a-room.mdx
diff --git a/api-reference/rooms/get-agent-rooms.mdx → rest-reference/rooms/get-agent-rooms.mdx b/api-reference/rooms/get-agent-rooms.mdx → rest-reference/rooms/get-agent-rooms.mdx
diff --git a/api-reference/rooms/get-room-details.mdx → rest-reference/rooms/get-room-details.mdx b/api-reference/rooms/get-room-details.mdx → rest-reference/rooms/get-room-details.mdx
diff --git a/api-reference/rooms/update-a-room.mdx → rest-reference/rooms/update-a-room.mdx b/api-reference/rooms/update-a-room.mdx → rest-reference/rooms/update-a-room.mdx
diff --git a/api-reference/system/basic-health-check.mdx → rest-reference/system/basic-health-check.mdx b/api-reference/system/basic-health-check.mdx → rest-reference/system/basic-health-check.mdx
diff --git a/...ystem/get-local-environment-variables.mdx → ...ystem/get-local-environment-variables.mdx b/...ystem/get-local-environment-variables.mdx → ...ystem/get-local-environment-variables.mdx
diff --git a/...erence/system/get-server-debug-info-1.mdx → ...erence/system/get-server-debug-info-1.mdx b/...erence/system/get-server-debug-info-1.mdx → ...erence/system/get-server-debug-info-1.mdx
diff --git a/...eference/system/get-server-debug-info.mdx → ...eference/system/get-server-debug-info.mdx b/...eference/system/get-server-debug-info.mdx → ...eference/system/get-server-debug-info.mdx
diff --git a/api-reference/system/get-system-status.mdx → rest-reference/system/get-system-status.mdx b/api-reference/system/get-system-status.mdx → rest-reference/system/get-system-status.mdx
diff --git a/...eference/system/health-check-endpoint.mdx → ...eference/system/health-check-endpoint.mdx b/...eference/system/health-check-endpoint.mdx → ...eference/system/health-check-endpoint.mdx
diff --git a/api-reference/system/ping-health-check.mdx → rest-reference/system/ping-health-check.mdx b/api-reference/system/ping-health-check.mdx → rest-reference/system/ping-health-check.mdx
diff --git a/api-reference/system/stop-the-server.mdx → rest-reference/system/stop-the-server.mdx b/api-reference/system/stop-the-server.mdx → rest-reference/system/stop-the-server.mdx
diff --git a/...em/update-local-environment-variables.mdx → ...em/update-local-environment-variables.mdx b/...em/update-local-environment-variables.mdx → ...em/update-local-environment-variables.mdx
diff --git a/...bsocket/socketio-real-time-connection.mdx → ...bsocket/socketio-real-time-connection.mdx b/...bsocket/socketio-real-time-connection.mdx → ...bsocket/socketio-real-time-connection.mdx
diff --git a/runtime/sessions-api.mdx b/runtime/sessions-api.mdx
@@ -1953,7 +1953,7 @@ class SessionsAPIClient:
 ## See Also
 
 <CardGroup cols={2}>
-  <Card title="WebSocket Integration" icon="wifi" href="/api-reference/websocket/socketio-real-time-connection">
+  <Card title="WebSocket Integration" icon="wifi" href="/rest-reference/websocket/socketio-real-time-connection">
     Add real-time capabilities to your sessions
   </Card>
   <Card title="Core Concepts" icon="lightbulb" href="/agents/runtime-and-lifecycle">