API overview

Eyedeea exposes a REST API used by the web app, Android, and Fire TV clients.

Base URL

Environment	URL
Production	`https://www.eyedeeaphotos.com/api`
Local dev	`http://localhost:3000`

Most endpoints require a JWT access token obtained after OAuth sign-in or refresh. Requests include:

Authorization: Bearer <access_token>

Household context is derived from the authenticated user session.

The full endpoint list with request/response schemas is available at:

Swagger JSON is generated from the API codebase (npm run docs in the api package).

Real-time updates (scan progress, job completion) use a WebSocket connection at wss://<host>/api/v1/realtime/ws.