These endpoints power the IVGraph web application. They require JWT authentication unless noted otherwise. Documented here as a reference — for integration use cases, prefer the V1 LLM API.

User & Profile

Method Endpoint Description
GET /api/auth/me/ Current user info (id, email, username, is_staff)
GET /api/auth/validate/ Check if JWT token is valid
POST /api/auth/refresh/ Refresh access token
POST /api/auth/logout/ Blacklist refresh token
GET /api/user/me/ User profile detail
PUT /api/user/me/ Update user profile
GET /api/user/profile/ User profile view

Referral System

Method Endpoint Description
GET /api/referral/my-code/ Get user's referral code
POST /api/referral/apply/ Apply a referral code
GET /api/referral/stats/ Referral statistics

Notion OAuth

Method Endpoint Description
GET /api/integrations/auth/notion/ Start Notion OAuth flow (redirects to Notion)
GET /api/integrations/auth/notion/callback OAuth callback (exchanges code for tokens)
GET /api/integrations/auth/notion/status Check OAuth connection status
POST /api/integrations/auth/logout/ Disconnect Notion integration
POST /api/integrations/auth/delete-account/ Delete user account and all data

Workspace Management

Method Endpoint Description
GET /api/integrations/workspaces/ List user's Notion workspaces
GET /api/integrations/workspaces/<id>/ Workspace details
POST /api/integrations/workspaces/<id>/primary/ Set workspace as primary

Sync Management

Method Endpoint Description
GET /api/integrations/status/ Integration and sync status
GET /api/integrations/notion/permissions/ Check Notion API permissions
POST /api/integrations/airbyte/setup/ Setup Airbyte connection for workspace
GET /api/integrations/airbyte/setup/progress/ Setup progress
POST /api/integrations/airbyte/sync/ Trigger incremental sync
POST /api/integrations/airbyte/sync/cancel/ Cancel running sync
GET /api/integrations/airbyte/sync/progress/ Sync progress (poll this)
POST /api/integrations/airbyte/full-refresh/ Full data refresh (re-syncs everything)

Billing (Stripe)

Method Endpoint Description
GET /api/billing/plans/ List available subscription plans
POST /api/billing/create-checkout/ Create Stripe checkout session
POST /api/billing/confirm-checkout/ Confirm completed checkout
GET /api/billing/subscription/ Get user's subscription details
POST /api/billing/portal/ Create Stripe customer portal link

Style Rules & Graph Settings

Method Endpoint Description
GET /api/databases/ List databases for rule targeting
GET/PUT /api/graph-settings/ Global graph settings (colors, toggles)
GET/POST /api/advanced-rules/ List/create advanced style rules
GET/PUT/DELETE /api/advanced-rules/<id>/ Manage individual rule
POST /api/advanced-rules/reorder/ Reorder rules by priority
GET/POST /api/style-presets/ List/create style presets
GET/PUT/DELETE /api/style-presets/<id>/ Manage individual preset
POST /api/style-presets/<id>/activate/ Set preset as active
POST /api/style-presets/<id>/duplicate/ Duplicate a preset

Service Token Management

Method Endpoint Description
GET /api/tokens/ List user's service tokens
POST /api/tokens/ Create new service token
DELETE /api/tokens/<id>/ Revoke token (permanent)

See Authentication for details on token creation.

Miscellaneous

Method Endpoint Auth Description
GET /api/connections/ JWT List user's Airbyte connections
GET /api/integrations/ JWT Integrations overview
GET /api/activity/ JWT Recent activity log
GET /api/health/ None Health check
GET /api/health/celery/ None Celery worker health
GET /api/stats/public/ None Platform stats (24h cache)
POST /api/errors/report/ None Frontend error reporting