API Reference

API Reference

Authentication

POST /api/auth/login
Content-Type: application/json

{"username": "admin", "password": "Admin@2026"}

Response: {"access_token": "...", "refresh_token": "..."}

All subsequent requests require:

Authorization: Bearer <access_token>

Conversation API

POST /api/conversations/{id}/messages
Content-Type: application/json
Authorization: Bearer <token>

{"content": "Hello", "file_ids": []}

Response: SSE stream (text/event-stream)

Agent Management

GET  /api/admin/agents              # List all agents
POST /api/admin/agents              # Create agent
PATCH /api/admin/agents/{id}        # Update agent
DELETE /api/admin/agents/{id}       # Delete agent

Models

GET  /api/admin/models              # List all models
POST /api/admin/models/{id}/test    # Test model connectivity
PATCH /api/admin/models/{id}        # Update model

See the full API documentation at docs/en/API.md in the repository.