Update plugins/sangmata.js

plugins/sangmata.js

@@ -8,9 +8,9 @@ const SangmataRoutes = express.Router();
  * @swagger
  * /api/v2/sangmata/tracker:
  *   post:
- *     summary: Create a sangmata tracker
+ *     summary: Track and update a user's first name history
  *     tags: [Sangmata]
- *     description: Creates a new sangmata with a first name and username.
+ *     description: Updates or creates a record tracking a user's first name changes.
  *     security:
  *       - apiKeyAuth: []
  *     requestBody:
@@ -22,14 +22,16 @@ const SangmataRoutes = express.Router();
  *             properties:
  *               user_id:
  *                 type: integer
- *                 description: UserId
+ *                 description: Unique Telegram user ID.
+ *                 example: 123456789
  *               username:
  *                 type: string
- *                 description: Usernames.
+ *                 description: User's latest Telegram username.
+ *                 example: "new_user"
  *               first_name:
  *                 type: string
- *                 description: first name.
- *
+ *                 description: New first name to be added to history.
+ *                 example: "John"
  *     parameters:
  *       - in: header
  *         name: x-api-key
@@ -39,17 +41,34 @@ const SangmataRoutes = express.Router();
  *           type: string
  *     responses:
  *       200:
- *         description: Sangmata successfully.
+ *         description: User data updated successfully.
  *         content:
  *           application/json:
  *             schema:
  *               type: object
  *               properties:
+ *                 success:
+ *                   type: boolean
+ *                   example: true
  *                 message:
  *                   type: string
- *                   example: User data updated successfully
+ *                   example: "User data updated successfully"
+ *                 user:
+ *                   type: object
+ *                   properties:
+ *                     user_id:
+ *                       type: integer
+ *                       example: 123456789
+ *                     username:
+ *                       type: string
+ *                       example: "new_user"
+ *                     first_name:
+ *                       type: array
+ *                       items:
+ *                         type: string
+ *                       example: ["John", "Johnny", "Jonathan"]
  *       400:
- *         description: Sangmata already exists or missing parameters.
+ *         description: Missing required parameters or invalid data.
  *       500:
  *         description: Internal server error.
  */