API Reference

47 REST routes + WebSocket upgrade. All routes are served by the embedded axum HTTP server.

▸
HealthConfigLogsSessionsMemorySchedulerStatisticsCircuit BreakerAgentWalletSkillsPluginsBrowserAgentsWorkspaceA2AWebhooksChannelsWebSocket

Health

GET/api/healthQuick health check (status, uptime, version)

Config

GET/api/configCurrent configuration
PUT/api/configUpdate configuration

Logs

GET/api/logsStructured log output

Sessions

GET/api/sessionsList sessions
POST/api/sessionsCreate new session
GET/api/sessions/:idSession detail
GET/api/sessions/:id/messagesSession message history
POST/api/sessions/:id/messagesAppend message to session

Memory

GET/api/memory/working/:session_idWorking memory (session-scoped)
GET/api/memory/episodicEpisodic memory (events)
GET/api/memory/semantic/:categorySemantic memory (facts)
GET/api/memory/searchFull-text memory search (FTS5)

Scheduler

GET/api/cron/jobsList cron jobs
POST/api/cron/jobsCreate cron job
GET/api/cron/jobs/:idCron job detail
DELETE/api/cron/jobs/:idDelete cron job

Statistics

GET/api/stats/costsInference cost history
GET/api/stats/transactionsFinancial transaction history
GET/api/stats/cacheCache hit/miss statistics

Circuit Breaker

GET/api/breaker/statusAll provider breaker states
POST/api/breaker/reset/:providerReset a provider breaker

Agent

GET/api/agent/statusAgent state, model, cache stats
POST/api/agent/messageSend message through agent pipeline

Wallet

GET/api/wallet/balanceUSDC + credit balance
GET/api/wallet/addressWallet address

Skills

GET/api/skillsList all registered skills
GET/api/skills/:idSkill detail + content
POST/api/skills/reloadTrigger hot-reload from disk
PUT/api/skills/:id/toggleEnable/disable a skill

Plugins

GET/api/pluginsList installed plugins
PUT/api/plugins/:name/toggleEnable/disable plugin
POST/api/plugins/:name/execute/:toolExecute a plugin tool

Browser

GET/api/browser/statusBrowser session status
POST/api/browser/startStart headless browser
POST/api/browser/stopStop browser session
POST/api/browser/actionExecute browser action

Agents

GET/api/agentsList agent instances
POST/api/agents/:id/startStart an agent
POST/api/agents/:id/stopStop an agent

Workspace

GET/api/workspace/stateWorkspace file/state overview

A2A

POST/api/a2a/helloA2A handshake initiation

Webhooks

POST/api/webhooks/telegramTelegram webhook receiver
GET/api/webhooks/whatsappWhatsApp verify endpoint
POST/api/webhooks/whatsappWhatsApp webhook receiver

Channels

GET/api/channels/statusChannel adapter status

WebSocket

GET/wsReal-time event push (upgrades to WebSocket)

WebSocket

The /ws endpoint upgrades to a WebSocket connection for real-time event push. Events include session updates, tool call results, memory changes, and scheduler notifications.

ws://localhost:18789/ws