API Reference

Memo exposes a REST API on the configured port (default 8090). All endpoints return JSON. Streaming endpoints use SSE.

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