Sindbad~EG File Manager

/**
 * @swagger
 * components:
 *   schemas:
 *     Signature:
 *       type: object
 *       required:
 *         - signature
 *         - signature_name
 *         - active
 *         - user_id
 *       properties:
 *         signature:
 *           type: string
 *           description: The actual signature content
 *         signature_name:
 *           type: string
 *           description: The name of the signature
 *         active:
 *           type: boolean
 *           description: Indicates if the signature is active
 *         user_id:
 *           type: string
 *           description: The unique identifier of the user
 *       example:
 *         signature: "signatures.jpeg"
 *         signature_name: "signature_name"
 *         active: true
 *         user_id: "667dcaf3f52d0d7678ea7dea"
 *     UpdateResponse:
 *       type: object
 *       properties:
 *         message:
 *           type: string
 *           example: "Data updated successfully"
 *     DeleteResponse:
 *       type: object
 *       properties:
 *         message:
 *           type: string
 *           example: "entry_name and related data deleted successfully"
 *   securitySchemes:
 *     bearerAuth:
 *       type: http
 *       scheme: bearer
 *       bearerFormat: JWT
 */

/**
 * @swagger
 * tags:
 *   - name: Signature
 *     description: Signature related operations
 */

/**
 * @swagger
 * /signature/list:
 *   get:
 *     summary: Returns the list of signatures
 *     tags: [Signature]
 *     security:
 *       - bearerAuth: []
 *     responses:
 *       200:
 *         description: The list of signatures
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/Signature'
 */

/**
 * @swagger
 * /signature/add:
 *   post:
 *     summary: Create a new signature
 *     description: |
 *       - To add goal information, follow these guidelines:
 *         * For **User/Agent**:
 *           - When accessing another agent's profile, provide `user_id` in request body.
 *           - For the logged-in agent, `user_id` will be automatically obtained from the JWT token.
 *     tags: [Signature]
 *     security:
 *       - bearerAuth: []
 *     requestBody:
 *       required: true
 *       content:
 *         application/json:
 *           schema:
 *             $ref: '#/components/schemas/Signature'
 *     responses:
 *       201:
 *         description: The signature was successfully created
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/Signature'
 */

/**
 * @swagger
 * /signature/edit/{id}:
 *   put:
 *     summary: Update the signature by ID
 *     tags: [Signature]
 *     security:
 *       - bearerAuth: []
 *     parameters:
 *       - in: path
 *         name: id
 *         schema:
 *           type: string
 *         required: true
 *         description: The signature ID
 *     requestBody:
 *       required: true
 *       content:
 *         application/json:
 *           schema:
 *             $ref: '#/components/schemas/Signature'
 *     responses:
 *       200:
 *         description: The signature was successfully updated
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/UpdateResponse'
 */

/**
 * @swagger
 * /signature/delete/{id}:
 *   delete:
 *     summary: Delete the signature by ID
 *     tags: [Signature]
 *     security:
 *       - bearerAuth: []
 *     parameters:
 *       - in: path
 *         name: id
 *         schema:
 *           type: string
 *         required: true
 *         description: The signature ID
 *     responses:
 *       200:
 *         description: The signature was successfully deleted
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/DeleteResponse'

 */