REST API

All endpoints are prefixed with /api. Authentication uses JWT Bearer tokens.

Auth

Method	Path	Body	Description
POST	/api/auth/register	{username, password, display_name?}	Create account, returns token
POST	/api/auth/login	{username, password}	Login, returns token
GET	/api/auth/me	—	Current user info
GET	/api/auth/check	—	Check if any users exist

Conversations

Method	Path	Body	Description
GET	/api/conversations	—	List all conversations
POST	/api/conversations	{title?, model?, mode?}	Create conversation
GET	/api/conversations/:uuid	—	Get conversation + messages
DELETE	/api/conversations/:uuid	—	Delete conversation
POST	/api/conversations/:uuid/switch	—	Switch active conversation

Messaging

Method	Path	Body	Description
POST	/api/message	{message, mode?}	Send message (mode: plan/research/write)
POST	/api/answers	{answers: {qid: label}}	Answer structured questions
POST	/api/interrupt	—	Cancel current agent turn
POST	/api/approval	{approvals: {id: bool}}	Approve/reject tool calls
POST	/api/undo	—	Undo last turn
POST	/api/compact	—	Compact conversation context
POST	/api/model	{model}	Switch LLM model

SSE

Method	Path	Description
GET	/api/events?token=JWT	Server-Sent Events stream
GET	/api/events/test	Test endpoint (3 events)

Settings

Method	Path	Description
GET	/api/settings	All settings
GET	/api/settings/:category	Settings by category
PUT	/api/settings/:category/:key	Update setting
DELETE	/api/settings/:category/:key	Delete setting
GET	/api/providers	List provider status
GET	/api/models	List available models
GET	/api/status	Current model + config
GET	/api/reports/:id	Get completion report content

Health

Method	Path	Description
GET	/health	{"status": "ok", "version": "2.0.0"}