LessonForge
Loading
We are loading the next page now. This usually means we are preparing product details, dashboard data, or the next step in the flow.
LessonForge
API Reference
This page turns the app routes into one readable API map, so you can see what the website exposes without reading every route file.
Start here
Start here
Use the section names to jump between buyer, seller, admin, and generated-asset endpoints.
What you are seeing
A plain-language reference for the current Next.js route handlers in this website.
What happens next
Use these paths to build docs, connect tools, test flows, or wire future front-end work.
This is the website-facing API inventory for LessonForge right now.
Use these endpoints to inspect or switch the current viewer role.
/api/session/viewerReturns the current viewer object.
/api/session/viewerSwitches the current viewer role.
Body shape
{ "role": "buyer" | "seller" | "admin" | "owner" }These routes power checkout, purchase completion, and protected library delivery.
/api/checkoutCreates a real Stripe Checkout session when possible, otherwise falls back to checkout preview.
Body shape
{ "resourceId": "..." } or { "resource": { ... } }/api/lessonforge/purchaseCreates a purchase order from JSON for the current buyer flow.
Body shape
{ "productId": "...", "buyerEmail": "...", "amountCents": 1200, ... }/api/lessonforge/purchase-completeCompletes the checkout preview purchase form and redirects into the library.
Body shape
FormData from checkout preview/api/lessonforge/library-deliveryRedirects the buyer into a protected download flow for an order.
Query params
orderId=.../api/lessonforge/library-deliveryReturns a protected delivery URL and expiration for an order.
Body shape
{ "orderId": "..." }/api/lessonforge/protected-downloadValidates a protected delivery token and streams the purchased file placeholder.
Query params
token=...These routes create products, list persisted products, and support moderation changes.
/api/lessonforge/productsLists persisted products.
/api/lessonforge/productsCreates or saves a product after validation.
Body shape
{ "product": { ...ProductRecord } }/api/lessonforge/productsUpdates product moderation state and seller-facing moderation feedback.
Body shape
{ "productId": "...", "productStatus": "Flagged", "moderationFeedback": "..." }/api/lessonforge/ranking-insightsReturns seller-specific ranking and marketplace performance insights.
Query params
sellerId=...These endpoints handle seller profile setup, Stripe onboarding, payout status, and seller AI usage.
/api/lessonforge/seller-profileLists seller profiles.
/api/lessonforge/seller-profileSaves a seller profile draft.
Body shape
{ "profile": { ...SellerProfileDraft } }/api/lessonforge/seller-aiReturns seller AI subscription, ledger, and admin setting overview.
Query params
sellerId=...&sellerEmail=...&sellerPlanKey=starter/api/sellers/onboardCreates or reopens Stripe Connect onboarding and returns the onboarding URL.
Body shape
{ "email": "...", "displayName": "..." } or { "accountId": "..." }/api/sellers/statusReturns payout status details for one or more seller accounts.
Body shape
{ "accounts": [{ "accountId": "...", "key": "seller-a" }] }/api/lessonforge/ai/standards-scanRuns the seller standards scan and consumes seller AI credits.
Body shape
{ "sellerId": "...", "sellerEmail": "...", "title": "...", "excerpt": "...", "provider": "openai" }These endpoints power favorites, reviews, refund requests, and issue reports.
/api/lessonforge/favoritesReturns the current buyer’s saved products.
/api/lessonforge/favoritesToggles a product in or out of the buyer shortlist.
Body shape
{ "productId": "..." }/api/lessonforge/reviewsLists reviews.
/api/lessonforge/reviewsCreates a new product review.
Body shape
{ "productId": "...", "rating": 5, "title": "...", "body": "...", ... }/api/lessonforge/refund-requestsLists refund requests.
/api/lessonforge/refund-requestsCreates a refund request for a purchased order.
Body shape
{ "orderId": "...", "reason": "...", ... }/api/lessonforge/refund-requestsApproves or denies a refund request with an admin note.
Body shape
{ "refundRequestId": "...", "status": "Approved", "adminResolutionNote": "..." }/api/lessonforge/reportsLists buyer reports.
/api/lessonforge/reportsCreates a new report.
Body shape
{ "report": { ...ReportPayload } }/api/lessonforge/reportsUpdates report triage status and admin resolution note.
Body shape
{ "reportId": "...", "status": "Resolved", "adminResolutionNote": "..." }These routes expose AI settings, system settings, and persistence readiness reporting.
/api/lessonforge/admin-ai-settingsReturns current AI control settings.
/api/lessonforge/admin-ai-settingsUpdates AI kill switch and warning thresholds.
Body shape
{ "aiKillSwitchEnabled": true, "warningThresholds": { ... } }/api/lessonforge/system-settingsReturns maintenance-mode and other system settings.
/api/lessonforge/system-settingsUpdates maintenance-mode settings.
Body shape
{ "maintenanceModeEnabled": true, "maintenanceMessage": "..." }/api/lessonforge/persistence-readinessReturns cutover and persistence readiness information based on viewer role.
These endpoints generate managed preview and thumbnail SVG assets for marketplace listings.
/api/lessonforge/preview-assets/[slug]Returns a generated preview SVG for a listing page.
Query params
page=1/api/lessonforge/thumbnail-assets/[slug]Returns a generated thumbnail SVG for a listing.