API Overview

All API endpoints require authentication via X-API-Key header or Authorization: Bearer <jwt>.

Base URL: http://localhost:9090

Health Check

GET /healthz

No authentication required.

Core Endpoints

Method	Path	Description
POST	/v1/chat	Send a chat message
POST	/v1/chat/stream	Stream chat response (SSE)
GET	/v1/skills	List available skills
GET	/v1/version	Agent version info
GET	/v1/metrics	Usage metrics
GET	/v1/models	List configured models

Memory

Method	Path	Description
GET	/v1/memory/stats	Memory layer statistics
GET	/v1/memory/search	Search memories
POST	/v1/memory/add	Add a memory entry

Knowledge Base

Method	Path	Description
GET	/v1/knowledge/search	Hybrid search (BM25 + vector)
GET	/v1/knowledge/sources	List knowledge sources
POST	/v1/knowledge/ingest	Ingest a document
POST	/v1/knowledge/upload	Upload a file

Sessions

Method	Path	Description
GET	/v1/sessions	List sessions
DELETE	/v1/sessions/:id	Delete a session

Audit

Method	Path	Description
GET	/v1/audit/tail	Recent audit records
GET	/v1/audit/verify	Verify Merkle chain integrity
GET	/v1/audit/stats	Audit statistics

Cron Jobs

Method	Path	Description
GET	/v1/cron/list	List scheduled jobs
POST	/v1/cron/add	Create a cron job
POST	/v1/cron/run/:id	Manually trigger a job