API Endpoints Registry
This document provides a comprehensive list of all API endpoints and web routes across the dLANDiscord ecosystem.
Overview
The project operates multiple web servers across different ports, each with a specific responsibility. Most internal tools and global handlers are served by the Assistant API on port :6573, which utilizes the Go default serve mux. Other specialized modules like Mission Control, dWebGame, and Wakeup operate on their own isolated ports and routers.
| Port | Service | Implementation | Router Type |
|---|---|---|---|
| :6573 | Main Assistant API | assistant/webserver.go |
Default ServeMux |
| :6574 | Secure Assistant API | assistant/webserver.go |
Default ServeMux (TLS) |
| :7142 | Event Router (Wakeup) | assistant/wakeup.go |
gorilla/mux |
| :8468 | Kanban Server | assistant/todo.go |
http.NewServeMux |
| :9999 | Mission Control | assistant/missioncontrol.go |
http.NewServeMux |
| :8888 | dWebGame | dwebgame/dwebgame.go |
gorilla/mux |
| :8778 | Crypto Trader | cryptotrader/cryptotrader.go |
gorilla/mux |
| :7165 | Public AI API | publicai/publicai.go |
gorilla/mux |
| :8080 | Public Website | websrv/websrv.go |
gorilla/mux |
1. Main Assistant API (:6573 / :6574)
This is the primary interface for agent interactions and global system utilities. It serves both the assistant package routes and global routes registered in main.go.
Core Assistant Routes
| Method | Path | Purpose | Handler |
|---|---|---|---|
| GET | /assistant |
Main Assistant Dashboard | homeHandler |
| GET | /voice |
Voice Interaction UI | voiceHandler |
| GET | /chat |
Persistent Chat UI | chatPageHandler |
| POST | /api/query |
SSE Streaming Agent Query | queryHandler |
| POST | /api/query-sync |
Synchronous Agent Query | querySyncHandler |
| GET | /api/history |
Fetch Session History | historyHandler |
| POST | /api/voice/query |
Voice-to-Agent Pipeline | handleVoiceQuery |
| GET | /api/models |
List Available LLM Models | modelsHandler |
| GET | /api/agents/list |
List Available Personas | listAgentsHandler |
| GET | /api/tools/list |
List Available Tools | listToolsHandler |
Infrastructure & Management
| Method | Path | Purpose | Handler |
|---|---|---|---|
| GET | /api/prox-data |
Proxmox Cluster Stats | proxm0x.GetDashboardDataHandler |
| GET | /api/cpanel-data |
cPanel/WHM Cluster Status | getCPanelDashboardDataHandler |
| GET | /api/crypto-data |
Financial Market Summary | coinstats.GetDashboardDataHandler |
| POST | /api/schedule-task |
Add One-off/Cron Task | scheduleTaskHandler |
| GET | /api/scheduler/tasks |
List Scheduled Tasks | schedulerTasksHandler |
| GET | /api/contacts |
RBAC Contacts Management | HandleGetContactsAPI |
| GET | /doorbell |
Doorbell Snapshot Gallery | doorbell.html |
Global Routes (via main.go)
| Method | Path | Purpose | Handler |
|---|---|---|---|
| GET | /stn |
ServiceNow Dashboard | snowtickets.StnDashboardHandler |
| GET | /api/stn-data |
Raw SNOW Ticket Data | snowtickets.TicketsDataHandler |
| GET | /live-news |
Real-time RSS Feed UI | livenews.LiveNewsHandler |
| GET | /larry |
Larry Castaway Game | larrycastaway.LarryCastawayHandler |
| GET | /ants |
Dants Dashboard | dants.DantsHandler |
| GET | /dns |
DNS Monitor UI | dnsmonitor.DnsHandler |
2. Wakeup & Event Router (:7142)
Specialized for low-latency, one-way event signals from physical devices and external webhooks.
| Method | Path | Purpose | Integration |
|---|---|---|---|
| POST | /api/wakeup |
Physical Presence Trigger | UniFi Controller |
| GET | /api/status |
Event Router Status | Self-Monitoring |
| POST | /api/events/vonage/inbound |
Inbound SMS Handler | Vonage API |
| POST | /api/events/youtube |
New Video Subscription | Google PubSubHubbub |
| POST | /api/events/ha |
IoT State Transitions | Home Assistant |
3. Mission Control Dashboard (:9999)
The administrative powerhouse for observing agent reasoning and managing the system's evolution.
| Method | Path | Purpose | Key Feature |
|---|---|---|---|
| GET | / |
Mission Control Dashboard | SSE Live Stream |
| GET | /api/mc/telemetry |
Multi-Node System Stats | Fortress Poller |
| GET | /api/mc/timeline |
Live Agent Chain-of-Thought | Session JSONL Fallback |
| GET | /api/mc/mrtool/pending |
List Dynamically Created Tools | MrTool Pipeline |
| POST | /api/mc/mrtool/approve |
Approve/Activate New Tool | Dynamic Loading |
| POST | /api/mc/playbook/hunt |
Trigger Self-Evolution Pass | Playbook Evolution |
| POST | /api/mc/alerts/check |
Trigger Manual Sovereign Audit | Sentry Guard |
| GET | /api/mc/vault |
System-wide RAG Knowledge | Tier-4 Memory |
4. dWebGame (:8888)
The web-based RPG engine. Most endpoints require an encrypted session cookie.
| Method | Path | Purpose |
|---|---|---|
| POST | /auth |
Player Login / Session Start |
| GET | /dashboard/{user} |
Main Player UI |
| POST | /api/action/{name} |
Perform In-game Action (Mining, etc.) |
| POST | /api/travel/{dest} |
Move Player to New Location |
| GET | /api/inventory |
List Player Items |
| GET | /dadmin |
Staff Management Dashboard |
Chat & Voice
| Method | Path | Purpose | Handler |
|---|---|---|---|
| GET | /api/chats |
List Persistent Chats | ListChatsHandler |
| POST | (chat rename) | Rename Chat Session | RenameChatHandler |
| POST | (chat delete) | Delete Chat Session | DeleteChatHandler |
| POST | (chat upload) | Upload File to Chat (32MB max) | ChatUploadHandler |
| GET | (chat file) | Serve Chat Attachment | ChatFileHandler |
| POST | /api/voice/query |
Voice-to-Agent Pipeline | handleVoiceQuery |
5. Other Micro-Servers
Public Website (:8080)
Main public-facing portal for dLAN services.
/unifi: User-friendly network presence view./report/{stats...}: Endpoint for remote servers to report telemetry./alert/{title}/{msg}: Inbound alert signal from monitoring scripts.
Public AI API (:7165)
The authenticated guest portal for restricted AI tool use.
/api/login: Standard username/password auth./terminal.html: Web-based terminal for project execution./api/terminal: WebSocket for real-time shell output.
Crypto Trader (:8778)
Isolated dashboard for financial operations.
/dashboard/{user}: Account-specific trading stats./api/{command}: Manual trade or balance query triggers.
Security & Middleware Notes
- AssistantMiddleware: Applied to most
:6573and:9999routes. It handles RequestID tracing and basic access logs. - enableCORS: Injects headers to allow cross-origin requests from different dashboard ports.
- Secure Voice: Port
:6574is required for microphone access in most browsers, as they require HTTPS for WebAudio/STT APIs. - RBAC: Most
/api/mcand/api/projectsendpoints perform internal checks againstcontacts.jsonusing the user's role (MasterAdmin required for destructive actions).
Extension Points for AI Agents
- Adding API Routes: When implementing a new dashboard, register it in
assistant/webserver.goif it uses the default mux, ormissioncontrol.goif it belongs in the high-privilege audit UI. - Documentation Sync: If you change a handler signature or add a new port, you MUST update this registry.