docs/api-endpoint-map.md

API Endpoint Map

Mapping of Frontend features to Backend API endpoints.

Shared / Common

Feature	Method	Endpoint	Description
Cache Stats	GET	/v1/metrics/cache-stats	Get model cache hit rate and load times
Health Check	GET	/health	System health status

Tenant API (Requires X-Tenant-ID header)

Feature	Method	Endpoint	Payload / Params
Login	POST	/v1/auth/login	{tenant_id, username, password}
Register	POST	/v1/auth/tenants	{name, admin_email, admin_password}
Ask/Chat	POST	/v1/ask/	{query, top_k}
Active Sources	GET	/v1/sources/active	-
List Sources	GET	/v1/sources/	-
Add URL	POST	/v1/ingest/url	{url, name}
Upload Doc	POST	/v1/ingest/upload	Multipart: file
Add YouTube	POST	/v1/sources/youtube	Form: youtube_url, name, owner_attestation, transcript_file
Delete Source	DELETE	/v1/sources/{id}	-
Toggle Source	PUT	/v1/sources/{id}/toggle	?enabled=bool
Tenant Metrics	GET	/v1/tenants/{tid}/metrics	?hours=int
Cloud Connectors	GET	/v1/connectors/	?tenant_id=tid
Connect Start	GET	/v1/connectors/{prov}/oauth/start	?tenant_id=tid
Sync Connector	POST	/v1/connectors/{id}/sync	-
List Roots	GET	/v1/connectors/{id}/roots	-
Update Targets	POST	/v1/connectors/{id}/targets	?tenant_id=tid, Body: [{"id", "type"}]

Admin API (Requires Authorization: Bearer <token> header)

Feature	Method	Endpoint	Payload / Params
Admin Login	POST	/v1/admin/auth/login	{username, password}
Admin Register	POST	/v1/admin/auth/register	{username, email, password, registration_secret}
List Tenants	GET	/v1/admin/tenants	?status_filter=pending/approved/rejected
Get Tenant	GET	/v1/admin/tenants/{id}	-
Approve Tenant	POST	/v1/admin/tenants/{id}/approve	-
Reject Tenant	POST	/v1/admin/tenants/{id}/reject	{rejection_reason}
Global Metrics	GET	/v1/admin/metrics	-
Audit Logs	GET	/v1/admin/audit-logs	?limit=int&actor_type=str&action=str