API Reference

Memo exposes a REST API on the configured port (default 8090). All endpoints return JSON. Streaming endpoints use SSE. This page lists representative endpoints by area — the server has roughly 45 distinct routes, each also mirrored under an /api/v1/ prefix (so ~90 total paths respond), for a total surface of ~45 unique operations.

Chat and Messaging

Method	Endpoint	Description
POST	/api/chat/send	Send a message, returns streaming SSE response
POST	/api/chat/stop	Stop the current generation stream
PUT	/api/chat/{session_id}/rename	Rename a chat session
DELETE	/api/chat/{session_id}	Delete a chat session
GET	/api/chat/sessions	List all chat sessions
GET	/api/chat/{session_id}/messages	Get messages for a session
PUT	/api/chat/{session_id}/messages/{msg_id}	Edit a message
POST	/api/chat/upload	Upload a file to current session
POST	/api/chat/web-search	Toggle web search mode

Memory Management

Method	Endpoint	Description
GET	/api/memory/search	Search memories (semantic + keyword)
POST	/api/memory	Save a new memory
DELETE	/api/memory/{id}	Delete a memory
POST	/api/memory/export	Export all memories as JSON
POST	/api/memory/import	Import memories from JSON
GET	/api/memory/stats	Memory analytics (total, pinned, weekly, expiring)
GET	/api/memory/top	Most accessed memories

Model Control

Method	Endpoint	Description
GET	/api/model/list	List all installed models
POST	/api/model/start	Start a local model (llama.cpp)
POST	/api/model/stop	Stop a running model
GET	/api/model/store	Browse downloadable models
POST	/api/model/download	Download a model from the store
DELETE	/api/model/{id}	Delete a local model
POST	/api/model/import	Import a local model file
GET	/api/model/status	Current model status
PUT	/api/model/params	Set temperature, top-p, context size

External Providers

Method	Endpoint	Description
GET	/api/providers/list	List all configured providers
PUT	/api/providers/{provider}	Update provider config (key, model, context)
PUT	/api/providers/active	Set active provider
PUT	/api/providers/{provider}/enable	Enable/disable a provider
GET	/api/providers/status	Health status of all providers

Agent Mode

Method	Endpoint	Description
POST	/api/agent/execute	Execute an agent task
PUT	/api/agent/permissions	Update tool permissions
GET	/api/agent/permissions	List current permissions
GET	/api/agent/tools	List available tools

Orchestra Mode

Method	Endpoint	Description
POST	/api/orchestra/run	Execute an orchestra task
PUT	/api/orchestra/config	Update role assignments
GET	/api/orchestra/config	Get current orchestra configuration
PUT	/api/orchestra/quick-setup	Assign one model to all roles

Calendar

Method	Endpoint	Description
GET	/api/calendar/events	List events in a time range
POST	/api/calendar/events	Add an event manually
DELETE	/api/calendar/events/{id}	Delete an event
GET	/api/calendar/settings	Get reminder settings
PUT	/api/calendar/settings	Update reminder lead time

WhatsApp

Method	Endpoint	Description
POST	/api/whatsapp/connect	Start WhatsApp pairing (returns QR)
POST	/api/whatsapp/disconnect	Disconnect WhatsApp
GET	/api/whatsapp/status	Connection status
GET	/api/whatsapp/chats	List chats
GET	/api/whatsapp/chats/{jid}/messages	Get messages for a chat
POST	/api/whatsapp/send	Send a WhatsApp message
GET	/api/whatsapp/search	Search WhatsApp messages

Synchronization

Method	Endpoint	Description
POST	/api/sync/authenticate	Start Google OAuth flow
POST	/api/sync/push	Upload encrypted backup
POST	/api/sync/pull	Download and restore backup
GET	/api/sync/status	Sync status and last sync time
PUT	/api/sync/config	Update sync settings

Configuration

Method	Endpoint	Description
PUT	/api/config	Update configuration section
GET	/api/config	Get full configuration
POST	/api/backup/export	Create .memo export file
POST	/api/backup/import	Restore from .memo file
POST	/api/system/wipe	Wipe all user data

Skills

Method	Endpoint	Description
GET	/api/skills/list	List installed skills
GET	/api/skills/get/{name}	Get skill details
POST	/api/skills/install	Install from path
DELETE	/api/skills/remove/{name}	Remove skill
PUT	/api/skills/active	Set active skills
GET	/api/skills/active-list	Get active skill names

Routines

Method	Endpoint	Description
GET/POST	/api/routines	List / create routines
POST	/api/routines/parse	Parse a plain-language description into a routine definition
PUT/DELETE	/api/routines/{id}	Update / delete a routine
GET	/api/routines/mobile-ready	Routines ready to deliver as mobile local notifications
POST	/api/routines/sync-offset	Resync a routine's device timezone offset

Self-Insight

Method	Endpoint	Description
POST	/api/memory/insight	Generate an on-demand /insight pattern summary from mood history and memory

Developer API Gateway

Method	Endpoint	Description
POST	/v1/messages	Anthropic-compatible messages endpoint (Claude Code and similar tools point ANTHROPIC_BASE_URL here)
GET/PUT	/api/dev-gateway/config	Get / update gateway config (require_api_key, use_memory)
GET	/api/dev-gateway/models	List models in type/model-id format
GET	/api/dev-gateway/logs	Live log of requests passing through the gateway

Memo Swarm (Beta)

Method	Endpoint	Description
GET	/api/swarm/status	Current swarm room and worker status
POST	/api/swarm/host/create	Start hosting a swarm room, returns a room code
POST	/api/swarm/host/workers/add | /remove | /reorder | /share	Manage joined workers and their compute share
POST	/api/swarm/host/start | /stop | /close	Control the hosted swarm session
POST	/api/swarm/join / /api/swarm/leave	Join / leave a swarm room with a room code

Usage Stats

Method	Endpoint	Description
GET	/api/stats/usage	KPI totals, 30-day daily token usage, and per-model breakdown