diff --git a/apps/api/src/routes/users.ts b/apps/api/src/routes/users.ts
index 8d7f6d2ee4..45f086ddcc 100644
--- a/apps/api/src/routes/users.ts
+++ b/apps/api/src/routes/users.ts
@@ -3,6 +3,7 @@ import { Router } from "express";
 const router = Router();
 
 router.get("/", (_req, res) => {
+  // TODO: Replace the stub list with paginated user lookup and empty-state handling.
   res.json({
     data: [],
     message: "User listing is not implemented yet."
@@ -10,6 +11,7 @@ router.get("/", (_req, res) => {
 });
 
 router.post("/", (req, res) => {
+  // TODO: Validate required profile fields and return structured 4xx errors for invalid bodies.
   res.status(201).json({
     data: {
       id: "stub-user-id",