API Reference

agtOS provides three ways to interact with the platform:

Protocol	Port	Use Case
REST API	4102	Dashboard, CLI, health checks, chat
WebSocket	3000	Real-time voice audio streaming
MCP	4100	Tool integration for AI agents

Authentication

API endpoints support optional authentication via AGTOS_API_KEY:

curl -H "Authorization: Bearer your-api-key" http://localhost:4102/api/health

When AGTOS_API_KEY is not set, all endpoints are open (local development mode).

13+ HTTP endpoints for health, chat, sessions, memory, scheduling

Real-time audio streaming with push-to-talk and VAD

9 tools: voice, system health, sessions, workflows, scheduling

⌘I