/home/infinitibizsol/.trash/docs/discarded/ Current File: /home/infinitibizsol/.trash/docs/discarded/files.js
/**
 * @swagger
 * components:
 *   schemas:
 *     File:
 *       type: object
 *       required:
 *         - title
 *         - description
 *         - apply_description
 *         - created_by
 *         - file
 *       properties:
 *         title:
 *           type: string
 *           description: The title of the request
 *         description:
 *           type: string
 *           description: Description of the request
 *         apply_description:
 *           type: boolean
 *           description: Whether to apply the description or not
 *         created_by:
 *           type: string
 *           description: The ID of the creator
 *         file:
 *           type: string
 *           format: uri
 *           description: URL of the image associated with the request
 *       example:
 *         title: "sql query"
 *         description: "No Description"
 *         apply_description: true
 *         created_by: "666a1adb4a817baa96f0387a"
 *         file: "http://example.com/image.png"
 *     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: File
 *     description: Operations related to Custom Form Data
 */

/**
 * @swagger
 * /file/list:
 *   get:
 *     summary: Returns the list of Custom Form Data entries
 *     tags: [File]
 *     security:
 *       - bearerAuth: []
 *     responses:
 *       200:
 *         description: The list of Custom Form Data entries
 *         content:
 *           application/json:
 *             schema:
 *               type: array
 *               items:
 *                 $ref: '#/components/schemas/File'
 */

/**
 * @swagger
 * /file/add:
 *   post:
 *     summary: Create a new Custom Form Data entry with image or document file
 *     tags: [File]
 *     security:
 *       - bearerAuth: []
 *     requestBody:
 *       required: true
 *       content:
 *         multipart/form-data:
 *           schema:
 *             $ref: '#/components/schemas/File'
 *     responses:
 *       201:
 *         description: The Custom Form Data entry was successfully created
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/File'
 */

/**
 * @swagger
 * /file/edit/{id}:
 *   put:
 *     summary: Update a file by ID
 *     tags: [File]
 *     security:
 *       - bearerAuth: []
 *     parameters:
 *       - in: path
 *         name: id
 *         schema:
 *           type: string
 *         required: true
 *         description: The file ID
 *     requestBody:
 *       required: true
 *       content:
 *         multipart/form-data:
 *           schema:
 *             $ref: '#/components/schemas/File'
 *     responses:
 *       200:
 *         description: File updated successfully
 *         content:
 *           application/json:
 *             schema:
 *               $ref: '#/components/schemas/UpdateResponse'
 *       404:
 *         description: File not found
 */

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