API Reference

91 endpoints across 13 categories. Base URL: https://hearhuios.vercel.app

Auth Required

Public

Sections

Authentication (8)User Profile (9)Products (Public) (2)Checkout & Payment (4)Courses & LMS (9)Instructor (12)AI Skills (5)Blog (Public) (1)Upload (1)Admin — Dashboard (3)Admin — Content (12)Admin — Configuration (14)Admin — SEO & Tracking (11)

Authentication

POST/api/auth/signupRegister a new user account

POST/api/auth/callback/credentialsLogin with email/password (NextAuth)

POST/api/auth/forgot-passwordSend password reset email

POST/api/auth/reset-passwordReset password with token

POST/api/auth/verify-emailVerify email with token

POST/api/auth/resend-verificationResend verification email

GET/api/auth/check-verificationCheck email verification status

GET/api/auth/csrfGet CSRF token for form submission

User Profile

GET/api/users/profileGet current user profile

PUT/api/users/profileUpdate profile (firstName, lastName)

POST/api/users/upload-avatarUpload profile picture (multipart/form-data)

POST/api/users/change-passwordChange password

POST/api/users/delete-accountDelete user account permanently

GET/api/users/dashboard-statsGet dashboard statistics

GET/api/users/purchasesList user purchases

GET/api/users/filesList available file downloads

GET/api/users/referralGet referral code and stats

Products (Public)

GET/api/productsList all active products with prices

GET/api/products/[id]Get product detail with course curriculum

Checkout & Payment

POST/api/checkoutCreate Stripe checkout session

POST/api/payment/promptpayGenerate PromptPay QR code

GET/api/download/[token]Download purchased file (3-download limit)

POST/api/webhooks/stripeStripe webhook (checkout.session.completed)

Courses & LMS

GET/api/courses/[courseId]Get course details with modules/lessons

GET/api/courses/[courseId]/lessons/[lessonId]Get lesson content

GET/api/enrollmentsList user enrollments with progress

POST/api/enrollmentsEnroll in a course

POST/api/enrollments/progressMark lesson as complete

POST/api/enrollments/quizSubmit quiz answers

POST/api/enrollments/assignmentSubmit assignment

GET/api/certificatesList user certificates

GET/api/certificates/[id]Get certificate details

Instructor

GET/api/instructor/coursesList instructor's courses

POST/api/instructor/coursesCreate new course

GET/api/instructor/courses/[courseId]Get course with modules/lessons

PUT/api/instructor/courses/[courseId]Update course (title, desc, status)

POST/api/instructor/courses/[courseId]/modulesAdd module to course

DELETE/api/instructor/courses/[courseId]/modules/[moduleId]Delete module

POST/api/instructor/courses/[courseId]/lessonsAdd lesson to module

GET/api/instructor/courses/[courseId]/lessons/[lessonId]Get lesson with content

PUT/api/instructor/courses/[courseId]/lessons/[lessonId]Update lesson content

DELETE/api/instructor/courses/[courseId]/lessons/[lessonId]Delete lesson

GET/api/instructor/submissionsList student submissions

PUT/api/instructor/submissions/[id]Grade submission (approve/reject)

AI Skills

GET/api/skillsList all available AI skills

POST/api/skills/chatStart new chat session

PUT/api/skills/chatSend message (streaming SSE response)

GET/api/skills/journeyGet user journey progress

GET/api/skills/sessions/[sessionId]Get chat session with messages

Blog (Public)

GET/api/blogList published blog posts

Upload

POST/api/uploadUpload image (max 5MB, JPEG/PNG/WebP/GIF)

Admin — Dashboard

GET/api/admin/statsDashboard stats (users, products, revenue)

GET/api/admin/analyticsComprehensive analytics data

GET/api/admin/setup-statusSetup wizard checklist status

Admin — Content

GET/api/admin/productsList all products with prices

POST/api/admin/productsCreate product with price

GET/api/admin/blogList all blog posts (all statuses)

POST/api/admin/blogCreate blog post

GET/api/admin/usersList/search users

GET/api/admin/tagsList tags

POST/api/admin/tagsCreate tag

GET/api/admin/waitlistsList waitlists with member count

POST/api/admin/waitlistsCreate waitlist

GET/api/admin/transactionsList transactions

GET/api/admin/filesList deliverable files

POST/api/admin/filesUpload deliverable file

Admin — Configuration

GET/api/admin/email-configGet SMTP config status

POST/api/admin/email-configSave SMTP settings (encrypted)

GET/api/admin/email-templatesList email templates

POST/api/admin/email-templatesCreate email template

GET/api/admin/email-logsList email send logs

POST/api/admin/test-emailSend test email

GET/api/admin/stripe-configGet Stripe config status

POST/api/admin/stripe-configSave Stripe keys (encrypted)

GET/api/admin/ai-configGet Claude API config

POST/api/admin/ai-configSave Claude API key (encrypted)

GET/api/admin/system-settingsGet all system settings

POST/api/admin/system-settingsSave setting (key/value)

POST/api/admin/skills/seedSeed 8 default AI skills

POST/api/admin/email-templates/seedSeed 5 default email templates

Admin — SEO & Tracking

GET/api/admin/trackingList tracking tags

POST/api/admin/trackingCreate tracking tag

POST/api/admin/tracking/reportsGet tracking event reports

GET/api/admin/seo/keywordsList SEO keywords

POST/api/admin/seo/keywordsAdd keyword to track

GET/api/admin/seo/contentList content plans

POST/api/admin/seo/contentCreate content plan

GET/api/admin/seo/monitorList monitored sites

POST/api/admin/seo/monitorAdd site to monitor

POST/api/admin/seo/monitor/checkCheck site status now

GET/api/admin/seo/analyzerAnalyze URL for SEO

Documentation Home