Phase 5.14: API documentation - OpenAPI tags, response models, examples, docs

app/routes/notifications.py

@@ -19,7 +19,7 @@ from app.models.notification import (
     NotificationPreference,
     NotificationType,
 )
-from app.schemas.common import NotificationPreferenceUpdate
+from app.schemas.common import NotificationPreferenceUpdate, UnreadCountResponse
 
 router = APIRouter(prefix="/api/v1/notifications", tags=["notifications"])
 
@@ -67,7 +67,7 @@ async def mark_notification_read_endpoint(
     }
 
 
-@router.get("/unread-count")
+@router.get("/unread-count", response_model=UnreadCountResponse)
 async def unread_count_endpoint(
     db: AsyncSession = Depends(get_db),
     current_user: dict = Depends(require_permission("notifications:read")),