Skip to content

API Reference

29 HTTP endpoints plus 1 WebSocket endpoint from the current OpenAPI surface.

▸
HealthDiscoveryAgentSessionsMemorySchedulerSkillsStatisticsConfigWalletApprovalsInterviewSub-AgentsCircuit BreakerWebSocket

Health

GET/api/healthHealth check

Discovery

GET/.well-known/agent.jsonA2A agent discovery card

Agent

POST/api/agent/messageSend a message (standard inference)
POST/api/agent/message/streamSend a message (SSE streaming)
GET/api/agent/statusAgent and provider diagnostics

Sessions

GET/api/sessionsList sessions
POST/api/sessionsCreate session
GET/api/sessions/{id}Get session details
DELETE/api/sessions/{id}Delete session
GET/api/sessions/{id}/messagesList session messages

Memory

GET/api/memory/workingWorking memory entries
GET/api/memory/episodicEpisodic memory entries
GET/api/memory/semanticSemantic knowledge store
GET/api/memory/searchCross-tier hybrid memory search

Scheduler

GET/api/cron/jobsList cron jobs
POST/api/cron/jobsCreate cron job

Skills

GET/api/skillsList loaded skills

Statistics

GET/api/stats/costsInference cost tracking
GET/api/stats/efficiencyModel efficiency metrics

Config

GET/api/configCurrent configuration

Wallet

GET/api/wallet/balanceWallet balance

Approvals

GET/api/approvalsList approval requests
POST/api/approvals/{id}/approveApprove a pending request
POST/api/approvals/{id}/denyDeny a pending request

Interview

POST/api/interview/startStart personality interview
POST/api/interview/turnSubmit interview Q&A turn
POST/api/interview/finishFinish interview and generate config

Sub-Agents

GET/api/subagentsList sub-agents

Circuit Breaker

GET/api/breaker/statusCircuit breaker status

WebSocket

GET/wsWebSocket event stream

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
←PreviousSecurityNextCLI Reference→