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

app/routes/auth.py

@@ -12,7 +12,9 @@ from app.core.auth import get_redis
 from app.core.db import get_db
 from app.core.rate_limit import check_rate_limit, get_client_ip, reset_rate_limit
 from app.schemas.auth import (
+    AuthResponse,
     LoginRequest,
+    MessageResponse,
     PasswordResetConfirm,
     PasswordResetRequest,
     SwitchTenantRequest,
@@ -24,7 +26,7 @@ router = APIRouter(prefix="/api/v1/auth", tags=["auth"])
 settings = get_settings()
 
 
-@router.post("/login")
+@router.post("/login", response_model=AuthResponse)
 async def login(
     request: Request,
     body: LoginRequest,
@@ -91,7 +93,7 @@ async def login(
     return resp
 
 
-@router.post("/logout")
+@router.post("/logout", response_model=MessageResponse)
 async def logout(
     request: Request,
     db: AsyncSession = Depends(get_db),
@@ -112,7 +114,7 @@ async def logout(
     return resp
 
 
-@router.get("/me")
+@router.get("/me", response_model=AuthResponse)
 async def me(
     request: Request,
     db: AsyncSession = Depends(get_db),