Update openapi.yaml

Author: n1crack

docs/api-reference/openapi.yaml

@@ -178,8 +178,13 @@ components:
     DeleteRequest:
       type: object
       required:
+        - path
         - items
       properties:
+        path:
+          type: string
+          description: Current directory path (including storage prefix)
+          example: "local://uploads"
         items:
           type: array
           items:
@@ -200,9 +205,14 @@ components:
     RenameRequest:
       type: object
       required:
+        - path
         - item
         - name
       properties:
+        path:
+          type: string
+          description: Current directory path (including storage prefix)
+          example: "local://uploads"
         item:
           type: string
           description: Current full path of the item to rename (including storage prefix)
@@ -217,6 +227,7 @@ components:
       required:
         - sources
         - destination
+        - path
       properties:
         sources:
           type: array
@@ -228,6 +239,10 @@ components:
           type: string
           description: Full destination path (including storage prefix)
           example: "local://backup"
+        path:
+          type: string
+          description: Current directory path (including storage prefix)
+          example: "local://uploads"
 
     ArchiveRequest:
       type: object
@@ -279,8 +294,13 @@ components:
     CreateItemRequest:
       type: object
       required:
+        - path
         - name
       properties:
+        path:
+          type: string
+          description: Target directory path (including storage prefix)
+          example: "local://uploads"
         name:
           type: string
           description: Name for the new item
@@ -289,8 +309,13 @@ components:
     SaveRequest:
       type: object
       required:
+        - path
         - content
       properties:
+        path:
+          type: string
+          description: Full file path where content should be saved (including storage prefix)
+          example: "local://uploads/file.txt"
         content:
           type: string
           description: Content to save (as string)
@@ -440,21 +465,14 @@ paths:
       summary: Delete files or folders
       description: Delete one or more files or folders from the specified path.
       operationId: deleteFiles
-      parameters:
-        - name: path
-          in: query
-          required: false
-          description: Current directory path (optional)
-          schema:
-            type: string
-          example: "local://uploads"
       requestBody:
         required: true
         content:
           application/json:
             schema:
               $ref: '#/components/schemas/DeleteRequest'
             example:
+              path: "local://uploads"
               items:
                 - path: "local://uploads/file.txt"
                   type: "file"
@@ -514,21 +532,14 @@ paths:
       summary: Rename a file or folder
       description: Rename a file or folder to a new name.
       operationId: renameFile
-      parameters:
-        - name: path
-          in: query
-          required: false
-          description: Current directory path (optional)
-          schema:
-            type: string
-          example: "local://uploads"
       requestBody:
         required: true
         content:
           application/json:
             schema:
               $ref: '#/components/schemas/RenameRequest'
             example:
+              path: "local://uploads"
               item: "local://uploads/old-name.txt"
               name: "new-name.txt"
       responses:
@@ -577,6 +588,7 @@ paths:
             schema:
               $ref: '#/components/schemas/TransferRequest'
             example:
+              path: "local://uploads"
               sources:
                 - "local://uploads/file1.txt"
                 - "local://uploads/file2.txt"
@@ -627,6 +639,7 @@ paths:
             schema:
               $ref: '#/components/schemas/TransferRequest'
             example:
+              path: "local://uploads"
               sources:
                 - "local://uploads/file.txt"
               destination: "local://archive"
@@ -764,21 +777,14 @@ paths:
       summary: Create a new file
       description: Create a new empty file at the specified path.
       operationId: createFile
-      parameters:
-        - name: path
-          in: query
-          required: true
-          description: Target directory path (including storage prefix)
-          schema:
-            type: string
-          example: "local://uploads"
       requestBody:
         required: true
         content:
           application/json:
             schema:
               $ref: '#/components/schemas/CreateItemRequest'
             example:
+              path: "local://uploads"
               name: "new-file.txt"
       responses:
         '200':
@@ -813,21 +819,14 @@ paths:
       summary: Create a new folder
       description: Create a new empty folder at the specified path.
       operationId: createFolder
-      parameters:
-        - name: path
-          in: query
-          required: true
-          description: Target directory path (including storage prefix)
-          schema:
-            type: string
-          example: "local://uploads"
       requestBody:
         required: true
         content:
           application/json:
             schema:
               $ref: '#/components/schemas/CreateItemRequest'
             example:
+              path: "local://uploads"
               name: "new-folder"
       responses:
         '200':
@@ -1058,23 +1057,16 @@ paths:
       tags:
         - Files
       summary: Save content to file
-      description: Save text or binary content to a file at the specified path. Overwrites existing file if it already exists. The file path is provided as a query parameter.
+      description: Save text or binary content to a file at the specified path. Overwrites existing file if it already exists.
       operationId: saveFile
-      parameters:
-        - name: path
-          in: query
-          required: true
-          description: Full file path where content should be saved (including storage prefix)
-          schema:
-            type: string
-          example: "local://uploads/file.txt"
       requestBody:
         required: true
         content:
           application/json:
             schema:
               $ref: '#/components/schemas/SaveRequest'
             example:
+              path: "local://uploads/file.txt"
               content: "Hello, World!\nThis is the file content."
       responses:
         '200':