API Reference¶

Kaisho exposes a REST API on http://localhost:8765/api/. All endpoints return JSON unless noted otherwise.

Base URL¶

http://localhost:8765

Authentication¶

The local API has no authentication. It is designed for single-user access on localhost. CORS is restricted to local development origins.

Common Patterns¶

List endpoints return arrays:

[{"id": "abc123", "title": "My task", ...}, ...]

Create endpoints return the created object with HTTP 201.

Update endpoints accept partial objects (only changed fields) and return the updated object.

Delete endpoints return HTTP 204 with no body.

Error responses use standard HTTP status codes:

Error bodies:

{"detail": "Human-readable error message"}

Health Check¶

GET /health

Returns {"status": "ok"}. Use this to verify the server is running.

WebSocket¶

Real-time updates are pushed via WebSocket at ws://localhost:8765/ws. See WebSocket.

Endpoints by Domain¶