Developer docs

Phase 1 local API reference.

CueIQ currently exposes a local FastAPI bridge between PostgreSQL and the dashboard. These notes document the routes used by the workspace while production API docs are still being built. Current release: v0.1.0-local-mvp.

Dashboard API

Local development server: http://127.0.0.1:8001

GET /api/health
GET /api/me
GET /api/usage
GET /api/stats
GET /api/videos?limit=12
GET /api/frequency?limit=10
GET /api/players?limit=50
GET /api/stroke-clips
GET /api/videos/{video_id}/detections
GET /api/videos/{video_id}/analysis-runs
GET /api/review-queue?min_confidence=0.75
POST /api/signup/checkout
POST /api/trust/access-requests
POST /api/trust/access-check
GET /api/admin/trust/access-requests
PATCH /api/admin/trust/access-requests/{request_id}
POST /api/billing/checkout-session
POST /api/billing/portal-session
GET /api/billing/entitlement/{email} ยท auth required

Hosted auth routes: /auth/ for sign in/account creation and /auth/callback/ for Supabase email confirmation and magic-link callbacks.

REST contract

The Phase 1 contract is intentionally narrow: dashboard read endpoints, review-queue candidates, reviewed timestamp updates, analysis run history, stroke-library promotion, and stable JSON payloads for PostgreSQL-backed data.

PATCH /api/detections/{detection_id}/review
POST /api/detections/{detection_id}/benchmark
POST /api/detections/{detection_id}/stroke-clip
POST /api/lead-capture
POST /api/webhooks/stripe

Production mode requires a managed-auth Bearer JWT. The frontend stores the Supabase access token and sends it to FastAPI on dashboard API calls. Coach+ entitlements unlock curation, review queue, run history, stroke library, player comparison, and Stripe Customer Portal billing management. Admin entitlement is required for Trust Center approval review.

Webhooks

Stripe subscription webhooks are available for test-mode billing. Future production webhook candidates include analysis-job completion, trust-access approvals, and coach-review assignments.

Financial model

The beta economics are library-first and quota-gated: verified library consumption is the core subscription value, while fresh video analysis is metered by plan and sold through overage credits.

Open financial model

Support

For API questions during the local MVP, route requests through CueIQ Support so they can be tracked against the production roadmap.

Open Support

These docs are a Phase 1 bridge, not a public production API commitment. The production foundation plan will replace this page with authenticated API documentation and proper changelog/versioning.

Open workspace