API Reference

KULVEX exposes a REST API (FastAPI) at port 9100 and real-time events via Socket.IO.

Base URL

http://localhost:9100

Authentication

Most endpoints require a JWT token. See Authentication.

# Get a token
curl -X POST http://localhost:9100/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username": "admin", "password": "your-password"}'
 
# Use the token
curl http://localhost:9100/api/ai/status \
  -H "Authorization: Bearer YOUR_TOKEN"

Health Check

curl http://localhost:9100/health
# {"status": "ok", "version": "4.0.32"}

This endpoint does not require authentication.

Scenes & Automations Endpoints