API Endpoints
All routes are aggregated in app/routes/api.py.
Authentication
| Method |
Path |
Description |
| GET |
/login |
Initiate Cognito OAuth login |
| GET |
/logout |
Clear session and logout |
| GET |
/callback |
OAuth callback handler |
Core Pages
| Method |
Path |
Description |
| GET |
/ |
Dashboard (main landing) |
| GET |
/about |
About page |
| GET |
/me |
User profile |
Ingest (File Import)
| Method |
Path |
Description |
| GET |
/ingest |
Upload page |
| POST |
/ingest/upload |
Handle file upload |
| GET |
/ingest/inspect/{file} |
View & analyze file |
| GET |
/ingest/row/{id} |
Inspect single row |
| POST |
/ingest/row/{id} |
Update row classification |
| GET |
/ingest/rules |
Rules debug view |
Rules
| Method |
Path |
Description |
| GET |
/rules |
Rules list page |
| POST |
/rules/create |
Create new rule |
| POST |
/rules/{id}/update |
Update existing rule |
| DELETE |
/rules/{id} |
Delete rule |
Pipeline
| Method |
Path |
Description |
| POST |
/pipeline/run |
Run classification pipeline |
| GET |
/pipeline/status |
Check pipeline status |
Filter (HTMX Components)
| Method |
Path |
Description |
| GET |
/filter/dates |
Date range picker |
| GET |
/filter/categories |
Category selector |
| POST |
/filter/apply |
Apply filters, return results |
Visualization
| Method |
Path |
Description |
| GET |
/visualize |
Visualization hub |
| GET |
/visualize/numbers |
Spending stats & charts |
| GET |
/visualize/balance |
Balance over time + predictions |
| GET |
/visualize/flow |
Cash flow diagram |
| GET |
/visualize/chart |
Category charts |
| GET |
/visualize/pie |
Category pie chart |
| GET |
/visualize/incomes-expenses |
Income vs expenses view |
User API
| Method |
Path |
Description |
| GET |
/api/users/session |
Current session info |
| GET |
/api/users/files |
List user's imported files |
| DELETE |
/api/users/files/{file} |
Delete imported file |
Development Only
These routes are only available when ENV != production:
| Method |
Path |
Description |
| GET |
/docs |
FastAPI Swagger UI |
| GET |
/redoc |
ReDoc documentation |
| GET |
/openapi.json |
OpenAPI schema |