notifications

Get notification history for the authenticated user.

Authentication: Requires JWT token in Authorization header Usage: Mobile app notification inbox screen

Returns paginated list of notifications ordered by creation date (newest first). User can only see their own notifications (user_id extracted from JWT token).

Get count of unread notifications for the authenticated user.

Authentication: Requires JWT token Usage: Mobile app badge display on notification tab

Returns count of notifications where is_read=false.

Mark a specific notification as read.

Authentication: Requires JWT token Authorization: User can only mark their own notifications Usage: When user taps a notification in mobile app

Returns 204 No Content on success. Raises 404 if notification not found, 403 if user doesn't own it.

Mark all unread notifications as read for the authenticated user.

Authentication: Requires JWT token Usage: "Mark all as read" button in mobile app

Returns 204 No Content on success.

Get notification preferences for the authenticated user.

Authentication: Requires JWT token Usage: Settings screen in mobile app

Returns user's notification category preferences and muted artists. If user hasn't configured preferences, returns sensible defaults.

Update notification preferences for the authenticated user.

Authentication: Requires JWT token Usage: When user changes settings in mobile app

Accepts partial updates (can update preferences or muted_artists independently). Returns updated preferences after save.