API Overview

The agent's HTTP surface — base URL, conventions, and endpoint map.

The agent is a FastAPI server exposing ~51 endpoints. The shell uses a handful of them; the rest power widgets, workflows, settings, and integrations.

Base URL

text
http://127.0.0.1:8000

The agent binds to localhost only. The shell reaches it over plain HTTP; the agent pushes back over the Unix socket /tmp/megha_events.sock (not HTTP).

Health

bash
curl http://127.0.0.1:8000/health

Returns OK once the agent has finished startup (memory init, plugin registration). The launcher polls this before opening the shell.

Endpoint map

The pages that follow document the most-used endpoints in detail.