API

API routes

REST endpoints are defined in api/src/routes/ and mounted under /api. On Vercel, the frontend calls same-origin paths; locally, Nuxt devProxy forwards to the Express server.

Conventions

JSON request/response bodies
Auth via Authorization: Bearer <jwt>
Errors return JSON with appropriate HTTP status codes
Producer-only routes require PRODUCER role
Static media at /storage/* and /audio/* (not under /api)

Health

Method	Path	Description	Auth
GET	`/health` API liveness check	API liveness check	Public
GET	`/health/ffmpeg` ffmpeg/ffprobe availability for audio processing	ffmpeg/ffprobe availability for audio processing	Public

Auth

Method	Path	Description	Auth
POST	`/api/auth/register` Register with email and password	Register with email and password	Public
POST	`/api/auth/login` Login with email and password	Login with email and password	Public
GET	`/api/auth/me` Current authenticated user	Current authenticated user	User
PUT	`/api/auth/profile` Update profile fields	Update profile fields	User
POST	`/api/auth/forgot-password` Request password reset email	Request password reset email	Public
POST	`/api/auth/reset-password` Reset password with token	Reset password with token	Public
GET	`/api/auth/google` Start Google OAuth flow	Start Google OAuth flow	Public
GET	`/api/auth/google/callback` Google OAuth callback	Google OAuth callback	Public

Beats

Method	Path	Description	Auth
GET	`/api/beats` List beats with filters, search, pagination	List beats with filters, search, pagination	Public
GET	`/api/beats/stats` Aggregate marketplace stats	Aggregate marketplace stats	Public
GET	`/api/beats/:slugOrId` Beat detail by slug or ID	Beat detail by slug or ID	Public
POST	`/api/beats` Create beat draft	Create beat draft	Producer
POST	`/api/beats/upload` Upload beat files (audio + cover)	Upload beat files (audio + cover)	Producer
PUT	`/api/beats/:id` Update beat metadata	Update beat metadata	User
POST	`/api/beats/:id/publish` Publish beat	Publish beat	Producer
POST	`/api/beats/:id/like` Like beat	Like beat	User
POST	`/api/beats/:id/favorite` Toggle favorite	Toggle favorite	User
GET	`/api/beats/:id/download` Download purchased or free beat	Download purchased or free beat	Public
DELETE	`/api/beats/:id` Delete beat	Delete beat	User

Users & producers

Method	Path	Description	Auth
GET	`/api/users/producers` List producers	List producers	Public
GET	`/api/users/:identifier` Public producer profile	Public producer profile	Public
GET	`/api/users/:identifier/beats` Beats by producer	Beats by producer	Public
PUT	`/api/users/me` Update account (avatar upload)	Update account (avatar upload)	User
GET	`/api/users/me/beats` Current user beats	Current user beats	User
GET	`/api/users/me/favorites` Current user favorites	Current user favorites	User
GET	`/api/users/me/analytics` Producer analytics	Producer analytics	User
POST	`/api/users/:identifier/follow` Follow producer	Follow producer	User

Purchases

Method	Path	Description	Auth
GET	`/api/purchases/:purchaseId/download` Download purchased beat files	Download purchased beat files	User
GET	`/api/users/me/purchases` Current user purchase history	Current user purchase history	User

Messages

Method	Path	Description	Auth
GET	`/api/messages/conversations` List conversations	List conversations	User
GET	`/api/messages/conversations/:userId` Messages with a user	Messages with a user	User
POST	`/api/messages/send` Send message	Send message	User
PUT	`/api/messages/:messageId/read` Mark message read	Mark message read	User
GET	`/api/messages/notifications` Notification feed	Notification feed	User

Comments

Method	Path	Description	Auth
GET	`/api/comments/beats/:beatId` Comments on a beat	Comments on a beat	Public
POST	`/api/comments/beats/:beatId` Post comment	Post comment	User
DELETE	`/api/comments/:id` Delete comment	Delete comment	User

Admin

Method	Path	Description	Auth
GET	`/api/admin/stats` Platform statistics	Platform statistics	Admin
GET	`/api/admin/users` List users	List users	Admin
GET	`/api/admin/beats` List beats (moderation)	List beats (moderation)	Admin
GET	`/api/admin/settings` Platform settings	Platform settings	Admin
PUT	`/api/admin/settings` Update platform settings	Update platform settings	Admin