API Endpoints

CRITICAL — Endpoint Stability Rule: NEVER change an endpoint without explicit permission from Hamza. Endpoint changes have caused weeks of problems. This is equivalent to neurosurgery without consent.

Primary Canonical Endpoint

Aria Soul /chat

Context	URL
In-cluster	`http://aria-soul.aria.svc.cluster.local:3000/chat`
NodePort (external)	`http://192.168.4.25:30080/chat`
Port-forward	`http://localhost:3000/chat`

Hive Registration

There is NO /hive/register endpoint. Hive registration happens automatically when /chat is called with platform: 'opencode' in metadata.

POST /chat
Authorization: Bearer aria_ops_master_2026
Content-Type: application/json

{
  "message": "...",
  "userId": "session-id",
  "metadata": { "platform": "opencode" }
}

All Canonical Endpoints

Service	Endpoint	Method	Purpose
Aria Soul	`/chat`	POST	Main chat + tool calling
Aria Soul	`/health`	GET	Service health check
Aria Soul	`/hive/status`	GET	Active Hive sessions
MCP Pipeline	`:8091/mcp`	POST	Model Context Protocol
Manifold	`:50051`	gRPC	Vector eigenspace projections
Aria Hands	`:50052`	gRPC	Autonomous execution
Memory	`/api/memory/search`	POST	RAG search across all sources
Harness	`/api/harness/codex`	POST	Harness packet generation

Life OS & Ventures API

Endpoint	Method	Purpose
`/api/life/events`	POST	Receive device events (webhook)
`/api/life/devices`	GET	List all connected devices
`/api/life/devices/connect`	POST	Connect a new service/device
`/api/life/scenes`	GET	List all scenes
`/api/life/scenes/execute`	POST	Manually trigger a scene
`/api/life/inventory`	GET	View home inventory
`/api/life/purchases/approve`	POST	Approve/deny a purchase
`/api/life/health/summary`	GET	Health intelligence summary
`/api/ventures/dashboard`	GET	Unified P&L across all ventures
`/api/ventures/:name/clients`	GET	Clients for a specific venture
`/api/ventures/pipeline`	GET	Investor pipeline
`/api/ventures/financials`	GET	Financial summary

Authentication

Authorization: Bearer aria_ops_master_2026

All internal endpoints require bearer token authentication. External endpoints use platform-specific auth (OAuth2 for Google services, API keys for ElevenLabs, etc.).

Endpoint Usage Rules

Always use canonical /chat endpoint for hive registration
Always include platform: 'opencode' in metadata
Never try /hive/register — it doesn't exist
Test connectivity first with health endpoint
Inside cluster: use cluster DNS. Outside: use NodePort. Local: use port-forward