Update plugins/sangmata.js

plugins/sangmata.js

@@ -99,6 +99,53 @@ SangmataRoutes.post("/api/v2/sangmata/tracker", authenticateApiKey, async (req,
   }
 });
 
+/**
+ * @swagger
+ * /api/v2/sangmata/tracker/{user_id}:
+ *   get:
+ *     summary: Retrieve a user's first name history
+ *     tags: [Sangmata]
+ *     description: Fetches the historical first names and latest username of a tracked user.
+ *     security:
+ *       - apiKeyAuth: []
+ *     parameters:
+ *       - in: header
+ *         name: x-api-key
+ *         required: true
+ *         description: API key for authentication.
+ *         schema:
+ *           type: string
+ *       - in: path
+ *         name: user_id
+ *         required: true
+ *         description: The Telegram user ID to fetch tracking data for.
+ *         schema:
+ *           type: integer
+ *           example: 123456789
+ *     responses:
+ *       200:
+ *         description: Successfully retrieved user tracking data.
+ *         content:
+ *           application/json:
+ *             schema:
+ *               type: object
+ *               properties:
+ *                 user_id:
+ *                   type: integer
+ *                   example: 123456789
+ *                 username:
+ *                   type: string
+ *                   example: "new_user"
+ *                 first_name_history:
+ *                   type: array
+ *                   items:
+ *                     type: string
+ *                   example: ["John", "Johnny", "Jonathan"]
+ *       404:
+ *         description: User not found.
+ *       500:
+ *         description: Internal server error.
+ */
 SangmataRoutes.get("/api/v2/sangmata/tracker/:user_id", authenticateApiKey, async (req, res) => {
   try {
     const { user_id } = req.params;