General

Authentication

All endpoints require Bearer token.

Authorization: Bearer <token>

Each user has a personal token resolved against the users table (active rows only). Obtain one by signing in — the dashboard stores it in the session cookie and the proxy attaches it to every upstream call. For standalone API clients, generate a token via the create-user / update-user scripts in the API repo.

Error Handling

If a request fails, the response contains ok: false and a code field. Use code to determine the error — do not rely on HTTP status codes.

Supported Pairs

Error Codes