#🔌 Vibie REST API Reference

The Vibie backend exposes a FastAPI REST API for authentication, funnel management, video assets, and webhook processing.

---

#🔐 Authentication & Session Tokens

Vibie uses Dual JWT Tokens:

• Access Token: 15-minute expiration (transmitted via Authorization: Bearer <token>).
• Refresh Token: 7-day expiration (rotated upon refresh).

#Endpoints:

• POST /api/v1/auth/login — Authenticate and receive dual tokens.
• POST /api/v1/auth/register — Create a new creator account & default organization.
• POST /api/v1/auth/refresh — Exchange a valid refresh token for a new access/refresh pair.
• POST /api/v1/auth/logout — Revoke tokens and add JTI to the Redis blacklist.
• GET /api/v1/auth/me — Get current user profile and active organization context.

---

#🎬 Custom Video & Embed SDK Endpoints

#Protected (Creator Access):

• GET /api/v1/videos/?org_id={org_id} — List organization’s video assets.
• POST /api/v1/videos/?org_id={org_id} — Create a new video asset.
• GET /api/v1/videos/{video_id} — Retrieve video asset details.
• PATCH /api/v1/videos/{video_id} — Update video metadata, aspect ratio, CTA, or lead capture.
• DELETE /api/v1/videos/{video_id} — Delete a video asset.

#Public (SDK & Standalone Viewer):

• GET /api/v1/videos/public/{video_id} — Public metadata for SDK rendering (increments view count).
• POST /api/v1/videos/public/{video_id}/click — Track CTA button clicks.
• POST /api/v1/videos/public/{video_id}/lead — In-video lead capture form submissions.

---

#⚡ Media & Webhook Endpoints

• POST /api/v1/media/direct-upload — Generate Cloudflare Stream TUS direct upload URL.
• POST /api/v1/media/cloudflare-webhook — Cloudflare Stream encoding completion webhook.