chore: update generated openapi.yaml for fix-assets and clean-assets endpoints

Author: hassandotcms

dotCMS/src/main/webapp/WEB-INF/openapi/openapi.yaml

@@ -11122,6 +11122,55 @@ paths:
           description: default response
       tags:
       - TailLog
+  /v1/maintenance/_cleanAssets:
+    get:
+      description: Returns the current status of the clean orphan assets background
+        process. Poll this endpoint while running is true.
+      operationId: getCleanAssetsStatus
+      responses:
+        "200":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ResponseEntityCleanAssetsStatusView"
+          description: Current clean assets status
+        "401":
+          content:
+            application/json: {}
+          description: Unauthorized - authentication required
+        "403":
+          content:
+            application/json: {}
+          description: Forbidden - CMS Administrator role required
+      summary: Poll clean assets status
+      tags:
+      - Maintenance
+    post:
+      description: Starts a background thread that deletes orphan asset directories
+        with no matching contentlet in the database. Returns 409 if already running.
+      operationId: startCleanAssets
+      responses:
+        "200":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ResponseEntityCleanAssetsStatusView"
+          description: Clean assets process started
+        "401":
+          content:
+            application/json: {}
+          description: Unauthorized - authentication required
+        "403":
+          content:
+            application/json: {}
+          description: Forbidden - CMS Administrator role required
+        "409":
+          content:
+            application/json: {}
+          description: Conflict - clean assets process is already running
+      summary: Start clean orphan assets
+      tags:
+      - Maintenance
   /v1/maintenance/_downloadAssets:
     get:
       operationId: downloadAssets
@@ -11227,6 +11276,57 @@ paths:
           description: default response
       tags:
       - Maintenance
+  /v1/maintenance/_fixAssets:
+    get:
+      description: Returns the current results of the fix assets inconsistencies process.
+        Use this to poll for completion after starting the process.
+      operationId: getFixAssetsProgress
+      responses:
+        "200":
+          content:
+            application/json:
+              schema:
+                type: object
+                description: "ResponseEntityView wrapping a list of task result maps,\
+                  \ each containing total, errorsFixed, initialTime, finalTime, and\
+                  \ description"
+          description: Current fix task results
+        "401":
+          content:
+            application/json: {}
+          description: Unauthorized - authentication required
+        "403":
+          content:
+            application/json: {}
+          description: Forbidden - CMS Administrator role required
+      summary: Poll fix assets progress
+      tags:
+      - Maintenance
+    post:
+      description: Runs all registered FixTask classes that check for and fix database
+        inconsistencies. Returns task results when complete.
+      operationId: startFixAssets
+      responses:
+        "200":
+          content:
+            application/json:
+              schema:
+                type: object
+                description: "ResponseEntityView wrapping a list of task result maps,\
+                  \ each containing total, errorsFixed, initialTime, finalTime, and\
+                  \ description"
+          description: Fix tasks completed
+        "401":
+          content:
+            application/json: {}
+          description: Unauthorized - authentication required
+        "403":
+          content:
+            application/json: {}
+          description: Forbidden - CMS Administrator role required
+      summary: Start fix assets inconsistencies
+      tags:
+      - Maintenance
   /v1/maintenance/_oldVersions:
     delete:
       description: "Deletes all versions of versionable objects (contentlets, containers,\
@@ -23142,6 +23242,39 @@ components:
             type: string
           variable:
             type: string
+    CleanAssetsStatusView:
+      type: object
+      properties:
+        currentFiles:
+          type: integer
+          format: int32
+          description: Number of directories processed so far
+          example: 12500
+        deleted:
+          type: integer
+          format: int32
+          description: Number of orphan directories deleted
+          example: 83
+        running:
+          type: boolean
+          description: Whether the process is currently running
+          example: true
+        status:
+          type: string
+          description: "Current status description: Starting, Counting, Cleaning,\
+            \ Finished, or Error message"
+          example: Cleaning
+        totalFiles:
+          type: integer
+          format: int32
+          description: Total number of asset directories to process
+          example: 45000
+      required:
+      - currentFiles
+      - deleted
+      - running
+      - status
+      - totalFiles
     ColumnField:
       type: object
       allOf:
@@ -29109,6 +29242,29 @@ components:
           type: array
           items:
             type: string
+    ResponseEntityCleanAssetsStatusView:
+      type: object
+      properties:
+        entity:
+          $ref: "#/components/schemas/CleanAssetsStatusView"
+        errors:
+          type: array
+          items:
+            $ref: "#/components/schemas/ErrorEntity"
+        i18nMessagesMap:
+          type: object
+          additionalProperties:
+            type: string
+        messages:
+          type: array
+          items:
+            $ref: "#/components/schemas/MessageEntity"
+        pagination:
+          $ref: "#/components/schemas/Pagination"
+        permissions:
+          type: array
+          items:
+            type: string
     ResponseEntityCompanyConfigView:
       type: object
       properties:
@@ -31593,6 +31749,33 @@ components:
           type: array
           items:
             type: string
+    ResponseEntityViewListMap:
+      type: object
+      properties:
+        entity:
+          type: array
+          items:
+            type: object
+            additionalProperties:
+              type: object
+        errors:
+          type: array
+          items:
+            $ref: "#/components/schemas/ErrorEntity"
+        i18nMessagesMap:
+          type: object
+          additionalProperties:
+            type: string
+        messages:
+          type: array
+          items:
+            $ref: "#/components/schemas/MessageEntity"
+        pagination:
+          $ref: "#/components/schemas/Pagination"
+        permissions:
+          type: array
+          items:
+            type: string
     ResponseEntityViewListMulitreeView:
       type: object
       properties: